claude-flow-novice 2.4.0 → 2.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "AI Agent Orchestration CLI",
   "main": "src/index.ts",
   "bin": {

package/src/cli/simple-commands/init/templates/CLAUDE.md

@@ -1,5 +1,7 @@
 # Claude Flow Novice — AI Agent Orchestration
 
+**🚀 Production Status:** Redis coordination system fully deployed (Phase 7 - 2025-10-17)
+
 ---
 
 ## 1) Critical Rules (Single Source of Truth)
@@ -11,12 +13,13 @@
 * Agents communicate via Redis pub/sub with explicit dependencies (see `.claude/redis-agent-dependencies.md`)
 
 **Core Principles:**
-* Use agents for all non-trivial work (≥4 steps or multi-file/research/testing/architecture/security)
+* Use agents for all non-trivial work (≥3 steps or multi-file/research/testing/architecture/security)
 * **PRIMARY COORDINATOR: Use coordinator-hybrid for all multi-agent coordination** (cost-optimized CLI spawning with typed agents)
 * Initialize swarm before multi-agent work
 * Batch operations: spawn ALL agents (coordinator + workers) in single message
 * Run post-edit hook after every file edit
 * **REQUIRED: All CLI agent spawning must use explicit --agents flag with typed agents**
+* **Context continuity:** Redis/SQLite persistence enables unlimited continuation — never stop due to context/token concerns
 
 **Prohibited Patterns:**
 * Main chat orchestrating agents directly — spawn coordinator to handle orchestration
@@ -25,11 +28,12 @@
 * Using generic "coordinator" fallback when coordinator-hybrid available
 * Spawning agents without explicit --agents flag (must specify types from AVAILABLE-AGENTS.md)
 * Agent coordination without Redis pub/sub messaging — ALL agents must use Redis
-* Running tests inside agents — execute once; agents read results
+* Running tests inside agents — coordinator runs tests ONCE; workers read cached results from test-results.json
 * Concurrent test runs — terminate previous runs first
 * **Saving to project root — check `.artifacts/logs/post-edit-pipeline.log` after writes; move files if ROOT_WARNING**
 * Creating guides/summaries/reports unless explicitly asked
-* Asking permission to retry/advance when criteria/iterations allow. Instead relaunch agents
+* Asking permission to retry/advance when criteria/iterations allow — **relaunch agents immediately when consensus <threshold and iterations <max**
+* Stopping work due to context/token concerns — Redis/SQLite persistence handles continuation automatically
 
 **Communication:**
 * Use spartan language
@@ -121,15 +125,28 @@ If file created in root, hook returns `status: "ROOT_WARNING"` with `rootWarning
 
 ### 3.3 Safe Test Execution
 
+**Pattern: Coordinator runs tests ONCE before spawning workers**
+
 ```bash
-# Run once, save results
+# 1. Coordinator terminates any existing test runs
+pkill -f vitest; pkill -f "npm test"
+
+# 2. Coordinator runs tests once and caches results
 npm test -- --run --reporter=json > test-results.json 2>&1
-# Agents read results only
+
+# 3. Workers read cached results only (no test execution)
 cat test-results.json
-# Cleanup
+
+# 4. Cleanup after all work complete
 pkill -f vitest; pkill -f "npm test"
 ```
 
+**Rules:**
+* Coordinator executes tests before worker spawn
+* Workers ONLY read test-results.json (never run tests)
+* Single test execution prevents concurrent run conflicts
+* Cache results in test-results.json for worker consumption
+
 ### 3.4 Batching (One message = all related ops)
 
 * Spawn all agents with Task tool in one message
@@ -197,6 +214,47 @@ mv test.txt src/test.txt  # Move to suggested location
 
 **→ Pattern: `.claude/coordinator-feedback-pattern.md`**
 
+### 6.3 Dashboard Integration (Phase 5)
+
+**Real-time Dashboard:**
+- URL: http://localhost:3001 (RealtimeServer)
+- WebSocket: ws://localhost:3001/ws
+- Components: RedisCoordinationMonitor.tsx
+
+**REST API Endpoints:**
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| /api/redis/feedback | GET | Recent feedback (limit=100) |
+| /api/redis/metrics | GET | Current metrics snapshot |
+| /api/swarm/status | GET | Current swarm coordination status |
+
+**CLI Monitoring Commands:**
+```bash
+# Monitor feedback
+./scripts/monitor-swarm-redis.sh feedback
+
+# Monitor CFN Loop
+./scripts/monitor-swarm-redis.sh coordination
+
+# Realtime dashboard launch
+npx claude-flow-novice dashboard --port 3001
+```
+
+**Post-Spawn Validation:**
+```bash
+# Validate CLI agent
+node config/hooks/post-spawn-validation.js coder-1
+
+# Validate Task agent
+node config/hooks/post-spawn-validation.js task_abc123 --coordinator-id coordinator-cfn
+```
+
+**WebSocket Event Types:**
+- `swarm:coordination`
+- `agent:feedback`
+- `system:metrics`
+- `dashboard:status`
+
 ---
 
 ## 7) Commands & Setup