autoworkflow 3.0.0 → 3.0.1

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

@@ -1,60 +1,65 @@
 #!/bin/bash
 # AutoWorkflow Pre-Commit Check Hook
-# Runs on: PreToolUse for Bash tool when command contains "git commit"
-# Purpose: Block commits with TODO/FIXME/console.log
+# Runs on: PreToolUse for Bash tool
+# Purpose: Check for issues before commands execute
 
-# Get the command being run
-COMMAND="$1"
-
-# Check if this is a git commit command
-if echo "$COMMAND" | grep -q "git commit"; then
-    echo ""
-    echo "=================================================="
-    echo "AUTOWORKFLOW: PRE-COMMIT CHECK"
-    echo "=================================================="
-
-    ERRORS=0
-
-    # Check for TODO/FIXME in staged files
+# 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 "BLOCKED: TODO/FIXME comments found in staged files"
+        echo "=================================================="
+        echo "AUTOWORKFLOW: TODO/FIXME DETECTED"
+        echo "=================================================="
+        echo ""
+        echo "Found TODO/FIXME comments in staged files."
         echo "Remove all TODO/FIXME comments before committing."
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check for console.log in staged files (excluding test files)
-    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 "BLOCKED: console.log statements found in staged files"
-        echo "Remove debug logs before committing."
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check commit message format (if provided)
-    if echo "$COMMAND" | grep -q '\-m'; then
-        MSG=$(echo "$COMMAND" | sed -n 's/.*-m ["\x27]\([^"\x27]*\)["\x27].*/\1/p')
-        if [ -n "$MSG" ]; then
-            # Check conventional commit format
-            if ! echo "$MSG" | grep -qE "^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([a-z0-9-]+\))?: .+"; then
-                echo ""
-                echo "BLOCKED: Invalid commit message format"
-                echo "Use: type(scope): description"
-                echo "Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert"
-                ERRORS=$((ERRORS + 1))
-            fi
-        fi
+        echo "=================================================="
+        return 1
     fi
+    return 0
+}
 
-    if [ $ERRORS -gt 0 ]; then
+# 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 "Fix the above issues before committing."
+        echo "=================================================="
+        echo "AUTOWORKFLOW: CONSOLE.LOG DETECTED"
         echo "=================================================="
         echo ""
-    else
+        echo "Found console.log statements in staged files."
+        echo "Remove debug logs before committing."
         echo ""
-        echo "All pre-commit checks passed."
         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/settings.json

