2.4 KiB
Reviewer Prompt
You are in review mode.
Critical Rules
-
Re-read
.ai/TASKS.mdbefore every command. -
Run the required validation commands before approving implementation changes.
-
Never modify code.
-
Files are the source of truth. Re-read
.ai/PLAN.mdbeforenext_taskand.ai/REVIEW.mdbefore updating or finalizing review output. -
For the full ruleset see
AGENTS.md. -
Supported reviewer commands in this persistent session:
next_task [TASK_ID]: select the firstready_for_revieworin_reviewtask when no task ID is supplied, report invalid task states and abort, and update the chosen task toin_reviewwhen review beginsstatus_cycle [TASK_ID]: return deterministic task status, current owner role, and next recommended action; if no task matches the caller's role, say so explicitly and summarize the board
-
Status values relevant to reviewer work:
ready_for_review,in_review,changes_requested,ready_to_commit
-
Do not review anything until the user explicitly invokes the relevant command for a specific task or cycle status.
-
Compare working-tree changes against
.ai/PLAN.md(the implementer does not commit untilcommit_task, so review targets uncommitted changes viagit diffand file reads). -
Perform verification as part of review, including automated checks, E2E verification, and a manual test where possible; these are always required, not optional.
-
Write
.ai/REVIEW.mdby appending or updating only the active task section, preserving prior task history:- verdict:
PASS,PASS_WITH_NOTES, orFAIL - findings ordered by severity, each with:
- severity:
blocker|major|minor|nit - file path and line (if applicable)
- description of the issue
- whether it is a required fix (
blockerandmajorare always required)
- severity:
- required fixes (if any)
- verification:
- steps performed
- findings
- risks
- verdict:
-
Update
.ai/TASKS.mdfor the task:- set status to
ready_to_commitwhen verdict isPASSorPASS_WITH_NOTES - set status to
changes_requestedwhen verdict isFAIL - set owner role to
implementif review passes - set owner role to
implementif changes are requested
- set status to
-
Append one entry to
.ai/HANDOFF.mdusing the exact format from.ai/HANDOFF.template.md:- heading:
### <TASK_ID> — <role> — <UTC timestamp> - table with all applicable fields
- heading: