feat(parallel): integrate auto-suggester hook with m4-generate

- Add parallel execution integration section to m4-generate.md
- Add parallelization check as step 5 in execution instructions
- Add user approval prompt template for parallel generation
- Add validation function to install.sh with --validate flag
- Validation checks: skill file, 9 commands, 11 lib files, 2 hooks
- Auto-validation runs after installation completes
- Document iteration 9 in parallel-agents manifold

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: dhanesh

.manifold/parallel-agents.yaml

@@ -414,6 +414,23 @@ iterations:
       file_count: 13
     result: "distributable"
 
+  - number: 9
+    phase: "hook-integration"
+    timestamp: "2026-01-16T12:00:00Z"
+    issue: "Parallel execution hooks not being invoked during /m4-generate"
+    changes:
+      - "Added 'Parallel Execution Integration' section to m4-generate.md"
+      - "Added parallelization check as step 5 in execution instructions"
+      - "Added user approval prompt template for parallel generation"
+      - "Added validation function to install.sh (--validate flag)"
+      - "Validation checks: skill file, 9 commands, 11 library files, 2 hooks"
+    validation_added:
+      - "validate_installation() function for per-agent validation"
+      - "run_validation() function for all-agents validation"
+      - "install.sh --validate flag for standalone validation"
+      - "Auto-validation after installation completes"
+    result: "integrated"
+
 generation:
   option: "D"
   timestamp: "2026-01-16T10:15:00Z"

install/commands/m4-generate.md

@@ -165,18 +165,110 @@ After generation, verify:
 - [ ] Install script includes new command files
 - [ ] Hooks are in `install/hooks/` if they need distribution
 
+## Parallel Execution Integration
+
+**IMPORTANT**: Before generating artifacts, check for parallelization opportunities.
+
+### Parallelization Check
+
+When the generation plan includes **3+ independent artifact groups**, invoke the parallel execution system:
+
+1. **Analyze Artifact Groups**
+   - Code files (can be generated in parallel across modules)
+   - Test files (depend on code, but tests for different modules can parallelize)
+   - Documentation (independent, can parallelize)
+   - Operational artifacts (runbooks, dashboards, alerts - independent)
+
+2. **Invoke Auto-Suggester**
+   ```typescript
+   // The auto-suggester at ~/.claude/hooks/auto-suggester.ts analyzes tasks
+   // Import and use when parallelization is beneficial:
+   import { AutoSuggester } from '~/.claude/lib/parallel/index';
+
+   const suggester = new AutoSuggester(process.cwd());
+   const tasks = [
+     "Generate PaymentRetryClient.ts with error classification",
+     "Generate PaymentRetryQueue.ts with durable queue logic",
+     "Generate IdempotencyService.ts with duplicate prevention",
+     "Generate all test files for retry module",
+     "Generate documentation for payment-retry feature"
+   ];
+
+   const suggestion = await suggester.suggest(tasks);
+   if (suggestion.shouldParallelize) {
+     // Display suggestion to user
+     console.log(suggester.formatSuggestion(suggestion));
+   }
+   ```
+
+3. **User Approval Prompt**
+   When parallelization is suggested, display:
+   ```
+   PARALLEL EXECUTION OPPORTUNITY DETECTED
+
+   The following artifact groups can be generated in parallel:
+
+   Group 1: Code Implementation
+   - PaymentRetryClient.ts
+   - PaymentRetryQueue.ts
+   - IdempotencyService.ts
+   - CircuitBreaker.ts
+
+   Group 2: Test Files
+   - PaymentRetryClient.test.ts
+   - IdempotencyService.test.ts
+   - integration.test.ts
+
+   Group 3: Documentation & Ops
+   - README.md, API.md, DECISIONS.md
+   - Runbooks, Dashboards, Alerts
+
+   Estimated speedup: 2.5x
+   Confidence: 85%
+
+   Would you like to generate artifacts in parallel using git worktrees?
+   [Y]es / [N]o / [D]etails
+   ```
+
+4. **If Approved**: Use `/parallel` command to execute generation in isolated worktrees
+5. **If Declined**: Proceed with sequential generation
+
+### Parallel Generation Flow
+
+```
+User runs: /m4-generate payment-retry --option=C
+
+1. Parse manifold and anchoring
+2. Build artifact generation plan
+3. Analyze for parallelization (≥3 independent groups?)
+   └── YES: Invoke auto-suggester
+       └── Suggestion positive?
+           └── YES: Prompt user for approval
+               └── Approved: Use /parallel for generation
+               └── Declined: Sequential generation
+           └── NO: Sequential generation
+   └── NO: Sequential generation
+4. Generate artifacts (parallel or sequential)
+5. Merge results and update manifold
+```
+
 ## Execution Instructions
 
 1. Read manifold from `.manifold/<feature>.yaml`
 2. Read anchoring from `.manifold/<feature>.anchor.yaml`
 3. Select solution option (from `--option` or prompt user)
 4. **CHECK PROJECT PATTERNS** - Examine existing structure before placing files
