Files
proffesor-for-testing__agen…/docs/PHASE4-SKILL-OPTIMIZATION-PLAN.md
Profa 4830e43662 feat: Merge AQE Fleet + Claude Flow into unified CLAUDE.md
✅ 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>
2025-10-20 14:48:24 +00:00

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-hunter integration
  • 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-analyzer integration
  • 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-generator TDD 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-executor CI 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-validator examples
  • 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)

  1. risk-based-testing: Missing YAML frontmatter - MUST FIX FIRST

🟡 High Priority

  1. agentic-quality-engineering: Too brief, foundational skill needs expansion
  2. All skills: Need "Using with QE Agents" section
  3. All skills: Need related skills cross-references

🟢 Medium Priority

  1. Add more code examples throughout
  2. Improve progressive disclosure structure
  3. Add troubleshooting sections
  4. 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-engineering expanded 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

  1. Immediate: Fix risk-based-testing YAML frontmatter
  2. Priority 1: Expand agentic-quality-engineering skill
  3. Priority 2: Add agent integration sections to all skills
  4. Priority 3: Add cross-references and related skills
  5. Priority 4: Review and optimize remaining skills

Last Updated: October 20, 2025 Owner: Agentic QE Fleet Team Status: 📋 Planning Complete → 🚀 Ready for Execution