Agent Instructions

Working on Agentic Tickets

Issues labeled “Agentic” are meant for an agent to pick up and work on. When the user points you to one (or asks you to pick one up):

  1. Read the issue to understand the task.
  2. Create a feature branch named feature/<issue-number>.
  3. Do the work described in the issue.
  4. Open a PR targeting main with Fixes #<issue-number> in the body.
  5. Ensure all PR checks pass before merging.
  6. Merge automatically unless the issue says otherwise.

Responding to PR Comments

When a user comments on a PR that you previously opened, you will be invoked again with the PR’s head branch already checked out. To respond:

  1. Read the comment to understand what is being requested.
  2. If the request is unclear or ambiguous, do not push any changes. Post a reply on the PR asking a specific clarifying question (gh pr comment <pr-number> --body "...") and stop.
  3. Otherwise, make the requested changes on the current branch.
  4. Commit and push. The existing PR will pick up the new commits automatically.
  5. Post a reply on the PR thread summarizing what changed.

Do not open a new PR — always push to the existing branch.