> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-ai/untitled-1/use-harness-ai/ai-agents/productivity-agent.md).

# Developer Productivity Agents

Harness Developer Productivity agents automate common engineering workflows that are tedious and time-consuming. The **Feature Flag Cleanup** agent removes stale flags from codebases, the **React Upgrade** agent handles framework upgrades with custom prompts, and the **Onboarding** agent imports repositories and auto-generates CI pipelines.

***

### Feature Flag Cleanup Agent <a href="#feature-flag-cleanup-agent" id="feature-flag-cleanup-agent"></a>

The Feature Flag Cleanup agent removes stale feature flags from codebases. Given a feature flag name and the desired treatment (e.g., `on` or `off`), it uses Claude AI to find all flag references, remove evaluations while keeping only the selected treatment's code path, and clean up unused imports and variables.

#### How It Works <a href="#how-it-works" id="how-it-works"></a>

1. **Task Generation** — Generates a detailed cleanup prompt based on the flag name and desired treatment.
2. **Code Analysis** — Claude AI (up to 50 iterations) scans the codebase for all flag references.
3. **Flag Removal** — Removes flag evaluations, keeping only the code path for the selected treatment.
4. **Cleanup** — Removes unused imports, variables, and dead code left by flag removal.
5. **Draft PR** — Pushes changes and creates a draft PR via the Harness Code API.

#### Key Inputs <a href="#key-inputs" id="key-inputs"></a>

| Input           | Type   | Description                               |
| --------------- | ------ | ----------------------------------------- |
| `anthropicKey`  | secret | Anthropic API key for Claude AI           |
| `harnessApiKey` | secret | Harness API key for creating PRs          |
| `featureFlag`   | string | Name of the feature flag to remove        |
| `treatment`     | string | Desired treatment to keep (default: `on`) |
| `repo`          | string | Repository name                           |
| `branch`        | string | Target branch                             |

#### Output Artifacts <a href="#output-artifacts" id="output-artifacts"></a>

The agent writes four files that are used to create the PR:

* `branch.txt` — Name of the created branch
* `commit.txt` — Commit SHA of the changes
* `pr_title.txt` — AI-generated PR title
* `pr_description.txt` — AI-generated PR description

#### Pipeline Configuration <a href="#pipeline-configuration" id="pipeline-configuration"></a>

```yaml
pipeline:
  clone:
    depth: 1
    ref:
      name: <+inputs.branch>
      type: branch
    repo: <+inputs.repo>
  stages:
    - name: FFCleanup
      timeout: 10m
      cache:
        disabled: false
      platform:
        os: linux
        arch: arm64
      steps:
        - name: Agent prompt
          run:
            shell: bash
            script: >
              # Generate cleanup task prompt
        - name: coding_agent
          run:
            container:
              image: anewdocker25/mydockerhub:coding-agent
            with:
              detailed_logging: "true"
              max_iterations: "50"
              task_file_path: /harness/temp-pipeline/task.txt
              working_directory: /harness
            env:
              ANTHROPIC_API_KEY: <+inputs.anthropicKey>
        - name: createNetrc
          run:
            shell: sh
            script: |-
              cat <<EOF > ${HOME}/.netrc
                ...
              EOF
        - name: Pull Request Pusher
          run:
            shell: bash
            script: >
              # Push and create PR via Harness Code API
  inputs:
    anthropicKey:
      type: secret
      default: ffcleanup_anthropic_apikey
    harnessApiKey:
      type: secret
      default: ffcleanup_harness_apikey
    featureFlag:
      type: string
      label: Feature Flag
      required: true
      description: The feature flag to be cleaned up
    treatment:
      type: string
      label: Treatment
      description: The treatment to keep the branch code
      required: false
      default: "on"
    repo:
      type: string
    branch:
      type: string
      default: main
```

{% hint style="info" %}
**DRAFT PR REVIEW**

The Feature Flag Cleanup agent creates draft PRs so your team can review changes before merging. It generates both a PR title and description using AI, making the review easy to understand.
{% endhint %}

***

### React Upgrade Agent <a href="#react-upgrade-agent" id="react-upgrade-agent"></a>

The React Upgrade agent automates React version upgrades and code modifications using custom prompts. Despite its name, it's the most flexible agent — it accepts any free-form `prompt` input, making it suitable for framework upgrades, refactoring, dependency updates, and performance optimizations.

#### Use Cases <a href="#use-cases" id="use-cases"></a>

* Upgrade React from version 17 to 18
* Refactor class components to functional components with hooks
* Update deprecated API usage across the codebase
* Migrate from one state management library to another
* Apply performance optimizations based on custom criteria

#### Key Inputs <a href="#key-inputs" id="key-inputs"></a>

| Input          | Type      | Description                                                           |
| -------------- | --------- | --------------------------------------------------------------------- |
| `llmConnector` | connector | LLM connector for AI operations                                       |
| `harnessKey`   | secret    | Harness API key                                                       |
| `gitConnector` | connector | Git connector for repository access                                   |
| `repo`         | string    | Repository name                                                       |
| `branch`       | string    | Target branch                                                         |
| `prompt`       | string    | Custom prompt describing the upgrade/modification task (**required**) |

#### Pipeline Configuration <a href="#pipeline-configuration" id="pipeline-configuration"></a>

