skill-staged-review

# Two-Stage Review Pipeline Separates **spec compliance** (did you build the right thing?) from **code quality** (did you build it right?). Stage 1 must pass before Stage 2 runs. --- ## Stage 1: Spec Compliance Validates the implementation against the intent contract. ### Step 1: Load Intent Contract ```bash INTENT_FILE=".claude/session-intent.md" if [[ -f "$INTENT_FILE" ]]; then echo "Intent contract found: $INTENT_FILE" cat "$INTENT_FILE" else echo "WARNING: No intent contract found at $INTENT_FILE" echo "Skipping Stage 1 — proceeding to Stage 2 (code quality) only." fi ``` **If no intent contract exists:** Warn the user and skip to Stage 2. Do NOT fabricate success criteria — the contract must exist from a prior workflow. ### Step 2: Validate Success Criteria For each success criterion in the intent contract: 1. **Read the criterion** from the `## Success Criteria` section 2. **Find evidence** in the codebase that the criterion is met 3. **Mark status:** - `[PASS]` — Evidence confirms criterion is met - `[FAIL]` — Evidence shows criterion is NOT met - `[PARTIAL]` — Partially met, gaps identified Present results: ```markdown ## Stage 1: Spec Compliance ### Success Criteria Check #### Good Enough Criteria - [PASS] Criterion 1: <how it was met> - [FAIL] Criterion 2: <why not met, what's missing> #### Exceptional Criteria - [PARTIAL] Criterion 1: <what's done, what's remaining> ``` ### Step 3: Validate Boundaries For each boundary in the inten...