agentic-qe 3.7.15 → 3.7.17

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 (301) hide show
  1. package/.claude/agents/v3/qe-devils-advocate.md +20 -0
  2. package/.claude/agents/v3/qe-gap-detector.md +25 -0
  3. package/.claude/agents/v3/qe-quality-gate.md +8 -0
  4. package/.claude/agents/v3/qe-requirements-validator.md +25 -0
  5. package/.claude/agents/v3/subagents/qe-code-reviewer.md +11 -0
  6. package/.claude/agents/v3/subagents/qe-integration-reviewer.md +11 -0
  7. package/.claude/agents/v3/subagents/qe-performance-reviewer.md +11 -0
  8. package/.claude/agents/v3/subagents/qe-security-reviewer.md +11 -0
  9. package/.claude/helpers/adr-compliance.sh +10 -10
  10. package/.claude/helpers/auto-memory-hook.mjs +24 -9
  11. package/.claude/helpers/brain-checkpoint.cjs +55 -134
  12. package/.claude/helpers/ddd-tracker.sh +2 -2
  13. package/.claude/helpers/guidance-hooks.sh +2 -2
  14. package/.claude/helpers/hook-handler.cjs +57 -18
  15. package/.claude/helpers/statusline.cjs +414 -595
  16. package/.claude/helpers/v3/quality-criteria/evidence-classification.md +116 -116
  17. package/.claude/helpers/v3/quality-criteria/htsm-categories.md +139 -139
  18. package/.claude/skills/README.md +8 -11
  19. package/.claude/skills/brutal-honesty-review/SKILL.md +3 -0
  20. package/.claude/skills/code-review-quality/SKILL.md +3 -0
  21. package/.claude/skills/qcsd-cicd-swarm/SKILL.md +79 -2075
  22. package/.claude/skills/qcsd-cicd-swarm/steps/01-flag-detection.md +62 -0
  23. package/.claude/skills/qcsd-cicd-swarm/steps/02-core-agents.md +33 -0
  24. package/.claude/skills/qcsd-cicd-swarm/steps/03-batch1-results.md +21 -0
  25. package/.claude/skills/qcsd-cicd-swarm/steps/04-conditional-agents.md +23 -0
  26. package/.claude/skills/qcsd-cicd-swarm/steps/05-decision-synthesis.md +30 -0
  27. package/.claude/skills/qcsd-cicd-swarm/steps/06-report-generation.md +17 -0
  28. package/.claude/skills/qcsd-cicd-swarm/steps/07-learning-persistence.md +27 -0
  29. package/.claude/skills/qcsd-cicd-swarm/steps/08-deployment-advisor.md +25 -0
  30. package/.claude/skills/qcsd-cicd-swarm/steps/09-final-output.md +16 -0
  31. package/.claude/skills/qcsd-development-swarm/SKILL.md +79 -2027
  32. package/.claude/skills/qcsd-development-swarm/steps/01-flag-detection.md +50 -0
  33. package/.claude/skills/qcsd-development-swarm/steps/02-core-agents.md +29 -0
  34. package/.claude/skills/qcsd-development-swarm/steps/03-batch1-results.md +14 -0
  35. package/.claude/skills/qcsd-development-swarm/steps/04-conditional-agents.md +23 -0
  36. package/.claude/skills/qcsd-development-swarm/steps/05-decision-synthesis.md +30 -0
  37. package/.claude/skills/qcsd-development-swarm/steps/06-report-generation.md +16 -0
  38. package/.claude/skills/qcsd-development-swarm/steps/07-learning-persistence.md +25 -0
  39. package/.claude/skills/qcsd-development-swarm/steps/08-defect-predictor.md +25 -0
  40. package/.claude/skills/qcsd-development-swarm/steps/09-final-output.md +16 -0
  41. package/.claude/skills/qcsd-ideation-swarm/SKILL.md +94 -1894
  42. package/.claude/skills/qcsd-ideation-swarm/steps/01-flag-detection.md +57 -0
  43. package/.claude/skills/qcsd-ideation-swarm/steps/02-core-agents.md +29 -0
  44. package/.claude/skills/qcsd-ideation-swarm/steps/03-batch1-results.md +15 -0
  45. package/.claude/skills/qcsd-ideation-swarm/steps/04-conditional-agents.md +23 -0
  46. package/.claude/skills/qcsd-ideation-swarm/steps/05-decision-synthesis.md +29 -0
  47. package/.claude/skills/qcsd-ideation-swarm/steps/06-report-generation.md +18 -0
  48. package/.claude/skills/qcsd-ideation-swarm/steps/07-learning-persistence.md +29 -0
  49. package/.claude/skills/qcsd-ideation-swarm/steps/08-final-output.md +18 -0
  50. package/.claude/skills/qcsd-production-swarm/SKILL.md +88 -2663
  51. package/.claude/skills/qcsd-production-swarm/steps/01-flag-detection.md +206 -0
  52. package/.claude/skills/qcsd-production-swarm/steps/02-core-agents.md +428 -0
  53. package/.claude/skills/qcsd-production-swarm/steps/03-batch1-results.md +101 -0
  54. package/.claude/skills/qcsd-production-swarm/steps/04-conditional-agents.md +125 -0
  55. package/.claude/skills/qcsd-production-swarm/steps/05-decision-synthesis.md +136 -0
  56. package/.claude/skills/qcsd-production-swarm/steps/06-report-generation.md +181 -0
  57. package/.claude/skills/qcsd-production-swarm/steps/07-learning-persistence.md +185 -0
  58. package/.claude/skills/qcsd-production-swarm/steps/08-feedback-loop.md +122 -0
  59. package/.claude/skills/qcsd-production-swarm/steps/09-final-output.md +140 -0
  60. package/.claude/skills/qcsd-refinement-swarm/SKILL.md +59 -2312
  61. package/.claude/skills/qcsd-refinement-swarm/steps/01-flag-detection.md +91 -0
  62. package/.claude/skills/qcsd-refinement-swarm/steps/02-core-agents.md +40 -0
  63. package/.claude/skills/qcsd-refinement-swarm/steps/03-batch1-results.md +40 -0
  64. package/.claude/skills/qcsd-refinement-swarm/steps/04-conditional-agents.md +35 -0
  65. package/.claude/skills/qcsd-refinement-swarm/steps/05-decision-synthesis.md +43 -0
  66. package/.claude/skills/qcsd-refinement-swarm/steps/06-report-generation.md +42 -0
  67. package/.claude/skills/qcsd-refinement-swarm/steps/07-learning-persistence.md +53 -0
  68. package/.claude/skills/qcsd-refinement-swarm/steps/08-transformation.md +36 -0
  69. package/.claude/skills/qcsd-refinement-swarm/steps/09-final-output.md +46 -0
  70. package/.claude/skills/sherlock-review/SKILL.md +3 -0
  71. package/.claude/skills/skill-builder/SKILL.md +103 -0
  72. package/.claude/skills/skills-manifest.json +1 -1
  73. package/CHANGELOG.md +44 -0
  74. package/assets/agents/v3/qe-devils-advocate.md +20 -0
  75. package/assets/agents/v3/qe-gap-detector.md +25 -0
  76. package/assets/agents/v3/qe-quality-gate.md +8 -0
  77. package/assets/agents/v3/qe-requirements-validator.md +25 -0
  78. package/assets/agents/v3/subagents/qe-code-reviewer.md +11 -0
  79. package/assets/agents/v3/subagents/qe-integration-reviewer.md +11 -0
  80. package/assets/agents/v3/subagents/qe-performance-reviewer.md +11 -0
  81. package/assets/agents/v3/subagents/qe-security-reviewer.md +11 -0
  82. package/assets/helpers/statusline-v3.cjs +693 -0
  83. package/assets/skills/brutal-honesty-review/SKILL.md +3 -0
  84. package/assets/skills/code-review-quality/SKILL.md +3 -0
  85. package/assets/skills/qcsd-cicd-swarm/SKILL.md +79 -2075
  86. package/assets/skills/qcsd-cicd-swarm/steps/01-flag-detection.md +62 -0
  87. package/assets/skills/qcsd-cicd-swarm/steps/02-core-agents.md +33 -0
  88. package/assets/skills/qcsd-cicd-swarm/steps/03-batch1-results.md +21 -0
  89. package/assets/skills/qcsd-cicd-swarm/steps/04-conditional-agents.md +23 -0
  90. package/assets/skills/qcsd-cicd-swarm/steps/05-decision-synthesis.md +30 -0
  91. package/assets/skills/qcsd-cicd-swarm/steps/06-report-generation.md +17 -0
  92. package/assets/skills/qcsd-cicd-swarm/steps/07-learning-persistence.md +27 -0
  93. package/assets/skills/qcsd-cicd-swarm/steps/08-deployment-advisor.md +25 -0
  94. package/assets/skills/qcsd-cicd-swarm/steps/09-final-output.md +16 -0
  95. package/assets/skills/qcsd-development-swarm/SKILL.md +79 -2027
  96. package/assets/skills/qcsd-development-swarm/steps/01-flag-detection.md +50 -0
  97. package/assets/skills/qcsd-development-swarm/steps/02-core-agents.md +29 -0
  98. package/assets/skills/qcsd-development-swarm/steps/03-batch1-results.md +14 -0
  99. package/assets/skills/qcsd-development-swarm/steps/04-conditional-agents.md +23 -0
  100. package/assets/skills/qcsd-development-swarm/steps/05-decision-synthesis.md +30 -0
  101. package/assets/skills/qcsd-development-swarm/steps/06-report-generation.md +16 -0
  102. package/assets/skills/qcsd-development-swarm/steps/07-learning-persistence.md +25 -0
  103. package/assets/skills/qcsd-development-swarm/steps/08-defect-predictor.md +25 -0
  104. package/assets/skills/qcsd-development-swarm/steps/09-final-output.md +16 -0
  105. package/assets/skills/qcsd-ideation-swarm/SKILL.md +94 -1894
  106. package/assets/skills/qcsd-ideation-swarm/steps/01-flag-detection.md +57 -0
  107. package/assets/skills/qcsd-ideation-swarm/steps/02-core-agents.md +29 -0
  108. package/assets/skills/qcsd-ideation-swarm/steps/03-batch1-results.md +15 -0
  109. package/assets/skills/qcsd-ideation-swarm/steps/04-conditional-agents.md +23 -0
  110. package/assets/skills/qcsd-ideation-swarm/steps/05-decision-synthesis.md +29 -0
  111. package/assets/skills/qcsd-ideation-swarm/steps/06-report-generation.md +18 -0
  112. package/assets/skills/qcsd-ideation-swarm/steps/07-learning-persistence.md +29 -0
  113. package/assets/skills/qcsd-ideation-swarm/steps/08-final-output.md +18 -0
  114. package/assets/skills/qcsd-production-swarm/SKILL.md +88 -2663
  115. package/assets/skills/qcsd-production-swarm/steps/01-flag-detection.md +206 -0
  116. package/assets/skills/qcsd-production-swarm/steps/02-core-agents.md +428 -0
  117. package/assets/skills/qcsd-production-swarm/steps/03-batch1-results.md +101 -0
  118. package/assets/skills/qcsd-production-swarm/steps/04-conditional-agents.md +125 -0
  119. package/assets/skills/qcsd-production-swarm/steps/05-decision-synthesis.md +136 -0
  120. package/assets/skills/qcsd-production-swarm/steps/06-report-generation.md +181 -0
  121. package/assets/skills/qcsd-production-swarm/steps/07-learning-persistence.md +185 -0
  122. package/assets/skills/qcsd-production-swarm/steps/08-feedback-loop.md +122 -0
  123. package/assets/skills/qcsd-production-swarm/steps/09-final-output.md +140 -0
  124. package/assets/skills/qcsd-refinement-swarm/SKILL.md +59 -2312
  125. package/assets/skills/qcsd-refinement-swarm/steps/01-flag-detection.md +91 -0
  126. package/assets/skills/qcsd-refinement-swarm/steps/02-core-agents.md +40 -0
  127. package/assets/skills/qcsd-refinement-swarm/steps/03-batch1-results.md +40 -0
  128. package/assets/skills/qcsd-refinement-swarm/steps/04-conditional-agents.md +35 -0
  129. package/assets/skills/qcsd-refinement-swarm/steps/05-decision-synthesis.md +43 -0
  130. package/assets/skills/qcsd-refinement-swarm/steps/06-report-generation.md +42 -0
  131. package/assets/skills/qcsd-refinement-swarm/steps/07-learning-persistence.md +53 -0
  132. package/assets/skills/qcsd-refinement-swarm/steps/08-transformation.md +36 -0
  133. package/assets/skills/qcsd-refinement-swarm/steps/09-final-output.md +46 -0
  134. package/assets/skills/sherlock-review/SKILL.md +3 -0
  135. package/assets/templates/agent-override-example.yaml +39 -0
  136. package/dist/agents/devils-advocate/agent.d.ts +25 -1
  137. package/dist/agents/devils-advocate/agent.js +108 -4
  138. package/dist/agents/devils-advocate/types.d.ts +54 -0
  139. package/dist/agents/devils-advocate/types.js +14 -0
  140. package/dist/agents/overlay-loader.d.ts +28 -0
  141. package/dist/agents/overlay-loader.js +232 -0
  142. package/dist/agents/overlay-schema.d.ts +56 -0
  143. package/dist/agents/overlay-schema.js +77 -0
  144. package/dist/analysis/branch-enumerator.d.ts +68 -0
  145. package/dist/analysis/branch-enumerator.js +393 -0
  146. package/dist/analysis/index.d.ts +2 -0
  147. package/dist/analysis/index.js +2 -0
  148. package/dist/cli/bundle.js +2469 -634
  149. package/dist/cli/commands/coverage.js +50 -0
  150. package/dist/cli/handlers/brain-handler.js +2 -1
  151. package/dist/context/compiler.d.ts +62 -0
  152. package/dist/context/compiler.js +143 -0
  153. package/dist/context/index.d.ts +8 -0
  154. package/dist/context/index.js +6 -0
  155. package/dist/context/sources/coverage-source.d.ts +15 -0
  156. package/dist/context/sources/coverage-source.js +77 -0
  157. package/dist/context/sources/git-source.d.ts +12 -0
  158. package/dist/context/sources/git-source.js +33 -0
  159. package/dist/context/sources/index.d.ts +6 -0
  160. package/dist/context/sources/index.js +5 -0
  161. package/dist/context/sources/memory-source.d.ts +17 -0
  162. package/dist/context/sources/memory-source.js +94 -0
  163. package/dist/context/sources/test-source.d.ts +13 -0
  164. package/dist/context/sources/test-source.js +53 -0
  165. package/dist/context/sources/types.d.ts +42 -0
  166. package/dist/context/sources/types.js +5 -0
  167. package/dist/domains/test-generation/coordinator.js +6 -4
  168. package/dist/feedback/feedback-loop.d.ts +5 -0
  169. package/dist/feedback/feedback-loop.js +12 -0
  170. package/dist/feedback/index.d.ts +1 -1
  171. package/dist/feedback/index.js +1 -1
  172. package/dist/init/agents-installer.d.ts +9 -0
  173. package/dist/init/agents-installer.js +72 -0
  174. package/dist/init/phases/07-hooks.d.ts +11 -0
  175. package/dist/init/phases/07-hooks.js +67 -0
  176. package/dist/init/phases/09-assets.js +3 -0
  177. package/dist/init/settings-merge.js +1 -1
  178. package/dist/kernel/hnsw-adapter.d.ts +3 -0
  179. package/dist/kernel/hnsw-adapter.js +11 -1
  180. package/dist/kernel/unified-memory-schemas.d.ts +1 -1
  181. package/dist/kernel/unified-memory-schemas.js +2 -0
  182. package/dist/kernel/unified-memory.js +25 -0
  183. package/dist/learning/experience-capture-middleware.js +24 -0
  184. package/dist/learning/sqlite-persistence.d.ts +3 -0
  185. package/dist/learning/sqlite-persistence.js +9 -0
  186. package/dist/learning/token-tracker.js +4 -0
  187. package/dist/mcp/bundle.js +3694 -3101
  188. package/dist/mcp/handlers/handler-factory.js +92 -11
  189. package/dist/mcp/services/task-router.d.ts +11 -0
  190. package/dist/mcp/services/task-router.js +26 -0
  191. package/dist/routing/qe-agent-registry.d.ts +11 -0
  192. package/dist/routing/qe-agent-registry.js +34 -0
  193. package/dist/routing/qe-task-router.d.ts +1 -0
  194. package/dist/routing/qe-task-router.js +34 -2
  195. package/dist/routing/routing-feedback.d.ts +5 -0
  196. package/dist/routing/routing-feedback.js +29 -3
  197. package/dist/routing/types.d.ts +2 -0
  198. package/dist/sync/pull-agent.js +2 -1
  199. package/dist/test-scheduling/pipeline.d.ts +7 -0
  200. package/dist/test-scheduling/pipeline.js +9 -0
  201. package/dist/validation/index.d.ts +3 -0
  202. package/dist/validation/index.js +10 -0
  203. package/dist/validation/pipeline.d.ts +80 -0
  204. package/dist/validation/pipeline.js +173 -0
  205. package/dist/validation/steps/requirements.d.ts +32 -0
  206. package/dist/validation/steps/requirements.js +596 -0
  207. package/package.json +6 -6
  208. package/.claude/agents/consensus/README.md +0 -253
  209. package/.claude/agents/deprecated/qe-api-contract-validator.md.v2 +0 -162
  210. package/.claude/agents/deprecated/qe-coverage-analyzer.md.v2 +0 -208
  211. package/.claude/agents/deprecated/qe-test-generator.md.v2 +0 -212
  212. package/.claude/agents/deprecated/qe-visual-tester.md.v2 +0 -216
  213. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +0 -130
  214. package/.claude/agents/hive-mind/queen-coordinator.md +0 -203
  215. package/.claude/agents/hive-mind/scout-explorer.md +0 -242
  216. package/.claude/agents/hive-mind/swarm-memory-manager.md +0 -193
  217. package/.claude/agents/hive-mind/worker-specialist.md +0 -217
  218. package/.claude/agents/neural/safla-neural.md +0 -74
  219. package/.claude/agents/optimization/README.md +0 -250
  220. package/.claude/agents/reasoning/agent.md +0 -816
  221. package/.claude/agents/reasoning/goal-planner.md +0 -73
  222. package/.claude/agents/subagents/qe-code-reviewer.md +0 -76
  223. package/.claude/agents/subagents/qe-coverage-gap-analyzer.md +0 -76
  224. package/.claude/agents/subagents/qe-data-generator.md +0 -77
  225. package/.claude/agents/subagents/qe-flaky-investigator.md +0 -91
  226. package/.claude/agents/subagents/qe-integration-tester.md +0 -90
  227. package/.claude/agents/subagents/qe-performance-validator.md +0 -92
  228. package/.claude/agents/subagents/qe-security-auditor.md +0 -94
  229. package/.claude/agents/subagents/qe-test-data-architect-sub.md +0 -93
  230. package/.claude/agents/subagents/qe-test-implementer.md +0 -106
  231. package/.claude/agents/subagents/qe-test-refactorer.md +0 -117
  232. package/.claude/agents/subagents/qe-test-writer.md +0 -112
  233. package/.claude/agents/swarm/README.md +0 -190
  234. package/.claude/agents/templates/migration-plan.md +0 -746
  235. package/.claude/agents/testing/unit/tdd-london-swarm.md +0 -244
  236. package/.claude/agents/testing/validation/production-validator.md +0 -395
  237. package/.claude/agents/v3/README.md +0 -39
  238. package/.claude/agents/v3/typescript-specialist.yaml +0 -21
  239. package/.claude/agents/v3/v3-memory-specialist.md +0 -318
  240. package/.claude/agents/v3/v3-performance-engineer.md +0 -397
  241. package/.claude/agents/v3/v3-queen-coordinator.md +0 -98
  242. package/.claude/agents/v3/v3-security-architect.md +0 -174
  243. package/.claude/commands/README.md +0 -106
  244. package/.claude/commands/agents/README.md +0 -10
  245. package/.claude/commands/agents/agent-capabilities.md +0 -21
  246. package/.claude/commands/agents/agent-coordination.md +0 -28
  247. package/.claude/commands/agents/agent-spawning.md +0 -28
  248. package/.claude/commands/agents/agent-types.md +0 -26
  249. package/.claude/commands/coordination/README.md +0 -9
  250. package/.claude/commands/coordination/agent-spawn.md +0 -25
  251. package/.claude/commands/coordination/init.md +0 -44
  252. package/.claude/commands/coordination/orchestrate.md +0 -43
  253. package/.claude/commands/coordination/spawn.md +0 -45
  254. package/.claude/commands/coordination/swarm-init.md +0 -85
  255. package/.claude/commands/coordination/task-orchestrate.md +0 -25
  256. package/.claude/commands/hive-mind/README.md +0 -17
  257. package/.claude/commands/hive-mind/hive-mind-consensus.md +0 -8
  258. package/.claude/commands/hive-mind/hive-mind-init.md +0 -18
  259. package/.claude/commands/hive-mind/hive-mind-memory.md +0 -8
  260. package/.claude/commands/hive-mind/hive-mind-metrics.md +0 -8
  261. package/.claude/commands/hive-mind/hive-mind-resume.md +0 -8
  262. package/.claude/commands/hive-mind/hive-mind-sessions.md +0 -8
  263. package/.claude/commands/hive-mind/hive-mind-spawn.md +0 -21
  264. package/.claude/commands/hive-mind/hive-mind-status.md +0 -8
  265. package/.claude/commands/hive-mind/hive-mind-stop.md +0 -8
  266. package/.claude/commands/hive-mind/hive-mind-wizard.md +0 -8
  267. package/.claude/commands/hive-mind/hive-mind.md +0 -27
  268. package/.claude/commands/memory/README.md +0 -9
  269. package/.claude/commands/memory/memory-persist.md +0 -25
  270. package/.claude/commands/memory/memory-search.md +0 -25
  271. package/.claude/commands/memory/memory-usage.md +0 -25
  272. package/.claude/commands/memory/neural.md +0 -47
  273. package/.claude/commands/swarm/README.md +0 -15
  274. package/.claude/commands/swarm/swarm-analysis.md +0 -8
  275. package/.claude/commands/swarm/swarm-background.md +0 -8
  276. package/.claude/commands/swarm/swarm-init.md +0 -19
  277. package/.claude/commands/swarm/swarm-modes.md +0 -8
  278. package/.claude/commands/swarm/swarm-monitor.md +0 -8
  279. package/.claude/commands/swarm/swarm-spawn.md +0 -19
  280. package/.claude/commands/swarm/swarm-status.md +0 -8
  281. package/.claude/commands/swarm/swarm-strategies.md +0 -8
  282. package/.claude/commands/swarm/swarm.md +0 -27
  283. package/.claude/commands/training/README.md +0 -9
  284. package/.claude/commands/training/model-update.md +0 -25
  285. package/.claude/commands/training/neural-patterns.md +0 -74
  286. package/.claude/commands/training/neural-train.md +0 -25
  287. package/.claude/commands/training/pattern-learn.md +0 -25
  288. package/.claude/commands/training/specialization.md +0 -63
  289. package/.claude/commands/workflows/README.md +0 -9
  290. package/.claude/commands/workflows/development.md +0 -78
  291. package/.claude/commands/workflows/research.md +0 -63
  292. package/.claude/commands/workflows/workflow-create.md +0 -25
  293. package/.claude/commands/workflows/workflow-execute.md +0 -25
  294. package/.claude/commands/workflows/workflow-export.md +0 -25
  295. package/.claude/skills/agentic-jujutsu/SKILL.md +0 -645
  296. package/.claude/skills/hive-mind-advanced/SKILL.md +0 -712
  297. package/.claude/skills/iterative-loop/SKILL.md +0 -371
  298. package/.claude/skills/performance-analysis/SKILL.md +0 -569
  299. package/.claude/skills/performance-analysis/evals/performance-analysis.yaml +0 -144
  300. package/.claude/skills/performance-analysis/schemas/output.json +0 -588
  301. package/.claude/skills/performance-analysis/scripts/validate-config.json +0 -36
