Skip to main content

Agent Name

Purpose​

Clear, single-sentence description of this agent's primary responsibility.

Core Capabilities​

  • Capability 1 with specific expertise
  • Capability 2 with measurable outcome
  • Capability 3 with technical depth

File Boundaries​

src/module/     # Primary ownership with full control
src/shared/     # Shared ownership, coordinate with [agent-name]
tests/module/   # Test ownership for owned modules

Integration Points​

Depends On​

  • database-specialist: For data models and repository patterns
  • security-specialist: For authentication and authorization

Provides To​

  • frontend-developer: REST API endpoints
  • monitoring-specialist: Metrics and logging integration

Quality Standards​

  • Test Coverage: 95% minimum (unit + integration)
  • Code Quality: ADR-compliant, no linting errors
  • Performance: < 100ms response time for APIs
  • Security: Input validation, rate limiting

CODI Integration​

# Session initialization
export SESSION_ID="AGENT-NAME-SESSION-N"
codi-log "$SESSION_ID: Starting work on [task]" "SESSION_START"

# Task tracking
codi-log "$SESSION_ID: Created [file]" "CREATE"
codi-log "$SESSION_ID: Updated [component]" "UPDATE"
codi-log "$SESSION_ID: Completed [task]" "COMPLETE"

# Coordination
codi-log "$SESSION_ID: FILE_CLAIM src/module/file.rs" "FILE_CLAIM"
codi-log "$SESSION_ID: HANDOFF to [agent]" "HANDOFF"

Task Patterns​

Primary Tasks​

  1. Task Type 1: Description and approach
  2. Task Type 2: Description and approach
  3. Task Type 3: Description and approach

Delegation Triggers​

  • Delegates to security-specialist when: Security review needed
  • Delegates to testing-specialist when: Coverage < 95%
  • Escalates to orchestrator when: Cross-agent coordination required

Success Metrics​

  • Task completion rate: > 90%
  • Code quality score: > 9/10
  • First-time success rate: > 85%
  • Mean time to completion: < 2 hours for medium tasks

Example Workflows​

Workflow 1: Creating New Component​

1. Claim files via CODI
2. Implement with TDD approach
3. Validate against ADRs
4. Request review if needed

Workflow 2: Updating Existing Code​

1. Analyze current implementation
2. Check test coverage
3. Make changes preserving behavior
4. Update documentation

Common Patterns​

// Example code pattern this agent uses

Anti-Patterns to Avoid​

  • Don't do X because Y
  • Avoid pattern Z in favor of pattern W

References​