pr-workflow-with-agents.qmd

---
title: "Pull-Request Workflow with Agents"
format:
  html: default
  revealjs:
    output-file: pr-workflow-with-agents-slides.html
  pdf:
    output-file: pr-workflow-with-agents-handout.pdf
  docx:
    output-file: pr-workflow-with-agents.docx
---

The practices below apply whether you are driving an agent's work or doing the
work yourself. They keep parallel sessions from colliding and keep a pull
request moving toward a clean, mergeable state.

# File an Issue Before Starting

{{< include ../.ai-config/shared/workflow/issue-first.md >}}

# Claim a PR or Issue Before Working on It

{{< include ../.ai-config/shared/workflow/claim-pr.md >}}

# Keep Your Branch Synced with Main

{{< include ../.ai-config/shared/workflow/sync-with-main.md >}}

# Driving a Pull Request to Clean

{{< include ../.ai-config/shared/workflow/ardi.md >}}

# What "Fully Clean" Means {#sec-fully-clean}

{{< include ../.ai-config/shared/workflow/fully-clean.md >}}

# Address Every In-Scope Review Comment

{{< include ../.ai-config/shared/workflow/address-every-comment.md >}}

# Reviewing AI-generated work {#sec-invalidate-ai-review}

{{< include ai-tools/reviewing-ai-generated-work.qmd >}}

# Auto-fix PRs with Claude Code {#sec-autofix-pr}

[Claude Code's `/autofix-pr`](https://code.claude.com/docs/en/commands#autofix-pr)
watches the current branch's pull request from Claude Code on the web
and pushes fixes when CI fails or reviewers leave comments.
It detects the open PR from your checked-out branch via `gh pr view`;
to watch a different PR, check out its branch first.
By default it fixes every CI failure and review comment;
pass a prompt to scope it, for example `/autofix-pr only fix lint and type errors`.
It requires the `gh` CLI and access to Claude Code on the web.
A Marketplace action at
[pr-autofix-with-claude-code](https://github.com/marketplace/actions/pr-autofix-with-claude-code)
offers the same capability as a GitHub Action.

# References {.unnumbered}

::: {#refs}
:::