claude-flow-novice 2.6.0 → 2.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (364) hide show
  1. package/.claude/adaptive-context/cfn-v3-reflection.json +21 -0
  2. package/.claude/agents/AGENT_LIFECYCLE.md +495 -0
  3. package/.claude/agents/CLAUDE.md +1002 -995
  4. package/.claude/agents/accessibility-advocate.md +457 -0
  5. package/.claude/agents/agent-principles/README.md +226 -226
  6. package/.claude/agents/agent-principles/agent-type-guidelines.md +10 -0
  7. package/.claude/agents/agent-principles/format-selection.md +10 -0
  8. package/.claude/agents/agent-principles/phase4-template-optimization.md +502 -494
  9. package/.claude/agents/agent-principles/prompt-engineering.md +8 -0
  10. package/.claude/agents/agent-principles/quality-metrics.md +8 -0
  11. package/.claude/agents/analysis/code-analyzer.md +7 -17
  12. package/.claude/agents/analysis/code-review/analyze-code-quality.md +2 -104
  13. package/.claude/agents/analysis/perf-analyzer.md +2 -196
  14. package/.claude/agents/context/context-curator.md +78 -84
  15. package/.claude/agents/context/context-reflector.md +27 -81
  16. package/.claude/agents/coordinators/README.md +42 -0
  17. package/.claude/agents/coordinators/cfn-v3-coordinator.md +440 -0
  18. package/.claude/agents/{product-owner-team → coordinators}/cto-agent.md +154 -187
  19. package/.claude/agents/coordinators/multi-sprint-coordinator.md +50 -0
  20. package/.claude/agents/{product-owner-team → coordinators}/product-owner-agent.md +6 -39
  21. package/.claude/agents/{cfn-loop → coordinators}/product-owner.md +72 -17
  22. package/.claude/agents/core-agents/reviewer.md +114 -135
  23. package/.claude/agents/custom/agent-builder.md +637 -637
  24. package/.claude/agents/developers/README.md +69 -0
  25. package/.claude/agents/developers/backend-dev.md +77 -0
  26. package/.claude/agents/{core-agents → developers}/coder.md +131 -26
  27. package/.claude/agents/developers/react-frontend-engineer.md +121 -0
  28. package/.claude/agents/{frontend → developers}/state-architect.md +1 -0
  29. package/.claude/agents/{frontend → developers}/ui-designer.md +1 -0
  30. package/.claude/agents/development/backend/dev-backend-api.md +0 -29
  31. package/.claude/agents/development/npm-package-specialist.md +355 -347
  32. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +8 -0
  33. package/.claude/agents/documentation/api-docs.md +8 -0
  34. package/.claude/agents/github/github-commit-agent.md +125 -117
  35. package/.claude/agents/goal/goal-planner.md +8 -0
  36. package/.claude/agents/infrastructure/README.md +100 -0
  37. package/.claude/agents/{specialized → infrastructure}/devops-engineer.md +131 -150
  38. package/.claude/agents/planners/README.md +94 -0
  39. package/.claude/agents/{core-agents → planners}/analyst.md +1 -22
  40. package/.claude/agents/{planning-team → planners}/api-designer-persona.md +8 -0
  41. package/.claude/agents/{core-agents → planners}/architect.md +7 -20
  42. package/.claude/agents/{core-agents → planners}/planner.md +0 -21
  43. package/.claude/agents/{planning-team → planners}/security-architect-persona.md +8 -28
  44. package/.claude/agents/{planning-team → planners}/system-architect-persona.md +6 -38
  45. package/.claude/agents/{architecture → planners}/system-architect.md +12 -17
  46. package/.claude/agents/product-owner-team/accessibility-advocate-persona.md +132 -161
  47. package/.claude/agents/product-owner-team/power-user-persona.md +149 -182
  48. package/.claude/agents/retrospective-analyst.md +84 -0
  49. package/.claude/agents/reviewers/README.md +58 -0
  50. package/.claude/agents/{analysis → reviewers}/code-quality-validator.md +8 -17
  51. package/.claude/agents/reviewers/reviewer.md +181 -0
  52. package/.claude/agents/sparc/architecture.md +6 -25
  53. package/.claude/agents/sparc/pseudocode.md +6 -0
  54. package/.claude/agents/sparc/refinement.md +6 -0
  55. package/.claude/agents/sparc/specification.md +1 -0
  56. package/.claude/agents/specialists/README.md +60 -0
  57. package/.claude/agents/{core-agents → specialists}/base-template-generator.md +8 -21
  58. package/.claude/agents/{specialized → specialists}/cli-agent-optimizer.md +1 -1
  59. package/.claude/agents/{specialized → specialists}/code-booster.md +1 -0
  60. package/.claude/agents/{consensus → specialists}/consensus-builder.md +1 -17
  61. package/.claude/agents/{specialized/mobile → specialists}/mobile-dev.md +0 -20
  62. package/.claude/agents/{core-agents → specialists}/performance-benchmarker.md +134 -148
  63. package/.claude/agents/{specialized → specialists}/rust-developer.md +1 -20
  64. package/.claude/agents/{specialized → specialists}/rust-enterprise-developer.md +1 -20
  65. package/.claude/agents/{specialized → specialists}/rust-mvp-developer.md +1 -20
  66. package/.claude/agents/{core-agents → specialists}/security-manager.md +68 -88
  67. package/.claude/agents/{security → specialists}/security-specialist-existing.md +6 -57
  68. package/.claude/agents/{security → specialists}/security-specialist.md +6 -30
  69. package/.claude/agents/{specialized/mobile → specialists}/spec-mobile-react-native.md +2 -21
  70. package/.claude/agents/testers/README.md +94 -0
  71. package/.claude/agents/{testing → testers}/e2e/playwright-agent.md +1 -20
  72. package/.claude/agents/{testing → testers}/interaction-tester.md +1 -20
  73. package/.claude/agents/{testing → testers}/playwright-tester.md +1 -1
  74. package/.claude/agents/testers/tester.md +139 -0
  75. package/.claude/agents/testers/unit/tdd-london-swarm.md +49 -0
  76. package/.claude/agents/testers/validation/production-validator.md +33 -0
  77. package/.claude/agents-ignore/cfn-loop-coordinator.md +157 -0
  78. package/.claude/agents-ignore/cfn-loop-coordinator.md.backup +156 -0
  79. package/.claude/agents-ignore/coordinator.md.backup +182 -0
  80. package/.claude/agents-ignore/cost-savings-cfn-loop-coordinator.md +760 -0
  81. package/.claude/agents-ignore/cost-savings-coordinator.md +173 -0
  82. package/.claude/artifacts/ace-reflections/REFLECT-001-summary.json +39 -0
  83. package/.claude/artifacts/ace-reflections/sprint-7_$(date -u +/"%Y%m%d_%H%M%S/").json" +47 -0
  84. package/.claude/commands/CFN_COORDINATOR_PARAMETERS.md +10 -10
  85. package/.claude/commands/cfn-loop-epic.md +3 -3
  86. package/.claude/commands/cfn-loop-single.md +3 -3
  87. package/.claude/commands/cfn-loop-sprints.md +1 -1
  88. package/.claude/commands/cfn-loop.md +3 -3
  89. package/.claude/commands/cfn-mode.md +20 -0
  90. package/.claude/commands/write-plan.md +104 -0
  91. package/.claude/data/cfn-loop.db +0 -0
  92. package/.claude/data/cfn_loop_logs.db +0 -0
  93. package/.claude/hooks/BACKUP_USAGE.md +243 -0
  94. package/.claude/hooks/post-edit-cfn-retrospective.sh +79 -0
  95. package/.claude/hooks/post-edit.sh +21 -0
  96. package/.claude/hooks/pre-edit-backup.sh +71 -0
  97. package/.claude/hooks/restore-from-backup.sh +37 -0
  98. package/.claude/prompts/cfn-loop-context.md +115 -0
  99. package/.claude/prompts/loop-specific/loop2.md +50 -0
  100. package/.claude/prompts/loop-specific/loop3.md +43 -0
  101. package/.claude/prompts/loop-specific/loop4.md +54 -0
  102. package/.claude/root-claude-distribute/CLAUDE.md +76 -2
  103. package/.claude/skills/ace-system/sprint-7-lessons.json +46 -0
  104. package/.claude/skills/ace-system/store-reflection.sh +33 -136
  105. package/.claude/skills/agent-discovery/SKILL.md +40 -0
  106. package/.claude/skills/agent-discovery/agents-registry-clean.json +0 -0
  107. package/.claude/skills/agent-discovery/agents-registry-fixed.json +19 -0
  108. package/.claude/skills/agent-discovery/agents-registry.json +718 -0
  109. package/.claude/skills/agent-discovery/discover-agents.py +175 -0
  110. package/.claude/skills/agent-discovery/discover-agents.sh +87 -0
  111. package/.claude/skills/agent-discovery/invoke-registry.sh +11 -0
  112. package/.claude/skills/agent-discovery/temp_script.py +0 -0
  113. package/.claude/skills/agent-output-processing/SKILL.md +359 -0
  114. package/.claude/skills/agent-selector/SKILL.md +90 -0
  115. package/.claude/skills/agent-selector/select-agents.sh +96 -0
  116. package/.claude/skills/agent-spawning/agent-selection-guide.md +1 -1
  117. package/.claude/skills/agent-swap/SKILL.md +36 -0
  118. package/.claude/skills/agent-swap/recommend-swap.sh +60 -0
  119. package/.claude/skills/api-validation/test-endpoints.sh +54 -0
  120. package/.claude/skills/automatic-memory-persistence/SKILL.md +73 -0
  121. package/.claude/skills/automatic-memory-persistence/persist-agent-output.sh +49 -0
  122. package/.claude/skills/automatic-memory-persistence/query-agent-history.sh +35 -0
  123. package/.claude/skills/automatic-memory-persistence/test-memory-persistence.sh +235 -0
  124. package/.claude/skills/cfn-loop-orchestration/README.md +41 -0
  125. package/.claude/skills/cfn-loop-orchestration/SKILL.md +299 -0
  126. package/.claude/skills/cfn-loop-orchestration/helpers/auto-tune-timeouts.sh +228 -0
  127. package/.claude/skills/cfn-loop-orchestration/helpers/consensus.sh +84 -0
  128. package/.claude/skills/cfn-loop-orchestration/helpers/deliverable-verifier.sh +71 -0
  129. package/.claude/skills/cfn-loop-orchestration/helpers/gate-check.sh +90 -0
  130. package/.claude/skills/cfn-loop-orchestration/helpers/iteration-manager.sh +87 -0
  131. package/.claude/skills/cfn-loop-orchestration/helpers/timeout-calculator.sh +51 -0
  132. package/.claude/skills/cfn-loop-orchestration/inject-loop-context.sh +41 -0
  133. package/.claude/skills/cfn-loop-orchestration/monitor-execution.sh +156 -0
  134. package/.claude/skills/cfn-loop-orchestration/orchestrate.sh +840 -0
  135. package/.claude/skills/cfn-loop-orchestration/security_utils.sh +99 -0
  136. package/.claude/skills/cfn-loop-orchestration/test-cfn-orchestration.sh +281 -0
  137. package/.claude/skills/cfn-loop-orchestration/test-edge-cases.sh +188 -0
  138. package/.claude/skills/cfn-loop-validation/SKILL.md +307 -217
  139. package/.claude/skills/complexity-estimator/SKILL.md +96 -0
  140. package/.claude/skills/complexity-estimator/estimate-complexity.sh +144 -0
  141. package/.claude/skills/context-pruner/SKILL.md +75 -0
  142. package/.claude/skills/context-pruner/prune-context.sh +73 -0
  143. package/.claude/skills/defense-in-depth/SKILL.md +133 -0
  144. package/.claude/skills/dependency-extractor/SKILL.md +35 -0
  145. package/.claude/skills/dependency-extractor/extract-dependencies.sh +66 -0
  146. package/.claude/skills/epic-decomposer/SKILL.md +44 -0
  147. package/.claude/skills/epic-decomposer/decompose-epic.sh +104 -0
  148. package/.claude/skills/improvement-recommender/SKILL.md +33 -0
  149. package/.claude/skills/improvement-recommender/recommend-improvements.sh +92 -0
  150. package/.claude/skills/intervention-detector/SKILL.md +39 -0
  151. package/.claude/skills/intervention-detector/detect-intervention.sh +111 -0
  152. package/.claude/skills/intervention-orchestrator/SKILL.md +43 -0
  153. package/.claude/skills/intervention-orchestrator/execute-intervention.sh +59 -0
  154. package/.claude/skills/loop2-output-processing/SKILL.md +163 -0
  155. package/.claude/skills/loop2-output-processing/execute-and-extract.sh +77 -0
  156. package/.claude/skills/loop2-output-processing/execute-and-extract.sh.backup +36 -0
  157. package/.claude/skills/loop2-output-processing/parse-feedback.sh +147 -0
  158. package/.claude/skills/loop2-output-processing/process-validator-output.sh +275 -0
  159. package/.claude/skills/loop2-output-processing/test-bug27-fix.sh +200 -0
  160. package/.claude/skills/loop2-output-processing/test-loop2-processing.sh +113 -0
  161. package/.claude/skills/loop3-output-processing/AGENT_COMPLETION_PROTOCOL.md +206 -0
  162. package/.claude/skills/loop3-output-processing/SKILL.md +421 -0
  163. package/.claude/skills/loop3-output-processing/calculate-confidence.sh +28 -0
  164. package/.claude/skills/loop3-output-processing/execute-and-extract.sh +85 -0
  165. package/.claude/skills/loop3-output-processing/parse-confidence.sh +31 -0
  166. package/.claude/skills/loop3-output-processing/test-agent-timeout.sh +327 -0
  167. package/.claude/skills/loop3-output-processing/test-loop3-processing.sh +155 -0
  168. package/.claude/skills/loop3-output-processing/verify-deliverables.sh +42 -0
  169. package/.claude/skills/pattern-extraction/SKILL.md +30 -0
  170. package/.claude/skills/pattern-extraction/extract-patterns.sh +80 -0
  171. package/.claude/skills/playbook/SKILL.md +113 -0
  172. package/.claude/skills/playbook/init-playbook.sh +54 -0
  173. package/.claude/skills/playbook/playbook.db +0 -0
  174. package/.claude/skills/playbook/query-playbook.sh +79 -0
  175. package/.claude/skills/playbook/update-playbook.sh +69 -0
  176. package/.claude/skills/playbook-auto-update/SKILL.md +29 -0
  177. package/.claude/skills/playbook-auto-update/auto-update-playbook.sh +86 -0
  178. package/.claude/skills/product-owner-decision/SKILL.md +332 -0
  179. package/.claude/skills/product-owner-decision/execute-decision.sh +176 -0
  180. package/.claude/skills/product-owner-decision/parse-decision.sh +66 -0
  181. package/.claude/skills/product-owner-decision/validate-deliverables.sh +82 -0
  182. package/.claude/skills/redis-coordination/LOGGING.md +260 -0
  183. package/.claude/skills/redis-coordination/README.md +30 -29
  184. package/.claude/skills/redis-coordination/SKILL.md +685 -83
  185. package/.claude/skills/redis-coordination/analyze-task-complexity.sh +277 -0
  186. package/.claude/skills/redis-coordination/cfn-loop-exec.sh +468 -0
  187. package/.claude/skills/redis-coordination/collect-confidence-scores.sh +179 -0
  188. package/.claude/skills/redis-coordination/collect-results.sh +75 -0
  189. package/.claude/skills/redis-coordination/data/cfn-loop.db +0 -0
  190. package/.claude/skills/redis-coordination/{test-orchestrator.sh → demos/test-orchestrator.sh} +25 -0
  191. package/.claude/skills/redis-coordination/execute-product-owner-decision.sh +258 -0
  192. package/.claude/skills/redis-coordination/get-agent-timeout.sh +176 -176
  193. package/.claude/skills/redis-coordination/invoke-waiting-mode.sh +93 -227
  194. package/.claude/skills/redis-coordination/invoke-waiting-mode.sh.backup-p7 +423 -0
  195. package/.claude/skills/redis-coordination/log-event.sh +109 -0
  196. package/.claude/skills/redis-coordination/monitor-cfn-violations.sh +391 -0
  197. package/.claude/skills/redis-coordination/orchestrate-cfn-loop-v3.sh +141 -0
  198. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh +31 -993
  199. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup +38 -0
  200. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-1761167675 +1672 -0
  201. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-p5 +1604 -0
  202. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-phase1 +1550 -0
  203. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-phase2 +1621 -0
  204. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-phase3 +1621 -0
  205. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.bak +0 -0
  206. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.broken +1627 -0
  207. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.corrupted +80 -0
  208. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.deprecated +1864 -0
  209. package/.claude/skills/redis-coordination/query-logs.sh +103 -0
  210. package/.claude/skills/redis-coordination/retrieve-context.sh +58 -0
  211. package/.claude/skills/redis-coordination/select-specialist-agent.sh +371 -0
  212. package/.claude/skills/redis-coordination/semantic-match-tfidf.py +252 -0
  213. package/.claude/skills/redis-coordination/send-heartbeat.sh +164 -72
  214. package/.claude/skills/redis-coordination/signal.sh +38 -0
  215. package/.claude/skills/redis-coordination/store-context.sh +86 -0
  216. package/.claude/skills/redis-coordination/test-context-injection.sh +354 -0
  217. package/.claude/skills/redis-coordination/test-timeout-enforcement.sh +513 -0
  218. package/.claude/skills/redis-coordination/tests/convert-line-endings.sh +15 -0
  219. package/.claude/skills/redis-coordination/tests/dlq-functionality-test.sh +101 -101
  220. package/.claude/skills/redis-coordination/tests/edge-cases-test.sh +98 -98
  221. package/.claude/skills/redis-coordination/tests/integration-test.sh +169 -169
  222. package/.claude/skills/redis-coordination/tests/retry-mechanism-test.sh +81 -81
  223. package/.claude/skills/redis-coordination/tests/run-test-suite.sh +91 -91
  224. package/.claude/skills/redis-coordination/tests/run-tests.sh +4 -0
  225. package/.claude/skills/redis-coordination/tests/test-primitives.sh +166 -0
  226. package/.claude/skills/redis-coordination/tests/test-utils.sh +53 -121
  227. package/.claude/skills/redis-coordination/tests/test_coordination_primitives.sh.deprecated +20 -0
  228. package/.claude/skills/redis-coordination/tests/test_utils.sh +49 -0
  229. package/.claude/skills/redis-coordination/v2_modularization/core_orchestration.sh +76 -0
  230. package/.claude/skills/redis-coordination/validate-parameters.sh +492 -0
  231. package/.claude/skills/retrospective-report/SKILL.md +31 -0
  232. package/.claude/skills/retrospective-report/generate-report.sh +101 -0
  233. package/.claude/skills/run-all-skill-tests.sh +124 -0
  234. package/.claude/skills/scope-simplifier/SKILL.md +37 -0
  235. package/.claude/skills/scope-simplifier/simplify-scope.sh +68 -0
  236. package/.claude/skills/simplified-agent-lifecycle/COST_ANALYSIS.md +49 -0
  237. package/.claude/skills/simplified-agent-lifecycle/DESIGN.md +98 -0
  238. package/.claude/skills/simplified-agent-lifecycle/MIGRATION_PLAN.md +74 -0
  239. package/.claude/skills/specialist-injection/SKILL.md +41 -0
  240. package/.claude/skills/specialist-injection/recommend-specialist.sh +57 -0
  241. package/.claude/skills/sprint-execution/SKILL.md +27 -0
  242. package/.claude/skills/sprint-execution/execute-sprint-task.sh +59 -0
  243. package/.claude/skills/sprint-execution/execute-sprint.sh +65 -0
  244. package/.claude/skills/sprint-planner/SKILL.md +37 -0
  245. package/.claude/skills/sprint-planner/plan-sprint.sh +85 -0
  246. package/.claude/skills/standardized-error-handling/SKILL.md +56 -0
  247. package/.claude/skills/standardized-error-handling/capture-agent-error.sh +87 -0
  248. package/.claude/skills/standardized-error-handling/test-error-handling.sh +166 -0
  249. package/.claude/skills/task-classifier/SKILL.md +94 -0
  250. package/.claude/skills/task-classifier/classify-task.sh +115 -0
  251. package/.claude/skills/validation-templates/SKILL.md +47 -0
  252. package/.claude/skills/validation-templates/content.json +38 -0
  253. package/.claude/skills/validation-templates/data.json +38 -0
  254. package/.claude/skills/validation-templates/design.json +38 -0
  255. package/.claude/skills/validation-templates/infrastructure.json +38 -0
  256. package/.claude/skills/validation-templates/research.json +38 -0
  257. package/.claude/skills/validation-templates/software.json +38 -0
  258. package/.claude/skills/webapp-testing/README.md +142 -0
  259. package/.claude/skills/webapp-testing/SCREENSHOT_NAMING_CONVENTION.md +547 -0
  260. package/.claude/skills/webapp-testing/SKILL.md +877 -0
  261. package/.claude/skills/webapp-testing/capture-screenshot.sh +238 -0
  262. package/.claude/skills/webapp-testing/cfn-loop-integration.sh +265 -0
  263. package/.claude/skills/webapp-testing/compare-screenshots.sh +199 -0
  264. package/.claude/skills/webapp-testing/init-storage.sh +150 -0
  265. package/.claude/skills/webapp-testing/set-baseline.sh +196 -0
  266. package/.claude/skills/webapp-testing/test-webapp-testing.sh +233 -0
  267. package/.claude/spawn-pattern-examples.md +3 -3
  268. package/CLAUDE.md +319 -45
  269. package/README.md +598 -251
  270. package/dist/agents/agent-loader.js +146 -165
  271. package/dist/agents/agent-loader.js.map +1 -1
  272. package/dist/cli/agent-command.js +2 -0
  273. package/dist/cli/agent-command.js.map +1 -1
  274. package/dist/cli/agent-definition-parser.js +7 -0
  275. package/dist/cli/agent-definition-parser.js.map +1 -1
  276. package/dist/cli/agent-executor.js +145 -11
  277. package/dist/cli/agent-executor.js.map +1 -1
  278. package/dist/cli/agent-prompt-builder.js +81 -1
  279. package/dist/cli/agent-prompt-builder.js.map +1 -1
  280. package/dist/cli/agent-spawn.js +10 -1
  281. package/dist/cli/agent-spawn.js.map +1 -1
  282. package/dist/cli/anthropic-client.js +192 -13
  283. package/dist/cli/anthropic-client.js.map +1 -1
  284. package/dist/cli/cfn-context.js +150 -0
  285. package/dist/cli/cfn-context.js.map +1 -1
  286. package/dist/cli/cfn-fork.js +159 -0
  287. package/dist/cli/cfn-fork.js.map +1 -0
  288. package/dist/cli/cli-agent-context.js +8 -3
  289. package/dist/cli/cli-agent-context.js.map +1 -1
  290. package/dist/cli/config-manager.js +109 -91
  291. package/dist/cli/config-manager.js.map +1 -1
  292. package/dist/cli/conversation-fork.js +201 -0
  293. package/dist/cli/conversation-fork.js.map +1 -0
  294. package/dist/cli/index.js +4 -0
  295. package/dist/cli/index.js.map +1 -1
  296. package/dist/cli/tool-definitions.js +263 -0
  297. package/dist/cli/tool-definitions.js.map +1 -0
  298. package/dist/cli/tool-executor.js +247 -0
  299. package/dist/cli/tool-executor.js.map +1 -0
  300. package/dist/hello.js +8 -0
  301. package/dist/hello.js.map +1 -0
  302. package/package.json +14 -6
  303. package/scripts/README.md +68 -0
  304. package/scripts/cfn-intervention-example.sh +21 -0
  305. package/scripts/migrate-test-infrastructure.sh +40 -0
  306. package/scripts/validate-test-migration.sh +49 -0
  307. package/scripts/verify-no-secrets.sh +55 -0
  308. package/.claude/agents/architecture/system-architect.md.backup +0 -603
  309. package/.claude/agents/code-booster.md +0 -131
  310. package/.claude/agents/consensus/performance-benchmarker.md +0 -101
  311. package/.claude/agents/consensus/security-manager.md +0 -107
  312. package/.claude/agents/context-curator.md +0 -167
  313. package/.claude/agents/context-reflector.md +0 -65
  314. package/.claude/agents/core-agents/cfn-loop-coordinator.md +0 -134
  315. package/.claude/agents/core-agents/code-quality-validator.md +0 -149
  316. package/.claude/agents/core-agents/context-curator.md +0 -452
  317. package/.claude/agents/core-agents/context-reflector.md +0 -273
  318. package/.claude/agents/core-agents/cost-savings-cfn-loop-coordinator.md +0 -235
  319. package/.claude/agents/core-agents/tester.md +0 -170
  320. package/.claude/agents/development/backend-dev.md +0 -165
  321. package/.claude/agents/devops/devops-engineer.md +0 -148
  322. package/.claude/agents/frontend/interaction-tester.md +0 -139
  323. package/.claude/agents/frontend/react-frontend-engineer.md +0 -9
  324. package/.claude/agents/personas/accessibility-advocate-persona.md +0 -107
  325. package/.claude/agents/testing/production-validator.md +0 -179
  326. package/.claude/agents/testing/tdd-london-swarm.md +0 -209
  327. package/.claude/agents/testing/unit/tdd-london-swarm.md +0 -43
  328. package/.claude/agents/testing/validation/production-validator.md +0 -43
  329. package/.claude/api-configs/config-current-zai-config.env +0 -62
  330. package/.claude/api-configs/config-test-zai-config.env +0 -62
  331. package/.claude/api-configs/env-backups/before-anthropic-20251020-025404.env +0 -62
  332. package/.claude/api-configs/env-backups/before-restore-20251020-025431.env +0 -62
  333. package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-1760949407 +0 -933
  334. package/dist/cli/cli-agent-context.test.js +0 -451
  335. package/dist/cli/cli-agent-context.test.js.map +0 -1
  336. package/dist/coordination/fleet-manager.test.js +0 -141
  337. package/dist/coordination/fleet-manager.test.js.map +0 -1
  338. package/dist/middleware/transparency-middleware.test.js +0 -184
  339. package/dist/middleware/transparency-middleware.test.js.map +0 -1
  340. /package/.claude/agents/{core-agents → developers}/researcher.md +0 -0
  341. /package/.claude/agents/{consensus → specialists}/crdt-synchronizer.md +0 -0
  342. /package/.claude/agents/{consensus → specialists}/quorum-manager.md +0 -0
  343. /package/.claude/agents/{consensus → specialists}/raft-manager.md +0 -0
  344. /package/.claude/{agents/core-agents → agents-ignore}/coordinator.md +0 -0
  345. /package/.claude/{agents/core-agents/cost-savings-coordinator.md → agents-ignore/cost-savings-coordinator.md.backup} +0 -0
  346. /package/.claude/skills/redis-coordination/{phase4-wake-queue-test-report.md → demos/phase4-wake-queue-test-report.md} +0 -0
  347. /package/.claude/skills/redis-coordination/{test-bzpopmin-fix.sh → demos/test-bzpopmin-fix.sh} +0 -0
  348. /package/.claude/skills/redis-coordination/{test-cancel-swarm.sh → demos/test-cancel-swarm.sh} +0 -0
  349. /package/.claude/skills/redis-coordination/{test-dlq.sh → demos/test-dlq.sh} +0 -0
  350. /package/.claude/skills/redis-coordination/{test-iteration-feedback.sh → demos/test-iteration-feedback.sh} +0 -0
  351. /package/.claude/skills/redis-coordination/{test-priority-wake-phase4-unix.sh → demos/test-priority-wake-phase4-unix.sh} +0 -0
  352. /package/.claude/skills/redis-coordination/{test-priority-wake-phase4.sh → demos/test-priority-wake-phase4.sh} +0 -0
  353. /package/.claude/skills/redis-coordination/{test-priority-wake.sh → demos/test-priority-wake.sh} +0 -0
  354. /package/.claude/skills/redis-coordination/{test-quick-fix.sh → demos/test-quick-fix.sh} +0 -0
  355. /package/.claude/skills/redis-coordination/{test-quorum-absolute.sh → demos/test-quorum-absolute.sh} +0 -0
  356. /package/.claude/skills/redis-coordination/{test-quorum-fallback.sh → demos/test-quorum-fallback.sh} +0 -0
  357. /package/.claude/skills/redis-coordination/{test-quorum-percentage.sh → demos/test-quorum-percentage.sh} +0 -0
  358. /package/.claude/skills/redis-coordination/{test-quorum-with-retry.sh → demos/test-quorum-with-retry.sh} +0 -0
  359. /package/.claude/skills/redis-coordination/{test-quorum.sh → demos/test-quorum.sh} +0 -0
  360. /package/.claude/skills/redis-coordination/{test-shutdown-handling.sh → demos/test-shutdown-handling.sh} +0 -0
  361. /package/.claude/skills/redis-coordination/{test-shutdown.sh → demos/test-shutdown.sh} +0 -0
  362. /package/.claude/skills/redis-coordination/{test-utils-unix.sh → demos/test-utils-unix.sh} +0 -0
  363. /package/.claude/skills/redis-coordination/{test-utils.sh → demos/test-utils.sh} +0 -0
  364. /package/.claude/skills/redis-coordination/{test-waiting-mode.sh → demos/test-waiting-mode.sh} +0 -0
package/CLAUDE.md CHANGED
@@ -17,16 +17,25 @@
17
17
  * **Never save to project root.** Use proper subdirs
18
18
  * **No guides/summaries/reports** unless explicitly asked
19
19
  * **Use spartan language and give answers in plain english**
20
- * **Concise summaries only** - no code examples unless requested
20
+ * **Concise answers only** - no code examples unless requested
21
21
  * **Redis persistence enables swarm recovery** - swarm state survives interruptions
22
22
  * **ALL agent communication MUST use Redis pub/sub** - no direct file coordination
23
+ * **NEVER HARDCODE API KEYS**
24
+ * **sleep on repeat** when monitoring a background process. sleep x minutes, check progress, sleep, repeat
25
+
26
+ **Agent Output Standards:**
27
+ * **Bug documentation**: `docs/BUG_#_*.md` (investigation, fix summary, validation)
28
+ * **Test scripts**: `tests/test-*.sh` (persistent, version controlled)
29
+ * **Feature documentation**: `docs/FEATURE_NAME.md` (architecture, process docs)
30
+ * **Temporary files ONLY**: `/tmp/` (ephemeral test fixtures, scratch data)
31
+ * **Full guidelines**: `docs/AGENT_OUTPUT_STANDARDS.md`
23
32
 