-5. For each artifact type:
+5. **PARALLELIZATION CHECK** - Analyze artifacts for parallel generation opportunity
+   - If ≥3 independent artifact groups detected
+   - Run auto-suggester analysis
+   - Prompt user: "Parallel generation detected (Xfiles, Yx speedup). Enable? [Y/N]"
+   - If approved, use `/parallel` command with artifact tasks
+6. For each artifact type:
    - Generate artifact with constraint traceability
    - Add comments linking to constraint IDs: `// Satisfies: B1, T2`
    - **Place in correct directory per Artifact Placement Rules**
-6. Create all files in appropriate directories
-7. **Update install script** if adding new distributable commands
-8. **Update manifold YAML** with generation tracking (artifacts, coverage)
-9. Set phase to GENERATED
-10. Display summary with constraint coverage
+7. Create all files in appropriate directories
+8. **Update install script** if adding new distributable commands
+9. **Update manifold YAML** with generation tracking (artifacts, coverage)
+10. Set phase to GENERATED
+11. Display summary with constraint coverage

install/install.sh

@@ -343,10 +343,118 @@ main() {
     echo ""
 }
 
+# Validate installation
+validate_installation() {
+    local base_dir="$1"
+    local agent_name="$2"
+    local errors=0
+
+    echo ""
+    print_step "Validating $agent_name installation..."
+
+    # Check skill file
+    if [[ ! -f "$base_dir/skills/manifold/SKILL.md" ]]; then
+        print_error "Missing: skills/manifold/SKILL.md"
+        ((errors++))
+    else
+        print_success "Found: skills/manifold/SKILL.md"
+    fi
+
+    # Check command files
+    for cmd_file in "${COMMAND_FILES[@]}"; do
+        if [[ ! -f "$base_dir/commands/$cmd_file" ]]; then
+            print_error "Missing: commands/$cmd_file"
+            ((errors++))
+        else
+            print_success "Found: commands/$cmd_file"
+        fi
+    done
+
+    # Check parallel library files
+    for lib_file in "${PARALLEL_LIB_FILES[@]}"; do
+        if [[ ! -f "$base_dir/lib/parallel/$lib_file" ]]; then
+            print_error "Missing: lib/parallel/$lib_file"
+            ((errors++))
+        else
+            print_success "Found: lib/parallel/$lib_file"
+        fi
+    done
+
+    # Check hooks
+    local hooks=("manifold-context.ts" "auto-suggester.ts")
+    for hook_file in "${hooks[@]}"; do
+        if [[ ! -f "$base_dir/hooks/$hook_file" ]]; then
+            print_error "Missing: hooks/$hook_file"
+            ((errors++))
+        else
+            print_success "Found: hooks/$hook_file"
+        fi
+    done
+
+    # Summary
+    echo ""
+    if [[ $errors -eq 0 ]]; then
+        print_success "$agent_name installation validated: All files present"
+        return 0
+    else
+        print_error "$agent_name installation has $errors missing file(s)"
+        return 1
+    fi
+}
+
+# Run validation for all detected agents
+run_validation() {
+    local validated=0
+    local failed=0
+
+    echo ""
+    echo -e "${CYAN}╔════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${CYAN}║${NC}  ${BOLD}Manifold Installation Validation${NC}                      ${CYAN}║${NC}"
+    echo -e "${CYAN}╚════════════════════════════════════════════════════════╝${NC}"
+    echo ""
+
+    # Validate Claude Code
+    if [[ -d "$HOME/.claude" ]]; then
+        if validate_installation "$HOME/.claude" "Claude Code"; then
+            ((validated++))
+        else
+            ((failed++))
+        fi
+    fi
+
+    # Validate AMP
+    if [[ -d "$HOME/.amp" ]]; then
+        if validate_installation "$HOME/.amp" "AMP"; then
+            ((validated++))
+        else
+            ((failed++))
+        fi
+    fi
+
+    echo ""
+    echo -e "${GREEN}════════════════════════════════════════════════════════${NC}"
+    if [[ $failed -eq 0 ]]; then
+        echo -e "${GREEN}  Validation complete: $validated agent(s) verified${NC}"
+    else
+        echo -e "${YELLOW}  Validation complete: $validated passed, $failed failed${NC}"
+    fi
+    echo -e "${GREEN}════════════════════════════════════════════════════════${NC}"
+    echo ""
+}
+
 # Handle local install mode
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 if [[ -f "$SCRIPT_DIR/manifold/SKILL.md" && -d "$SCRIPT_DIR/commands" ]]; then
     LOCAL_INSTALL=1
 fi
 
+# Check for validation flag
+if [[ "$1" == "--validate" || "$1" == "-v" ]]; then
+    run_validation
+    exit 0
+fi
+
 main "$@"
+
+# Run validation after installation
+run_validation