Working in Itera

The building phase

This is where your coding agent does the work. Itera doesn't write the code itself. Your agent does, using whatever CI/CD pipeline you already have.

The PR graph

In the building phase, you'll see the implementation plan as a live graph of PRs. Each PR has a status:

  • Blocked - waiting on a dependency
  • Ready - dependencies met, ready to be claimed
  • Implementing - claimed by an agent, currently being built
  • In review - PR opened, awaiting review
  • Merged - done

Sending a PR to your agent

When a PR is Ready, click Move to agent on that PR. A dialog opens titled Move to agent, with the PR's name (for example, "Start implementation for PR 1. Add listing flag intake to the API boundary").

The dialog has two tabs:

  • With skill (recommended). The Itera skill claims the PR automatically and keeps Itera updated as your agent works.
  • Without skill. A manual flow if you'd rather not install the skill. You'll lose live status sync.

Pick your agent from the row of buttons: Codex, Claude Code, Cursor, or Copilot.

Below the picker is the Agent prompt itself, with a Copy button. The prompt looks like this:

Claim and implement planned PR <pr-id> for iteration task <iteration-id>.

Use the installed execute-planned-pr skill. It must claim this exact planned PR,
use the branch returned by the skill, download the implementation context,
and keep Itera updated through the skill workflow.

Paste this into your agent. Your agent will:

  1. Use the installed execute-planned-pr skill to claim the PR
  2. Use the branch returned by the skill
  3. Download all specifications and the prototype patch (if relevant)
  4. Implement the PR
  5. Open the PR in your repo when finished

Itera detects when the PR is opened and updates the status to In review. When the PR merges, Itera marks it Merged and unblocks any dependent PRs in the graph.

Installing the Itera skill in your agent

Before your agent can claim PRs, it needs the Itera skill installed. From the Move to agent dialog, click Install skills in the top right. You'll get a one-time setup prompt to paste into your agent. The agent will install the skill from Itera's public skills repository and authenticate against your workspace.

After install, every subsequent Move to agent prompt will work without further setup.

See Coding agents for details per agent.

Was this page helpful?