IMPORTANT: After running the command below, you'll see a LONG work package prompt (~1000+ lines).
You MUST scroll to the BOTTOM to see the completion commands!
Run this command to get the work package prompt and review instructions:
spec-kitty agent workflow review $ARGUMENTS --agent <your-name>
CRITICAL: You MUST provide --agent <your-name> to track who is reviewing!
If no WP ID is provided, it will automatically find the first work package with lane: "for_review" and move it to "doing" for you.
Dependency checks (required)
-
dependency_check: If the WP frontmatter lists dependencies , confirm each dependency WP is merged to the target branch before you review this WP.
-
dependent_check: Identify any WPs that list this WP as a dependency and note their current lanes.
-
rebase_warning: If you request changes AND any dependents exist, warn those agents to rebase and provide a concrete command (example: cd .worktrees/FEATURE-WP02 && git rebase FEATURE-WP01 ).
-
verify_instruction: Confirm dependency declarations match actual code coupling (imports, shared modules, API contracts).
After reviewing, scroll to the bottom and run ONE of these commands:
-
✅ Approve: spec-kitty agent tasks move-task WP## --to done --note "Review passed: <summary>"
-
❌ Reject: Write feedback to the temp file path shown in the prompt, then run spec-kitty agent tasks move-task WP## --to planned --review-feedback-file <temp-file-path>
The prompt will provide a unique temp file path for feedback - use that exact path to avoid conflicts with other agents!
The Python script handles all file updates automatically - no manual editing required!