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.
- package/.claude/agents/v3/qe-devils-advocate.md +20 -0
- package/.claude/agents/v3/qe-gap-detector.md +25 -0
- package/.claude/agents/v3/qe-quality-gate.md +8 -0
- package/.claude/agents/v3/qe-requirements-validator.md +25 -0
- package/.claude/agents/v3/subagents/qe-code-reviewer.md +11 -0
- package/.claude/agents/v3/subagents/qe-integration-reviewer.md +11 -0
- package/.claude/agents/v3/subagents/qe-performance-reviewer.md +11 -0
- package/.claude/agents/v3/subagents/qe-security-reviewer.md +11 -0
- package/.claude/helpers/adr-compliance.sh +10 -10
- package/.claude/helpers/auto-memory-hook.mjs +24 -9
- package/.claude/helpers/brain-checkpoint.cjs +55 -134
- package/.claude/helpers/ddd-tracker.sh +2 -2
- package/.claude/helpers/guidance-hooks.sh +2 -2
- package/.claude/helpers/hook-handler.cjs +57 -18
- package/.claude/helpers/statusline.cjs +414 -595
- package/.claude/helpers/v3/quality-criteria/evidence-classification.md +116 -116
- package/.claude/helpers/v3/quality-criteria/htsm-categories.md +139 -139
- package/.claude/skills/README.md +8 -11
- package/.claude/skills/brutal-honesty-review/SKILL.md +3 -0
- package/.claude/skills/code-review-quality/SKILL.md +3 -0
- package/.claude/skills/qcsd-cicd-swarm/SKILL.md +79 -2075
- package/.claude/skills/qcsd-cicd-swarm/steps/01-flag-detection.md +62 -0
- package/.claude/skills/qcsd-cicd-swarm/steps/02-core-agents.md +33 -0
- package/.claude/skills/qcsd-cicd-swarm/steps/03-batch1-results.md +21 -0
- package/.claude/skills/qcsd-cicd-swarm/steps/04-conditional-agents.md +23 -0
- package/.claude/skills/qcsd-cicd-swarm/steps/05-decision-synthesis.md +30 -0
- package/.claude/skills/qcsd-cicd-swarm/steps/06-report-generation.md +17 -0
- package/.claude/skills/qcsd-cicd-swarm/steps/07-learning-persistence.md +27 -0
- package/.claude/skills/qcsd-cicd-swarm/steps/08-deployment-advisor.md +25 -0
- package/.claude/skills/qcsd-cicd-swarm/steps/09-final-output.md +16 -0
- package/.claude/skills/qcsd-development-swarm/SKILL.md +79 -2027
- package/.claude/skills/qcsd-development-swarm/steps/01-flag-detection.md +50 -0
- package/.claude/skills/qcsd-development-swarm/steps/02-core-agents.md +29 -0
- package/.claude/skills/qcsd-development-swarm/steps/03-batch1-results.md +14 -0
- package/.claude/skills/qcsd-development-swarm/steps/04-conditional-agents.md +23 -0
- package/.claude/skills/qcsd-development-swarm/steps/05-decision-synthesis.md +30 -0
- package/.claude/skills/qcsd-development-swarm/steps/06-report-generation.md +16 -0
- package/.claude/skills/qcsd-development-swarm/steps/07-learning-persistence.md +25 -0
- package/.claude/skills/qcsd-development-swarm/steps/08-defect-predictor.md +25 -0
- package/.claude/skills/qcsd-development-swarm/steps/09-final-output.md +16 -0
- package/.claude/skills/qcsd-ideation-swarm/SKILL.md +94 -1894
- package/.claude/skills/qcsd-ideation-swarm/steps/01-flag-detection.md +57 -0
- package/.claude/skills/qcsd-ideation-swarm/steps/02-core-agents.md +29 -0
- package/.claude/skills/qcsd-ideation-swarm/steps/03-batch1-results.md +15 -0
- package/.claude/skills/qcsd-ideation-swarm/steps/04-conditional-agents.md +23 -0
- package/.claude/skills/qcsd-ideation-swarm/steps/05-decision-synthesis.md +29 -0
- package/.claude/skills/qcsd-ideation-swarm/steps/06-report-generation.md +18 -0
- package/.claude/skills/qcsd-ideation-swarm/steps/07-learning-persistence.md +29 -0
- package/.claude/skills/qcsd-ideation-swarm/steps/08-final-output.md +18 -0
- package/.claude/skills/qcsd-production-swarm/SKILL.md +88 -2663
- package/.claude/skills/qcsd-production-swarm/steps/01-flag-detection.md +206 -0
- package/.claude/skills/qcsd-production-swarm/steps/02-core-agents.md +428 -0
- package/.claude/skills/qcsd-production-swarm/steps/03-batch1-results.md +101 -0
- package/.claude/skills/qcsd-production-swarm/steps/04-conditional-agents.md +125 -0
- package/.claude/skills/qcsd-production-swarm/steps/05-decision-synthesis.md +136 -0
- package/.claude/skills/qcsd-production-swarm/steps/06-report-generation.md +181 -0
- package/.claude/skills/qcsd-production-swarm/steps/07-learning-persistence.md +185 -0
- package/.claude/skills/qcsd-production-swarm/steps/08-feedback-loop.md +122 -0
- package/.claude/skills/qcsd-production-swarm/steps/09-final-output.md +140 -0
- package/.claude/skills/qcsd-refinement-swarm/SKILL.md +59 -2312
- package/.claude/skills/qcsd-refinement-swarm/steps/01-flag-detection.md +91 -0
- package/.claude/skills/qcsd-refinement-swarm/steps/02-core-agents.md +40 -0
- package/.claude/skills/qcsd-refinement-swarm/steps/03-batch1-results.md +40 -0
- package/.claude/skills/qcsd-refinement-swarm/steps/04-conditional-agents.md +35 -0
- package/.claude/skills/qcsd-refinement-swarm/steps/05-decision-synthesis.md +43 -0
- package/.claude/skills/qcsd-refinement-swarm/steps/06-report-generation.md +42 -0
- package/.claude/skills/qcsd-refinement-swarm/steps/07-learning-persistence.md +53 -0
- package/.claude/skills/qcsd-refinement-swarm/steps/08-transformation.md +36 -0
- package/.claude/skills/qcsd-refinement-swarm/steps/09-final-output.md +46 -0
- package/.claude/skills/sherlock-review/SKILL.md +3 -0
- package/.claude/skills/skill-builder/SKILL.md +103 -0
- package/.claude/skills/skills-manifest.json +1 -1
- package/CHANGELOG.md +44 -0
- package/assets/agents/v3/qe-devils-advocate.md +20 -0
- package/assets/agents/v3/qe-gap-detector.md +25 -0
- package/assets/agents/v3/qe-quality-gate.md +8 -0
- package/assets/agents/v3/qe-requirements-validator.md +25 -0
- package/assets/agents/v3/subagents/qe-code-reviewer.md +11 -0
- package/assets/agents/v3/subagents/qe-integration-reviewer.md +11 -0
- package/assets/agents/v3/subagents/qe-performance-reviewer.md +11 -0
- package/assets/agents/v3/subagents/qe-security-reviewer.md +11 -0
- package/assets/helpers/statusline-v3.cjs +693 -0
- package/assets/skills/brutal-honesty-review/SKILL.md +3 -0
- package/assets/skills/code-review-quality/SKILL.md +3 -0
- package/assets/skills/qcsd-cicd-swarm/SKILL.md +79 -2075
- package/assets/skills/qcsd-cicd-swarm/steps/01-flag-detection.md +62 -0
- package/assets/skills/qcsd-cicd-swarm/steps/02-core-agents.md +33 -0
- package/assets/skills/qcsd-cicd-swarm/steps/03-batch1-results.md +21 -0
- package/assets/skills/qcsd-cicd-swarm/steps/04-conditional-agents.md +23 -0
- package/assets/skills/qcsd-cicd-swarm/steps/05-decision-synthesis.md +30 -0
- package/assets/skills/qcsd-cicd-swarm/steps/06-report-generation.md +17 -0
- package/assets/skills/qcsd-cicd-swarm/steps/07-learning-persistence.md +27 -0
- package/assets/skills/qcsd-cicd-swarm/steps/08-deployment-advisor.md +25 -0
- package/assets/skills/qcsd-cicd-swarm/steps/09-final-output.md +16 -0
- package/assets/skills/qcsd-development-swarm/SKILL.md +79 -2027
- package/assets/skills/qcsd-development-swarm/steps/01-flag-detection.md +50 -0
- package/assets/skills/qcsd-development-swarm/steps/02-core-agents.md +29 -0
- package/assets/skills/qcsd-development-swarm/steps/03-batch1-results.md +14 -0
- package/assets/skills/qcsd-development-swarm/steps/04-conditional-agents.md +23 -0
- package/assets/skills/qcsd-development-swarm/steps/05-decision-synthesis.md +30 -0
- package/assets/skills/qcsd-development-swarm/steps/06-report-generation.md +16 -0
- package/assets/skills/qcsd-development-swarm/steps/07-learning-persistence.md +25 -0
- package/assets/skills/qcsd-development-swarm/steps/08-defect-predictor.md +25 -0
- package/assets/skills/qcsd-development-swarm/steps/09-final-output.md +16 -0
- package/assets/skills/qcsd-ideation-swarm/SKILL.md +94 -1894
- package/assets/skills/qcsd-ideation-swarm/steps/01-flag-detection.md +57 -0
- package/assets/skills/qcsd-ideation-swarm/steps/02-core-agents.md +29 -0
- package/assets/skills/qcsd-ideation-swarm/steps/03-batch1-results.md +15 -0
- package/assets/skills/qcsd-ideation-swarm/steps/04-conditional-agents.md +23 -0
- package/assets/skills/qcsd-ideation-swarm/steps/05-decision-synthesis.md +29 -0
- package/assets/skills/qcsd-ideation-swarm/steps/06-report-generation.md +18 -0
- package/assets/skills/qcsd-ideation-swarm/steps/07-learning-persistence.md +29 -0
- package/assets/skills/qcsd-ideation-swarm/steps/08-final-output.md +18 -0
- package/assets/skills/qcsd-production-swarm/SKILL.md +88 -2663
- package/assets/skills/qcsd-production-swarm/steps/01-flag-detection.md +206 -0
- package/assets/skills/qcsd-production-swarm/steps/02-core-agents.md +428 -0
- package/assets/skills/qcsd-production-swarm/steps/03-batch1-results.md +101 -0
- package/assets/skills/qcsd-production-swarm/steps/04-conditional-agents.md +125 -0
- package/assets/skills/qcsd-production-swarm/steps/05-decision-synthesis.md +136 -0
- package/assets/skills/qcsd-production-swarm/steps/06-report-generation.md +181 -0
- package/assets/skills/qcsd-production-swarm/steps/07-learning-persistence.md +185 -0
- package/assets/skills/qcsd-production-swarm/steps/08-feedback-loop.md +122 -0
- package/assets/skills/qcsd-production-swarm/steps/09-final-output.md +140 -0
- package/assets/skills/qcsd-refinement-swarm/SKILL.md +59 -2312
- package/assets/skills/qcsd-refinement-swarm/steps/01-flag-detection.md +91 -0
- package/assets/skills/qcsd-refinement-swarm/steps/02-core-agents.md +40 -0
- package/assets/skills/qcsd-refinement-swarm/steps/03-batch1-results.md +40 -0
- package/assets/skills/qcsd-refinement-swarm/steps/04-conditional-agents.md +35 -0
- package/assets/skills/qcsd-refinement-swarm/steps/05-decision-synthesis.md +43 -0
- package/assets/skills/qcsd-refinement-swarm/steps/06-report-generation.md +42 -0
- package/assets/skills/qcsd-refinement-swarm/steps/07-learning-persistence.md +53 -0
- package/assets/skills/qcsd-refinement-swarm/steps/08-transformation.md +36 -0
- package/assets/skills/qcsd-refinement-swarm/steps/09-final-output.md +46 -0
- package/assets/skills/sherlock-review/SKILL.md +3 -0
- package/assets/templates/agent-override-example.yaml +39 -0
- package/dist/agents/devils-advocate/agent.d.ts +25 -1
- package/dist/agents/devils-advocate/agent.js +108 -4
- package/dist/agents/devils-advocate/types.d.ts +54 -0
- package/dist/agents/devils-advocate/types.js +14 -0
- package/dist/agents/overlay-loader.d.ts +28 -0
- package/dist/agents/overlay-loader.js +232 -0
- package/dist/agents/overlay-schema.d.ts +56 -0
- package/dist/agents/overlay-schema.js +77 -0
- package/dist/analysis/branch-enumerator.d.ts +68 -0
- package/dist/analysis/branch-enumerator.js +393 -0
- package/dist/analysis/index.d.ts +2 -0
- package/dist/analysis/index.js +2 -0
- package/dist/cli/bundle.js +2469 -634
- package/dist/cli/commands/coverage.js +50 -0
- package/dist/cli/handlers/brain-handler.js +2 -1
- package/dist/context/compiler.d.ts +62 -0
- package/dist/context/compiler.js +143 -0
- package/dist/context/index.d.ts +8 -0
- package/dist/context/index.js +6 -0
- package/dist/context/sources/coverage-source.d.ts +15 -0
- package/dist/context/sources/coverage-source.js +77 -0
- package/dist/context/sources/git-source.d.ts +12 -0
- package/dist/context/sources/git-source.js +33 -0
- package/dist/context/sources/index.d.ts +6 -0
- package/dist/context/sources/index.js +5 -0
- package/dist/context/sources/memory-source.d.ts +17 -0
- package/dist/context/sources/memory-source.js +94 -0
- package/dist/context/sources/test-source.d.ts +13 -0
- package/dist/context/sources/test-source.js +53 -0
- package/dist/context/sources/types.d.ts +42 -0
- package/dist/context/sources/types.js +5 -0
- package/dist/domains/test-generation/coordinator.js +6 -4
- package/dist/feedback/feedback-loop.d.ts +5 -0
- package/dist/feedback/feedback-loop.js +12 -0
- package/dist/feedback/index.d.ts +1 -1
- package/dist/feedback/index.js +1 -1
- package/dist/init/agents-installer.d.ts +9 -0
- package/dist/init/agents-installer.js +72 -0
- package/dist/init/phases/07-hooks.d.ts +11 -0
- package/dist/init/phases/07-hooks.js +67 -0
- package/dist/init/phases/09-assets.js +3 -0
- package/dist/init/settings-merge.js +1 -1
- package/dist/kernel/hnsw-adapter.d.ts +3 -0
- package/dist/kernel/hnsw-adapter.js +11 -1
- package/dist/kernel/unified-memory-schemas.d.ts +1 -1
- package/dist/kernel/unified-memory-schemas.js +2 -0
- package/dist/kernel/unified-memory.js +25 -0
- package/dist/learning/experience-capture-middleware.js +24 -0
- package/dist/learning/sqlite-persistence.d.ts +3 -0
- package/dist/learning/sqlite-persistence.js +9 -0
- package/dist/learning/token-tracker.js +4 -0
- package/dist/mcp/bundle.js +3694 -3101
- package/dist/mcp/handlers/handler-factory.js +92 -11
- package/dist/mcp/services/task-router.d.ts +11 -0
- package/dist/mcp/services/task-router.js +26 -0
- package/dist/routing/qe-agent-registry.d.ts +11 -0
- package/dist/routing/qe-agent-registry.js +34 -0
- package/dist/routing/qe-task-router.d.ts +1 -0
- package/dist/routing/qe-task-router.js +34 -2
- package/dist/routing/routing-feedback.d.ts +5 -0
- package/dist/routing/routing-feedback.js +29 -3
- package/dist/routing/types.d.ts +2 -0
- package/dist/sync/pull-agent.js +2 -1
- package/dist/test-scheduling/pipeline.d.ts +7 -0
- package/dist/test-scheduling/pipeline.js +9 -0
- package/dist/validation/index.d.ts +3 -0
- package/dist/validation/index.js +10 -0
- package/dist/validation/pipeline.d.ts +80 -0
- package/dist/validation/pipeline.js +173 -0
- package/dist/validation/steps/requirements.d.ts +32 -0
- package/dist/validation/steps/requirements.js +596 -0
- package/package.json +6 -6
- package/.claude/agents/consensus/README.md +0 -253
- package/.claude/agents/deprecated/qe-api-contract-validator.md.v2 +0 -162
- package/.claude/agents/deprecated/qe-coverage-analyzer.md.v2 +0 -208
- package/.claude/agents/deprecated/qe-test-generator.md.v2 +0 -212
- package/.claude/agents/deprecated/qe-visual-tester.md.v2 +0 -216
- package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +0 -130
- package/.claude/agents/hive-mind/queen-coordinator.md +0 -203
- package/.claude/agents/hive-mind/scout-explorer.md +0 -242
- package/.claude/agents/hive-mind/swarm-memory-manager.md +0 -193
- package/.claude/agents/hive-mind/worker-specialist.md +0 -217
- package/.claude/agents/neural/safla-neural.md +0 -74
- package/.claude/agents/optimization/README.md +0 -250
- package/.claude/agents/reasoning/agent.md +0 -816
- package/.claude/agents/reasoning/goal-planner.md +0 -73
- package/.claude/agents/subagents/qe-code-reviewer.md +0 -76
- package/.claude/agents/subagents/qe-coverage-gap-analyzer.md +0 -76
- package/.claude/agents/subagents/qe-data-generator.md +0 -77
- package/.claude/agents/subagents/qe-flaky-investigator.md +0 -91
- package/.claude/agents/subagents/qe-integration-tester.md +0 -90
- package/.claude/agents/subagents/qe-performance-validator.md +0 -92
- package/.claude/agents/subagents/qe-security-auditor.md +0 -94
- package/.claude/agents/subagents/qe-test-data-architect-sub.md +0 -93
- package/.claude/agents/subagents/qe-test-implementer.md +0 -106
- package/.claude/agents/subagents/qe-test-refactorer.md +0 -117
- package/.claude/agents/subagents/qe-test-writer.md +0 -112
- package/.claude/agents/swarm/README.md +0 -190
- package/.claude/agents/templates/migration-plan.md +0 -746
- package/.claude/agents/testing/unit/tdd-london-swarm.md +0 -244
- package/.claude/agents/testing/validation/production-validator.md +0 -395
- package/.claude/agents/v3/README.md +0 -39
- package/.claude/agents/v3/typescript-specialist.yaml +0 -21
- package/.claude/agents/v3/v3-memory-specialist.md +0 -318
- package/.claude/agents/v3/v3-performance-engineer.md +0 -397
- package/.claude/agents/v3/v3-queen-coordinator.md +0 -98
- package/.claude/agents/v3/v3-security-architect.md +0 -174
- package/.claude/commands/README.md +0 -106
- package/.claude/commands/agents/README.md +0 -10
- package/.claude/commands/agents/agent-capabilities.md +0 -21
- package/.claude/commands/agents/agent-coordination.md +0 -28
- package/.claude/commands/agents/agent-spawning.md +0 -28
- package/.claude/commands/agents/agent-types.md +0 -26
- package/.claude/commands/coordination/README.md +0 -9
- package/.claude/commands/coordination/agent-spawn.md +0 -25
- package/.claude/commands/coordination/init.md +0 -44
- package/.claude/commands/coordination/orchestrate.md +0 -43
- package/.claude/commands/coordination/spawn.md +0 -45
- package/.claude/commands/coordination/swarm-init.md +0 -85
- package/.claude/commands/coordination/task-orchestrate.md +0 -25
- package/.claude/commands/hive-mind/README.md +0 -17
- package/.claude/commands/hive-mind/hive-mind-consensus.md +0 -8
- package/.claude/commands/hive-mind/hive-mind-init.md +0 -18
- package/.claude/commands/hive-mind/hive-mind-memory.md +0 -8
- package/.claude/commands/hive-mind/hive-mind-metrics.md +0 -8
- package/.claude/commands/hive-mind/hive-mind-resume.md +0 -8
- package/.claude/commands/hive-mind/hive-mind-sessions.md +0 -8
- package/.claude/commands/hive-mind/hive-mind-spawn.md +0 -21
- package/.claude/commands/hive-mind/hive-mind-status.md +0 -8
- package/.claude/commands/hive-mind/hive-mind-stop.md +0 -8
- package/.claude/commands/hive-mind/hive-mind-wizard.md +0 -8
- package/.claude/commands/hive-mind/hive-mind.md +0 -27
- package/.claude/commands/memory/README.md +0 -9
- package/.claude/commands/memory/memory-persist.md +0 -25
- package/.claude/commands/memory/memory-search.md +0 -25
- package/.claude/commands/memory/memory-usage.md +0 -25
- package/.claude/commands/memory/neural.md +0 -47
- package/.claude/commands/swarm/README.md +0 -15
- package/.claude/commands/swarm/swarm-analysis.md +0 -8
- package/.claude/commands/swarm/swarm-background.md +0 -8
- package/.claude/commands/swarm/swarm-init.md +0 -19
- package/.claude/commands/swarm/swarm-modes.md +0 -8
- package/.claude/commands/swarm/swarm-monitor.md +0 -8
- package/.claude/commands/swarm/swarm-spawn.md +0 -19
- package/.claude/commands/swarm/swarm-status.md +0 -8
- package/.claude/commands/swarm/swarm-strategies.md +0 -8
- package/.claude/commands/swarm/swarm.md +0 -27
- package/.claude/commands/training/README.md +0 -9
- package/.claude/commands/training/model-update.md +0 -25
- package/.claude/commands/training/neural-patterns.md +0 -74
- package/.claude/commands/training/neural-train.md +0 -25
- package/.claude/commands/training/pattern-learn.md +0 -25
- package/.claude/commands/training/specialization.md +0 -63
- package/.claude/commands/workflows/README.md +0 -9
- package/.claude/commands/workflows/development.md +0 -78
- package/.claude/commands/workflows/research.md +0 -63
- package/.claude/commands/workflows/workflow-create.md +0 -25
- package/.claude/commands/workflows/workflow-execute.md +0 -25
- package/.claude/commands/workflows/workflow-export.md +0 -25
- package/.claude/skills/agentic-jujutsu/SKILL.md +0 -645
- package/.claude/skills/hive-mind-advanced/SKILL.md +0 -712
- package/.claude/skills/iterative-loop/SKILL.md +0 -371
- package/.claude/skills/performance-analysis/SKILL.md +0 -569
- package/.claude/skills/performance-analysis/evals/performance-analysis.yaml +0 -144
- package/.claude/skills/performance-analysis/schemas/output.json +0 -588
- 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.
|