✅ UNIFIED CONFIGURATION - Merged CLAUDE.md (AQE Fleet) + CLAUDE.md.backup (Claude Flow) - 72 total agents now available (18 QE + 54 Claude Flow) - Both agent types can work together in coordinated workflows - Preserved all critical concurrent execution rules 🤖 AGENT ECOSYSTEM **AQE Fleet (18 agents):** - Core Testing: qe-test-generator, qe-test-executor, qe-coverage-analyzer, qe-quality-gate, qe-quality-analyzer - Performance & Security: qe-performance-tester, qe-security-scanner - Strategic Planning: qe-requirements-validator, qe-production-intelligence, qe-fleet-commander - Deployment: qe-deployment-readiness - Advanced Testing: qe-regression-risk-analyzer, qe-test-data-architect, qe-api-contract-validator, qe-flaky-test-hunter - Specialized: qe-visual-tester, qe-chaos-engineer **Claude Flow (54 agents):** - Core Development: coder, reviewer, tester, planner, researcher - Swarm Coordination: hierarchical-coordinator, mesh-coordinator, adaptive-coordinator, etc. - Consensus & Distributed: byzantine-coordinator, raft-manager, gossip-coordinator, etc. - Performance & Optimization: perf-analyzer, performance-benchmarker, task-orchestrator, etc. - GitHub & Repository: github-modes, pr-manager, code-review-swarm, etc. - SPARC Methodology: sparc-coord, sparc-coder, specification, pseudocode, architecture, refinement - Specialized Development: backend-dev, mobile-dev, ml-developer, cicd-engineer, api-docs, system-architect, etc. - Testing & Validation: tdd-london-swarm, production-validator - Migration & Planning: migration-planner, swarm-init 📋 COORDINATION SYSTEM **Two Hook Systems:** - AQE Hooks: Native TypeScript (100-500x faster, zero dependencies) - Claude Flow Hooks: External via npx (flexible, feature-rich) **Memory Namespaces:** - aqe/* - Quality engineering agent state - swarm/* - Claude Flow agent state 🚀 QUICK START EXAMPLES **AQE Only:** Task("Generate tests", "...", "qe-test-generator") **Claude Flow Only:** Task("Research agent", "...", "researcher") **Combined Pipeline:** [Single Message]: Task("Backend Developer", "...", "backend-dev") // Claude Flow Task("Test Generator", "...", "qe-test-generator") // AQE Task("Security Scanner", "...", "qe-security-scanner") // AQE Task("Code Reviewer", "...", "reviewer") // Claude Flow 🔧 MCP SERVERS - agentic-qe: AQE Fleet tools (test generation, execution, quality analysis) - claude-flow: General agent coordination and SPARC methodology - ruv-swarm: Optional enhanced coordination - flow-nexus: Optional cloud features ⚡ CONCURRENT EXECUTION - GOLDEN RULE: 1 MESSAGE = ALL RELATED OPERATIONS - TodoWrite: Batch all todos in one call - Task tool: Spawn all agents in one message - File operations: Batch all reads/writes/edits - Always use appropriate subdirectories (never root folder) 📚 COMPLETE DOCUMENTATION - 18 QE agents + 54 Claude Flow agents - SPARC methodology integration - Multi-Model Router (70-81% cost savings) - Streaming progress support - Performance benefits from both systems - Comprehensive troubleshooting guide 💡 BEST PRACTICES 1. Use AQE agents for quality engineering tasks 2. Use Claude Flow agents for general development 3. Combine both in single workflows for full pipeline 4. Always batch operations in single messages 5. Use proper memory namespaces for coordination 6. Never save to root folder 🎯 Performance Benefits - Claude Flow: 84.8% SWE-Bench solve rate, 2.8-4.4x speed - AQE Fleet: 100-500x faster hooks, O(log n) algorithms, 10k+ records/sec 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
11 KiB
Phase 4: Skill Optimization Plan
Date: October 20, 2025 Status: In Progress Objective: Optimize all 17 QE skills to production quality
Optimization Criteria
1. Structure (Progressive Disclosure)
- ✅ Level 1: Quick Start (2-3 sentences, immediate value)
- ✅ Level 2: Core Concepts (main instructions, 80% use cases)
- ✅ Level 3: Advanced Techniques (deep dive, edge cases)
- ✅ Level 4: Reference (troubleshooting, resources, links)
2. QE Agent Integration
- Add "Using with QE Agents" section
- Show which agents leverage each skill
- Provide agent invocation examples
- Demonstrate skill-agent coordination patterns
3. Practical Examples
- Real-world scenarios from 12+ years QE experience
- Concrete code examples (not pseudocode)
- Anti-patterns and pitfalls
- Before/After comparisons
4. YAML Frontmatter
- ✅ name: Max 64 chars, Title Case
- ✅ description: Max 1024 chars, includes WHAT and WHEN
5. Cross-References
- Link to related skills
- Reference relevant agents
- Connect to QE Fleet ecosystem
Skills Analysis
Core Quality Practices (5 skills)
1. holistic-testing-pact ✅
Status: Good structure, needs agent integration Enhancements:
- Add "Using with QE Agents" section
- Link to
qe-quality-gate,qe-fleet-commander - Add practical PACT implementation example
- Include metrics for PACT adoption
2. context-driven-testing ✅
Status: Excellent content, needs minor updates Enhancements:
- Add agent examples for exploratory testing
- Link to
qe-test-generator(context-aware generation) - Add decision tree for approach selection
- Include RST agent patterns
3. agentic-quality-engineering ⚠️
Status: Too brief, needs expansion Enhancements:
- Expand from ~60 lines to ~300-400 lines
- Add detailed agent architecture patterns
- Show Q-learning integration examples
- Add swarm coordination patterns
- Include ROI calculations for agentic QE
- Link ALL 18 QE agents with use cases
4. exploratory-testing-advanced ✅
Status: Comprehensive, needs agent integration Enhancements:
- Add
qe-flaky-test-hunterintegration - Show automated charter generation
- Add AI-assisted test tour planning
- Include agent-augmented exploration patterns
5. risk-based-testing ❌
Status: Missing YAML frontmatter! Critical fix needed Enhancements:
- ADD YAML FRONTMATTER (blocking issue)
- Add
qe-regression-risk-analyzerintegration - Show ML-based risk assessment
- Add agent-driven risk monitoring
- Include production intelligence patterns
Development Methodologies (3 skills)
6. tdd-london-chicago ✅
Status: Excellent comparison, needs agent examples Enhancements:
- Add
qe-test-generatorTDD mode - Show agent-assisted test-first development
- Include AI code review for TDD quality
- Add refactoring agent patterns
7. xp-practices ✅
Status: Comprehensive, needs QE focus Enhancements:
- Add QE-specific XP adaptations
- Show ensemble testing with agents
- Include continuous testing patterns
- Link to
qe-test-executorCI integration
8. refactoring-patterns
Status: Not yet reviewed Enhancements: TBD after review
Testing Specializations (4 skills)
9. api-testing-patterns ✅
Status: Good structure (from review) Enhancements:
- Add
qe-api-contract-validatorexamples - Show breaking change detection
- Include version compatibility testing
- Add GraphQL testing patterns
10. performance-testing
Status: Not yet reviewed Enhancements: TBD after review
11. security-testing
Status: Not yet reviewed Enhancements: TBD after review
12. test-automation-strategy
Status: Not yet reviewed Enhancements: TBD after review
Communication & Process (3 skills)
13. technical-writing
Status: Not yet reviewed Enhancements: TBD after review
14. bug-reporting-excellence ✅
Status: Excellent detail, needs agent integration Enhancements:
- Add AI-assisted bug report generation
- Show root cause analysis agents
- Include automated reproduction steps
- Link to issue tracking automation
15. code-review-quality
Status: Not yet reviewed Enhancements: TBD after review
Professional Skills (2 skills)
16. consultancy-practices
Status: Not yet reviewed Enhancements: TBD after review
17. quality-metrics
Status: Not yet reviewed Enhancements: TBD after review
Priority Issues
🔴 Critical (Blocking)
- risk-based-testing: Missing YAML frontmatter - MUST FIX FIRST
🟡 High Priority
- agentic-quality-engineering: Too brief, foundational skill needs expansion
- All skills: Need "Using with QE Agents" section
- All skills: Need related skills cross-references
🟢 Medium Priority
- Add more code examples throughout
- Improve progressive disclosure structure
- Add troubleshooting sections
- Include metrics/success criteria
Implementation Plan
Step 1: Fix Critical Issues (5 min)
- ✅ Add YAML frontmatter to
risk-based-testing
Step 2: Expand Core Skills (60 min)
- ✅ Expand
agentic-quality-engineering(300-400 lines) - ✅ Add comprehensive agent integration patterns
- ✅ Include all 18 QE agent mappings
Step 3: Add Agent Integration (90 min)
For each of 17 skills:
- Add "Using with QE Agents" section (5 min per skill)
- Link to relevant agents (2 min per skill)
- Show 1-2 practical examples (8 min per skill)
Step 4: Add Cross-References (30 min)
- Add "Related Skills" section to each skill
- Create bidirectional links
- Add skill navigation patterns
Step 5: Review Remaining Skills (60 min)
- Read 9 unreviewed skills
- Identify optimization opportunities
- Apply consistent structure
Step 6: Final Polish (30 min)
- Verify all YAML frontmatter
- Check cross-references
- Test skill discovery
- Update documentation
Total Estimated Time: ~4.5 hours
Success Criteria
- All 17 skills have valid YAML frontmatter
- All 17 skills have "Using with QE Agents" section
- All 17 skills have "Related Skills" section
- All 17 skills follow progressive disclosure structure
agentic-quality-engineeringexpanded to 300-400 lines- All agent-skill mappings documented
- All skills tested and loadable by Claude
QE Agent → Skills Mapping
Core Testing (5 agents)
| Agent | Primary Skills | Secondary Skills |
|---|---|---|
qe-test-generator |
agentic-quality-engineering, api-testing-patterns, tdd-london-chicago | context-driven-testing, test-automation-strategy |
qe-test-executor |
test-automation-strategy, xp-practices | tdd-london-chicago, context-driven-testing |
qe-coverage-analyzer |
agentic-quality-engineering, quality-metrics | holistic-testing-pact, risk-based-testing |
qe-quality-gate |
quality-metrics, risk-based-testing | holistic-testing-pact |
qe-quality-analyzer |
quality-metrics, holistic-testing-pact | agentic-quality-engineering |
Performance & Security (2 agents)
| Agent | Primary Skills | Secondary Skills |
|---|---|---|
qe-performance-tester |
performance-testing, quality-metrics | risk-based-testing |
qe-security-scanner |
security-testing, risk-based-testing | api-testing-patterns |
Strategic Planning (3 agents)
| Agent | Primary Skills | Secondary Skills |
|---|---|---|
qe-requirements-validator |
holistic-testing-pact, context-driven-testing | agentic-quality-engineering |
qe-production-intelligence |
risk-based-testing, exploratory-testing-advanced | quality-metrics |
qe-fleet-commander |
agentic-quality-engineering, holistic-testing-pact | All skills (meta-level) |
Deployment (1 agent)
| Agent | Primary Skills | Secondary Skills |
|---|---|---|
qe-deployment-readiness |
risk-based-testing, quality-metrics | holistic-testing-pact |
Advanced Testing (4 agents)
| Agent | Primary Skills | Secondary Skills |
|---|---|---|
qe-regression-risk-analyzer |
risk-based-testing, exploratory-testing-advanced | quality-metrics |
qe-test-data-architect |
test-automation-strategy, agentic-quality-engineering | api-testing-patterns |
qe-api-contract-validator |
api-testing-patterns | test-automation-strategy |
qe-flaky-test-hunter |
exploratory-testing-advanced, risk-based-testing | quality-metrics |
Specialized (2 agents)
| Agent | Primary Skills | Secondary Skills |
|---|---|---|
qe-visual-tester |
exploratory-testing-advanced, quality-metrics | holistic-testing-pact |
qe-chaos-engineer |
risk-based-testing, exploratory-testing-advanced | holistic-testing-pact |
Skills → Agents Reverse Mapping
Core Quality Practices
- holistic-testing-pact: qe-quality-analyzer, qe-requirements-validator, qe-fleet-commander, qe-quality-gate
- context-driven-testing: qe-requirements-validator, qe-test-generator, qe-test-executor
- agentic-quality-engineering: ALL AGENTS (foundational skill)
- exploratory-testing-advanced: qe-production-intelligence, qe-regression-risk-analyzer, qe-flaky-test-hunter, qe-visual-tester, qe-chaos-engineer
- risk-based-testing: qe-quality-gate, qe-deployment-readiness, qe-regression-risk-analyzer, qe-flaky-test-hunter, qe-chaos-engineer, qe-performance-tester, qe-security-scanner
Development Methodologies
- tdd-london-chicago: qe-test-generator, qe-test-executor
- xp-practices: qe-test-executor
- refactoring-patterns: qe-test-generator (refactoring mode)
Testing Specializations
- api-testing-patterns: qe-test-generator, qe-api-contract-validator, qe-test-data-architect, qe-security-scanner
- performance-testing: qe-performance-tester
- security-testing: qe-security-scanner
- test-automation-strategy: qe-test-executor, qe-api-contract-validator, qe-test-data-architect
Communication & Process
- technical-writing: ALL AGENTS (reporting and documentation)
- bug-reporting-excellence: ALL AGENTS (bug detection and reporting)
- code-review-quality: qe-test-generator (code quality analysis)
Professional Skills
- consultancy-practices: qe-fleet-commander (strategic guidance)
- quality-metrics: qe-quality-analyzer, qe-coverage-analyzer, qe-quality-gate, qe-deployment-readiness, qe-regression-risk-analyzer, qe-flaky-test-hunter, qe-visual-tester, qe-performance-tester
Next Steps
- Immediate: Fix risk-based-testing YAML frontmatter
- Priority 1: Expand agentic-quality-engineering skill
- Priority 2: Add agent integration sections to all skills
- Priority 3: Add cross-references and related skills
- Priority 4: Review and optimize remaining skills
Last Updated: October 20, 2025 Owner: Agentic QE Fleet Team Status: 📋 Planning Complete → 🚀 Ready for Execution