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.