24
33
  **Consensus thresholds:**
25
34
  * Gate (agent self-confidence): **≥0.75 each**
26
35
  * Validators consensus: **≥0.90**
27
36
 
28
37
  ### CTO Delegation Persona
29
- * **Act as a busy CTO** who delegates all non-trivial work to specialized agents
38
+ * **Act as a busy CTO** who delegates all non-trivial work to specialized agents or a cfn-coordinator
30
39
  * **Define clear success criteria** for implementation (working code, passing tests, documented features)
31
40
  * **Never define adoption criteria** (user engagement, rollout strategy, training plans)
32
41
  * **Ruthlessly delegate** - if task requires >3 steps, spawn agents immediately
@@ -40,6 +49,8 @@
40
49
  - Redis Coordination (`.claude/skills/redis-coordination/SKILL.md`)
41
50
  - Agent Spawning (`.claude/skills/agent-spawning/SKILL.md`)
42
51
  - CFN Loop Validation (`.claude/skills/cfn-loop-validation/SKILL.md`)
52
+ - **Product Owner Decision** (`.claude/skills/product-owner-decision/SKILL.md`) - Strategic CFN loop decision execution
53
+ - **Agent Output Processing** (`.claude/skills/agent-output-processing/SKILL.md`) - Universal structured output extraction
43
54
 
