| name | agentpack-review |
| description | Run the full AgentPack PR review flow for the current branch or PR with an optional reviewer lens. |
| license | AGPL-3.0-only |
AgentPack Review
Use when the user invokes $agentpack-review or $agentpack-review <reviewer context>.
Do not claim correctness unless relevant checks actually ran.
Steps
- Refresh AgentPack context for this exact review task before reading PR diff or code. Prefer MCP:
agentpack_pack_context(task="review current PR $ARGUMENTS")
If MCP is unavailable, run:
agentpack guard --agent auto --repair-stale --refresh-context
If you bypass this refresh, state the bypass reason before continuing.
2. Prepare the full review bundle. If $ARGUMENTS names a PR number or PR URL, agentpack review must bind metadata, diff, and context to that PR. If the user did not name a PR, agentpack review must identify the current PR through gh; do not accept silent HEAD~1 fallback.
agentpack review "$ARGUMENTS"
Use this explicit form when the PR target is known:
agentpack review --pr <number-or-url> "$ARGUMENTS"
- Read
.agentpack/review.prompt.md and follow it end to end.
- By default,
agentpack review starts a fresh run under .agentpack/reviews/<branch-or-pr>/<run_id>/ and refreshes the stable alias files in .agentpack/.
- Do not perform the review inline from this skill. If you cannot write the required files, stop and report blocked.
- The Anchor role starts from
.agentpack/review-understanding.template.toon and writes the compatible run-scoped understanding TOON at the output path declared by agentpack review.
- Run
agentpack review --check; do not start Judge unless Anchor validates.
- Judge must read that understanding TOON from disk, start from
.agentpack/review-findings.template.toon, and write the candidate findings TOON at the declared run-scoped path.
- Run
agentpack review --check; Critic must read the canonical Anchor and Judge handoffs, start from .agentpack/review-critique.template.toon, and write exactly one accept, reject, or downgrade decision for every Judge finding at the declared path.
- Run
agentpack review --check to validate Critic and generate approved-findings.toon. --dry-run-post and --post-inline-comments consume only that approved artifact. Actor is publish-only: it never edits or pushes a PR branch. Do not produce a final review summary unless Critic validates and any intended PR-bound inline post succeeds.
- If an older model emits valid JSON or fenced output instead of TOON, rerun
agentpack review --check; AgentPack canonicalizes schema-valid output to TOON and writes a repair guide for invalid output.
- Resume an interrupted run only with
agentpack review --resume <run_id>.
- Use the latest PR head,
gh pr view, git diff, and direct code reads as source of truth.
- Treat any non-PR portion of
$ARGUMENTS only as a prioritization lens. It must not replace code evidence.
- Report approved findings first with file evidence, then state inline-post status and validation exactly: dry-run passed, posted, failed, or not run.