@@ -7,40 +7,52 @@
   "hooks": {
     "UserPromptSubmit": [
       {
-        "command": "./.claude/hooks/session-check.sh",
-        "timeout": 5000
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./.claude/hooks/session-check.sh",
+            "timeout": 5,
+            "statusMessage": "Checking project state..."
+          }
+        ]
       }
     ],
     "PostToolUse": [
       {
         "matcher": "Write|Edit",
-        "command": "./.claude/hooks/post-edit.sh"
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./.claude/hooks/post-edit.sh"
+          }
+        ]
       }
     ],
     "PreToolUse": [
       {
         "matcher": "Bash",
-        "command": "./.claude/hooks/pre-commit-check.sh \"$COMMAND\""
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./.claude/hooks/pre-commit-check.sh"
+          }
+        ]
       }
     ]
   },
 
   "instructions": [
     "WORKFLOW: Follow ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT for all tasks",
-
-    "SESSION START: If instructions/BLUEPRINT.md missing, immediately scan codebase (cat package.json, ls src/, find directories) and generate it. Do not ask to start - only ask to save.",
-
+    "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 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": {

package/CLAUDE.md

@@ -2,15 +2,18 @@
 
 > Automated workflow enforcement via hooks + system prompts.
 
-## How It Works
+## Architecture
 
 ```
-Hooks (automatic)     →  Trigger checks on events
-settings.json         →  Core instructions (system prompt)
-This file             →  Workflow details + gates
-instructions/         →  AI_RULES.md + BLUEPRINT.md (project-specific)
+.claude/hooks/           →  AUTO-TRIGGERS (run on events)
+.claude/settings.json    →  SYSTEM PROMPT (core instructions)
+CLAUDE.md (this file)    →  WORKFLOW SUMMARY
+instructions/            →  AI_RULES.md + BLUEPRINT.md
+system/                  →  DETAILED REFERENCE (gates, loops, triggers, router)
 ```
 
+**Priority:** Hooks → settings.json → This file → system/*.md
+
 ---
 
 ## Workflow
@@ -23,7 +26,7 @@ ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → U
 |-------|--------|
 | ANALYZE | Read relevant files, check BLUEPRINT.md |
 | PLAN | Design approach, show suggestions |
-| CONFIRM | Wait for user approval |
+| CONFIRM | **Wait for user approval** |
 | IMPLEMENT | Make changes (after approval only) |
 | VERIFY | Run `npm run verify` |
 | AUDIT | Run `npm run audit:ui` + `audit:cycles` |
@@ -34,50 +37,58 @@ ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → U
 
 ## Task Types
 
-| Type | Workflow | Audit? |
-|------|----------|--------|
-| feature | Full (9 phases) | Yes |
+| Type | Workflow | Audit Required? |
+|------|----------|-----------------|
+| feature | Full 9 phases | Yes |
 | fix | ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → COMMIT | No |
-| refactor | ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT | Yes |
+| refactor | ANALYZE → ... → VERIFY → AUDIT → COMMIT | Yes |
 | docs | ANALYZE → IMPLEMENT → COMMIT | No |
 | query | ANALYZE → RESPOND | No |
 
+See `system/router.md` for detailed task classification.
+
 ---
 
-## Gates (Blocking)
+## Blocking Gates
 
-### 1. Plan Approval Gate
-**Before:** IMPLEMENT
-**Requires:** User says "yes", "proceed", "approved", etc.
+| Gate | Blocks If | Reference |
+|------|-----------|-----------|
+| Plan Approval | User hasn't approved | `system/gates.md` |
+| Verify | TypeScript/ESLint errors | `system/gates.md` |
+| Audit | Orphan features or circular deps | `system/gates.md` |
+| Pre-Commit | TODO/FIXME, console.log, bad format | `system/gates.md` |
 
-### 2. Verify Gate
-**Before:** AUDIT/COMMIT
-**Requires:** `npm run verify` passes (0 errors)
+---
 
-### 3. Audit Gate
-**Before:** COMMIT (for features/refactors)
-**Requires:**
-- `npm run audit:ui` passes (no orphan features)
-- `npm run audit:cycles` passes (no circular deps)
+## Blocking Rules
 
-### 4. Pre-Commit Gate
-**Before:** git commit
-**Blocks if:**
-- TODO/FIXME comments in diff
-- console.log statements in diff
-- Invalid commit message format
+- **No orphan features** - Backend must have UI
+- **No TODO/FIXME** - Complete the work
+- **No console.log** - No debug logs
+- **No circular deps** - Clean imports
+- **Conventional commits** - `type(scope): description`
 
 ---
 
-## Blocking Rules
+## Auto-Triggers (Hooks)
 
-| Rule | Description |
-|------|-------------|
-| No orphan features | Backend must have UI |
-| No TODO/FIXME | Complete the work |
-| No console.log | No debug logs |
-| No circular deps | Clean imports |
-| Conventional commits | `type(scope): description` |
+| Event | Hook | Action |
+|-------|------|--------|
+| User message | `session-check.sh` | Check BLUEPRINT.md exists |
+| After Write/Edit | `post-edit.sh` | Remind to verify |
+| Before git commit | `pre-commit-check.sh` | Block bad commits |
+
+See `system/triggers.md` for all trigger definitions.
+
+---
+
+## Verification Loop
+
+```
+VERIFY → Failed? → FIX → VERIFY → Failed? → FIX → ... (max 10 iterations)
+```
+
+See `system/loops.md` for loop definitions.
 
 ---
 
@@ -92,13 +103,26 @@ npm run format        # Prettier
 
 ---
 
-## Instructions
+## Required Reading
+
+| File | Purpose |
+|------|---------|
+| `instructions/AI_RULES.md` | Your coding standards |
+| `instructions/BLUEPRINT.md` | Project specification |
+
+If BLUEPRINT.md is missing, the session-check hook will trigger an automatic audit.
+
+---
 
-Read `instructions/AI_RULES.md` for coding standards.
-Read `instructions/BLUEPRINT.md` for project specification.
+## Detailed Reference
 
-If BLUEPRINT.md is missing, the session-check hook will trigger.
-Run a project audit and generate it.
+| File | Contains |
+|------|----------|
+| `system/triggers.md` | Event → Action mappings |
+| `system/gates.md` | Blocking checkpoint definitions |
+| `system/loops.md` | Verify/fix cycle definitions |
+| `system/router.md` | Task type classification |
+| `instructions/CLAUDE.md` | Full 9-phase workflow details |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoworkflow",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Automated workflow enforcement for Claude Code via hooks and system prompts",
   "type": "module",
   "bin": {