Agents Reference

AgileFlow includes 26 specialized agents that handle specific types of development work. Each agent is an expert in its domain.

How Agents Work

Agents are autonomous AI assistants that:

• Handle specific types of tasks
• Have domain expertise
• Work independently or collaboratively
• Follow best practices for their specialty

Using Agents

Invoke agents by mentioning them:

@agileflow-api implement the user login endpoint
@agileflow-ui create the dashboard component
@agileflow-testing write integration tests for auth

Agents can also be assigned to stories:

/AgileFlow:assign AF-001 --owner AG-API

Core Development Agents

agileflow-api

Backend services and API development

Specialties:

• REST API endpoints
• GraphQL resolvers
• Database queries
• Business logic
• Data validation
• Error handling

Example tasks:

@agileflow-api implement CRUD operations for users
@agileflow-api add pagination to the products endpoint
@agileflow-api create authentication middleware

agileflow-ui

Frontend components and user interfaces

Specialties:

• React/Vue/Angular components
• Styling (CSS, Tailwind, etc.)
• Responsive design
• Accessibility (WCAG)
• Component libraries
• Design system implementation

Example tasks:

@agileflow-ui create a login form component
@agileflow-ui implement the user dashboard layout
@agileflow-ui add dark mode support

agileflow-database

Database design and optimization

Specialties:

• Schema design
• Migrations
• Query optimization
• Indexes
• Data modeling
• Database-intensive features

Example tasks:

@agileflow-database design schema for user roles
@agileflow-database optimize the products query
@agileflow-database create migration for new tables

Testing & Quality Agents

agileflow-testing

Test strategy and implementation

Specialties:

• Unit tests
• Integration tests
• E2E tests
• Test patterns
• Coverage optimization
• Test data management

Example tasks:

@agileflow-testing create unit tests for auth module
@agileflow-testing set up E2E tests for checkout flow
@agileflow-testing improve test coverage to 80%

agileflow-qa

Quality assurance and validation

Specialties:

• Test planning
• Test cases
• Quality metrics
• Regression testing
• Release readiness

Example tasks:

@agileflow-qa create test plan for sprint
@agileflow-qa validate release readiness
@agileflow-qa design regression test suite

agileflow-accessibility

WCAG compliance and inclusive design

Specialties:

• WCAG 2.1 compliance
• Screen reader support
• Keyboard navigation
• Color contrast
• ARIA labels
• Accessibility testing

Example tasks:

@agileflow-accessibility audit login form
@agileflow-accessibility fix keyboard navigation
@agileflow-accessibility add ARIA labels to components

DevOps & Infrastructure Agents

agileflow-ci

CI/CD and automation

Specialties:

• GitHub Actions
• GitLab CI
• Jenkins
• Test automation
• Build pipelines
• Code quality checks

Example tasks:

@agileflow-ci set up GitHub Actions workflow
@agileflow-ci add automated testing to CI
@agileflow-ci configure branch protection rules

agileflow-devops

Infrastructure and deployment

Specialties:

• Deployment automation
• Dependency management
• Code quality tools
• Impact analysis
• Technical debt tracking
• Changelog generation

Example tasks:

@agileflow-devops set up deployment pipeline
@agileflow-devops update dependencies
@agileflow-devops analyze impact of changes

agileflow-monitoring

Observability and logging

Specialties:

• Logging strategies
• Metrics dashboards
• Alerting rules
• Error tracking
• Performance monitoring
• Production visibility

Example tasks:

@agileflow-monitoring set up error tracking
@agileflow-monitoring create performance dashboard
@agileflow-monitoring configure alerting for API errors

Specialized Domain Agents

agileflow-security

Security analysis and implementation

Specialties:

• Vulnerability scanning
• Authentication patterns
• Authorization
• Data encryption
• Security best practices
• Compliance

Example tasks:

@agileflow-security audit authentication flow
@agileflow-security implement rate limiting
@agileflow-security scan for SQL injection risks

agileflow-performance

Optimization and scalability

Specialties:

• Performance profiling
• Bottleneck identification
• Caching strategies
• Query optimization
• Bundle size reduction
• Scalability planning

Example tasks:

@agileflow-performance optimize dashboard load time
@agileflow-performance implement caching strategy
@agileflow-performance reduce bundle size

agileflow-analytics

Data tracking and analysis

Specialties:

• Event tracking
• Analytics implementation
• User behavior analysis
• Metrics dashboards
• Data pipelines
• Reporting

Example tasks:

@agileflow-analytics implement user event tracking
@agileflow-analytics create conversion funnel
@agileflow-analytics build analytics dashboard

agileflow-integrations

Third-party integrations

Specialties:

• API integrations
• Webhooks
• Payment processors
• Auth providers (OAuth, SSO)
• External services
• API connectivity

Example tasks:

@agileflow-integrations integrate Stripe payments
@agileflow-integrations set up OAuth with Google
@agileflow-integrations implement webhook handlers

Documentation & Architecture Agents

agileflow-documentation

Technical documentation

Specialties:

• API documentation
• User guides
• Tutorials
• Code examples
• Documentation maintenance
• README files

