autoworkflow 3.5.0 → 3.6.1

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

@@ -86,27 +86,42 @@ print_header() {
     echo ""
 }
 
-# Run verification
-run_verify() {
+# Detect project type
+detect_project_type() {
+    if [ -f "package.json" ]; then
+        echo "node"
+    elif [ -f "composer.json" ]; then
+        echo "php"
+    elif [ -f "pyproject.toml" ] || [ -f "requirements.txt" ] || [ -f "setup.py" ]; then
+        echo "python"
+    elif [ -f "Cargo.toml" ]; then
+        echo "rust"
+    elif [ -f "go.mod" ]; then
+        echo "go"
+    elif [ -f "Gemfile" ]; then
+        echo "ruby"
+    elif [ -f "build.gradle" ] || [ -f "pom.xml" ]; then
+        echo "java"
+    else
+        echo "unknown"
+    fi
+}
+
+# Run verification for Node.js projects
+run_verify_node() {
     local has_verify=false
     local has_typecheck=false
     local has_lint=false
 
-    # Check what scripts are available
-    if [ -f "package.json" ]; then
-        grep -q '"verify"' package.json 2>/dev/null && has_verify=true
-        grep -q '"typecheck"' package.json 2>/dev/null && has_typecheck=true
-        grep -q '"lint"' package.json 2>/dev/null && has_lint=true
-    fi
+    grep -q '"verify"' package.json 2>/dev/null && has_verify=true
+    grep -q '"typecheck"' package.json 2>/dev/null && has_typecheck=true
+    grep -q '"lint"' package.json 2>/dev/null && has_lint=true
 
     if [ "$has_verify" = true ]; then
         echo -e "${CYAN}Running:${NC} npm run verify"
         echo ""
-        if npm run verify 2>&1; then
-            return 0
-        else
-            return 1
-        fi
+        npm run verify 2>&1
+        return $?
     elif [ "$has_typecheck" = true ] || [ "$has_lint" = true ]; then
         local exit_code=0
 
@@ -126,11 +141,169 @@ run_verify() {
         fi
 
         return $exit_code
-    else
-        echo -e "${YELLOW}⚠${NC} No verify/typecheck/lint scripts found in package.json"
-        echo "  Skipping verification."
-        return 0
     fi
+    return 0
+}
+
+# Run verification for PHP projects
+run_verify_php() {
+    local exit_code=0
+
+    # Check for PHPStan
+    if [ -f "phpstan.neon" ] || [ -f "phpstan.neon.dist" ] || grep -q '"phpstan"' composer.json 2>/dev/null; then
+        echo -e "${CYAN}Running:${NC} ./vendor/bin/phpstan analyse"
+        if ! ./vendor/bin/phpstan analyse 2>&1; then
+            exit_code=1
+        fi
+    fi
+
+    # Check for PHP CS Fixer or PHP_CodeSniffer
+    if [ -f ".php-cs-fixer.php" ] || [ -f ".php-cs-fixer.dist.php" ]; then
+        echo ""
+        echo -e "${CYAN}Running:${NC} ./vendor/bin/php-cs-fixer fix --dry-run --diff"
+        if ! ./vendor/bin/php-cs-fixer fix --dry-run --diff 2>&1; then
+            exit_code=1
+        fi
+    elif [ -f "phpcs.xml" ] || [ -f "phpcs.xml.dist" ]; then
+        echo ""
+        echo -e "${CYAN}Running:${NC} ./vendor/bin/phpcs"
+        if ! ./vendor/bin/phpcs 2>&1; then
+            exit_code=1
+        fi
+    fi
+
+    # Check for composer scripts
+    if grep -q '"test"' composer.json 2>/dev/null; then
+        echo ""
+        echo -e "${CYAN}Running:${NC} composer test"
+        if ! composer test 2>&1; then
+            exit_code=1
+        fi
+    fi
+
+    if [ $exit_code -eq 0 ] && ! grep -q '"phpstan"' composer.json 2>/dev/null && ! [ -f ".php-cs-fixer.php" ] && ! [ -f "phpcs.xml" ]; then
+        echo -e "${YELLOW}⚠${NC} No PHP verification tools detected (PHPStan, PHP-CS-Fixer, PHPCS)"
+        echo "  Consider adding: composer require --dev phpstan/phpstan"
+    fi
+
+    return $exit_code
+}
+
+# Run verification for Python projects
+run_verify_python() {
+    local exit_code=0
+
+    # Check for mypy
+    if [ -f "mypy.ini" ] || [ -f "setup.cfg" ] || [ -f "pyproject.toml" ]; then
+        if command -v mypy &> /dev/null; then
+            echo -e "${CYAN}Running:${NC} mypy ."
+            if ! mypy . 2>&1; then
+                exit_code=1
+            fi
+        fi
+    fi
+
+    # Check for ruff or flake8
+    if command -v ruff &> /dev/null; then
+        echo ""
+        echo -e "${CYAN}Running:${NC} ruff check ."
+        if ! ruff check . 2>&1; then
+            exit_code=1
+        fi
+    elif command -v flake8 &> /dev/null; then
+        echo ""
+        echo -e "${CYAN}Running:${NC} flake8 ."
+        if ! flake8 . 2>&1; then
+            exit_code=1
+        fi
+    fi
+
+    if [ $exit_code -eq 0 ] && ! command -v mypy &> /dev/null && ! command -v ruff &> /dev/null; then
+        echo -e "${YELLOW}⚠${NC} No Python verification tools detected (mypy, ruff, flake8)"
+        echo "  Consider adding: pip install mypy ruff"
+    fi
+
+    return $exit_code
+}
+
+# Run verification for Rust projects
+run_verify_rust() {
+    local exit_code=0
+
+    echo -e "${CYAN}Running:${NC} cargo check"
+    if ! cargo check 2>&1; then
+        exit_code=1
+    fi
+
+    echo ""
+    echo -e "${CYAN}Running:${NC} cargo clippy"
+    if ! cargo clippy -- -D warnings 2>&1; then
+        exit_code=1
+    fi
+
+    return $exit_code
+}
+
+# Run verification for Go projects
+run_verify_go() {
+    local exit_code=0
+
+    echo -e "${CYAN}Running:${NC} go build ./..."
+    if ! go build ./... 2>&1; then
+        exit_code=1
+    fi
+
+    echo ""
+    echo -e "${CYAN}Running:${NC} go vet ./..."
+    if ! go vet ./... 2>&1; then
+        exit_code=1
+    fi
+
+    if command -v golangci-lint &> /dev/null; then
+        echo ""
+        echo -e "${CYAN}Running:${NC} golangci-lint run"
+        if ! golangci-lint run 2>&1; then
+            exit_code=1
+        fi
+    fi
+
+    return $exit_code
+}
+
+# Run verification based on project type
+run_verify() {
+    local project_type=$(detect_project_type)
+
+    echo -e "${DIM}Detected project type: ${project_type}${NC}"
+    echo ""
+
+    case "$project_type" in
+        node)
+            run_verify_node
+            return $?
+            ;;
+        php)
+            run_verify_php
+            return $?
+            ;;
+        python)
+            run_verify_python
+            return $?
+            ;;
+        rust)
+            run_verify_rust
+            return $?
+            ;;
+        go)
+            run_verify_go
+            return $?
+            ;;
+        *)
+            echo -e "${YELLOW}⚠${NC} Unknown project type - no verification available"
+            echo "  Supported: Node.js, PHP, Python, Rust, Go"
+            return 0
+            ;;
+    esac
 }
 
 # Main execution

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

