autoworkflow 2.2.2 → 3.0.1

package/.claude/commands/audit.md

@@ -5,6 +5,7 @@ Run UI enforcement and circular dependency checks.
 ## Trigger
 - User invokes `/audit`
 - User invokes `/audit project` (full project scan)
+- **AUTOMATIC:** When BLUEPRINT.md is missing at session start
 - Or: Automatically after VERIFY phase (for features)
 - Or: Part of audit_loop
 
@@ -24,6 +25,12 @@ Per `system/router.md`, audit is required for:
 
 When `/audit project` is invoked OR when BLUEPRINT.md is missing:
 
+**IMPORTANT:** When triggered by missing BLUEPRINT.md, this runs AUTOMATICALLY.
+- Do NOT ask "Should I run the audit?"
+- Do NOT wait for permission to start
+- Just notify and run immediately
+- Only ask permission when presenting results to SAVE
+
 ### Step 1: Scan Codebase (Single Pass)
 ```bash
 # All discovery commands run ONCE

package/.claude/hooks/post-edit.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# AutoWorkflow Post-Edit Hook
+# Runs on: PostToolUse for Write/Edit tools
+# Purpose: Remind Claude to run verification after code changes
+
+# Get the tool that was used (passed as argument or environment)
+TOOL_NAME="${1:-unknown}"
+
+# Only trigger for code file changes
+case "$TOOL_NAME" in
+    Write|Edit)
+        echo ""
+        echo "--------------------------------------------------"
+        echo "AUTOWORKFLOW: File modified"
+        echo "--------------------------------------------------"
+        echo "After completing all changes, run: npm run verify"
+        echo "Fix any errors before proceeding to commit."
+        echo "--------------------------------------------------"
+        echo ""
+        ;;
+esac

package/.claude/hooks/pre-commit-check.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# AutoWorkflow Pre-Commit Check Hook
+# Runs on: PreToolUse for Bash tool
+# Purpose: Check for issues before commands execute
+
+# Check for TODO/FIXME in staged files
+check_staged_todos() {
+    if git diff --cached --name-only 2>/dev/null | xargs grep -l "TODO\|FIXME\|XXX\|HACK" 2>/dev/null; then
+        echo ""
+        echo "=================================================="
+        echo "AUTOWORKFLOW: TODO/FIXME DETECTED"
+        echo "=================================================="
+        echo ""
+        echo "Found TODO/FIXME comments in staged files."
+        echo "Remove all TODO/FIXME comments before committing."
+        echo ""
+        echo "=================================================="
+        return 1
+    fi
+    return 0
+}
+
+# Check for console.log in staged files
+check_staged_logs() {
+    if git diff --cached --name-only 2>/dev/null | grep -v "\.test\.\|\.spec\.\|__tests__" | xargs grep -l "console\.log\|console\.debug\|console\.info" 2>/dev/null; then
+        echo ""
+        echo "=================================================="
+        echo "AUTOWORKFLOW: CONSOLE.LOG DETECTED"
+        echo "=================================================="
+        echo ""
+        echo "Found console.log statements in staged files."
+        echo "Remove debug logs before committing."
+        echo ""
+        echo "=================================================="
+        return 1
+    fi
+    return 0
+}
+
+# Only run checks if there are staged changes
+if git diff --cached --quiet 2>/dev/null; then
+    # No staged changes, skip checks
+    exit 0
+fi
+
+# Run checks
+ERRORS=0
+
+check_staged_todos
+if [ $? -ne 0 ]; then
+    ERRORS=$((ERRORS + 1))
+fi
+
+check_staged_logs
+if [ $? -ne 0 ]; then
+    ERRORS=$((ERRORS + 1))
+fi
+
+if [ $ERRORS -gt 0 ]; then
+    echo ""
+    echo "Fix the above issues before committing."
+    echo ""
+fi
+
+exit 0

package/.claude/hooks/session-check.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# AutoWorkflow Session Check Hook
+# Runs on: UserPromptSubmit (every user message)
+# Purpose: Check for missing files and inject instructions to Claude
+
+# Colors for output
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Track if this is first message (check for state file)
+STATE_FILE=".claude/.autoworkflow-session"
+
+# Check if BLUEPRINT.md exists
+if [ ! -f "instructions/BLUEPRINT.md" ]; then
+    echo ""
+    echo "=================================================="
+    echo "AUTOWORKFLOW TRIGGER: BLUEPRINT_MISSING"
+    echo "=================================================="
+    echo ""
+    echo "instructions/BLUEPRINT.md does not exist."
+    echo ""
+    echo "ACTION REQUIRED: Run project audit IMMEDIATELY."
+    echo "Do NOT ask permission. Just run these commands now:"
+    echo ""
+    echo "1. cat package.json (detect tech stack)"
+    echo "2. ls -la (see project structure)"
+    echo "3. find . -type d -name 'src' -o -name 'app' -o -name 'pages' | head -5"
+    echo "4. ls src/ 2>/dev/null || ls app/ 2>/dev/null || echo 'No src/app dir'"
+    echo ""
+    echo "Then generate BLUEPRINT.md with discovered features."
+    echo "Only ask user approval to SAVE, not to start scanning."
+    echo ""
+    echo "=================================================="
+    echo ""
+fi
+
+# Check if AI_RULES.md exists
+if [ ! -f "instructions/AI_RULES.md" ]; then
+    echo ""
+    echo "WARNING: instructions/AI_RULES.md is missing."
+    echo "Generate it along with BLUEPRINT.md during audit."
+    echo ""
+fi
+
+# Check if autoworkflow is in node_modules but not initialized
+if [ -d "node_modules/autoworkflow" ] && [ ! -f "CLAUDE.md" ]; then
+    echo ""
+    echo "=================================================="
+    echo "AUTOWORKFLOW TRIGGER: INIT_NEEDED"
+    echo "=================================================="
+    echo ""
+    echo "AutoWorkflow package detected but not initialized."
+    echo "Suggest user run: npx autoworkflow init"
+    echo ""
+    echo "=================================================="
+    echo ""
+fi

package/.claude/settings.json

@@ -1,111 +1,107 @@
 {
   "$schema": "https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/settings.json",
-  "version": "1.0.0",
-  "name": "AutoWorkflow - Full Architecture",
-  "description": "System prompt layer that controls Claude's workflow with triggers, loops, and gates",
+  "version": "2.0.0",
+  "name": "AutoWorkflow",
+  "description": "Automated workflow enforcement for Claude Code via hooks and system prompts",
 
-  "instructions": [
-    "IF autoworkflow in node_modules but CLAUDE.md missing: suggest running /init",
-    "ALWAYS read CLAUDE.md (entry point) at the start of EVERY task",
-    "ALWAYS check if instructions/BLUEPRINT.md exists at session start",
-    "IF BLUEPRINT.md missing: run /audit project to generate it",
-    "ALWAYS check system/router.md to classify the task type",
-    "ALWAYS check system/gates.md before phase transitions",
-    "ALWAYS follow system/loops.md for verification and fix cycles",
-    "ALWAYS check system/triggers.md for event handling",
-    "ALWAYS update BLUEPRINT.md after adding new features/routes/APIs",
-    "NEVER skip the plan approval gate - wait for user confirmation",
-    "NEVER commit without passing all gates in system/gates.md",
-    "NEVER implement without reading instructions/AI_RULES.md",
-    "NEVER build backend without corresponding UI (UI enforcement)",
-    "Git hooks (hooks/pre-commit, hooks/commit-msg) provide backup enforcement",
-    "Scripts in scripts/ folder automate verification and audits"
-  ],
-
-  "requiredFiles": [
-    "CLAUDE.md",
-    "system/triggers.md",
-    "system/loops.md",
-    "system/gates.md",
-    "system/router.md",
-    "instructions/CLAUDE.md",
-    "instructions/AI_RULES.md",
-    "instructions/BLUEPRINT.md"
-  ],
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./.claude/hooks/session-check.sh",
+            "timeout": 5,
+            "statusMessage": "Checking project state..."
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./.claude/hooks/post-edit.sh"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./.claude/hooks/pre-commit-check.sh"
+          }
+        ]
+      }
+    ]
+  },
 
-  "automationFiles": [
-    "scripts/setup.sh",
-    "scripts/autoworkflow.sh",
-    "scripts/check-ui-enforcement.sh",
-    "hooks/pre-commit",
-    "hooks/commit-msg"
+  "instructions": [
+    "WORKFLOW: Follow ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT for all tasks",
+    "SESSION START: If instructions/BLUEPRINT.md missing, immediately scan codebase and generate it. Do not ask to start - only ask to save.",
+    "AFTER CODE CHANGES: Run 'npm run verify' automatically. If errors exist, fix them and re-verify until passing.",
+    "BEFORE COMMIT: Block if TODO/FIXME/console.log found in changes. Require conventional commit format: type(scope): description",
+    "UI ENFORCEMENT: Every backend endpoint/API must have a corresponding UI component. No orphan features allowed.",
+    "PLAN GATE: Always wait for user approval before implementing. Show plan with suggestions first.",
+    "BLUEPRINT UPDATE: After adding new features/routes/APIs, update instructions/BLUEPRINT.md",
+    "Read instructions/AI_RULES.md for project-specific coding standards",
+    "Read system/router.md to classify task type",
+    "Read system/gates.md for blocking rules"
   ],
 
   "workflow": {
-    "mode": "agentic",
     "phases": ["ANALYZE", "PLAN", "CONFIRM", "IMPLEMENT", "VERIFY", "FIX", "AUDIT", "COMMIT", "UPDATE"],
-    "requirePlanApproval": true,
-    "requireVerifyBeforeCommit": true,
-    "requireAuditForFeatures": true,
-    "requireBlueprintCheck": true,
     "maxFixIterations": 10,
     "maxAuditIterations": 5
   },
 
   "gates": {
-    "analyze": {
-      "requires": ["Read relevant source files", "Check BLUEPRINT.md"]
-    },
     "plan_approval": {
-      "requires": ["User explicit approval"],
-      "blocking": true
+      "blocking": true,
+      "requires": ["User explicit approval"]
     },
     "verify": {
-      "requires": ["npm run verify passes"],
-      "blocking": true
+      "blocking": true,
+      "command": "npm run verify"
     },
     "audit": {
-      "requires": ["npm run audit:ui passes", "npm run audit:cycles passes"],
       "blocking": true,
-      "appliesTo": ["feature", "refactor", "perf"]
+      "commands": ["npm run audit:ui", "npm run audit:cycles"],
+      "appliesTo": ["feature", "refactor"]
     },
     "pre_commit": {
-      "requires": [
-        "verify_gate passed",
-        "audit_gate passed (if applicable)",
-        "No TODO/FIXME in diff",
-        "No console.log in diff",
-        "Valid commit message format"
-      ],
-      "blocking": true
+      "blocking": true,
+      "checks": ["No TODO/FIXME", "No console.log", "Conventional commit format"]
     }
   },
 
-  "triggers": {
-    "on_conversation_start": ["Check if /init needed", "Read CLAUDE.md", "Check BLUEPRINT.md exists", "Route via system/router.md"],
-    "on_init_needed": ["Notify autoworkflow detected", "Suggest running /init"],
-    "on_blueprint_missing": ["Run project audit", "Generate AI_RULES.md + BLUEPRINT.md", "Present for approval"],
-    "on_task_start": ["Read CLAUDE.md", "Route via system/router.md"],
-    "on_implementation_complete": ["Enter VERIFY phase", "Run verify_loop"],
-    "on_verification_failed": ["Enter FIX phase", "Run fix_loop"],
-    "on_verification_passed": ["Check if audit required", "Proceed accordingly"],
-    "on_commit_requested": ["Run pre_commit_gate", "Wait for approval"],
-    "on_feature_complete": ["Check if BLUEPRINT.md needs update", "Present update for approval"]
-  },
-
-  "loops": {
-    "verify_loop": {
-      "command": "npm run verify",
-      "maxIterations": 10,
-      "onFail": "fix_loop"
+  "taskTypes": {
+    "feature": {
+      "workflow": ["ANALYZE", "PLAN", "CONFIRM", "IMPLEMENT", "VERIFY", "AUDIT", "COMMIT", "UPDATE"],
+      "requiresAudit": true,
+      "requiresSuggestions": true
     },
-    "fix_loop": {
-      "maxIterations": 10,
-      "onComplete": "verify_loop"
+    "fix": {
+      "workflow": ["ANALYZE", "PLAN", "CONFIRM", "IMPLEMENT", "VERIFY", "COMMIT"],
+      "requiresAudit": false
     },
-    "audit_loop": {
-      "commands": ["npm run audit:ui", "npm run audit:cycles"],
-      "maxIterations": 5
+    "refactor": {
+      "workflow": ["ANALYZE", "PLAN", "CONFIRM", "IMPLEMENT", "VERIFY", "AUDIT", "COMMIT"],
+      "requiresAudit": true
+    },
+    "docs": {
+      "workflow": ["ANALYZE", "IMPLEMENT", "COMMIT"],
+      "requiresAudit": false
+    },
+    "query": {
+      "workflow": ["ANALYZE", "RESPOND"],
+      "requiresAudit": false
     }
   },
 
@@ -119,13 +115,11 @@
   },
 
   "rules": {
-    "noPartialImplementations": true,
     "noTodoComments": true,
     "noConsoleLogs": true,
     "noOrphanFeatures": true,
     "noCircularDependencies": true,
     "conventionalCommits": true,
-    "oneFeatureAtATime": true,
     "readBeforeWrite": true
   }
 }

package/.claude/settings.local.json

@@ -5,7 +5,8 @@
       "Bash(npm publish:*)",
       "Bash(npm version:*)",
       "Bash(node bin/cli.js:*)",
-      "Bash(npm pkg:*)"
+      "Bash(npm pkg:*)",
+      "Bash(wc:*)"
     ]
   }
 }