@@ -1,93 +0,0 @@
1
- ---
2
- name: qe-test-data-architect-sub
3
- description: "Designs and generates high-volume test datasets with relationship preservation"
4
- parent: qe-test-data-architect
5
- ---
6
-
7
- <qe_subagent_definition>
8
- <identity>
9
- You are QE Test Data Architect Sub, a specialized subagent for generating sophisticated test datasets.
10
- Role: Create schema-aware datasets with referential integrity, edge cases, and high-volume streaming support.
11
- </identity>
12
-
13
- <implementation_status>
14
- ✅ Working: Schema-aware generation, relationship graphs, edge case synthesis, streaming for large datasets
15
- ⚠️ Partial: GDPR compliance masking, cross-database synchronization
16
- </implementation_status>
17
-
18
- <default_to_action>
19
- Generate datasets immediately when schema is provided.
20
- Preserve referential integrity automatically across all relationships.
21
- Include edge cases (boundary, null, injection) at configured density.
22
- Stream large datasets in chunks to prevent memory exhaustion.
23
- </default_to_action>
24
-
25
- <capabilities>
26
- - **Schema-Aware Generation**: Topological sort by dependencies, foreign key resolution, type-based field generation
27
- - **Relationship Graphs**: One-to-one, one-to-many, many-to-many with uniform/normal/zipf distributions
28
- - **Edge Case Synthesis**: Boundary values, null handling, special characters, unicode, overflow, injection patterns
29
- - **High-Volume Streaming**: Generate 10k+ records/sec with chunk-based memory management
30
- - **Size Presets**: small (100 users), medium (10K), large (100K), stress (1M+)
31
- - **Output Formats**: JSON, CSV, SQL with optional compression and partitioning
32
- </capabilities>
33
-
34
- <memory_namespace>
35
- Reads: aqe/test-data-arch/cycle-{cycleId}/context (schema, generation config)
36
- Writes: aqe/test-data-arch/cycle-{cycleId}/output/complete (dataset, statistics, edge-case report)
37
- Progress: aqe/test-data-arch/cycle-{cycleId}/generation/progress
38
- </memory_namespace>
39
-
40
- <output_format>
41
- Returns summary (entities generated, total records, integrity valid), dataset location, statistics by entity, relationship verification (orphans, duplicates), edge case report with samples, performance metrics (throughput, memory peak).
42
- </output_format>
43
-
44
- <examples>
45
- Example: Generate e-commerce dataset
46
- ```
47
- Input: Schema with users, orders, products; size: medium; edge cases: 5% density
48
- Output:
49
- - Generated: 10,000 users, 50,000 orders, 1,000 products
50
- - Relationships: 100% integrity, 0 orphans
51
- - Edge Cases: 2,500 boundary/null/injection records
52
- - Throughput: 12,450 records/sec
53
- - Location: /tmp/dataset-{cycleId}.json.gz
54
- ```
55
- </examples>
56
-
57
- <coordination>
58
- Reports to: qe-test-data-architect, qe-integration-orchestrator
59
- Triggers: When test data generation is requested with schema definition
60
- Handoff: Store dataset in memory namespace, emit `test-data-architect-sub:completed` event
61
- </coordination>
62
-
63
- <learning_protocol>
64
- **⚠️ MANDATORY**: After completing your task, call learning MCP tools.
65
-
66
- **Store Experience:**
67
- ```typescript
68
- mcp__agentic-qe__learning_store_experience({
69
- agentId: "qe-test-data-architect-sub",
70
- taskType: "test-data-architecture",
71
- reward: <calculated_reward>, // 0.0-1.0
72
- outcome: { /* task-specific results */ },
73
- metadata: { phase: "DATA_ARCHITECTURE", cycleId: "<cycleId>" }
74
- })
75
- ```
76
-
77
- **Store Artifacts:**
78
- ```typescript
79
- mcp__agentic-qe__memory_store({
80
- key: "aqe/test-data-arch/<task_id>",
81
- value: { /* task artifacts */ },
82
- namespace: "aqe",
83
- persist: true
84
- })
85
- ```
86
-
87
- **Reward Criteria:**
88
- - 1.0: 100% referential integrity, high throughput (>10k rec/sec), comprehensive edge cases, proper streaming
89
- - 0.7: Good integrity (no orphans), acceptable throughput, edge cases included
90
- - 0.5: Minor integrity issues, adequate throughput, basic edge case coverage
91
- - 0.0: Broken relationships, low throughput, or missing edge cases
92
- </learning_protocol>
93
- </qe_subagent_definition>
@@ -1,106 +0,0 @@
1
- ---
2
- name: qe-test-implementer
3
- description: "TDD GREEN phase specialist - implements minimal code to make failing tests pass"
4
- parent: qe-test-generator
5
- ---
6
-
7
- <qe_subagent_definition>
8
- <identity>
9
- You are QE Test Implementer, the TDD GREEN phase specialist.
10
- Role: Write MINIMAL code to make RED phase tests pass. No optimization, no extras - just enough to satisfy tests.
11
- Position: RED → GREEN → REFACTOR (You handle GREEN phase)
12
- </identity>
13
-
14
- <implementation_status>
15
- ✅ Working: Minimal implementation, test-driven coding, incremental development, YAGNI enforcement
16
- ⚠️ Partial: Complex async pattern implementation, database transaction handling
17
- </implementation_status>
18
-
19
- <default_to_action>
20
- Read RED phase tests from memory namespace.
21
- Implement MINIMAL code to make each test pass - nothing more.
22
- Run tests after each implementation to verify GREEN status.
23
- Block handoff if ANY test still fails.
24
- Follow YAGNI: You Aren't Gonna Need It.
25
- </default_to_action>
26
-
27
- <capabilities>
28
- - **Minimal Implementation**: Simplest code that makes tests pass (can be refined in REFACTOR)
29
- - **Test-Driven Coding**: Derive function signatures and logic from test expectations
30
- - **Incremental Development**: Implement one test at a time, sorted by complexity
31
- - **YAGNI Enforcement**: No premature optimization, no features beyond test requirements
32
- - **Regression Prevention**: Run all previous tests after each new implementation
33
- </capabilities>
34
-
35
- <memory_namespace>
36
- Reads: aqe/tdd/cycle-{cycleId}/context, aqe/tdd/cycle-{cycleId}/red/tests (testFile, tests, validation)
37
- Writes: aqe/tdd/cycle-{cycleId}/green/impl (implFile path/content/hash, validation)
38
- Validates: testFile.hash unchanged from RED phase (tests must not be modified)
39
- </memory_namespace>
40
-
41
- <output_format>
42
- Returns GREENPhaseOutput: cycleId, phase: "GREEN", testFile (path, hash - same as RED), implFile (path, content, hash), implementation (className, methods array), validation (allTestsPassing: true, passCount, totalCount, coverage), nextPhase: "REFACTOR", readyForHandoff: boolean.
43
- </output_format>
44
-
45
- <examples>
46
- Example: Implement OAuth2 authentication (GREEN phase)
47
- ```typescript
48
- // RED phase test expects: { success: true, sessionId: string, userId: string }
49
-
50
- // GREEN phase implementation (minimal):
51
- class AuthService {
52
- async authenticateWithOAuth2(token: string) {
53
- if (!token) return { success: false, error: 'NO_TOKEN' };
54
-
55
- const decoded = JSON.parse(Buffer.from(token, 'base64').toString());
56
-
57
- return {
58
- success: true,
59
- sessionId: Date.now().toString() + Math.random().toString(36),
60
- userId: decoded.userId
61
- };
62
- }
63
- }
64
- // Result: Tests PASS ✓ (minimal implementation)
65
- // Note: No error handling, no optimization - that's REFACTOR phase
66
- ```
67
- </examples>
68
-
69
- <coordination>
70
- Reports to: qe-test-generator, qe-code-reviewer
71
- Receives from: qe-test-writer (RED phase output with failing tests)
72
- Handoff: Store GREEN output in memory, emit `test-implementer:completed`, qe-test-refactorer picks up
73
- Validation: readyForHandoff=true ONLY if allTestsPassing=true AND testFile.hash unchanged
74
- </coordination>
75
-
76
- <learning_protocol>
77
- **⚠️ MANDATORY**: After completing your task, call learning MCP tools.
78
-
79
- **Store Experience:**
80
- ```typescript
81
- mcp__agentic-qe__learning_store_experience({
82
- agentId: "qe-test-implementer",
83
- taskType: "tdd-green-phase",
84
- reward: <calculated_reward>, // 0.0-1.0
85
- outcome: { /* task-specific results */ },
86
- metadata: { phase: "GREEN", cycleId: "<cycleId>" }
87
- })
88
- ```
89
-
90
- **Store Artifacts:**
91
- ```typescript
92
- mcp__agentic-qe__memory_store({
93
- key: "aqe/tdd/green/<task_id>",
94
- value: { /* task artifacts */ },
95
- namespace: "aqe",
96
- persist: true
97
- })
98
- ```
99
-
100
- **Reward Criteria:**
101
- - 1.0: All tests pass, minimal implementation, YAGNI enforced, no test modifications
102
- - 0.7: All tests pass, slightly over-engineered, tests unchanged
103
- - 0.5: Tests pass but implementation too complex or tests were modified
104
- - 0.0: Tests still failing or test file hash changed
105
- </learning_protocol>
106
- </qe_subagent_definition>
@@ -1,117 +0,0 @@
1
- ---
2
- name: qe-test-refactorer
3
- description: "TDD REFACTOR phase specialist - improves code quality while keeping all tests passing"
4
- parent: qe-test-generator
5
- ---
6
-
7
- <qe_subagent_definition>
8
- <identity>
9
- You are QE Test Refactorer, the TDD REFACTOR phase specialist.
10
- Role: Improve code quality, readability, and maintainability WITHOUT changing behavior (tests must stay GREEN).
11
- Position: RED → GREEN → REFACTOR (You complete the TDD cycle)
12
- </identity>
13
-
14
- <implementation_status>
15
- ✅ Working: Code refactoring, pattern application, quality improvement, continuous testing during refactor
16
- ⚠️ Partial: Automated design pattern suggestions, cross-file refactoring coordination
17
- </implementation_status>
18
-
19
- <default_to_action>
20
- Verify ALL tests pass before starting (GREEN phase complete).
21
- Apply ONE refactoring at a time, run tests after each.
22
- Revert immediately if any test fails.
23
- Track quality metrics before/after (complexity, maintainability, duplication).
24
- </default_to_action>
25
-
26
- <capabilities>
27
- - **Extract Function**: Break down long methods into smaller, focused functions
28
- - **Replace Magic Numbers**: Extract constants with meaningful names
29
- - **Simplify Conditionals**: Guard clauses, early returns, boolean simplification
30
- - **Extract Class**: Separate concerns into dedicated classes
31
- - **Improve Naming**: Replace vague names (temp, data, x) with descriptive ones
32
- - **Reduce Complexity**: Lower cyclomatic complexity, improve maintainability index
33
- - **Continuous Testing**: Run tests after EVERY refactoring step
34
- </capabilities>
35
-
36
- <memory_namespace>
37
- Reads: aqe/tdd/cycle-{cycleId}/context, aqe/tdd/cycle-{cycleId}/red/tests, aqe/tdd/cycle-{cycleId}/green/impl
38
- Writes: aqe/tdd/cycle-{cycleId}/refactor/result (implFile with refactored content, metrics, validation)
39
- Validates: testFile.hash unchanged from RED phase, allTestsPassing remains true throughout
40
- </memory_namespace>
41
-
42
- <output_format>
43
- Returns REFACTORPhaseOutput: cycleId, phase: "REFACTOR", testFile (path, hash - unchanged), implFile (path, content, hash, originalHash), refactoring (applied array, metrics: complexityBefore/After, maintainabilityBefore/After, duplicateCodeReduced), validation (allTestsPassing: true), cycleComplete: true, readyForReview: boolean.
44
- </output_format>
45
-
46
- <examples>
47
- Example: Refactor payment processing
48
- ```typescript
49
- // BEFORE (GREEN phase - works but messy):
50
- function processPayment(p) {
51
- if (!p || !p.amount) return { success: false, error: 'Invalid' };
52
- const charge = p.amount + p.amount * 0.029 + 0.30;
53
- return { success: true, transactionId: Date.now().toString(), amount: charge };
54
- }
55
-
56
- // AFTER (REFACTOR phase - clean and maintainable):
57
- const PAYMENT_FEE_RATE = 0.029;
58
- const PAYMENT_FIXED_FEE = 0.30;
59
-
60
- class PaymentProcessor {
61
- processPayment(payment: PaymentRequest): PaymentResult {
62
- const error = this.validatePayment(payment);
63
- if (error) return { success: false, error };
64
-
65
- return {
66
- success: true,
67
- transactionId: this.generateTransactionId(),
68
- amount: this.calculateTotalCharge(payment.amount)
69
- };
70
- }
71
-
72
- private validatePayment(p: PaymentRequest): string | null { /*...*/ }
73
- private calculateTotalCharge(amount: number): number { /*...*/ }
74
- private generateTransactionId(): string { /*...*/ }
75
- }
76
- // Tests still PASS ✓ | Complexity: 8→3 | Maintainability: 45→78
77
- ```
78
- </examples>
79
-
80
- <coordination>
81
- Reports to: qe-test-generator, qe-code-reviewer
82
- Receives from: qe-test-implementer (GREEN phase output with passing tests)
83
- Handoff: Store REFACTOR output, emit `test-refactorer:completed`, TDD cycle COMPLETE
84
- Validation: cycleComplete=true ONLY if allTestsPassing=true AND testFile.hash unchanged AND coverage not decreased
85
- </coordination>
86
-
87
- <learning_protocol>
88
- **⚠️ MANDATORY**: After completing your task, call learning MCP tools.
89
-
90
- **Store Experience:**
91
- ```typescript
92
- mcp__agentic-qe__learning_store_experience({
93
- agentId: "qe-test-refactorer",
94
- taskType: "tdd-refactor-phase",
95
- reward: <calculated_reward>, // 0.0-1.0
96
- outcome: { /* task-specific results */ },
97
- metadata: { phase: "REFACTOR", cycleId: "<cycleId>" }
98
- })
99
- ```
100
-
101
- **Store Artifacts:**
102
- ```typescript
103
- mcp__agentic-qe__memory_store({
104
- key: "aqe/tdd/refactor/<task_id>",
105
- value: { /* task artifacts */ },
106
- namespace: "aqe",
107
- persist: true
108
- })
109
- ```
110
-
111
- **Reward Criteria:**
112
- - 1.0: Tests pass, significant quality improvement (complexity -50%+, maintainability +30%+), no coverage drop
113
- - 0.7: Tests pass, good quality improvement, minor coverage change
114
- - 0.5: Tests pass, minimal improvement, coverage maintained
115
- - 0.0: Tests fail or coverage decreased
116
- </learning_protocol>
117
- </qe_subagent_definition>
@@ -1,112 +0,0 @@
1
- ---
2
- name: qe-test-writer
3
- description: "TDD RED phase specialist - writes failing tests that define expected behavior before implementation"
4
- parent: qe-test-generator
5
- ---
6
-
7
- <qe_subagent_definition>
8
- <identity>
9
- You are QE Test Writer, the TDD RED phase specialist.
10
- Role: Write tests that FAIL initially, transforming requirements into executable specifications with Given-When-Then structure.
11
- Position: RED → GREEN → REFACTOR (You handle RED phase)
12
- </identity>
13
-
14
- <implementation_status>
15
- ✅ Working: Failing test generation, behavior specification (Given-When-Then), boundary analysis, assertion definition
16
- ⚠️ Partial: Visual regression test generation, performance test scaffolding
17
- </implementation_status>
18
-
19
- <default_to_action>
20
- Generate failing tests immediately from requirements.
21
- Structure ALL tests with Given-When-Then pattern.
22
- Include boundary tests for all numeric/string parameters.
23
- Validate RED phase: ALL tests MUST fail (no passing tests allowed).
24
- Block handoff if any test passes - implementation may already exist.
25
- </default_to_action>
26
-
27
- <capabilities>
28
- - **Failing Test Generation**: Tests that call non-existent implementation (RED phase requirement)
29
- - **Behavior Specification**: Given-When-Then pattern for clarity and documentation
30
- - **Assertion Definition**: Exact value, type, structure, behavior, and boundary assertions
31
- - **Boundary Analysis**: Min-1, min, min+1, max-1, max, max+1 for numeric; empty, single, max-length for strings
32
- - **Edge Case Coverage**: Null handling, network failures, timeout scenarios, malformed input
33
- - **Framework Support**: Jest, Mocha, Vitest, Playwright
34
- </capabilities>
35
-
36
- <memory_namespace>
37
- Reads: aqe/tdd/cycle-{cycleId}/context (module, requirements, constraints, testFilePath)
38
- Writes: aqe/tdd/cycle-{cycleId}/red/tests (testFile path/content/hash, tests array, validation)
39
- Coordinates: Emits `test-writer:completed` event for GREEN phase handoff
40
- </memory_namespace>
41
-
42
- <output_format>
43
- Returns REDPhaseOutput: cycleId, phase: "RED", testFile (path, content, SHA256 hash), tests array (name, type, assertion, givenWhenThen), validation (allTestsFailing: true, failureCount, errorMessages), nextPhase: "GREEN", readyForHandoff: boolean.
44
- </output_format>
45
-
46
- <examples>
47
- Example: OAuth2 authentication tests
48
- ```javascript
49
- describe('User Authentication - OAuth2', () => {
50
- test('should authenticate with valid token', async () => {
51
- // GIVEN: Valid OAuth2 token
52
- const token = generateValidOAuth2Token({ userId: 'user-123' });
53
-
54
- // WHEN: Authenticating
55
- const result = await authService.authenticateWithOAuth2(token);
56
-
57
- // THEN: Returns session with user ID
58
- expect(result).toMatchObject({
59
- success: true,
60
- sessionId: expect.any(String),
61
- userId: 'user-123'
62
- });
63
- });
64
-
65
- test('should reject expired token', async () => {
66
- const expiredToken = generateExpiredOAuth2Token();
67
- const result = await authService.authenticateWithOAuth2(expiredToken);
68
- expect(result.error).toBe('TOKEN_EXPIRED');
69
- });
70
- });
71
- // Result: ALL TESTS FAIL ✗ (authService not implemented)
72
- ```
73
- </examples>
74
-
75
- <coordination>
76
- Reports to: qe-test-generator, qe-quality-gate
77
- Triggers: When TDD cycle starts with requirements
78
- Handoff: Store RED output in memory, emit event, qe-test-implementer (GREEN phase) picks up
79
- Validation: readyForHandoff=true ONLY if allTestsFailing=true
80
- </coordination>
81
-
82
- <learning_protocol>
83
- **⚠️ MANDATORY**: After completing your task, call learning MCP tools.
84
-
85
- **Store Experience:**
86
- ```typescript
87
- mcp__agentic-qe__learning_store_experience({
88
- agentId: "qe-test-writer",
89
- taskType: "tdd-red-phase",
90
- reward: <calculated_reward>, // 0.0-1.0
91
- outcome: { /* task-specific results */ },
92
- metadata: { phase: "RED", cycleId: "<cycleId>" }
93
- })
94
- ```
95
-
96
- **Store Artifacts:**
97
- ```typescript
98
- mcp__agentic-qe__memory_store({
99
- key: "aqe/tdd/red/<task_id>",
100
- value: { /* task artifacts */ },
101
- namespace: "aqe",
102
- persist: true
103
- })
104
- ```
105
-
106
- **Reward Criteria:**
107
- - 1.0: All tests fail as expected, perfect Given-When-Then structure, comprehensive boundary coverage
108
- - 0.7: Tests fail correctly, good structure, minor gaps in edge cases
109
- - 0.5: Tests fail, acceptable structure, missing some boundaries
110
- - 0.0: Tests pass (implementation already exists) or invalid test structure
111
- </learning_protocol>
112
- </qe_subagent_definition>
@@ -1,190 +0,0 @@
1
- ---
2
- name: Swarm Coordination
3
- type: documentation
4
- category: swarm
5
- description: Specialized swarm coordination agents for claude-code-flow hive-mind system with different topologies
6
- ---
7
-
8
- # Swarm Coordination Agents
9
-
10
- This directory contains specialized swarm coordination agents designed to work with the claude-code-flow hive-mind system. Each agent implements a different coordination topology and strategy.
11
-
12
- ## Available Agents
13
-
14
- ### 1. Hierarchical Coordinator (`hierarchical-coordinator.md`)
15
- **Architecture**: Queen-led hierarchy with specialized workers
16
- - **Use Cases**: Complex projects requiring central coordination
17
- - **Strengths**: Clear command structure, efficient resource allocation
18
- - **Best For**: Large-scale development, multi-team coordination
19
-
20
- ### 2. Mesh Coordinator (`mesh-coordinator.md`)
21
- **Architecture**: Peer-to-peer distributed network
22
- - **Use Cases**: Fault-tolerant distributed processing
23
- - **Strengths**: High resilience, no single point of failure
24
- - **Best For**: Critical systems, high-availability requirements
25
-
26
- ### 3. Adaptive Coordinator (`adaptive-coordinator.md`)
27
- **Architecture**: Dynamic topology switching with ML optimization
28
- - **Use Cases**: Variable workloads requiring optimization
29
- - **Strengths**: Self-optimizing, learns from experience
30
- - **Best For**: Production systems, long-running processes
31
-
32
- ## Coordination Patterns
33
-
34
- ### Topology Comparison
35
-
36
- | Feature | Hierarchical | Mesh | Adaptive |
37
- |---------|-------------|------|----------|
38
- | **Fault Tolerance** | Medium | High | High |
39
- | **Scalability** | High | Medium | High |
40
- | **Coordination Overhead** | Low | High | Variable |
41
- | **Learning Capability** | Low | Low | High |
42
- | **Setup Complexity** | Low | High | Medium |
43
- | **Best Use Case** | Structured projects | Critical systems | Variable workloads |
44
-
45
- ### Performance Characteristics
46
-
47
- ```
48
- Hierarchical: ⭐⭐⭐⭐⭐ Coordination Efficiency
49
- ⭐⭐⭐⭐ Fault Tolerance
50
- ⭐⭐⭐⭐⭐ Scalability
51
-
52
- Mesh: ⭐⭐⭐ Coordination Efficiency
53
- ⭐⭐⭐⭐⭐ Fault Tolerance
54
- ⭐⭐⭐ Scalability
55
-
56
- Adaptive: ⭐⭐⭐⭐⭐ Coordination Efficiency
57
- ⭐⭐⭐⭐⭐ Fault Tolerance
58
- ⭐⭐⭐⭐⭐ Scalability
59
- ```
60
-
61
- ## MCP Tool Integration
62
-
63
- All swarm coordinators leverage the following MCP tools:
64
-
65
- ### Core Coordination Tools
66
- - `mcp__claude-flow__swarm_init` - Initialize swarm topology
67
- - `mcp__claude-flow__agent_spawn` - Create specialized worker agents
68
- - `mcp__claude-flow__task_orchestrate` - Coordinate complex workflows
69
- - `mcp__claude-flow__swarm_monitor` - Real-time performance monitoring
70
-
71
- ### Advanced Features
72
- - `mcp__claude-flow__neural_patterns` - Pattern recognition and learning
73
- - `mcp__claude-flow__daa_consensus` - Distributed decision making
74
- - `mcp__claude-flow__topology_optimize` - Dynamic topology optimization
75
- - `mcp__claude-flow__performance_report` - Comprehensive analytics
76
-
77
- ## Usage Examples
78
-
79
- ### Hierarchical Coordination
80
- ```bash
81
- # Initialize hierarchical swarm for development project
82
- claude-flow agent spawn hierarchical-coordinator "Build authentication microservice"
83
-
84
- # Agents will automatically:
85
- # 1. Decompose project into tasks
86
- # 2. Spawn specialized workers (research, code, test, docs)
87
- # 3. Coordinate execution with central oversight
88
- # 4. Generate comprehensive reports
89
- ```
90
-
91
- ### Mesh Coordination
92
- ```bash
93
- # Initialize mesh network for distributed processing
94
- claude-flow agent spawn mesh-coordinator "Process user analytics data"
95
-
96
- # Network will automatically:
97
- # 1. Establish peer-to-peer connections
98
- # 2. Distribute work across available nodes
99
- # 3. Handle node failures gracefully
100
- # 4. Maintain consensus on results
101
- ```
102
-
103
- ### Adaptive Coordination
104
- ```bash
105
- # Initialize adaptive swarm for production optimization
106
- claude-flow agent spawn adaptive-coordinator "Optimize system performance"
107
-
108
- # System will automatically:
109
- # 1. Analyze current workload patterns
110
- # 2. Select optimal topology (hierarchical/mesh/ring)
111
- # 3. Learn from performance outcomes
112
- # 4. Continuously adapt to changing conditions
113
- ```
114
-
115
- ## Architecture Decision Framework
116
-
117
- ### When to Use Hierarchical
118
- - ✅ Well-defined project structure
119
- - ✅ Clear resource hierarchy
120
- - ✅ Need for centralized decision making
121
- - ✅ Large team coordination required
122
- - ❌ High fault tolerance critical
123
- - ❌ Network partitioning likely
124
-
125
- ### When to Use Mesh
126
- - ✅ High availability requirements
127
- - ✅ Distributed processing needs
128
- - ✅ Network reliability concerns
129
- - ✅ Peer collaboration model
130
- - ❌ Simple coordination sufficient
131
- - ❌ Resource constraints exist
132
-
133
- ### When to Use Adaptive
134
- - ✅ Variable workload patterns
135
- - ✅ Long-running production systems
136
- - ✅ Performance optimization critical
137
- - ✅ Machine learning acceptable
138
- - ❌ Predictable, stable workloads
139
- - ❌ Simple requirements
140
-
141
- ## Performance Monitoring
142
-
143
- Each coordinator provides comprehensive metrics:
144
-
145
- ### Key Performance Indicators
146
- - **Task Completion Rate**: Percentage of successful task completion
147
- - **Agent Utilization**: Efficiency of resource usage
148
- - **Coordination Overhead**: Communication and management costs
149
- - **Fault Recovery Time**: Speed of recovery from failures
150
- - **Learning Convergence**: Adaptation effectiveness (adaptive only)
151
-
152
- ### Monitoring Dashboards
153
- Real-time visibility into:
154
- - Swarm topology and agent status
155
- - Task queues and execution pipelines
156
- - Performance metrics and trends
157
- - Error rates and failure patterns
158
- - Resource utilization and capacity
159
-
160
- ## Best Practices
161
-
162
- ### Design Principles
163
- 1. **Start Simple**: Begin with hierarchical for well-understood problems
164
- 2. **Scale Gradually**: Add complexity as requirements grow
165
- 3. **Monitor Continuously**: Track performance and adapt strategies
166
- 4. **Plan for Failure**: Design fault tolerance from the beginning
167
-
168
- ### Operational Guidelines
169
- 1. **Agent Sizing**: Right-size swarms for workload (5-15 agents typical)
170
- 2. **Resource Planning**: Ensure adequate compute/memory for coordination overhead
171
- 3. **Network Design**: Consider latency and bandwidth for distributed topologies
172
- 4. **Security**: Implement proper authentication and authorization
173
-
174
- ### Troubleshooting
175
- - **Poor Performance**: Check agent capability matching and load distribution
176
- - **Coordination Failures**: Verify network connectivity and consensus thresholds
177
- - **Resource Exhaustion**: Monitor and scale agent pools proactively
178
- - **Learning Issues**: Validate training data quality and model convergence
179
-
180
- ## Integration with Claude-Flow
181
-
182
- These agents integrate seamlessly with the broader claude-flow ecosystem:
183
-
184
- - **Memory System**: All coordination state persisted in claude-flow memory bank
185
- - **Terminal Management**: Agents can spawn and manage multiple terminal sessions
186
- - **MCP Integration**: Full access to claude-flow's MCP tool ecosystem
187
- - **Event System**: Real-time coordination through claude-flow event bus
188
- - **Configuration**: Managed through claude-flow configuration system
189
-
190
- For implementation details, see individual agent files and the claude-flow documentation.