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.
- package/.claude/adaptive-context/cfn-v3-reflection.json +21 -0
- package/.claude/agents/AGENT_LIFECYCLE.md +495 -0
- package/.claude/agents/CLAUDE.md +1002 -995
- package/.claude/agents/accessibility-advocate.md +457 -0
- package/.claude/agents/agent-principles/README.md +226 -226
- package/.claude/agents/agent-principles/agent-type-guidelines.md +10 -0
- package/.claude/agents/agent-principles/format-selection.md +10 -0
- package/.claude/agents/agent-principles/phase4-template-optimization.md +502 -494
- package/.claude/agents/agent-principles/prompt-engineering.md +8 -0
- package/.claude/agents/agent-principles/quality-metrics.md +8 -0
- package/.claude/agents/analysis/code-analyzer.md +7 -17
- package/.claude/agents/analysis/code-review/analyze-code-quality.md +2 -104
- package/.claude/agents/analysis/perf-analyzer.md +2 -196
- package/.claude/agents/context/context-curator.md +78 -84
- package/.claude/agents/context/context-reflector.md +27 -81
- package/.claude/agents/coordinators/README.md +42 -0
- package/.claude/agents/coordinators/cfn-v3-coordinator.md +440 -0
- package/.claude/agents/{product-owner-team → coordinators}/cto-agent.md +154 -187
- package/.claude/agents/coordinators/multi-sprint-coordinator.md +50 -0
- package/.claude/agents/{product-owner-team → coordinators}/product-owner-agent.md +6 -39
- package/.claude/agents/{cfn-loop → coordinators}/product-owner.md +72 -17
- package/.claude/agents/core-agents/reviewer.md +114 -135
- package/.claude/agents/custom/agent-builder.md +637 -637
- package/.claude/agents/developers/README.md +69 -0
- package/.claude/agents/developers/backend-dev.md +77 -0
- package/.claude/agents/{core-agents → developers}/coder.md +131 -26
- package/.claude/agents/developers/react-frontend-engineer.md +121 -0
- package/.claude/agents/{frontend → developers}/state-architect.md +1 -0
- package/.claude/agents/{frontend → developers}/ui-designer.md +1 -0
- package/.claude/agents/development/backend/dev-backend-api.md +0 -29
- package/.claude/agents/development/npm-package-specialist.md +355 -347
- package/.claude/agents/documentation/api-docs/docs-api-openapi.md +8 -0
- package/.claude/agents/documentation/api-docs.md +8 -0
- package/.claude/agents/github/github-commit-agent.md +125 -117
- package/.claude/agents/goal/goal-planner.md +8 -0
- package/.claude/agents/infrastructure/README.md +100 -0
- package/.claude/agents/{specialized → infrastructure}/devops-engineer.md +131 -150
- package/.claude/agents/planners/README.md +94 -0
- package/.claude/agents/{core-agents → planners}/analyst.md +1 -22
- package/.claude/agents/{planning-team → planners}/api-designer-persona.md +8 -0
- package/.claude/agents/{core-agents → planners}/architect.md +7 -20
- package/.claude/agents/{core-agents → planners}/planner.md +0 -21
- package/.claude/agents/{planning-team → planners}/security-architect-persona.md +8 -28
- package/.claude/agents/{planning-team → planners}/system-architect-persona.md +6 -38
- package/.claude/agents/{architecture → planners}/system-architect.md +12 -17
- package/.claude/agents/product-owner-team/accessibility-advocate-persona.md +132 -161
- package/.claude/agents/product-owner-team/power-user-persona.md +149 -182
- package/.claude/agents/retrospective-analyst.md +84 -0
- package/.claude/agents/reviewers/README.md +58 -0
- package/.claude/agents/{analysis → reviewers}/code-quality-validator.md +8 -17
- package/.claude/agents/reviewers/reviewer.md +181 -0
- package/.claude/agents/sparc/architecture.md +6 -25
- package/.claude/agents/sparc/pseudocode.md +6 -0
- package/.claude/agents/sparc/refinement.md +6 -0
- package/.claude/agents/sparc/specification.md +1 -0
- package/.claude/agents/specialists/README.md +60 -0
- package/.claude/agents/{core-agents → specialists}/base-template-generator.md +8 -21
- package/.claude/agents/{specialized → specialists}/cli-agent-optimizer.md +1 -1
- package/.claude/agents/{specialized → specialists}/code-booster.md +1 -0
- package/.claude/agents/{consensus → specialists}/consensus-builder.md +1 -17
- package/.claude/agents/{specialized/mobile → specialists}/mobile-dev.md +0 -20
- package/.claude/agents/{core-agents → specialists}/performance-benchmarker.md +134 -148
- package/.claude/agents/{specialized → specialists}/rust-developer.md +1 -20
- package/.claude/agents/{specialized → specialists}/rust-enterprise-developer.md +1 -20
- package/.claude/agents/{specialized → specialists}/rust-mvp-developer.md +1 -20
- package/.claude/agents/{core-agents → specialists}/security-manager.md +68 -88
- package/.claude/agents/{security → specialists}/security-specialist-existing.md +6 -57
- package/.claude/agents/{security → specialists}/security-specialist.md +6 -30
- package/.claude/agents/{specialized/mobile → specialists}/spec-mobile-react-native.md +2 -21
- package/.claude/agents/testers/README.md +94 -0
- package/.claude/agents/{testing → testers}/e2e/playwright-agent.md +1 -20
- package/.claude/agents/{testing → testers}/interaction-tester.md +1 -20
- package/.claude/agents/{testing → testers}/playwright-tester.md +1 -1
- package/.claude/agents/testers/tester.md +139 -0
- package/.claude/agents/testers/unit/tdd-london-swarm.md +49 -0
- package/.claude/agents/testers/validation/production-validator.md +33 -0
- package/.claude/agents-ignore/cfn-loop-coordinator.md +157 -0
- package/.claude/agents-ignore/cfn-loop-coordinator.md.backup +156 -0
- package/.claude/agents-ignore/coordinator.md.backup +182 -0
- package/.claude/agents-ignore/cost-savings-cfn-loop-coordinator.md +760 -0
- package/.claude/agents-ignore/cost-savings-coordinator.md +173 -0
- package/.claude/artifacts/ace-reflections/REFLECT-001-summary.json +39 -0
- package/.claude/artifacts/ace-reflections/sprint-7_$(date -u +/"%Y%m%d_%H%M%S/").json" +47 -0
- package/.claude/commands/CFN_COORDINATOR_PARAMETERS.md +10 -10
- package/.claude/commands/cfn-loop-epic.md +3 -3
- package/.claude/commands/cfn-loop-single.md +3 -3
- package/.claude/commands/cfn-loop-sprints.md +1 -1
- package/.claude/commands/cfn-loop.md +3 -3
- package/.claude/commands/cfn-mode.md +20 -0
- package/.claude/commands/write-plan.md +104 -0
- package/.claude/data/cfn-loop.db +0 -0
- package/.claude/data/cfn_loop_logs.db +0 -0
- package/.claude/hooks/BACKUP_USAGE.md +243 -0
- package/.claude/hooks/post-edit-cfn-retrospective.sh +79 -0
- package/.claude/hooks/post-edit.sh +21 -0
- package/.claude/hooks/pre-edit-backup.sh +71 -0
- package/.claude/hooks/restore-from-backup.sh +37 -0
- package/.claude/prompts/cfn-loop-context.md +115 -0
- package/.claude/prompts/loop-specific/loop2.md +50 -0
- package/.claude/prompts/loop-specific/loop3.md +43 -0
- package/.claude/prompts/loop-specific/loop4.md +54 -0
- package/.claude/root-claude-distribute/CLAUDE.md +76 -2
- package/.claude/skills/ace-system/sprint-7-lessons.json +46 -0
- package/.claude/skills/ace-system/store-reflection.sh +33 -136
- package/.claude/skills/agent-discovery/SKILL.md +40 -0
- package/.claude/skills/agent-discovery/agents-registry-clean.json +0 -0
- package/.claude/skills/agent-discovery/agents-registry-fixed.json +19 -0
- package/.claude/skills/agent-discovery/agents-registry.json +718 -0
- package/.claude/skills/agent-discovery/discover-agents.py +175 -0
- package/.claude/skills/agent-discovery/discover-agents.sh +87 -0
- package/.claude/skills/agent-discovery/invoke-registry.sh +11 -0
- package/.claude/skills/agent-discovery/temp_script.py +0 -0
- package/.claude/skills/agent-output-processing/SKILL.md +359 -0
- package/.claude/skills/agent-selector/SKILL.md +90 -0
- package/.claude/skills/agent-selector/select-agents.sh +96 -0
- package/.claude/skills/agent-spawning/agent-selection-guide.md +1 -1
- package/.claude/skills/agent-swap/SKILL.md +36 -0
- package/.claude/skills/agent-swap/recommend-swap.sh +60 -0
- package/.claude/skills/api-validation/test-endpoints.sh +54 -0
- package/.claude/skills/automatic-memory-persistence/SKILL.md +73 -0
- package/.claude/skills/automatic-memory-persistence/persist-agent-output.sh +49 -0
- package/.claude/skills/automatic-memory-persistence/query-agent-history.sh +35 -0
- package/.claude/skills/automatic-memory-persistence/test-memory-persistence.sh +235 -0
- package/.claude/skills/cfn-loop-orchestration/README.md +41 -0
- package/.claude/skills/cfn-loop-orchestration/SKILL.md +299 -0
- package/.claude/skills/cfn-loop-orchestration/helpers/auto-tune-timeouts.sh +228 -0
- package/.claude/skills/cfn-loop-orchestration/helpers/consensus.sh +84 -0
- package/.claude/skills/cfn-loop-orchestration/helpers/deliverable-verifier.sh +71 -0
- package/.claude/skills/cfn-loop-orchestration/helpers/gate-check.sh +90 -0
- package/.claude/skills/cfn-loop-orchestration/helpers/iteration-manager.sh +87 -0
- package/.claude/skills/cfn-loop-orchestration/helpers/timeout-calculator.sh +51 -0
- package/.claude/skills/cfn-loop-orchestration/inject-loop-context.sh +41 -0
- package/.claude/skills/cfn-loop-orchestration/monitor-execution.sh +156 -0
- package/.claude/skills/cfn-loop-orchestration/orchestrate.sh +840 -0
- package/.claude/skills/cfn-loop-orchestration/security_utils.sh +99 -0
- package/.claude/skills/cfn-loop-orchestration/test-cfn-orchestration.sh +281 -0
- package/.claude/skills/cfn-loop-orchestration/test-edge-cases.sh +188 -0
- package/.claude/skills/cfn-loop-validation/SKILL.md +307 -217
- package/.claude/skills/complexity-estimator/SKILL.md +96 -0
- package/.claude/skills/complexity-estimator/estimate-complexity.sh +144 -0
- package/.claude/skills/context-pruner/SKILL.md +75 -0
- package/.claude/skills/context-pruner/prune-context.sh +73 -0
- package/.claude/skills/defense-in-depth/SKILL.md +133 -0
- package/.claude/skills/dependency-extractor/SKILL.md +35 -0
- package/.claude/skills/dependency-extractor/extract-dependencies.sh +66 -0
- package/.claude/skills/epic-decomposer/SKILL.md +44 -0
- package/.claude/skills/epic-decomposer/decompose-epic.sh +104 -0
- package/.claude/skills/improvement-recommender/SKILL.md +33 -0
- package/.claude/skills/improvement-recommender/recommend-improvements.sh +92 -0
- package/.claude/skills/intervention-detector/SKILL.md +39 -0
- package/.claude/skills/intervention-detector/detect-intervention.sh +111 -0
- package/.claude/skills/intervention-orchestrator/SKILL.md +43 -0
- package/.claude/skills/intervention-orchestrator/execute-intervention.sh +59 -0
- package/.claude/skills/loop2-output-processing/SKILL.md +163 -0
- package/.claude/skills/loop2-output-processing/execute-and-extract.sh +77 -0
- package/.claude/skills/loop2-output-processing/execute-and-extract.sh.backup +36 -0
- package/.claude/skills/loop2-output-processing/parse-feedback.sh +147 -0
- package/.claude/skills/loop2-output-processing/process-validator-output.sh +275 -0
- package/.claude/skills/loop2-output-processing/test-bug27-fix.sh +200 -0
- package/.claude/skills/loop2-output-processing/test-loop2-processing.sh +113 -0
- package/.claude/skills/loop3-output-processing/AGENT_COMPLETION_PROTOCOL.md +206 -0
- package/.claude/skills/loop3-output-processing/SKILL.md +421 -0
- package/.claude/skills/loop3-output-processing/calculate-confidence.sh +28 -0
- package/.claude/skills/loop3-output-processing/execute-and-extract.sh +85 -0
- package/.claude/skills/loop3-output-processing/parse-confidence.sh +31 -0
- package/.claude/skills/loop3-output-processing/test-agent-timeout.sh +327 -0
- package/.claude/skills/loop3-output-processing/test-loop3-processing.sh +155 -0
- package/.claude/skills/loop3-output-processing/verify-deliverables.sh +42 -0
- package/.claude/skills/pattern-extraction/SKILL.md +30 -0
- package/.claude/skills/pattern-extraction/extract-patterns.sh +80 -0
- package/.claude/skills/playbook/SKILL.md +113 -0
- package/.claude/skills/playbook/init-playbook.sh +54 -0
- package/.claude/skills/playbook/playbook.db +0 -0
- package/.claude/skills/playbook/query-playbook.sh +79 -0
- package/.claude/skills/playbook/update-playbook.sh +69 -0
- package/.claude/skills/playbook-auto-update/SKILL.md +29 -0
- package/.claude/skills/playbook-auto-update/auto-update-playbook.sh +86 -0
- package/.claude/skills/product-owner-decision/SKILL.md +332 -0
- package/.claude/skills/product-owner-decision/execute-decision.sh +176 -0
- package/.claude/skills/product-owner-decision/parse-decision.sh +66 -0
- package/.claude/skills/product-owner-decision/validate-deliverables.sh +82 -0
- package/.claude/skills/redis-coordination/LOGGING.md +260 -0
- package/.claude/skills/redis-coordination/README.md +30 -29
- package/.claude/skills/redis-coordination/SKILL.md +685 -83
- package/.claude/skills/redis-coordination/analyze-task-complexity.sh +277 -0
- package/.claude/skills/redis-coordination/cfn-loop-exec.sh +468 -0
- package/.claude/skills/redis-coordination/collect-confidence-scores.sh +179 -0
- package/.claude/skills/redis-coordination/collect-results.sh +75 -0
- package/.claude/skills/redis-coordination/data/cfn-loop.db +0 -0
- package/.claude/skills/redis-coordination/{test-orchestrator.sh → demos/test-orchestrator.sh} +25 -0
- package/.claude/skills/redis-coordination/execute-product-owner-decision.sh +258 -0
- package/.claude/skills/redis-coordination/get-agent-timeout.sh +176 -176
- package/.claude/skills/redis-coordination/invoke-waiting-mode.sh +93 -227
- package/.claude/skills/redis-coordination/invoke-waiting-mode.sh.backup-p7 +423 -0
- package/.claude/skills/redis-coordination/log-event.sh +109 -0
- package/.claude/skills/redis-coordination/monitor-cfn-violations.sh +391 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop-v3.sh +141 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh +31 -993
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup +38 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-1761167675 +1672 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-p5 +1604 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-phase1 +1550 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-phase2 +1621 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-phase3 +1621 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.bak +0 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.broken +1627 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.corrupted +80 -0
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.deprecated +1864 -0
- package/.claude/skills/redis-coordination/query-logs.sh +103 -0
- package/.claude/skills/redis-coordination/retrieve-context.sh +58 -0
- package/.claude/skills/redis-coordination/select-specialist-agent.sh +371 -0
- package/.claude/skills/redis-coordination/semantic-match-tfidf.py +252 -0
- package/.claude/skills/redis-coordination/send-heartbeat.sh +164 -72
- package/.claude/skills/redis-coordination/signal.sh +38 -0
- package/.claude/skills/redis-coordination/store-context.sh +86 -0
- package/.claude/skills/redis-coordination/test-context-injection.sh +354 -0
- package/.claude/skills/redis-coordination/test-timeout-enforcement.sh +513 -0
- package/.claude/skills/redis-coordination/tests/convert-line-endings.sh +15 -0
- package/.claude/skills/redis-coordination/tests/dlq-functionality-test.sh +101 -101
- package/.claude/skills/redis-coordination/tests/edge-cases-test.sh +98 -98
- package/.claude/skills/redis-coordination/tests/integration-test.sh +169 -169
- package/.claude/skills/redis-coordination/tests/retry-mechanism-test.sh +81 -81
- package/.claude/skills/redis-coordination/tests/run-test-suite.sh +91 -91
- package/.claude/skills/redis-coordination/tests/run-tests.sh +4 -0
- package/.claude/skills/redis-coordination/tests/test-primitives.sh +166 -0
- package/.claude/skills/redis-coordination/tests/test-utils.sh +53 -121
- package/.claude/skills/redis-coordination/tests/test_coordination_primitives.sh.deprecated +20 -0
- package/.claude/skills/redis-coordination/tests/test_utils.sh +49 -0
- package/.claude/skills/redis-coordination/v2_modularization/core_orchestration.sh +76 -0
- package/.claude/skills/redis-coordination/validate-parameters.sh +492 -0
- package/.claude/skills/retrospective-report/SKILL.md +31 -0
- package/.claude/skills/retrospective-report/generate-report.sh +101 -0
- package/.claude/skills/run-all-skill-tests.sh +124 -0
- package/.claude/skills/scope-simplifier/SKILL.md +37 -0
- package/.claude/skills/scope-simplifier/simplify-scope.sh +68 -0
- package/.claude/skills/simplified-agent-lifecycle/COST_ANALYSIS.md +49 -0
- package/.claude/skills/simplified-agent-lifecycle/DESIGN.md +98 -0
- package/.claude/skills/simplified-agent-lifecycle/MIGRATION_PLAN.md +74 -0
- package/.claude/skills/specialist-injection/SKILL.md +41 -0
- package/.claude/skills/specialist-injection/recommend-specialist.sh +57 -0
- package/.claude/skills/sprint-execution/SKILL.md +27 -0
- package/.claude/skills/sprint-execution/execute-sprint-task.sh +59 -0
- package/.claude/skills/sprint-execution/execute-sprint.sh +65 -0
- package/.claude/skills/sprint-planner/SKILL.md +37 -0
- package/.claude/skills/sprint-planner/plan-sprint.sh +85 -0
- package/.claude/skills/standardized-error-handling/SKILL.md +56 -0
- package/.claude/skills/standardized-error-handling/capture-agent-error.sh +87 -0
- package/.claude/skills/standardized-error-handling/test-error-handling.sh +166 -0
- package/.claude/skills/task-classifier/SKILL.md +94 -0
- package/.claude/skills/task-classifier/classify-task.sh +115 -0
- package/.claude/skills/validation-templates/SKILL.md +47 -0
- package/.claude/skills/validation-templates/content.json +38 -0
- package/.claude/skills/validation-templates/data.json +38 -0
- package/.claude/skills/validation-templates/design.json +38 -0
- package/.claude/skills/validation-templates/infrastructure.json +38 -0
- package/.claude/skills/validation-templates/research.json +38 -0
- package/.claude/skills/validation-templates/software.json +38 -0
- package/.claude/skills/webapp-testing/README.md +142 -0
- package/.claude/skills/webapp-testing/SCREENSHOT_NAMING_CONVENTION.md +547 -0
- package/.claude/skills/webapp-testing/SKILL.md +877 -0
- package/.claude/skills/webapp-testing/capture-screenshot.sh +238 -0
- package/.claude/skills/webapp-testing/cfn-loop-integration.sh +265 -0
- package/.claude/skills/webapp-testing/compare-screenshots.sh +199 -0
- package/.claude/skills/webapp-testing/init-storage.sh +150 -0
- package/.claude/skills/webapp-testing/set-baseline.sh +196 -0
- package/.claude/skills/webapp-testing/test-webapp-testing.sh +233 -0
- package/.claude/spawn-pattern-examples.md +3 -3
- package/CLAUDE.md +319 -45
- package/README.md +598 -251
- package/dist/agents/agent-loader.js +146 -165
- package/dist/agents/agent-loader.js.map +1 -1
- package/dist/cli/agent-command.js +2 -0
- package/dist/cli/agent-command.js.map +1 -1
- package/dist/cli/agent-definition-parser.js +7 -0
- package/dist/cli/agent-definition-parser.js.map +1 -1
- package/dist/cli/agent-executor.js +145 -11
- package/dist/cli/agent-executor.js.map +1 -1
- package/dist/cli/agent-prompt-builder.js +81 -1
- package/dist/cli/agent-prompt-builder.js.map +1 -1
- package/dist/cli/agent-spawn.js +10 -1
- package/dist/cli/agent-spawn.js.map +1 -1
- package/dist/cli/anthropic-client.js +192 -13
- package/dist/cli/anthropic-client.js.map +1 -1
- package/dist/cli/cfn-context.js +150 -0
- package/dist/cli/cfn-context.js.map +1 -1
- package/dist/cli/cfn-fork.js +159 -0
- package/dist/cli/cfn-fork.js.map +1 -0
- package/dist/cli/cli-agent-context.js +8 -3
- package/dist/cli/cli-agent-context.js.map +1 -1
- package/dist/cli/config-manager.js +109 -91
- package/dist/cli/config-manager.js.map +1 -1
- package/dist/cli/conversation-fork.js +201 -0
- package/dist/cli/conversation-fork.js.map +1 -0
- package/dist/cli/index.js +4 -0
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/tool-definitions.js +263 -0
- package/dist/cli/tool-definitions.js.map +1 -0
- package/dist/cli/tool-executor.js +247 -0
- package/dist/cli/tool-executor.js.map +1 -0
- package/dist/hello.js +8 -0
- package/dist/hello.js.map +1 -0
- package/package.json +14 -6
- package/scripts/README.md +68 -0
- package/scripts/cfn-intervention-example.sh +21 -0
- package/scripts/migrate-test-infrastructure.sh +40 -0
- package/scripts/validate-test-migration.sh +49 -0
- package/scripts/verify-no-secrets.sh +55 -0
- package/.claude/agents/architecture/system-architect.md.backup +0 -603
- package/.claude/agents/code-booster.md +0 -131
- package/.claude/agents/consensus/performance-benchmarker.md +0 -101
- package/.claude/agents/consensus/security-manager.md +0 -107
- package/.claude/agents/context-curator.md +0 -167
- package/.claude/agents/context-reflector.md +0 -65
- package/.claude/agents/core-agents/cfn-loop-coordinator.md +0 -134
- package/.claude/agents/core-agents/code-quality-validator.md +0 -149
- package/.claude/agents/core-agents/context-curator.md +0 -452
- package/.claude/agents/core-agents/context-reflector.md +0 -273
- package/.claude/agents/core-agents/cost-savings-cfn-loop-coordinator.md +0 -235
- package/.claude/agents/core-agents/tester.md +0 -170
- package/.claude/agents/development/backend-dev.md +0 -165
- package/.claude/agents/devops/devops-engineer.md +0 -148
- package/.claude/agents/frontend/interaction-tester.md +0 -139
- package/.claude/agents/frontend/react-frontend-engineer.md +0 -9
- package/.claude/agents/personas/accessibility-advocate-persona.md +0 -107
- package/.claude/agents/testing/production-validator.md +0 -179
- package/.claude/agents/testing/tdd-london-swarm.md +0 -209
- package/.claude/agents/testing/unit/tdd-london-swarm.md +0 -43
- package/.claude/agents/testing/validation/production-validator.md +0 -43
- package/.claude/api-configs/config-current-zai-config.env +0 -62
- package/.claude/api-configs/config-test-zai-config.env +0 -62
- package/.claude/api-configs/env-backups/before-anthropic-20251020-025404.env +0 -62
- package/.claude/api-configs/env-backups/before-restore-20251020-025431.env +0 -62
- package/.claude/skills/redis-coordination/orchestrate-cfn-loop.sh.backup-1760949407 +0 -933
- package/dist/cli/cli-agent-context.test.js +0 -451
- package/dist/cli/cli-agent-context.test.js.map +0 -1
- package/dist/coordination/fleet-manager.test.js +0 -141
- package/dist/coordination/fleet-manager.test.js.map +0 -1
- package/dist/middleware/transparency-middleware.test.js +0 -184
- package/dist/middleware/transparency-middleware.test.js.map +0 -1
- /package/.claude/agents/{core-agents → developers}/researcher.md +0 -0
- /package/.claude/agents/{consensus → specialists}/crdt-synchronizer.md +0 -0
- /package/.claude/agents/{consensus → specialists}/quorum-manager.md +0 -0
- /package/.claude/agents/{consensus → specialists}/raft-manager.md +0 -0
- /package/.claude/{agents/core-agents → agents-ignore}/coordinator.md +0 -0
- /package/.claude/{agents/core-agents/cost-savings-coordinator.md → agents-ignore/cost-savings-coordinator.md.backup} +0 -0
- /package/.claude/skills/redis-coordination/{phase4-wake-queue-test-report.md → demos/phase4-wake-queue-test-report.md} +0 -0
- /package/.claude/skills/redis-coordination/{test-bzpopmin-fix.sh → demos/test-bzpopmin-fix.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-cancel-swarm.sh → demos/test-cancel-swarm.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-dlq.sh → demos/test-dlq.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-iteration-feedback.sh → demos/test-iteration-feedback.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-priority-wake-phase4-unix.sh → demos/test-priority-wake-phase4-unix.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-priority-wake-phase4.sh → demos/test-priority-wake-phase4.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-priority-wake.sh → demos/test-priority-wake.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-quick-fix.sh → demos/test-quick-fix.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-quorum-absolute.sh → demos/test-quorum-absolute.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-quorum-fallback.sh → demos/test-quorum-fallback.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-quorum-percentage.sh → demos/test-quorum-percentage.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-quorum-with-retry.sh → demos/test-quorum-with-retry.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-quorum.sh → demos/test-quorum.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-shutdown-handling.sh → demos/test-shutdown-handling.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-shutdown.sh → demos/test-shutdown.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-utils-unix.sh → demos/test-utils-unix.sh} +0 -0
- /package/.claude/skills/redis-coordination/{test-utils.sh → demos/test-utils.sh} +0 -0
- /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
|
|
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
|
-
| `
|
|
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("
|
|
163
|
+
Task("cfn-v3-coordinator", `
|
|
125
164
|
Execute CFN Loop for: Implement authentication
|
|
126
165
|
|
|
127
166
|
Coordinator will:
|
|
128
|
-
1. Invoke
|
|
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/
|
|
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("
|
|
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/
|
|
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. **
|
|
414
|
-
-
|
|
415
|
-
-
|
|
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 `
|
|
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
|
|
476
|
-
|
|
477
|
-
### Strategy
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
- **
|
|
481
|
-
- **
|
|
482
|
-
|
|
483
|
-
-
|
|
484
|
-
- **
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
-
|
|
490
|
-
- **
|
|
491
|
-
- **
|
|
492
|
-
- **
|
|
493
|
-
- **
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
- **
|
|
499
|
-
- **
|
|
500
|
-
- **
|
|
501
|
-
- **
|
|
502
|
-
- **
|
|
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
|