claude-flow-novice 2.14.15 → 2.14.16

package/.claude/commands/cfn-loop-cli.md

@@ -79,58 +79,129 @@ Savings: 64% with custom routing, 95-98% vs all-Task
 
 ## 🚨 CRITICAL EXECUTION INSTRUCTIONS
 
-**THIS IS A SLASH COMMAND - MAIN CHAT EXECUTES THIS DIRECTLY**
+**YOU ARE MAIN CHAT. YOU SPAWN ONLY THE cfn-v3-coordinator AGENT.**
 
-**DO NOT manually spawn Task() agents for CFN Loop workflows**
-**DO NOT spawn cfn-v3-coordinator manually**
 **DO NOT spawn Loop 3 agents (backend-dev, researcher, etc.)**
 **DO NOT spawn Loop 2 agents (reviewer, tester, etc.)**
 **DO NOT spawn product-owner**
 
-**Main Chat simply executes the slash command - everything else is automatic**
+The coordinator handles ALL agent spawning internally via enhanced CLI mode v3.0.
 
 ---
 
-## How This Command Works:
-
-When Main Chat executes `/cfn-loop-cli "task description"`, this slash command:
-
-1. **Automatically spawns cfn-v3-coordinator** with proper parameters
-2. **Coordinator invokes enhanced orchestrator** with monitoring v3.0
-3. **Orchestrator spawns all agents via CLI** (background execution)
-4. **Handles complete CFN Loop workflow** with real-time monitoring
-5. **Returns structured result** to Main Chat when complete
-
-## Enhanced Features v3.0:
-
-- ✅ **Real-time monitoring** with automatic stuck agent recovery
-- ✅ **Process health checking** and dead process cleanup
-- ✅ **Protocol compliance** preventing "consensus on vapor" anti-patterns
-- ✅ **Progress visibility** with detailed timestamped reports
-- ✅ **95-98% cost savings** with Z.ai routing optimization
-- ✅ **Background execution** with Redis persistence
-
-## Main Chat Execution Rules
-
-**THIS SLASH COMMAND HANDLES EVERYTHING AUTOMATICALLY**
-
-**Main Chat simply executes:**
-```bash
-/cfn-loop-cli "Task description" --mode=standard
+### Execute This Task() Call:
+
+```javascript
+Task("cfn-v3-coordinator", `
+  CFN LOOP CLI MODE - ENHANCED PRODUCTION EXECUTION v3.0
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  TASK SPECIFICATION
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Task Description: $ARGUMENTS
+  Task ID: cfn-cli-$(date +%s%N | tail -c 7)-${RANDOM}
+  Mode: ${mode.toUpperCase()}
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  SUCCESS CRITERIA
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Acceptance Criteria:
+  - [ ] Core functionality implemented
+  - [ ] All tests pass with >80% coverage
+  - [ ] Security review completed
+  - [ ] Documentation updated
+  - [ ] No regression in existing features
+
+  Quality Gates (${mode.toUpperCase()} MODE):
+  - Loop 3 Gate Threshold: ${mode === 'enterprise' ? 0.85 : mode === 'standard' ? 0.75 : 0.70}
+  - Loop 2 Consensus Threshold: ${mode === 'enterprise' ? 0.95 : mode === 'standard' ? 0.90 : 0.80}
+  - Max Iterations: ${maxIterations}
+
+  Definition of Done:
+  - Consensus ≥ threshold achieved
+  - All acceptance criteria met
+  - Product Owner approval received
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ENHANCED ORCHESTRATION CONFIGURATION v3.0
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Mode: ${mode.toUpperCase()}
+
+  Loop 3 Agents (Implementation) - SELECT BASED ON TASK:
+  Examples:
+  - Backend API: backend-dev, researcher, devops
+  - Full-Stack: backend-dev, react-frontend-engineer, devops
+  - Infrastructure: devops, rust-developer, researcher
+  - Security: security-specialist, backend-dev, researcher
+
+  Loop 2 Agents (Validation) - SCALE BY COMPLEXITY:
+  Simple (1-2 files): reviewer, tester
+  Standard (3-5 files): reviewer, tester, architect, security-specialist
+  Complex (>5 files): +code-analyzer, +performance-benchmarker
+
+  Product Owner: product-owner
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ENHANCED EXECUTION INSTRUCTIONS v3.0
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  1. INVOKE ENHANCED ORCHESTRATOR (CLI spawning v3.0):
+
+     TASK_ID="cfn-cli-$(date +%s%N | tail -c 7)-${RANDOM}"
+     MODE="${mode}"
+     LOOP3_AGENTS="backend-dev,researcher,devops"  # Customize for task
+     LOOP2_AGENTS="reviewer,tester,architect,security-specialist"  # Scale by complexity
+
+     ./.claude/skills/cfn-loop-orchestration/orchestrate.sh \\
+       --task-id "$TASK_ID" \\
+       --mode "$MODE" \\
+       --loop3-agents "$LOOP3_AGENTS" \\
+       --loop2-agents "$LOOP2_AGENTS" \\
+       --product-owner "product-owner" \\
+       --max-iterations ${maxIterations}
+
+  2. ENHANCED ORCHESTRATOR HANDLES v3.0:
+     - **Real-time monitoring** with automatic stuck agent recovery
+     - **Process health checking** and dead process cleanup
+     - **Protocol compliance** preventing "consensus on vapor" anti-patterns
+     - **Progress visibility** with detailed timestamped reports
+     - Spawns all agents via enhanced CLI (background)
+     - Loop 3: Gate check (≥threshold) → PASS/ITERATE
+     - Loop 2: Consensus check (≥threshold) → COMPLETE/ITERATE
+     - Product Owner: PROCEED/ITERATE/ABORT decision
+     - Git commit/push on PROCEED
+     - Returns structured result to Main Chat
+
+  3. RETURN STRUCTURED RESULT:
+     {
+       "taskId": "cfn-cli-XXXXX",
+       "status": "complete|failed",
+       "iterations": {"loop3": N, "loop2": M},
+       "finalConsensus": 0.XX,
+       "acceptanceCriteria": {
+         "met": [...],
+         "pending": [...]
+       },
+       "deliverables": [...],
+       "recommendations": [...]
+     }
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  CRITICAL RULES
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  - DO NOT spawn agents with Task() - orchestrator uses enhanced CLI
+  - ALL agents run in background via npx claude-flow-novice
+  - USE Redis BLPOP for loop dependencies
+  - AGENTS use Z.ai routing automatically (when enabled)
+  - ORCHESTRATOR provides real-time monitoring and recovery
+  - RETURN structured result when complete
+`, "cfn-v3-coordinator")
 ```
 
-**The slash command automatically:**
-- ✅ Spawns coordinator with proper parameters
-- ✅ Handles all agent spawning via CLI
-- ✅ Manages complete CFN Loop workflow
-- ✅ Returns structured result when complete
-
-**Main Chat should NOT:**
-- ❌ Manually spawn any Task() agents for CFN Loop
-- ❌ Ask about retry/iteration decisions (handled automatically)
-- ❌ Monitor agent progress (slash command handles this)
-- ❌ Coordinate between agents (built-in coordination)
-
 ## CLI Mode Benefits
 
 **Cost Savings:**

package/claude-assets/commands/cfn-loop-cli.md

@@ -79,58 +79,129 @@ Savings: 64% with custom routing, 95-98% vs all-Task
 
 ## 🚨 CRITICAL EXECUTION INSTRUCTIONS
 
-**THIS IS A SLASH COMMAND - MAIN CHAT EXECUTES THIS DIRECTLY**
+**YOU ARE MAIN CHAT. YOU SPAWN ONLY THE cfn-v3-coordinator AGENT.**
 
-**DO NOT manually spawn Task() agents for CFN Loop workflows**
-**DO NOT spawn cfn-v3-coordinator manually**
 **DO NOT spawn Loop 3 agents (backend-dev, researcher, etc.)**
 **DO NOT spawn Loop 2 agents (reviewer, tester, etc.)**
 **DO NOT spawn product-owner**
 
-**Main Chat simply executes the slash command - everything else is automatic**
+The coordinator handles ALL agent spawning internally via enhanced CLI mode v3.0.
 
 ---
 
-## How This Command Works:
-
-When Main Chat executes `/cfn-loop-cli "task description"`, this slash command:
-
-1. **Automatically spawns cfn-v3-coordinator** with proper parameters
-2. **Coordinator invokes enhanced orchestrator** with monitoring v3.0
-3. **Orchestrator spawns all agents via CLI** (background execution)
-4. **Handles complete CFN Loop workflow** with real-time monitoring
-5. **Returns structured result** to Main Chat when complete
-
-## Enhanced Features v3.0:
-
-- ✅ **Real-time monitoring** with automatic stuck agent recovery
-- ✅ **Process health checking** and dead process cleanup
-- ✅ **Protocol compliance** preventing "consensus on vapor" anti-patterns
-- ✅ **Progress visibility** with detailed timestamped reports
-- ✅ **95-98% cost savings** with Z.ai routing optimization
-- ✅ **Background execution** with Redis persistence
-
-## Main Chat Execution Rules
-
-**THIS SLASH COMMAND HANDLES EVERYTHING AUTOMATICALLY**
-
-**Main Chat simply executes:**
-```bash
-/cfn-loop-cli "Task description" --mode=standard
+### Execute This Task() Call:
+
+```javascript
+Task("cfn-v3-coordinator", `
+  CFN LOOP CLI MODE - ENHANCED PRODUCTION EXECUTION v3.0
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  TASK SPECIFICATION
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Task Description: $ARGUMENTS
+  Task ID: cfn-cli-$(date +%s%N | tail -c 7)-${RANDOM}
+  Mode: ${mode.toUpperCase()}
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  SUCCESS CRITERIA
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Acceptance Criteria:
+  - [ ] Core functionality implemented
+  - [ ] All tests pass with >80% coverage
+  - [ ] Security review completed
+  - [ ] Documentation updated
+  - [ ] No regression in existing features
+
+  Quality Gates (${mode.toUpperCase()} MODE):
+  - Loop 3 Gate Threshold: ${mode === 'enterprise' ? 0.85 : mode === 'standard' ? 0.75 : 0.70}
+  - Loop 2 Consensus Threshold: ${mode === 'enterprise' ? 0.95 : mode === 'standard' ? 0.90 : 0.80}
+  - Max Iterations: ${maxIterations}
+
+  Definition of Done:
+  - Consensus ≥ threshold achieved
+  - All acceptance criteria met
+  - Product Owner approval received
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ENHANCED ORCHESTRATION CONFIGURATION v3.0
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Mode: ${mode.toUpperCase()}
+
+  Loop 3 Agents (Implementation) - SELECT BASED ON TASK:
+  Examples:
+  - Backend API: backend-dev, researcher, devops
+  - Full-Stack: backend-dev, react-frontend-engineer, devops
+  - Infrastructure: devops, rust-developer, researcher
+  - Security: security-specialist, backend-dev, researcher
+
+  Loop 2 Agents (Validation) - SCALE BY COMPLEXITY:
+  Simple (1-2 files): reviewer, tester
+  Standard (3-5 files): reviewer, tester, architect, security-specialist
+  Complex (>5 files): +code-analyzer, +performance-benchmarker
+
+  Product Owner: product-owner
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ENHANCED EXECUTION INSTRUCTIONS v3.0
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  1. INVOKE ENHANCED ORCHESTRATOR (CLI spawning v3.0):
+
+     TASK_ID="cfn-cli-$(date +%s%N | tail -c 7)-${RANDOM}"
+     MODE="${mode}"
+     LOOP3_AGENTS="backend-dev,researcher,devops"  # Customize for task
+     LOOP2_AGENTS="reviewer,tester,architect,security-specialist"  # Scale by complexity
+
+     ./.claude/skills/cfn-loop-orchestration/orchestrate.sh \\
+       --task-id "$TASK_ID" \\
+       --mode "$MODE" \\
+       --loop3-agents "$LOOP3_AGENTS" \\
+       --loop2-agents "$LOOP2_AGENTS" \\
+       --product-owner "product-owner" \\
+       --max-iterations ${maxIterations}
+
+  2. ENHANCED ORCHESTRATOR HANDLES v3.0:
+     - **Real-time monitoring** with automatic stuck agent recovery
+     - **Process health checking** and dead process cleanup
+     - **Protocol compliance** preventing "consensus on vapor" anti-patterns
+     - **Progress visibility** with detailed timestamped reports
+     - Spawns all agents via enhanced CLI (background)
+     - Loop 3: Gate check (≥threshold) → PASS/ITERATE
+     - Loop 2: Consensus check (≥threshold) → COMPLETE/ITERATE
+     - Product Owner: PROCEED/ITERATE/ABORT decision
+     - Git commit/push on PROCEED
+     - Returns structured result to Main Chat
+
+  3. RETURN STRUCTURED RESULT:
+     {
+       "taskId": "cfn-cli-XXXXX",
+       "status": "complete|failed",
+       "iterations": {"loop3": N, "loop2": M},
+       "finalConsensus": 0.XX,
+       "acceptanceCriteria": {
+         "met": [...],
+         "pending": [...]
+       },
+       "deliverables": [...],
+       "recommendations": [...]
+     }
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  CRITICAL RULES
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  - DO NOT spawn agents with Task() - orchestrator uses enhanced CLI
+  - ALL agents run in background via npx claude-flow-novice
+  - USE Redis BLPOP for loop dependencies
+  - AGENTS use Z.ai routing automatically (when enabled)
+  - ORCHESTRATOR provides real-time monitoring and recovery
+  - RETURN structured result when complete
+`, "cfn-v3-coordinator")
 ```
 
-**The slash command automatically:**
-- ✅ Spawns coordinator with proper parameters
-- ✅ Handles all agent spawning via CLI
-- ✅ Manages complete CFN Loop workflow
-- ✅ Returns structured result when complete
-
-**Main Chat should NOT:**
-- ❌ Manually spawn any Task() agents for CFN Loop
-- ❌ Ask about retry/iteration decisions (handled automatically)
-- ❌ Monitor agent progress (slash command handles this)
-- ❌ Coordinate between agents (built-in coordination)
-
 ## CLI Mode Benefits
 
 **Cost Savings:**