autoworkflow 1.1.0 → 2.0.0

package/scripts/run-verification.sh

@@ -0,0 +1,112 @@
+#!/bin/bash
+# run-verification.sh
+# Runs TypeScript + ESLint verification with structured output
+
+set -o pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔍 VERIFICATION PHASE"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+cd "$PROJECT_ROOT"
+
+ERRORS_FOUND=0
+TS_ERRORS=0
+LINT_ERRORS=0
+
+# ─────────────────────────────────────────────────────────────
+# TypeScript Check
+# ─────────────────────────────────────────────────────────────
+
+echo ""
+echo "📋 Running TypeScript check..."
+echo ""
+
+TSC_OUTPUT=$(npm run typecheck 2>&1) || true
+
+if echo "$TSC_OUTPUT" | grep -q "error TS"; then
+    TS_ERRORS=$(echo "$TSC_OUTPUT" | grep -c "error TS" || echo "0")
+    ERRORS_FOUND=1
+
+    echo -e "${RED}❌ TypeScript: $TS_ERRORS error(s) found${NC}"
+    echo ""
+    echo "$TSC_OUTPUT" | grep "error TS" | head -20
+
+    if [ "$TS_ERRORS" -gt 20 ]; then
+        echo ""
+        echo "... and $(($TS_ERRORS - 20)) more errors"
+    fi
+else
+    echo -e "${GREEN}✅ TypeScript: No errors${NC}"
+fi
+
+# ─────────────────────────────────────────────────────────────
+# ESLint Check
+# ─────────────────────────────────────────────────────────────
+
+echo ""
+echo "📋 Running ESLint check..."
+echo ""
+
+LINT_OUTPUT=$(npm run lint 2>&1) || true
+
+if echo "$LINT_OUTPUT" | grep -qE "error|warning"; then
+    LINT_ERRORS=$(echo "$LINT_OUTPUT" | grep -cE "error|warning" || echo "0")
+    ERRORS_FOUND=1
+
+    echo -e "${RED}❌ ESLint: Issues found${NC}"
+    echo ""
+    echo "$LINT_OUTPUT" | head -30
+else
+    echo -e "${GREEN}✅ ESLint: No warnings${NC}"
+fi
+
+# ─────────────────────────────────────────────────────────────
+# Summary
+# ─────────────────────────────────────────────────────────────
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [ $ERRORS_FOUND -eq 0 ]; then
+    echo -e "${GREEN}✅ VERIFICATION PASSED${NC}"
+    echo ""
+    echo "No TypeScript errors."
+    echo "No ESLint warnings."
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${GREEN}✓ Ready to commit${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    echo ""
+    echo "VERIFICATION_STATUS=PASSED"
+    echo "TS_ERRORS=0"
+    echo "LINT_ERRORS=0"
+
+    exit 0
+else
+    echo -e "${RED}❌ VERIFICATION FAILED${NC}"
+    echo ""
+    echo "TypeScript errors: $TS_ERRORS"
+    echo "ESLint issues: $LINT_ERRORS"
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${YELLOW}⚠️  Fix errors before proceeding${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    echo ""
+    echo "VERIFICATION_STATUS=FAILED"
+    echo "TS_ERRORS=$TS_ERRORS"
+    echo "LINT_ERRORS=$LINT_ERRORS"
+
+    exit 1
+fi

package/scripts/setup.sh

@@ -0,0 +1,201 @@
+#!/bin/bash
+# setup.sh
+# AutoWorkflow - Full Setup Script
+# This script sets up the complete workflow system for any project
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+print_banner() {
+    echo ""
+    echo -e "${CYAN}╔══════════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${CYAN}║                                                              ║${NC}"
+    echo -e "${CYAN}║              AUTOWORKFLOW SETUP                              ║${NC}"
+    echo -e "${CYAN}║              System Prompt Layer for Claude Code             ║${NC}"
+    echo -e "${CYAN}║                                                              ║${NC}"
+    echo -e "${CYAN}╚══════════════════════════════════════════════════════════════╝${NC}"
+    echo ""
+}
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+TARGET_DIR="${1:-.}"
+
+print_banner
+
+echo -e "${BLUE}Target directory: $TARGET_DIR${NC}"
+echo ""
+
+# Navigate to target
+cd "$TARGET_DIR"
+
+# Step 1: Check prerequisites
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Step 1: Checking prerequisites"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [ ! -f "package.json" ]; then
+    echo -e "${YELLOW}⚠️  No package.json found. Creating minimal one...${NC}"
+    echo '{"name": "my-project", "version": "1.0.0", "private": true, "type": "module", "scripts": {}}' > package.json
+fi
+echo -e "${GREEN}✓ package.json exists${NC}"
+
+# Step 2: Create directory structure
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Step 2: Creating directory structure"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+mkdir -p .claude/commands scripts hooks src
+echo -e "${GREEN}✓ Created directories${NC}"
+
+# Step 3: Copy workflow files if source exists
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Step 3: Installing workflow files"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Copy from project root if available
+if [ -f "$PROJECT_ROOT/CLAUDE.md" ]; then
+    cp "$PROJECT_ROOT/CLAUDE.md" ./CLAUDE.md 2>/dev/null && echo -e "${GREEN}✓ Installed CLAUDE.md${NC}"
+fi
+
+if [ -d "$PROJECT_ROOT/system" ]; then
+    cp -r "$PROJECT_ROOT/system" ./ 2>/dev/null && echo -e "${GREEN}✓ Installed system/ folder${NC}"
+fi
+
+if [ -d "$PROJECT_ROOT/instructions" ]; then
+    cp -r "$PROJECT_ROOT/instructions" ./ 2>/dev/null && echo -e "${GREEN}✓ Installed instructions/ folder${NC}"
+fi
+
+if [ -d "$PROJECT_ROOT/.claude" ]; then
+    cp -r "$PROJECT_ROOT/.claude/"* ./.claude/ 2>/dev/null && echo -e "${GREEN}✓ Installed .claude/ commands${NC}"
+fi
+
+if [ -d "$PROJECT_ROOT/.vscode" ]; then
+    mkdir -p .vscode
+    cp -r "$PROJECT_ROOT/.vscode/"* ./.vscode/ 2>/dev/null && echo -e "${GREEN}✓ Installed .vscode/ settings${NC}"
+fi
+
+# Step 4: Install Git hooks
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Step 4: Installing Git hooks"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Initialize git if needed
+if [ ! -d ".git" ]; then
+    git init
+    echo -e "${GREEN}✓ Initialized git repository${NC}"
+fi
+
+# Copy hooks
+mkdir -p .git/hooks
+if [ -d "$PROJECT_ROOT/hooks" ]; then
+    cp "$PROJECT_ROOT/hooks/"* .git/hooks/ 2>/dev/null
+    chmod +x .git/hooks/* 2>/dev/null
+    echo -e "${GREEN}✓ Installed pre-commit hook${NC}"
+    echo -e "${GREEN}✓ Installed commit-msg hook${NC}"
+fi
+
+# Step 5: Add npm scripts
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Step 5: Adding npm scripts"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Add scripts using Node.js
+node -e "
+const fs = require('fs');
+const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+pkg.scripts = pkg.scripts || {};
+
+// Verification commands
+pkg.scripts['typecheck'] = pkg.scripts['typecheck'] || 'tsc --noEmit';
+pkg.scripts['lint'] = pkg.scripts['lint'] || 'eslint . --max-warnings 0';
+pkg.scripts['lint:fix'] = pkg.scripts['lint:fix'] || 'eslint . --fix';
+pkg.scripts['verify'] = 'npm run typecheck && npm run lint';
+pkg.scripts['verify:full'] = 'npm run verify && npm run test';
+
+// Formatting
+pkg.scripts['format'] = pkg.scripts['format'] || 'prettier --write .';
+pkg.scripts['format:check'] = pkg.scripts['format:check'] || 'prettier --check .';
+
+// Audit commands
+pkg.scripts['audit:ui'] = './scripts/check-ui-enforcement.sh';
+pkg.scripts['audit:cycles'] = 'npx madge --circular --extensions ts,tsx src/ 2>/dev/null || echo \"No circular dependencies found\"';
+pkg.scripts['audit:all'] = 'npm run audit:ui && npm run audit:cycles';
+
+// Workflow commands
+pkg.scripts['dyad:status'] = './scripts/autoworkflow.sh status';
+pkg.scripts['dyad:verify'] = './scripts/autoworkflow.sh verify';
+pkg.scripts['dyad:commit'] = './scripts/autoworkflow.sh commit';
+pkg.scripts['dyad:full'] = './scripts/autoworkflow.sh full';
+
+// Hook setup
+pkg.scripts['setup:hooks'] = 'cp hooks/* .git/hooks/ 2>/dev/null && chmod +x .git/hooks/* 2>/dev/null || true';
+pkg.scripts['postinstall'] = 'npm run setup:hooks 2>/dev/null || true';
+
+fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');
+" 2>/dev/null && echo -e "${GREEN}✓ Added npm scripts${NC}" || echo -e "${YELLOW}⚠️  Could not auto-update package.json${NC}"
+
+# Step 6: Copy scripts
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Step 6: Installing automation scripts"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [ -d "$PROJECT_ROOT/scripts" ]; then
+    cp "$PROJECT_ROOT/scripts/"*.sh ./scripts/ 2>/dev/null
+    chmod +x ./scripts/*.sh 2>/dev/null
+    echo -e "${GREEN}✓ Installed automation scripts${NC}"
+fi
+
+# Step 7: Final verification
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Step 7: Verifying installation"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+echo "Checking installed files:"
+[ -f "CLAUDE.md" ] && echo -e "  ${GREEN}✓${NC} CLAUDE.md" || echo -e "  ${YELLOW}○${NC} CLAUDE.md (optional)"
+[ -d "system" ] && echo -e "  ${GREEN}✓${NC} system/" || echo -e "  ${YELLOW}○${NC} system/ (optional)"
+[ -d "instructions" ] && echo -e "  ${GREEN}✓${NC} instructions/" || echo -e "  ${YELLOW}○${NC} instructions/ (optional)"
+[ -d ".claude/commands" ] && echo -e "  ${GREEN}✓${NC} .claude/commands/" || echo -e "  ${YELLOW}○${NC} .claude/commands/"
+[ -f ".git/hooks/pre-commit" ] && echo -e "  ${GREEN}✓${NC} pre-commit hook" || echo -e "  ${YELLOW}○${NC} pre-commit hook"
+[ -f ".git/hooks/commit-msg" ] && echo -e "  ${GREEN}✓${NC} commit-msg hook" || echo -e "  ${YELLOW}○${NC} commit-msg hook"
+[ -d "scripts" ] && echo -e "  ${GREEN}✓${NC} scripts/" || echo -e "  ${YELLOW}○${NC} scripts/"
+
+echo ""
+echo -e "${GREEN}╔══════════════════════════════════════════════════════════════╗${NC}"
+echo -e "${GREEN}║                                                              ║${NC}"
+echo -e "${GREEN}║     ✅ SETUP COMPLETE                                        ║${NC}"
+echo -e "${GREEN}║                                                              ║${NC}"
+echo -e "${GREEN}╚══════════════════════════════════════════════════════════════╝${NC}"
+echo ""
+echo "Next steps:"
+echo ""
+echo "  1. Install dependencies:"
+echo "     ${CYAN}npm install${NC}"
+echo ""
+echo "  2. Start developing with Claude Code:"
+echo "     ${CYAN}code .${NC}"
+echo ""
+echo "  3. Claude will automatically:"
+echo "     • Follow the workflow in CLAUDE.md"
+echo "     • Verify after every change"
+echo "     • Fix errors before committing"
+echo "     • Enforce UI completeness"
+echo ""
+echo "Available commands:"
+echo "  ${CYAN}npm run verify${NC}        - TypeScript + ESLint check"
+echo "  ${CYAN}npm run audit:all${NC}     - UI enforcement + circular deps"
+echo "  ${CYAN}npm run dyad:full${NC}     - Full workflow"
+echo ""

package/system/gates.md

@@ -0,0 +1,390 @@
+# System Gates
+
+> Blocking checkpoints that MUST pass before proceeding.
+> Gates enforce hard rules that cannot be bypassed.
+
+---
+
+## Gate Philosophy
+
+Gates are **BLOCKING**. If a gate fails:
+1. Claude MUST stop
+2. Claude MUST report the failure
+3. Claude MUST NOT proceed until resolved
+4. User CANNOT override blocking gates (only fix the issue)
+
+---
+
+## Gate Definitions
+
+### `analyze_gate`
+
+**Phase:** Before ANALYZE → PLAN transition
+**Purpose:** Ensure adequate analysis was performed
+
+```
+GATE: analyze_gate
+├── REQUIRES:
+│   ✓ Read relevant source files
+│   ✓ Understood existing code patterns
+│   ✓ Identified affected files
+│   ✓ Checked BLUEPRINT.md for requirements
+│   ✓ Checked AI_RULES.md for standards
+│
+├── ON_PASS:
+│   └── Proceed to: PLAN phase
+│
+└── ON_FAIL:
+    └── BLOCK: "Insufficient analysis"
+    └── Report: what's missing
+    └── Return to: ANALYZE phase
+```
+
+---
+
+### `plan_approval_gate`
+
+**Phase:** Before PLAN → IMPLEMENT transition
+**Purpose:** User must approve the plan before implementation
+
+```
+GATE: plan_approval_gate
+├── REQUIRES:
+│   ✓ Plan has been presented to user
+│   ✓ Suggestions (if applicable) have been shown
+│   ✓ User has explicitly approved
+│       - "yes", "proceed", "go ahead", "approved", etc.
+│       - OR selected which suggestions to include
+│
+├── ON_PASS:
+│   └── Record: approved suggestions
+│   └── Proceed to: IMPLEMENT phase
+│
+├── ON_FAIL (no approval):
+│   └── BLOCK: "Awaiting user approval"
+│   └── State: "Should I proceed with this plan?"
+│   └── Wait for: user response
+│
+└── ON_REJECT (user says no):
+    └── Ask: "What should I change?"
+    └── Return to: PLAN phase
+    └── Revise: based on feedback
+```
+
+**Approval Detection:**
+```
+APPROVED if user says:
+- "yes" / "y" / "yeah" / "yep"
+- "proceed" / "go ahead" / "do it"
+- "approved" / "lgtm" / "looks good"
+- "all" / "include all" (for suggestions)
+- "required" / "required only"
+- Specific numbers: "1, 3, 5" (for suggestions)
+
+NOT APPROVED if user says:
+- "no" / "n" / "nope"
+- "wait" / "hold on"
+- "change" / "modify"
+- Question asking for clarification
+```
+
+---
+
+### `verify_gate`
+
+**Phase:** After IMPLEMENT, before AUDIT/COMMIT
+**Purpose:** Code must pass TypeScript and ESLint checks
+
+```
+GATE: verify_gate
+├── REQUIRES:
+│   ✓ npm run typecheck → exit code 0
+│   ✓ npm run lint → exit code 0 (0 warnings)
+│   ✓ No TypeScript errors in any file
+│   ✓ No ESLint errors or warnings
+│
+├── COMMANDS:
+│   npm run verify
+│   (which runs: npm run typecheck && npm run lint)
+│
+├── ON_PASS:
+│   └── Report: "✅ Verification passed"
+│   └── Proceed to: AUDIT phase (if feature) or COMMIT gate
+│
+└── ON_FAIL:
+    └── BLOCK: "⛔ Verification failed"
+    └── Report: all errors with file:line
+    └── Enter: fix_loop (from system/loops.md)
+    └── After fix: re-check gate
+```
+
+**Output Format:**
+```
+## Verify Gate Check
+
+| Check | Status | Details |
+|-------|--------|---------|
+| TypeScript | ✅/⛔ | X errors found |
+| ESLint | ✅/⛔ | X warnings found |
+
+Gate Status: ✅ PASSED / ⛔ BLOCKED
+```
+
+---
+
+### `audit_gate`
+
+**Phase:** After VERIFY, before COMMIT (for features)
+**Purpose:** No orphan features, no circular dependencies
+
+```
+GATE: audit_gate
+├── REQUIRES:
+│   ✓ npm run audit:ui → no orphan features
+│   ✓ npm run audit:cycles → no circular dependencies
+│
+├── CHECKS:
+│   1. UI Enforcement:
+│      - Every API endpoint has a UI that calls it
+│      - Every hook is used by a component
+│      - Every utility is imported somewhere
+│      - User can access every feature
+│
+│   2. Circular Dependencies:
+│      - No A → B → A import cycles
+│      - No longer chains (A → B → C → A)
+│
+├── ON_PASS:
+│   └── Report: "✅ All audits passed"
+│   └── Proceed to: pre_commit_gate
+│
+├── ON_UI_FAIL:
+│   └── BLOCK: "⛔ Orphan feature detected"
+│   └── Report: features missing UI
+│   └── Enter: ui_fix_loop
+│   └── After fix: re-check gate
+│
+└── ON_CYCLE_FAIL:
+    └── BLOCK: "⛔ Circular dependency detected"
+    └── Report: cycle paths
+    └── Enter: cycle_fix_loop
+    └── After fix: re-check gate
+```
+
+---
+
+### `pre_commit_gate`
+
+**Phase:** Before COMMIT
+**Purpose:** Final check before committing - ALL rules enforced
+
+```
+GATE: pre_commit_gate
+├── REQUIRES:
+│   ✓ verify_gate passed (TypeScript + ESLint clean)
+│   ✓ audit_gate passed (no orphans, no cycles)
+│   ✓ No TODO comments in changed files
+│   ✓ No FIXME comments in changed files
+│   ✓ No console.log in changed files
+│   ✓ No console.debug in changed files
+│   ✓ No console.info in changed files
+│   ✓ Commit message follows conventional format
+│
+├── CHECKS:
+│   1. Re-verify: npm run verify
+│   2. Check diff: grep -E "TODO|FIXME"
+│   3. Check diff: grep "console\.(log|debug|info)"
+│   4. Validate: commit message format
+│
+├── COMMIT_MESSAGE_FORMAT:
+│   type(scope): description
+│
+│   Valid types: feat, fix, docs, style, refactor,
+│                perf, test, build, ci, chore, revert
+│
+│   Examples:
+│   - feat(auth): add login page
+│   - fix(api): handle null response
+│   - refactor(utils): extract date helpers
+│
+├── ON_PASS:
+│   └── Report: "✅ All pre-commit checks passed"
+│   └── Show: commit preview (files + message)
+│   └── Ask: "Should I commit?"
+│   └── Wait for: user confirmation
+│
+└── ON_FAIL:
+    └── BLOCK: "⛔ Cannot commit"
+    └── Report: ALL blocking issues
+    └── Route to: appropriate fix action
+    └── After fix: re-check gate
+```
+
+**Output Format:**
+```
+## Pre-Commit Gate Check
+
+| Check | Status | Details |
+|-------|--------|---------|
+| TypeScript | ✅ | No errors |
+| ESLint | ✅ | No warnings |
+| UI Enforcement | ✅ | All features have UI |
+| Circular Deps | ✅ | No cycles |
+| TODO/FIXME | ✅ | None in diff |
+| console.log | ✅ | None in diff |
+| Commit Message | ✅ | Valid format |
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ ALL GATES PASSED
+
+Ready to commit:
+- 3 files changed
+- Message: "feat(auth): add login page"
+
+Should I proceed with this commit?
+```
+
+---
+
+### `destructive_action_gate`
+
+**Phase:** Before any destructive action
+**Purpose:** User must confirm dangerous operations
+
+```
+GATE: destructive_action_gate
+├── TRIGGERS_ON:
+│   - Deleting files
+│   - Removing significant code (>50 lines)
+│   - Changing database schema
+│   - Modifying authentication logic
+│   - Changing API contracts
+│   - Force operations (git push --force, etc.)
+│
+├── REQUIRES:
+│   ✓ User explicitly confirms the action
+│   ✓ Impact has been clearly explained
+│
+├── FORMAT:
+│   ⚠️ **Warning:** This will [describe impact].
+│
+│   Files affected:
+│   - [file1]
+│   - [file2]
+│
+│   This action [is/is not] reversible.
+│
+│   **Should I proceed?**
+│
+└── ON_CONFIRM:
+    └── Proceed with: action
+    └── On reject: cancel action
+```
+
+---
+
+## Gate Hierarchy
+
+Gates are checked in order. Later gates assume earlier gates passed.
+
+```
+1. analyze_gate
+      │
+      ▼
+2. plan_approval_gate
+      │
+      ▼
+3. [IMPLEMENT]
+      │
+      ▼
+4. verify_gate
+      │
+      ▼
+5. audit_gate (if feature/component)
+      │
+      ▼
+6. pre_commit_gate
+      │
+      ▼
+7. [COMMIT]
+```
+
+---
+
+## Gate Override Policy
+
+**CANNOT be overridden by user:**
+- `verify_gate` - TypeScript/ESLint errors
+- `audit_gate` - Orphan features
+- `pre_commit_gate` - Blocking rule violations
+
+**CAN be acknowledged by user:**
+- `destructive_action_gate` - With explicit "yes, delete it"
+
+**User controls:**
+- `plan_approval_gate` - User decides when to proceed
+
+---
+
+## Reporting Gate Status
+
+Claude MUST show gate status at phase transitions:
+
+```
+## Gate: pre_commit_gate
+
+Checking requirements...
+
+[1/7] TypeScript errors: ✅ PASS (0 errors)
+[2/7] ESLint warnings: ✅ PASS (0 warnings)
+[3/7] UI Enforcement: ✅ PASS (no orphans)
+[4/7] Circular deps: ✅ PASS (no cycles)
+[5/7] TODO/FIXME: ✅ PASS (none found)
+[6/7] console.log: ✅ PASS (none found)
+[7/7] Commit format: ✅ PASS (valid)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ GATE PASSED - Ready to proceed
+```
+
+Or on failure:
+
+```
+## Gate: pre_commit_gate
+
+Checking requirements...
+
+[1/7] TypeScript errors: ✅ PASS
+[2/7] ESLint warnings: ✅ PASS
+[3/7] UI Enforcement: ⛔ FAIL
+      └── Missing UI for: /api/users endpoint
+[4/7] Circular deps: ✅ PASS
+[5/7] TODO/FIXME: ⛔ FAIL
+      └── Found: src/utils.ts:42 "TODO: implement"
+[6/7] console.log: ✅ PASS
+[7/7] Commit format: ✅ PASS
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⛔ GATE BLOCKED - Cannot proceed
+
+Issues to resolve:
+1. Add UI component for /api/users
+2. Remove TODO comment at src/utils.ts:42
+
+Fixing now...
+```
+
+---
+
+## Quick Reference
+
+| Gate | When | Blocking Rule |
+|------|------|---------------|
+| `analyze_gate` | Before planning | Must read relevant files |
+| `plan_approval_gate` | Before implementing | User must approve |
+| `verify_gate` | After implementing | Zero TS/ESLint errors |
+| `audit_gate` | Before committing features | No orphans, no cycles |
+| `pre_commit_gate` | Before any commit | All rules enforced |
+| `destructive_action_gate` | Before dangerous ops | User must confirm |
+
+**Gates are non-negotiable. Fix issues, don't bypass gates.**