```yaml
pipeline:
  clone:
    depth: 1
    ref:
      name: <+inputs.branch>
      type: branch
    repo: <+inputs.repo>
    connector: "<+inputs.gitConnector != null ? inputs.gitConnector.id : ''>"
  stages:
    - name: react_upgrade
      id: stage1
      steps:
        - name: coding_agent
          id: step1
          run:
            container:
              image: anewdocker25/mydockerhub:coding-agent
            with:
              detailed_logging: "true"
              max_iterations: "300"
              working_directory: /harness
              show_diff: "false"
              prompt: <+inputs.prompt>
              react_upgrade: "true"
            env:
              ANTHROPIC_API_KEY: <+inputs.llmConnector.token>
        - name: show_git_diff
          id: step2
          run:
            shell: bash
            script: |-
              git add -A
              git diff --cached
        - name: fix_env_variables
          id: step3
          run:
            shell: bash
            script: |-
              # Detect SCM provider and set credentials
              # Exports SCM_PROVIDER, TOKEN, NETRC_USERNAME, etc.
            env:
              HARNESS_API_KEY: <+inputs.harnessKey>
              SCM_TOKEN: <+inputs.gitConnector.token>
        - name: push_and_create_pr
          id: step4
          run:
            container:
              image: himanshu6956/create-pr-plugin:latest
            env:
              PLUGIN_SCM_PROVIDER: <+pipeline.stages.stage1.steps.step3.output.outputVariables.SCM_PROVIDER>
              PLUGIN_TOKEN: <+pipeline.stages.stage1.steps.step3.output.outputVariables.TOKEN>
              PLUGIN_REPO: ${{inputs.repo}}
              PLUGIN_SOURCE_BRANCH: ${{inputs.branch}}
              PLUGIN_BRANCH_SUFFIX: react-upgrade-code-agent
              PLUGIN_COMMIT_MESSAGE: "React upgrade: automated changes by Harness AI"
              PLUGIN_CREATE_PR: "true"
              PLUGIN_PR_TITLE: "React Upgrade: Automated changes by Harness AI"
      platform:
        os: linux
        arch: arm64
  inputs:
    llmConnector:
      type: connector
    harnessKey:
      type: secret
      default: harness_api_key
    gitConnector:
      type: connector
    repo:
      type: string
    branch:
      type: string
      default: main
      description: The branch to clone from and create PR against (defaults to main)
    prompt:
      type: string
      required: true
      description: The prompt/task for the coding agent to execute
```

{% hint style="info" %}
**FLEXIBLE BRANCHING**

The React Upgrade agent uses up to 300 AI iterations and creates branches with timestamps (e.g., `react-upgrade-code-agent-1706123456`) to avoid conflicts when running multiple upgrades in parallel.
{% endhint %}

***

### Onboarding Agent <a href="#onboarding-agent" id="onboarding-agent"></a>

The Onboarding agent streamlines repository setup in Harness. It imports repositories from GitHub into Harness Code, analyzes the repo structure to detect technologies and build commands, and auto-generates a CI pipeline tailored to the project.

#### How It Works <a href="#how-it-works" id="how-it-works"></a>

1. **Repository Import** — Clones the source repository from GitHub and imports it into Harness Code.
2. **Technology Detection** — Claude Sonnet analyzes the repo structure (languages, frameworks, build tools, dependencies).
3. **Pipeline Generation** — Claude Opus generates a complete CI pipeline based on the detected technology stack.
4. **Pipeline Creation** — The generated pipeline is created in Harness via the API.

#### Unique Architecture <a href="#unique-architecture" id="unique-architecture"></a>

The Onboarding agent has a few notable differences from other agents: it uses **two Claude models** in sequence (Sonnet for fast analysis, Opus for high-quality pipeline generation), it has **no clone step** in the pipeline (the agent container handles cloning itself), and it runs on `linux/amd64` rather than the `arm64` platform used by most agents.

#### Key Inputs <a href="#key-inputs" id="key-inputs"></a>

| Input           | Type   | Description                                               |
| --------------- | ------ | --------------------------------------------------------- |
| `anthropicKey`  | secret | Anthropic API key for Claude AI                           |
| `harnessKey`    | secret | Harness API key for creating repos and pipelines          |
| `scmToken`      | secret | Optional SCM token for private repository access          |
| `repoNamespace` | string | Source repository namespace/owner (e.g., `myorg`)         |
| `repoName`      | string | Source repository name                                    |
| `connectorRef`  | string | Harness connector reference for git operations (optional) |

#### Pipeline Configuration <a href="#pipeline-configuration" id="pipeline-configuration"></a>

```yaml
pipeline:
  stages:
    - name: onboarding
      steps:
        - name: onboarding_agent
          run:
            container:
              image: colinharness/onboarding-agent:1.0.49
            env:
              ANTHROPIC_API_KEY: <+inputs.anthropicKey>
              HARNESS_API_KEY: <+inputs.harnessKey>
              REPO_NAME: <+inputs.repoName>
              REPO_NAMESPACE: <+inputs.repoNamespace>
              SCM_TOKEN: <+inputs.scmToken>
              CONNECTOR_REF: <+inputs.connectorRef>
      platform:
        os: linux
        arch: amd64
  inputs:
    anthropicKey:
      type: secret
      default: account.onboarding_anthropic_api_key
      description: Anthropic API key for Claude AI
    harnessKey:
      type: secret
      default: account.onboarding_harness_token_pat
      description: Harness API key for creating pipelines
    scmToken:
      type: secret
      description: GitHub token for accessing private repositories (optional)
    repoName:
      type: string
      required: true
      description: Name of repository to clone
    repoNamespace:
      type: string
      required: true
      description: Namespace of repository to clone (e.g., GitHub username)
    connectorRef:
      type: string
      description: Harness connector reference for git operations (optional)
  name: onboarding
```

{% hint style="info" %}
**MIGRATION MADE EASY**

The Onboarding agent is ideal for teams migrating to Harness. Import existing GitHub repositories and automatically generate CI pipelines — dramatically reducing the time to get up and running.
{% endhint %}