44
55
  **Coordination Principles:**
45
56
  * ALL agent communication via explicit Redis pub/sub dependencies
@@ -50,7 +61,7 @@
50
61
 
51
62
  ### Main Chat Role (Thin Orchestration Layer)
52
63
  * Spawn ONLY coordinator agent (single Task() call)
53
- * Coordinator handles all agent spawning internally via CLI
64
+ * Coordinator handles all agent spawning internally via CLI using the orchestration skill
54
65
  * Delegate ALL coordination to skills
55
66
  * Use skill-specific configuration for complex workflows
56
67
 
@@ -70,12 +81,40 @@
70
81
 
71
82
  | Coordinator | Spawning Method | Cost Savings | Use Case |
72
83
  |-------------|----------------|--------------|----------|
73
- | `cost-savings-cfn-loop-coordinator` | CLI | 95-98% | CFN Loops |
84
+ | `cfn-v3-coordinator` | CLI | 95-98% | CFN Loops |
74
85
  | `cost-savings-coordinator` | CLI | 95-98% | General tasks |
75
86
 
76
87
  **Architecture:**
77
88
  Main Chat → Single coordinator agent → Coordinator spawns workers via CLI → 95-98% cost savings
78
89
 
90
+ ## CFN v3 Dual-Mode Architecture
91
+
92
+ **Two spawning modes:**
93
+ 1. **CLI Mode** (default): Cost-optimized, Redis context, Z.ai routing
94
+ 2. **Task Mode**: Simplified, direct injection, Anthropic routing
95
+
96
+ **Mode Selection:**
97
+ ```bash
98
+ # Default: CLI mode (95-98% savings)
99
+ /cfn-loop "Task description"
100
+
101
+ # Explicit Task mode (full visibility)
102
+ /cfn-loop "Task description" --spawn-mode=task
103
+ ```
104
+
105
+ **Key Differences:**
106
+ - CLI mode: Main Chat → Coordinator → cfn-loop-orchestration/orchestrate.sh → CLI agents
107
+ - Task mode: Main Chat → Coordinator → JSON → Main Chat spawns Task() agents
108
+ - CLI agents use Z.ai routing automatically
109
+ - Redis context enables swarm recovery (CLI mode)
110
+
111
+ **Context Storage:**
112
+ - Both modes store context in Redis
113
+ - CLI agents read from Redis: `redis-cli HGETALL "cfn_loop:task:$TASK_ID:context"`
114
+ - Task mode: Main Chat injects directly but also stores in Redis
115
+
116
+ **Reference:** See `planning/cfn-v3/DUAL_MODE_IMPLEMENTATION.md`
117
+
79
118
  ### Custom Routing (Z.ai Provider Integration)
