assist-review · git:20260406.661d690 · 2026-04-06 · sha256 ddc3865c017af2bb
assist-review git:20260406.661d690A
Immutable. This exact content is served forever at /api/v1/blob/ddc3865c017af2bb.
--- name: assist-review description: Designed to lower cognitive load for a human reviewer by auditing specifically for architectural risks mapped to the original track specification. --- # Draft Assist Review: Human-in-the-Loop Gateway Help human reviewers effectively review an executed track without shifting the entire cognitive burden onto them. ## Red Flags - STOP if you're: - Conducting standard unit tests; use `/draft:review` for that. - Fixing code rather than explaining logic and risk profiles to the human. - Reviewing output without first summarizing the source `spec.md` intent. --- ## Workflow Constraints 1. **Context Extraction:** - Load `draft/tracks/<id>/spec.md` and `draft/tracks/<id>/plan.md`. - Re-summarize the **Intent** of what this track was supposed to achieve in exactly two sentences. 2. **Blast Radius Isolation:** - Scan the `git diff` generated by the target track. - Separate trivial edits (naming, routing adjustments) from **Structural Edits** (schema updates, concurrency alterations, middleware auth changes). 3. **Draft the Human Helper Guide:** - Instead of a traditional bug hunt, generate an executive summary containing a `Risk Assessment`. - Write out: *“I chose to implement `[Specific File/Function]` using the `[Pattern]` because the `architecture.md` mandated it. You should specifically scrutinize lines X through Y because they influence global state."* 4. **Knowledge Base Verification:** - Verify if any pattern implemented violates the `draft/guardrails.md` learned anti-patterns. If so, specifically direct the human reviewer to veto the PR unless an ADR is created.