@@ -22,6 +22,9 @@ STATE_DIR=".claude/.autoworkflow"
 PHASE_FILE="$STATE_DIR/phase"
 TASK_TYPE_FILE="$STATE_DIR/task-type"
 PLAN_APPROVED_FILE="$STATE_DIR/plan-approved"
+SUGGESTIONS_SHOWN_FILE="$STATE_DIR/suggestions-shown"
+CURRENT_TURN_EDITS_FILE="$STATE_DIR/current-turn-edits"
+SELECTED_ITEMS_FILE="$STATE_DIR/selected-items"
 
 # Get current phase
 get_phase() {
@@ -50,6 +53,41 @@ is_plan_approved() {
     return 1
 }
 
+# Check if suggestions were shown (for feature tasks)
+suggestions_shown() {
+    if [ -f "$SUGGESTIONS_SHOWN_FILE" ]; then
+        local status=$(cat "$SUGGESTIONS_SHOWN_FILE")
+        [ "$status" = "true" ] && return 0
+    fi
+    return 1
+}
+
+# Get number of edits in current turn
+get_turn_edit_count() {
+    if [ -f "$CURRENT_TURN_EDITS_FILE" ]; then
+        cat "$CURRENT_TURN_EDITS_FILE"
+    else
+        echo "0"
+    fi
+}
+
+# Increment turn edit count
+increment_turn_edits() {
+    local current=$(get_turn_edit_count)
+    local next=$((current + 1))
+    echo "$next" > "$CURRENT_TURN_EDITS_FILE"
+    echo "$next"
+}
+
+# Check if user has selected items to implement
+has_selected_items() {
+    if [ -f "$SELECTED_ITEMS_FILE" ]; then
+        local content=$(cat "$SELECTED_ITEMS_FILE")
+        [ -n "$content" ] && return 0
+    fi
+    return 1
+}
+
 # Check if task type requires approval
 requires_approval() {
     local task_type="$1"
@@ -122,6 +160,60 @@ main() {
         fi
     fi
 
+    # CHECK: Suggestions must be shown for feature tasks before implementing
+    if [ "$task_type" = "feature" ] && [ "$phase" = "IMPLEMENT" ]; then
+        if ! suggestions_shown; then
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "${RED}${BOLD}⛔ AUTOWORKFLOW: SUGGESTIONS REQUIRED${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            echo -e "${CYAN}Task Type:${NC} feature"
+            echo ""
+            echo "For feature tasks, you MUST show 3-tier suggestions first:"
+            echo ""
+            echo "  🔴 Required    - Must implement"
+            echo "  🟡 Recommended - Should implement"
+            echo "  🟢 Optional    - Nice to have"
+            echo ""
+            echo "Show suggestions, let user select items, THEN implement."
+            echo ""
+            echo -e "${DIM}To mark suggestions shown: echo 'true' > $SUGGESTIONS_SHOWN_FILE${NC}"
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            exit 1
+        fi
+    fi
+
+    # CHECK: One fix at a time (max 1 edit per turn in FIX phase)
+    if [ "$phase" = "FIX" ]; then
+        local edit_count=$(get_turn_edit_count)
+        if [ "$edit_count" -ge 1 ]; then
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo -e "${YELLOW}${BOLD}⚠ AUTOWORKFLOW: ONE FIX AT A TIME${NC}"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            echo -e "${CYAN}Edits this turn:${NC} $edit_count"
+            echo ""
+            echo "Fix ONE issue at a time, then verify."
+            echo ""
+            echo "This ensures:"
+            echo "  1. Easier to track what changed"
+            echo "  2. Errors caught early"
+            echo "  3. User can review incrementally"
+            echo ""
+            echo "Wait for verification to complete before next fix."
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            exit 1
+        fi
+        # Track this edit
+        increment_turn_edits > /dev/null
+    fi
+
     # All checks passed, allow edit
     exit 0
 }

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

@@ -31,6 +31,8 @@ TASK_DESCRIPTION_FILE="$STATE_DIR/task-description"
 PLAN_APPROVED_FILE="$STATE_DIR/plan-approved"
 CHANGED_FILES_FILE="$STATE_DIR/changed-files"
 SESSION_RESUMED_FILE="$STATE_DIR/session-resumed"
+CURRENT_TURN_EDITS_FILE="$STATE_DIR/current-turn-edits"
+SUGGESTIONS_SHOWN_FILE="$STATE_DIR/suggestions-shown"
 
 # Check for resumable session state
 check_session_resume() {
@@ -395,6 +397,12 @@ show_state() {
     fi
 }
 
+# Reset turn-based state (called each user turn)
+reset_turn_state() {
+    # Reset edit counter for this turn
+    echo "0" > "$CURRENT_TURN_EDITS_FILE"
+}
+
 # Main execution
 main() {
     local is_new_session=false
@@ -404,6 +412,9 @@ main() {
         is_new_session=true
     fi
 
+    # Reset turn state on each user message
+    reset_turn_state
+
     # Check if init is needed (package installed but not set up)
     if check_init_needed; then
         exit 0

package/.claude/settings.json

@@ -78,6 +78,22 @@
     "ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → UPDATE",
     "```",
     "",
+    "### CRITICAL: ONE FIX AT A TIME RULE",
+    "**This is NON-NEGOTIABLE and applies to ALL projects (TypeScript, PHP, Python, Go, Rust, etc.):**",
+    "",
+    "1. **NEVER batch multiple fixes** - Fix ONE issue, verify, then move to next",
+    "2. **MUST show 3-tier suggestions FIRST** before any fix:",
+    "   - 🔴 Required (must fix)",
+    "   - 🟡 Recommended (should fix)",
+    "   - 🟢 Optional (nice to have)",
+    "3. **MUST WAIT for user to select** which items to implement",
+    "4. **After user selects**, implement ONE item at a time",
+    "5. **Verify after EACH fix** before moving to the next",
+    "",
+    "❌ WRONG: 'I found 14 issues, let me fix them all'",
+    "✅ RIGHT: 'I found 14 issues. Here are my suggestions: [show tiers]. Which would you like me to fix first?'",
+    "",
+    "",
     "### Skill Loading (CRITICAL)",
     "When executing ANY command from .claude/commands/:",
     "1. Read the command's YAML frontmatter",

package/.claude/settings.local.json

@@ -13,7 +13,10 @@
       "Bash(git commit -m \"$\\(cat <<''EOF''\nfeat\\(hooks\\): implement full auto-trigger system with blocking gates\n\n- Add 7 new hook scripts for workflow automation:\n  - session-check.sh: Init, blueprint check, task classification\n  - post-edit.sh: Auto-verify with loop tracking \\(max 10 iterations\\)\n  - pre-tool-router.sh: Route Bash commands to appropriate checks\n  - pre-commit-check.sh: All 7 gate checks with blocking \\(exit 1\\)\n  - phase-transition.sh: State management and gate enforcement\n  - audit-runner.sh: UI enforcement + circular dependency checks\n  - blueprint-generator.sh: Auto-scan project structure\n\n- Pre-commit gate now checks:\n  - TypeScript errors\n  - ESLint warnings\n  - TODO/FIXME comments\n  - console.log statements\n  - Orphan features \\(UI enforcement\\)\n  - Circular dependencies\n  - Conventional commit format\n\n- State tracking in .claude/.autoworkflow/:\n  - phase, task-type, verify-iteration, audit-iteration\n  - verify-status, audit-status, plan-approved\n\n- Updated CLAUDE.md files with:\n  - Slash commands table\n  - Hook files reference\n  - Hook integration section\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
       "Bash(git commit:*)",
       "Bash(unzip:*)",
-      "Bash(node:*)"
+      "Bash(node:*)",
+      "Bash(echo:*)",
+      "Bash(ls:*)",
+      "Bash(npm view:*)"
     ]
   }
 }

package/README.md

@@ -2,7 +2,7 @@
 
 > Automated workflow enforcement for Claude Code via hooks and system prompts.
 
-**v3.5.0** - Full hook enforcement, 106 skills library, agent-structured commands.
+**v3.6.0** - Multi-language support, one-fix-at-a-time enforcement, suggestions gate.
 
 When you use Claude Code with AutoWorkflow, hooks automatically enforce workflow phases, block unauthorized edits, and guide Claude through a structured process for all coding tasks.
 
@@ -21,6 +21,34 @@ Options:
 
 ---
 
+## What's New in v3.6.0
+
+### Multi-Language Project Support
+Automatic verification for any project type:
+
+| Project Type | Detection | Verification |
+|--------------|-----------|--------------|
+| Node.js | `package.json` | TypeScript + ESLint |
+| PHP | `composer.json` | PHPStan, PHP-CS-Fixer |
+| Python | `pyproject.toml` | mypy, ruff, flake8 |
+| Rust | `Cargo.toml` | cargo check + clippy |
+| Go | `go.mod` | go vet + golangci-lint |
+
+### One-Fix-At-A-Time Enforcement
+Claude MUST fix issues incrementally:
+- ❌ "I found 14 issues, fixing them all now..."
+- ✅ "I found 14 issues. Here are my suggestions. Which first?"
+
+### 3-Tier Suggestions Gate
+For feature tasks, Claude MUST show categorized suggestions:
+- 🔴 **Required** - Must implement
+- 🟡 **Recommended** - Should implement
+- 🟢 **Optional** - Nice to have
+
+Hook blocks implementation until suggestions are shown and user selects items.
+
+---
+
 ## What's New in v3.5.0
 
 ### Hook-Based Enforcement (Not Just Instructions)
@@ -60,10 +88,11 @@ guardrails:
 ┌─────────────────────────────────────────────────────────────┐
 │                    HOOKS (Automatic)                         │
 │                                                              │
-│  UserPromptSubmit  →  session-check.sh (resume, blueprint)  │
-│  PreToolUse        →  pre-edit.sh (BLOCKS without approval) │
+│  UserPromptSubmit  →  session-check.sh (resume, turn reset) │
+│  PreToolUse        →  pre-edit.sh (3 gates: approval,       │
+│                       suggestions, one-fix-at-a-time)       │
 │  PreToolUse        →  pre-commit-check.sh (BLOCKS bad code) │
-│  PostToolUse       →  post-edit.sh (verification loop)      │
+│  PostToolUse       →  post-edit.sh (multi-lang verify)      │
 │  PostToolUse       →  post-commit.sh (BLUEPRINT reminder)   │
 │                                                              │
 │  Hooks ENFORCE workflow - they physically block actions     │
@@ -112,9 +141,9 @@ ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → U
 
 | Hook | Trigger | Action |
 |------|---------|--------|
-| `session-check.sh` | Every user message | Resume previous session, check BLUEPRINT.md |
-| `pre-edit.sh` | Before Write/Edit | **BLOCK if plan not approved** |
-| `post-edit.sh` | After Write/Edit | Run verification loop (max 10 iterations) |
+| `session-check.sh` | Every user message | Resume session, reset turn counter |
+| `pre-edit.sh` | Before Write/Edit | **BLOCK** if: no approval, no suggestions, or multiple fixes |
+| `post-edit.sh` | After Write/Edit | Detect project type, run verification |
 | `pre-commit-check.sh` | Before git commit | **BLOCK if TODO/console.log/errors** |
 | `post-commit.sh` | After git commit | Remind to update BLUEPRINT.md |
 
@@ -125,7 +154,9 @@ ANALYZE → PLAN → CONFIRM → IMPLEMENT → VERIFY → AUDIT → COMMIT → U
 | Gate | Blocks If | Enforced By |
 |------|-----------|-------------|
 | Plan Approval | User hasn't approved the plan | `pre-edit.sh` (exit 1) |
-| Verify | TypeScript or ESLint errors exist | `post-edit.sh` loop |
+| Suggestions | Feature task without 3-tier suggestions shown | `pre-edit.sh` (exit 1) |
+| One-Fix-At-A-Time | Multiple edits in FIX phase per turn | `pre-edit.sh` (exit 1) |
+| Verify | TypeScript/ESLint/language-specific errors | `post-edit.sh` loop |
 | Audit | Orphan features or circular dependencies | Required before commit |
 | Pre-Commit | TODO/FIXME, console.log, bad format | `pre-commit-check.sh` (exit 1) |
 

package/package.json

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

package/system/triggers.md

@@ -13,11 +13,14 @@
 |---------|-------------|-------|
 | `on:conversation_start` | `session-check.sh` | UserPromptSubmit |
 | `on:session_resume` | `session-check.sh` | UserPromptSubmit |
+| `on:turn_start` | `session-check.sh` | UserPromptSubmit |
 | `on:blueprint_missing` | `session-check.sh` + `blueprint-generator.sh` | UserPromptSubmit |
 | `on:init_needed` | `session-check.sh` | UserPromptSubmit |
 | `on:task_received` | `session-check.sh` | UserPromptSubmit |
 | `on:phase_transition` | `phase-transition.sh` | Manual call |
 | `on:pre_implementation_check` | `pre-edit.sh` | PreToolUse (Write\|Edit) |
+| `on:suggestions_required` | `pre-edit.sh` | PreToolUse (Write\|Edit) |
+| `on:one_fix_at_a_time` | `pre-edit.sh` | PreToolUse (Write\|Edit) |
 | `on:implementation_complete` | `post-edit.sh` | PostToolUse (Write\|Edit) |
 | `on:verification_failed` | `post-edit.sh` | PostToolUse (Write\|Edit) |
 | `on:verification_passed` | `post-edit.sh` | PostToolUse (Write\|Edit) |
@@ -44,7 +47,10 @@ All workflow state is stored in `.claude/.autoworkflow/`:
 ├── plan-approved        # Plan approval status (true/false)
 ├── changed-files        # List of modified files
 ├── blueprint-checked    # Blueprint check done flag
-└── session-resumed      # Session resume prompt shown flag
+├── session-resumed      # Session resume prompt shown flag
+├── suggestions-shown    # 3-tier suggestions displayed (true/false)
+├── current-turn-edits   # Number of edits in current user turn
+└── selected-items       # User-selected items to implement
 ```
 
 ---
@@ -172,6 +178,83 @@ Required workflow:
 
 ---
 
+### `on:suggestions_required`
+
+**When:** Claude attempts to implement a feature without showing suggestions
+**Hook:** `.claude/hooks/pre-edit.sh`
+**Event:** `PreToolUse` for `Write|Edit`
+
+**Purpose:** ENFORCE 3-tier suggestions for feature tasks
+
+**Gate Check:**
+1. Check if task type is `feature`
+2. Check if phase is `IMPLEMENT`
+3. Check if `suggestions-shown` is "true"
+4. If NOT → **BLOCK the edit** (exit code 1)
+
+**Output on BLOCK:**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⛔ AUTOWORKFLOW: SUGGESTIONS REQUIRED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Task Type: feature
+
+For feature tasks, you MUST show 3-tier suggestions first:
+
+  🔴 Required    - Must implement
+  🟡 Recommended - Should implement
+  🟢 Optional    - Nice to have
+
+Show suggestions, let user select items, THEN implement.
+```
+
+**Required Workflow:**
+1. Analyze codebase and identify issues/improvements
+2. Show categorized suggestions (Required/Recommended/Optional)
+3. Wait for user to select items
+4. Set `suggestions-shown` to "true"
+5. THEN implement ONE item at a time
+
+---
+
+### `on:one_fix_at_a_time`
+
+**When:** Claude attempts multiple edits in FIX phase during single turn
+**Hook:** `.claude/hooks/pre-edit.sh`
+**Event:** `PreToolUse` for `Write|Edit`
+
+**Purpose:** ENFORCE one fix per turn
+
+**Gate Check:**
+1. Check if phase is `FIX`
+2. Check `current-turn-edits` count
+3. If count >= 1 → **BLOCK additional edits** (exit code 1)
+4. If count < 1 → Increment counter, allow edit
+
+**Output on BLOCK:**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠ AUTOWORKFLOW: ONE FIX AT A TIME
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Edits this turn: 1
+
+Fix ONE issue at a time, then verify.
+
+This ensures:
+  1. Easier to track what changed
+  2. Errors caught early
+  3. User can review incrementally
+
+Wait for verification to complete before next fix.
+```
+
+**Reset Condition:**
+- Counter resets on each new UserPromptSubmit (session-check.sh)
+
+---
+
 ### `on:blueprint_missing`
 
 **When:** BLUEPRINT.md does not exist at session start
@@ -268,11 +351,24 @@ Required workflow:
 **Event:** `PostToolUse` for `Write|Edit`
 
 **Actions:**
-1. Enter VERIFY phase automatically
-2. Run `npm run verify` (or typecheck + lint)
-3. Track iteration count (max 10)
-4. If PASS → Reset counter, proceed to AUDIT or COMMIT
-5. If FAIL → Enter FIX phase, report errors
+1. Detect project type (multi-language support)
+2. Enter VERIFY phase automatically
+3. Run appropriate verification commands
+4. Track iteration count (max 10)
+5. If PASS → Reset counter, proceed to AUDIT or COMMIT
+6. If FAIL → Enter FIX phase, report errors
+
+**Multi-Language Support:**
+
+| Project Type | Detection | Verification Commands |
+|--------------|-----------|----------------------|
+| Node.js | `package.json` | `npm run verify` or `npm run typecheck && npm run lint` |
+| PHP | `composer.json` | PHPStan, PHP-CS-Fixer, PHPCS |
+| Python | `pyproject.toml`, `requirements.txt` | mypy, ruff, flake8 |
+| Rust | `Cargo.toml` | `cargo check`, `cargo clippy` |
+| Go | `go.mod` | `go build`, `go vet`, golangci-lint |
+| Ruby | `Gemfile` | Rubocop |
+| Java | `build.gradle`, `pom.xml` | Checkstyle, SpotBugs |
 
 **Output:**
 ```
@@ -280,7 +376,9 @@ Required workflow:
 AUTOWORKFLOW: VERIFY LOOP (Iteration 1/10)
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Running: npm run verify
+Detected project type: php
+
+Running: ./vendor/bin/phpstan analyse
 
 ✅ VERIFICATION PASSED
 ```