80
119
 
81
120
  **Provider Routing Model:**
@@ -108,7 +147,7 @@ When spawned via CLI (`npx claude-flow-novice`), you automatically benefit from
108
147
 
109
148
  **CRITICAL: Single Coordinator Pattern (v2)**
110
149
 
111
- Main Chat spawns ONLY the coordinator agent. The coordinator handles all agent spawning internally via CLI.
150
+ Main Chat spawns ONLY the coordinator agent. The coordinator handles all agent spawning internally via CLI and .claude/skills/cfn-loop-orchestration/orchestrate.sh
112
151
 
113
152
  **❌ FORBIDDEN - Main Chat Spawning Workers:**
114
153
  ```javascript
@@ -121,11 +160,11 @@ Task("tester", "Test feature...") // ❌ NO
121
160
  **✅ REQUIRED - Single Coordinator:**
122
161
  ```javascript
123
162
  // CORRECT - Main Chat spawns only coordinator
124
- Task("cost-savings-cfn-loop-coordinator", `
163
+ Task("cfn-v3-coordinator", `
125
164
  Execute CFN Loop for: Implement authentication
126
165
 
127
166
  Coordinator will:
128
- 1. Invoke orchestrate-cfn-loop.sh
167
+ 1. Invoke .claude/skills/cfn-loop-orchestration/orchestrate.sh
129
168
  2. Orchestrator spawns agents via CLI
130
169
  3. Coordinator manages all Redis coordination
131
170
  4. Return structured result to Main Chat
@@ -133,7 +172,7 @@ Task("cost-savings-cfn-loop-coordinator", `
133
172
  ```
134
173
 
135
174
  **Why This Pattern:**
136
- - Coordinator controls spawn timing via CLI (no timeout issues)
175
+ - Coordinator controls spawn timing via .claude/skills/cfn-loop-orchestration/orchestrate.sh and CLI (no timeout issues)
137
176
  - 95-98% cost savings vs Task() spawning
138
177
  - Zero-token waiting between iterations (Redis BLPOP)
139
178
  - Sequential CLI spawning is safe (coordinator manages order)
@@ -266,7 +305,7 @@ Use zero-token blocking mechanisms (like Redis BLPOP) to create efficient, low-o
266
305
  **Option 1: Always Use Full Orchestration (RECOMMENDED)**
267
306
  ```bash
268
307
  # CORRECT: Use orchestrator for all multi-agent workflows
269
- ./.claude/skills/redis-coordination/orchestrate-cfn-loop.sh \
308
+ ./.claude/skills/cfn-loop-orchestration/orchestrate.sh \
270
309
  --task-id "$TASK_ID" \
271
310
  --mode standard \
272
311
  --loop3-agents "coder-1,researcher-1" \
@@ -343,7 +382,7 @@ Task("cfn-loop-coordinator", "Execute CFN Loop with orchestrator...")
343
382
 
344
383
  **1. Main Chat spawns coordinator:**
345
384
  ```javascript
346
- Task("cost-savings-cfn-loop-coordinator", `
385
+ Task("cfn-v3-coordinator", `
347
386
  Execute CFN Loop for: Implement authentication system
348
387
 
349
388
  Use orchestrator for dependency enforcement.
@@ -354,13 +393,22 @@ Task("cost-savings-cfn-loop-coordinator", `
354
393
  **2. Coordinator invokes orchestrator internally:**
355
394
  ```bash
356
395
  # Coordinator runs this script (NOT Main Chat)
357
- ./.claude/skills/redis-coordination/orchestrate-cfn-loop.sh \
396
+ ./.claude/skills/cfn-loop-orchestration/orchestrate.sh \
358
397
  --task-id "unique-task-id" \
359
398
  --mode standard \
360
399
  --loop3-agents "researcher,backend-dev,devops" \
361
400
  --loop2-agents "reviewer,architect,tester" \
362
401
  --product-owner "product-owner" \
363
- --max-iterations 10
402
+ --max-iterations 10 \
403
+ --phase-id "phase-2" \
404
+ --epic-context '{"epicGoal":"Build feature X","inScope":["A","B"]}' \
405
+ --phase-context '{"currentPhase":"Phase 2","deliverables":["Component 1","Component 2"]}' \
406
+ --success-criteria '{"acceptanceCriteria":["Tests pass","Coverage >80%"],"gateThreshold":0.75}'
407
+
408
+ # CFN v3 UPDATE: Modular orchestrator (78% code reduction)
409
+ # - Helper scripts for context injection, agent spawning, validation
410
+ # - Stateless context retrieval from Redis
411
+ # - Better agent ID tracking (no BLPOP hangs)
364
412
  ```
365
413
 
366
414
  **3. Orchestrator spawns all agents via CLI:**
@@ -410,9 +458,15 @@ redis-cli lpush "swarm:${TASK_ID}:${AGENT_ID}:done" "complete"
410
458
  - IF gate PASSES → Signal Loop 2 to start work
411
459
  3. Loop 2 validators WAIT for gate pass signal (`redis-cli blpop "swarm:${TASK_ID}:gate-passed" 0`)
412
460
  4. Loop 2 validators review Loop 3 work and report consensus
413
- 5. **Consensus Check:** Loop 2 scores checked
414
- - IF consensus reached → Task complete
415
- - IF consensus fails Wake all agents for iteration N+1
461
+ 5. **Product Owner Decision (BUG #11 FIX):** Orchestrator spawns Product Owner and parses output
462
+ - Uses `.claude/skills/product-owner-decision/execute-decision.sh`
463
+ - Extracts PROCEED/ITERATE/ABORT from agent output
464
+ - Validates deliverables (prevents "consensus on vapor")
465
+ - Orchestrator pushes decision to Redis (not agent)
466
+ 6. **Decision Execution:**
467
+ - IF PROCEED → Task complete
468
+ - IF ITERATE → Wake all agents for iteration N+1
469
+ - IF ABORT → Exit with error
416
470
 
417
471
  ### CFN Loop Slash Commands
418
472
 
@@ -432,7 +486,7 @@ Main Chat should use these commands instead of manually spawning coordinators:
432
486
  ```
433
487
 
434
488
  **What These Commands Do:**
435
- - Automatically spawn `cost-savings-cfn-loop-coordinator`
489
+ - Automatically spawn `cfn-v3-coordinator`
436
490
  - Pass structured parameters (success criteria, agent configuration)
437
491
  - Include custom routing cost reminders
438
492
  - Enable web portal visibility
@@ -471,32 +525,252 @@ Implement comprehensive test suites that validate both functional requirements a
471
525
  - Maintenance Schedule: `planning/skills/MAINTENANCE_SCHEDULE.md`
472
526
 
473
527
  **Migration Analytics:**
474
- See `.artifacts/analytics/context-reduction-report.json`
475
- ## Adaptive Context Extensions: CLI Agent Spawning Insights (v2.5.2)
476
-
477
- ### Strategy Patterns
478
-
479
- #### PATTERN-001: Environment Configuration
480
- - **Context**: CLI Entrypoints
481
- - **Insight**: Always explicitly load environment configurations using 'import dotenv/config' to ensure provider-specific settings are correctly read and applied across different execution contexts.
482
- - **Tags**: environment, configuration, cli, dotenv
483
- - **Confidence**: 0.95
484
- - **Priority**: 9/10
485
-
486
- ### Domain Insights
487
-
488
- #### PATTERN-002: Multi-Provider API Integration
489
- - **Context**: API Provider Configuration
490
- - **Insight**: Create explicit provider-specific mappings that account for endpoint differences, model naming conventions, and protocol variations to ensure robust cross-provider compatibility.
491
- - **Tags**: api-integration, provider-mapping, resilience, configuration
492
- - **Confidence**: 0.92
493
- - **Priority**: 8/10
494
-
495
- ### Edge Case Handling
496
-
497
- #### PATTERN-004: Resilient API Call Mechanisms
498
- - **Context**: Error Handling and Timeout Management
499
- - **Insight**: Configure explicit timeouts and retry mechanisms for API calls to prevent indefinite hanging and provide built-in resilience, with provider-specific timeout and retry configurations.
500
- - **Tags**: error-handling, timeout, resilience, api-calls
501
- - **Confidence**: 0.90
502
- - **Priority**: 9/10
528
+ See `.artifacts/analytics/context-reduction-report.json`
529
+ ## Sprint 7 Adaptive Context Lessons
530
+
531
+ ### STRAT-007: Background Execution Strategy
532
+ - **Confidence:** 0.95
533
+ - **Priority:** 9
534
+ - **Insight**: Use background execution with Redis monitoring for long-running orchestration workflows (>10 minutes). Bash tool has hard 10-minute timeout that cannot be extended.
535
+ - **Tags**: orchestration, bash-timeout, redis-monitoring, background-execution
536
+
537
+ ### ANTI-004: Regex Validation Anti-Pattern
538
+ - **Confidence:** 0.92
539
+ - **Priority:** 8
540
+ - **Insight**: Avoid simplistic regex matching for agent validation. Pattern `[[ $AGENTS =~ $AGENTS ]]` always returns true (self-matching).
541
+ - **Tags**: regex, validation, bug-prevention, orchestration
542
+
543
+ ### PATTERN-008: Product Owner Decision Flow
544
+ - **Confidence:** 0.90
545
+ - **Priority:** 8
546
+ - **Insight**: Implement explicit Product Owner decision flow after Loop 2 consensus to prevent validator scope creep and enforce strategic boundaries.
547
+ - **Tags**: cfn-loop, product-owner, scope-management, decision-flow
548
+
549
+ ## Sprint 8 Adaptive Context Lessons (Phase 1 & 2 - Skill-Based Output Processing)
550
+
551
+ ### PATTERN-009: Multi-Pattern Confidence Parsing
552
+ - **Confidence:** 0.95
553
+ - **Priority:** 9
554
+ - **Insight**: Implement multi-pattern confidence parsing with fallback strategies. Design interfaces that gracefully handle multiple input formats, with explicit confidence scoring for each parsing attempt. Patterns: explicit numeric (0.85), percentage (85%), qualitative (high/medium/low), calculated defaults.
555
+ - **Tags**: parsing, confidence, strategy, error-handling, skill-based-processing
556
+ - **Applied in**: Loop 3 output processing, Loop 2 feedback extraction
557
+ - **Impact**: 100% confidence extraction success rate, eliminates 0.0 defaults
558
+
559
+ ### STRAT-014: Skill Interface Consistency
560
+ - **Confidence:** 0.90
561
+ - **Priority:** 8
562
+ - **Insight**: Design skill interfaces with consistent parameter structures across skills. Use named parameters (--agent-type, --task-id, --agent-id, --context, --iteration, --timeout) with explicit type definitions, default values, and clear error messaging to improve skill reusability and reduce integration complexity. Enabled 95% code reuse between Loop 3 and Loop 2 implementations.
563
+ - **Tags**: interface, skill-design, consistency, reusability, pattern-reuse
564
+ - **Applied in**: loop3-output-processing, loop2-output-processing skills
565
+ - **Impact**: Phase 2 took 1.2h vs 3h from scratch (36% time savings)
566
+
567
+ ### PATTERN-010: Parallel Execution with Temp Files
568
+ - **Confidence:** 0.93
569
+ - **Priority:** 9
570
+ - **Insight**: Use background processes with temporary files to eliminate race conditions in parallel agent coordination. Pattern: spawn all agents in background with `(skill-execution > /tmp/output-file) &`, collect PIDs, use `wait` to synchronize, read results from temp files after completion. Eliminates polling wait and guarantees synchronous output capture.
571
+ - **Tags**: parallel-execution, race-conditions, temp-files, background-processes, coordination
572
+ - **Applied in**: .claude/skills/cfn-loop-orchestration/orchestrate.sh (modular helper scripts)
573
+ - **Impact**: 3x speedup for 3 agents, zero race conditions
574
+
575
+ ## Adaptive Context Extensions: CLI Agent Spawning Insights (v2.5.2)
576
+
577
+ ### Strategy Patterns
578
+
579
+ #### PATTERN-001: Environment Configuration
580
+ - **Context**: CLI Entrypoints
581
+ - **Insight**: Always explicitly load environment configurations using 'import dotenv/config' to ensure provider-specific settings are correctly read and applied across different execution contexts.
582
+ - **Tags**: environment, configuration, cli, dotenv
583
+ - **Confidence**: 0.95
584
+ - **Priority**: 9/10
585
+
586
+
587
+ ## Adaptive Context Extensions: CFN Loop Context Injection Insights (BUG #20)
588
+
589
+ ### Strategy Patterns
590
+
591
+ #### STRAT-020: Mandatory Deliverable Verification
592
+ - **Context**: CFN Loop Consensus Validation
593
+ - **Insight**: Implement mandatory deliverable verification with forced iteration when no files created. After Loop 2 consensus, check git status for file changes. If task requires implementation (keywords: create/build/implement) but git shows zero changes, override consensus and force ITERATE with explicit deliverable requirements in feedback. Prevents 'consensus on vapor' where validators approve plans without actual code.
594
+ - **Tags**: deliverable-verification, consensus-validation, git-diff, cfn-loop, quality-gate
595
+ - **Confidence**: 0.95
596
+ - **Priority**: 10/10
597
+ - **Validation**: Core implementation in `.claude/skills/cfn-loop-validation/validate-deliverables.sh`
598
+ - **Retry Pattern**: Limited to 3 iterations, escalate to Product Owner if still no deliverables
599
+
600
+ #### STRAT-021: Standardized Context Extraction Templates
601
+ - **Context**: Coordinator Design
602
+ - **Insight**: Use standardized context extraction templates in coordinators. Template structure: epicGoal (1-2 sentences), inScope (list), outOfScope (list), deliverables (file paths), directory (creation path), acceptanceCriteria (measurable requirements). Extract using bash text processing (grep, sed, jq) with reasonable defaults for missing fields. Prevents minimal context ('Checkpoint' + '4.1') that causes wrong deliverables.
603
+ - **Tags**: context-extraction, coordinator, templates, standardization, parsing
604
+ - **Confidence**: 0.93
605
+ - **Priority**: 9/10
606
+
607
+ ### Implementation Patterns
608
+
609
+ #### PATTERN-020: Multi-Layer Context Injection
610
+ - **Context**: Coordinator → Orchestrator → Agent Flow
611
+ - **Insight**: When implementing multi-layer coordination (coordinator → orchestrator → agents), ensure context flows through ALL layers. Pattern: Coordinator extracts context from task description, orchestrator retrieves context from Redis and injects into agent spawn parameters, agents receive complete deliverables/acceptance criteria in --context parameter. Breaking this chain causes 'consensus on vapor' (high confidence, zero deliverables).
612
+ - **Tags**: context-injection, cfn-loop, coordination, multi-layer, deliverables
613
+ - **Confidence**: 0.92
614
+ - **Priority**: 9/10
615
+
616
+ #### PATTERN-021: Context Validation Pipeline
617
+ - **Context**: Multi-Layer Coordination
618
+ - **Insight**: Design context validation pipeline with checkpoints at each layer. Pattern: (1) Coordinator validates extracted context has deliverables/acceptance criteria before spawning orchestrator, (2) Orchestrator validates Redis context retrieval succeeded before spawning agents, (3) Agents validate received context contains required fields before starting work. Each layer logs validation results. Fail-fast prevents cascading context loss.
619
+ - **Tags**: validation, context-injection, fail-fast, multi-layer, checkpoints
620
+ - **Confidence**: 0.87
621
+ - **Priority**: 8/10
622
+
623
+ #### PATTERN-022: Agent Lifecycle - Exit vs Waiting Mode
624
+ - **Context**: CFN Loop Agent Management
625
+ - **Insight**: When agents enter waiting mode after reporting confidence, they block orchestrator's wait $PID indefinitely. Solution: Remove waiting mode from CFN protocol Step 3, let agents exit cleanly. Enables adaptive agent specialization - orchestrator can spawn different specialist (security-specialist for security issues, not original coder) for next iteration based on feedback type. Pattern validated by BUG #18 fix.
626
+ - **Tags**: waiting-mode, agent-lifecycle, adaptive-specialization, orchestrator-blocking
627
+ - **Confidence**: 0.89
628
+ - **Priority**: 8/10
629
+
630
+ ### Anti-Patterns
631
+
632
+ #### ANTI-020: Context Storage Without Injection
633
+ - **Context**: Redis Coordination
634
+ - **Insight**: Avoid storing context in Redis without retrieving and injecting it into agent prompts. Anti-pattern: Orchestrator stores epic-context, phase-context, success-criteria in Redis but spawns agents with generic context ('Loop 3 implementation for iteration N'). Result: Agents have no access to deliverables list, acceptance criteria, or directory paths despite context being 'available'.
635
+ - **Tags**: context-injection, redis, agent-spawning, storage-without-use
636
+ - **Confidence**: 0.88
637
+ - **Priority**: 8/10
638
+
639
+ #### ANTI-021: Generic Context When Specifics Exist
640
+ - **Context**: Agent Spawning
641
+ - **Insight**: Never pass generic iteration-level context when task-specific deliverables exist. Anti-pattern: Agent receives 'Loop 3 implementation for iteration 2' when Redis contains detailed deliverables list. Agents have no telepathy - they cannot infer '.claude/skills/checkpoint-state/SKILL.md' from 'iteration 2'. Always inject complete deliverables, directory paths, and acceptance criteria even if 'already in Redis'.
642
+ - **Tags**: agent-context, specificity, deliverables, telepathy-fallacy, explicitness
643
+ - **Confidence**: 0.91
644
+ - **Priority**: 9/10
645
+
646
+ ### Edge Cases & Testing
647
+
648
+ #### EDGE-020: Comparative Agent Spawn Testing
649
+ - **Context**: Context Debugging
650
+ - **Insight**: When debugging context issues, use comparative agent spawn testing. Edge case discovered: Agents succeed when spawned manually with explicit context ('Create /tmp/test.sh') but fail in CFN Loop with generic context ('Loop 3 implementation'). This reveals context injection failure rather than tool/API issues. Test pattern: Manual spawn with explicit deliverables → verify file created → confirms agent capability → proves orchestrator context gap.
651
+ - **Tags**: debugging, context-testing, manual-spawn, comparative-testing, isolation
652
+ - **Confidence**: 0.90
653
+ - **Priority**: 7/10
654
+
655
+ ## Sprint Execution in Claude Flow Novice
656
+
657
+ ### Sprint Context Injection
658
+
659
+ #### Purpose
660
+ Decompose large epics into focused, manageable sprints with clear deliverables and scope boundaries.
661
+
662
+ #### Key Principles
663
+ 1. **Focused Scope**: Each sprint targets a specific subset of epic requirements
664
+ 2. **Incremental Progress**: Sprints build upon each other
665
+ 3. **Precise Deliverables**: Create only sprint-specific files
666
+ 4. **Context Specificity**: Agents receive sprint-level, not epic-level context
667
+
668
+ #### Sprint Context Structure
669
+
670
+ ```json
671
+ {
672
+ "sprint_name": "P1 Coordinator Monitoring",
673
+ "sprint_num": 1,
674
+ "total_sprints": 7,
675
+ "deliverables": [
676
+ "test-p1-monitoring.sh",
677
+ "docs/P1_MONITORING_RESULTS.md"
678
+ ],
679
+ "in_scope": [
680
+ "P1 coordinator monitoring validation",
681
+ "Test timeout mechanisms",
682
+ "Logging verification"
683
+ ],
684
+ "out_of_scope": [
685
+ "P2-P7 monitoring",
686
+ "Cross-priority integration",
687
+ "Epic-level summary"
688
+ ],
689
+ "directory": "/mnt/c/Users/masha/Documents/claude-flow-novice/tests/p1"
690
+ }
691
+ ```
692
+
693
+ #### Sprint Execution Tool: `execute-sprint-task.sh`
694
+
695
+ Enables sprint-aware agent execution with focused context injection.
696
+
697
+ **Usage:**
698
+ ```bash
699
+ ./.claude/skills/sprint-execution/execute-sprint-task.sh \
700
+ [AGENT_TYPE] \
701
+ [TASK_ID] \
702
+ [AGENT_ID] \
703
+ [SPRINT_ID]
704
+ ```
705
+
706
+ ### Sprint vs Epic Implementation
707
+
708
+ **Epic Context (Broad)**:
709
+ ```
710
+ Validate P1-P7 monitoring across entire system
711
+ Deliverables:
712
+ - Comprehensive test suite
713
+ - System-wide monitoring report
714
+ ```
715
+
716
+ **Sprint Context (Focused)**:
717
+ ```
718
+ Sprint: 1.1 - P1 Coordinator Monitoring
719
+ Deliverables:
720
+ - test-p1-monitoring.sh
721
+ - docs/P1_MONITORING_RESULTS.md
722
+
723
+ Scope:
724
+ - P1 coordinator timeout verification
725
+ - Basic logging checks
726
+
727
+ Out of Scope:
728
+ - P2-P7 monitoring
729
+ - Cross-priority tests
730
+ ```
731
+
732
+ ### Confidence Reporting
733
+
734
+ - Report confidence based on **sprint deliverable completion**
735
+ - 0.90+ confidence means sprint objectives met
736
+ - Do NOT report confidence for entire epic
737
+ - when monitoring something, sleep for X minutes on repeat with check in between
738
+ ### STRAT-025: Explicit Deliverable Tracking
739
+
740
+ ## Sprint 9 Adaptive Context Lessons (CFN v3 Dual-Mode Implementation)
741
+
742
+ ### STRAT-026: Redis Context Storage Over CLI Parameters
743
+ - **Confidence:** 0.95
744
+ - **Priority:** 9
745
+ - **Insight**: Use Redis for complex JSON context storage instead of CLI parameters. Eliminates shell escaping issues, enables swarm recovery, and provides single source of truth for agent coordination.
746
+ - **Tags**: redis, context-storage, cli-spawning, swarm-recovery
747
+
748
+ ### PATTERN-023: Dual-Mode Architecture Pattern
749
+ - **Confidence:** 0.92
750
+ - **Priority:** 9
751
+ - **Insight**: Implement dual execution modes (optimized vs simplified) sharing core logic. CLI mode for production (cost-optimized), Task mode for debugging (full visibility), both using same coordinator and context structure.
752
+ - **Tags**: architecture, dual-mode, debugging, production
753
+
754
+ ### STRAT-027: Consensus Validation for Architecture
755
+ - **Confidence:** 0.90
756
+ - **Priority:** 8
757
+ - **Insight**: Use specialized consensus teams (reviewer + tester) to validate implementations before deployment. Achieved 0.92-0.95 confidence scores, caught design issues early.
758
+ - **Tags**: validation, consensus, testing, quality-assurance
759
+
760
+ ### ANTI-022: Premature Optimization (Context Pruning)
761
+ - **Confidence:** 0.88
762
+ - **Priority:** 7
763
+ - **Insight**: Avoid implementing optimization features (like context pruning) before validating necessity. CFN v3 removed pruning after determining context small enough without it, saving implementation complexity.
764
+ - **Tags**: optimization, yagni, context-management, simplification
765
+
766
+ ### PATTERN-024: Swarm Recovery via Persistence
767
+ - **Confidence:** 0.93
768
+ - **Priority:** 9
769
+ - **Insight**: Store swarm state in Redis with TTL to enable crash recovery. Agents can resume from last known state using task_id as recovery key. Critical for long-running CFN Loops.
770
+ - **Tags**: recovery, redis, persistence, fault-tolerance, swarm-coordination
771
+
772
+ ### STRAT-028: Modular Skill Architecture
773
+ - **Confidence:** 0.91
774
+ - **Priority:** 8
775
+ - **Insight**: Decompose complex systems into independent skills (20 skills in CFN v3: task-classifier, playbook, validation-templates, etc.). Enables reuse, testing isolation, and incremental enhancement.
776
+ - **Tags**: modularity, skills, architecture, reusability