AI Workforce Documentation
Overview
This section documents the specialized AI agents that power development workflows for the Momentum Learning Management Platform. These agents work together to deliver high-quality code, comprehensive testing, robust security, and thorough documentation.
Contents
Specialized Agents
Comprehensive catalog of all available AI agents, their capabilities, tools, and use cases. Includes:
- Development agents (orchestrators, builders, testers)
- Security and compliance agents
- Performance and architecture agents
- Documentation and quality agents
Quick Reference
Agent Categories
| Category | Agents | Primary Use |
|---|---|---|
| General | general-purpose | Multi-step tasks |
| Exploration | Explore, Plan | Codebase analysis, planning |
| Development | develop-workflow-orchestrator | Full-stack development |
| Testing | test-engineer, root-cause-analyzer | Testing, debugging |
| Security | security-auditor, config-safety-reviewer | Security, configuration |
| Architecture | systems-architect, performance-tuner | Design, optimization |
| Documentation | docs-writer | Technical writing |
| Quality | refactor-expert | Code quality, refactoring |
When to Use Which Agent
Need to... Use...
────────────────────────────────────────────────────
Build a feature → develop-workflow-orchestrator
Debug a complex issue → root-cause-analyzer
Generate tests → test-engineer
Review security → security-auditor
Optimize performance → performance-tuner
Write documentation → docs-writer
Refactor code → refactor-expert
Plan architecture → systems-architect
Explore codebase → Explore
Validate configuration → config-safety-reviewer
Common Workflows
Feature Development
Plan → develop-workflow-orchestrator → test-engineer →
security-auditor → docs-writer
Bug Fix
root-cause-analyzer → [Fix] → test-engineer → docs-writer
Production Deployment
security-auditor → config-safety-reviewer →
performance-tuner → test-engineer
Code Review
refactor-expert → security-auditor →
config-safety-reviewer → test-engineer → docs-writer
Quality Standards
All agents adhere to project quality standards:
- Code Coverage: >80% for all new code
- TypeScript: Strict mode compliance
- Security: OWASP Top 10 compliance
- Performance: API P95 <300ms, Page load <2s
- Documentation: YAML front matter required
Integration with Development
Proactive Agent Use
Agents are used proactively when their expertise is needed:
test-engineerauto-generates tests for new featuressecurity-auditorreviews authentication changesconfig-safety-reviewervalidates production configsdocs-writerdocuments all API changes
Agent Chaining
Multiple agents work together for comprehensive results:
- Development agent builds feature
- Testing agent validates functionality
- Security agent reviews vulnerabilities
- Documentation agent creates docs
- Architecture agent validates design
Parallel Execution
Independent tasks run in parallel for efficiency:
// Run simultaneously
Task(test-engineer) + Task(security-auditor) + Task(docs-writer)
Best Practices
- Use Specialized Agents: Don’t use general-purpose for specialized tasks
- Provide Clear Context: Detailed prompts get better results
- Chain Agents: Combine for comprehensive workflows
- Leverage Parallelism: Run independent tasks concurrently
- Resume When Needed: Continue agent work with resume capability
Related Documentation
Last Updated: 2025-12-24 Status: Active Maintained By: Development Team