Example tasks:

@agileflow-documentation create API reference
@agileflow-documentation write user guide for dashboard
@agileflow-documentation update README with new features

agileflow-adr-writer

Architecture Decision Records

Specialties:

• Technical decision documentation
• Trade-off analysis
• Alternatives evaluation
• Decision tracking
• Architecture patterns

Example tasks:

@agileflow-adr-writer document database choice
@agileflow-adr-writer create ADR for state management
@agileflow-adr-writer record API design decision

agileflow-design

Design systems and patterns

Specialties:

• Design system implementation
• UI/UX patterns
• Component design
• Visual consistency
• Design documentation
• Figma/Sketch integration

Example tasks:

@agileflow-design implement button variants
@agileflow-design create color palette
@agileflow-design document component usage

Planning & Strategy Agents

agileflow-product

Product requirements and validation

Specialties:

• Requirements analysis
• User story creation
• Acceptance criteria
• Feature validation
• Product-market fit
• Stakeholder communication

Example tasks:

@agileflow-product clarify requirements for login
@agileflow-product validate feature against user needs
@agileflow-product write acceptance criteria

agileflow-epic-planner

Epic breakdown and planning

Specialties:

• Epic decomposition
• Story generation
• Effort estimation
• Dependency mapping
• Milestone planning
• Release planning

Example tasks:

@agileflow-epic-planner break down auth epic
@agileflow-epic-planner plan Q2 release
@agileflow-epic-planner map feature dependencies

agileflow-mentor

End-to-end implementation guidance

Specialties:

• Feature implementation
• Best practices
• Approach research
• Multi-step workflows
• Story creation
• Agent orchestration

Example tasks:

@agileflow-mentor guide me through implementing payments
@agileflow-mentor help plan the auth system
@agileflow-mentor research best approach for real-time updates

Code Quality Agents

agileflow-refactor

Code improvement and modernization

Specialties:

• Code refactoring
• Technical debt cleanup
• Legacy code modernization
• Code smell detection
• Architecture improvement
• Pattern implementation

Example tasks:

@agileflow-refactor modernize auth module
@agileflow-refactor eliminate code duplication
@agileflow-refactor improve error handling patterns

agileflow-research

Technical research and exploration

Specialties:

• Technology research
• Proof of concepts
• Competitive analysis
• Best practices
• Tool evaluation
• Research documentation

Example tasks:

@agileflow-research compare state management libraries
@agileflow-research evaluate database options
@agileflow-research research authentication patterns

Compliance & Standards Agents

agileflow-compliance

Regulatory compliance

Specialties:

• GDPR compliance
• HIPAA compliance
• SOC2 requirements
• Audit trails
• Data privacy
• Legal requirements

Example tasks:

@agileflow-compliance implement GDPR consent
@agileflow-compliance add audit logging
@agileflow-compliance create data retention policy

Migration & Data Agents

agileflow-datamigration

Data migration planning

Specialties:

• Migration strategies
• Data validation
• Rollback plans
• Zero-downtime migrations
• Data transformation
• Migration testing

Example tasks:

@agileflow-datamigration plan user table migration
@agileflow-datamigration create rollback strategy
@agileflow-datamigration validate migrated data

Mobile Development Agent

agileflow-mobile

Mobile app development

Specialties:

• React Native
• Flutter
• Mobile UI patterns
• Platform-specific features
• Mobile performance
• App store deployment

Example tasks:

@agileflow-mobile create login screen for mobile
@agileflow-mobile optimize mobile performance
@agileflow-mobile implement push notifications

Utility Agents

agileflow-readme-updater

README and folder documentation

Specialties:

• README files
• Folder documentation
• Code structure docs
• Module overviews
• Quick start guides
• Documentation auditing

Example tasks:

@agileflow-readme-updater update project README
@agileflow-readme-updater sync docs folder README
@agileflow-readme-updater create component README

agileflow-context7

External documentation fetching

Specialties:

• Library documentation
• Framework guides
• API references
• Context fetching
• Documentation search
• Best practices lookup

Example tasks:

@agileflow-context7 get Next.js docs for routing
@agileflow-context7 fetch React Query documentation
@agileflow-context7 find Tailwind CSS examples

Agent Collaboration

Agents can work together on complex tasks:

# UI agent creates component
@agileflow-ui create user profile component

# Accessibility agent audits it
@agileflow-accessibility audit profile component

# Testing agent adds tests
@agileflow-testing add tests for profile component

# Documentation agent documents it
@agileflow-documentation document profile component API

Best Practices

1. Be Specific

Bad:

@agileflow-api fix the thing

Good:

@agileflow-api implement POST /api/users endpoint with email validation

2. Provide Context

@agileflow-ui create login form matching our design system
Story: AF-001
Design: figma.com/file/abc123

3. Set Expectations

@agileflow-testing create unit tests with >80% coverage
Include edge cases for:
- Empty inputs
- Invalid formats
- Network errors

4. Use the Right Agent

• API work → agileflow-api
• UI components → agileflow-ui
• Database → agileflow-database
• Tests → agileflow-testing
• Deployment → agileflow-devops

Next Steps