Commands Reference
Complete reference for all 41 AgileFlow commands
Commands Reference
AgileFlow provides 41 slash commands to streamline your development workflow. Commands are organized by category.
Story Management
/AgileFlow:story
Create a new user story with AI-generated acceptance criteria.
Prompts for:
- Feature description
- User type
- Business value
Generates:
- User story (As a/I want/So that)
- Given/When/Then acceptance criteria
- Story points estimate
- Technical requirements
- Test scenarios
Stories are saved to .agileflow/stories/ with auto-generated IDs (AF-001, AF-002, etc.)
/AgileFlow:epic
Create an epic with multiple related stories.
Use cases:
- Large features spanning multiple sprints
- Feature sets with dependencies
- Product initiatives
Generates:
- Epic structure
- Individual stories
- Dependency mapping
- Milestone planning
/AgileFlow:status
Update the status of a story.
Valid statuses:
backlog- Not yet plannedready- Ready for sprintin-progress- Being worked onreview- In code review/testingdone- Completedblocked- Blocked by dependency
/AgileFlow:assign
Assign a story to an owner.
Owners:
- Agent names (AG-API, AG-UI, AG-TESTING, etc.)
- Team member names
unassignedto clear owner
Sprint Planning
/AgileFlow:sprint
Interactive sprint planning with velocity tracking.
Features:
- View team velocity
- Select stories for sprint
- Calculate capacity
- Set sprint goals
- Track dependencies
/AgileFlow:board
Display visual kanban board.
Shows:
- Stories by status
- Story points per column
- Sprint progress
- WIP limits (if configured)
/AgileFlow:velocity
Track and analyze team velocity.
Metrics:
- Average velocity (last 3/6/all sprints)
- Velocity trend
- Commitment reliability
- Recommended capacity
/AgileFlow:metrics
View sprint and project metrics.
Displays:
- Current sprint progress
- Velocity trends
- Cycle time
- Throughput
- Blocker count
Documentation
/AgileFlow:adr
Create an Architecture Decision Record.
Structure:
- Title: Decision being made
- Context: Why this decision is needed
- Decision: What you decided
- Consequences: Trade-offs and implications
Saved to: docs/03-decisions/
/AgileFlow:docs
Synchronize documentation with code changes.
Actions:
- Updates README files
- Syncs API documentation
- Generates changelog entries
- Updates code examples
/AgileFlow:readme-sync
Synchronize a folder's README with its contents.
Updates:
- File listings
- Module descriptions
- Usage examples
- Links to documentation
Code Quality
/AgileFlow:review
AI-powered code review with quality suggestions.
Checks:
- Code style and conventions
- Potential bugs
- Performance issues
- Security concerns
- Best practices
/AgileFlow:refactor
Identify and plan technical debt cleanup.
Analyzes:
- Code smells
- Duplication
- Complexity
- Test coverage
- Documentation gaps
/AgileFlow:debt
Track and prioritize technical debt.
Features:
- Debt inventory
- Impact/effort matrix
- Prioritization suggestions
- Cleanup roadmap
Testing
/AgileFlow:tests
Set up automated testing infrastructure.
Configures:
- Test framework
- Coverage reporting
- CI integration
- Test patterns
/AgileFlow:verify
Run project tests and update story status.
Actions:
- Runs test suite
- Updates test status on story
- Reports failures
- Generates coverage report
CI/CD & Deployment
/AgileFlow:ci
Bootstrap CI/CD workflow.
Sets up:
- GitHub Actions / GitLab CI
- Test automation
- Linting and type checking
- Build pipeline
/AgileFlow:deploy
Configure automated deployment.
Supports:
- Vercel, Netlify, AWS
- Docker containers
- Kubernetes
- Custom deployment scripts
/AgileFlow:packages
Manage dependencies with updates and security audits.
Features:
- Update outdated packages
- Security vulnerability scan
- Breaking change detection
- Dependency graph
Git & Pull Requests
/AgileFlow:pr
Generate pull request description from story.
Generates:
- PR title from story
- Description with context
- Testing instructions
- Checklist
/AgileFlow:changelog
Auto-generate changelog from commit history.
Format: Keep a Changelog
- Added, Changed, Fixed, Deprecated, Removed, Security
/AgileFlow:baseline
Mark current state as verified baseline.
Use cases:
- Before major changes
- After releases
- Known good states
Research & Analysis
/AgileFlow:research
Initialize research note with structured template.
Template sections:
- Question/Problem
- Context
- Options explored
- Findings
- Recommendations
- Next steps
Saved to: docs/research/
/AgileFlow:impact
Analyze change impact across codebase.
Analyzes:
- Files affected
- Dependent modules
- Test coverage
- Breaking changes
- Migration needs
/AgileFlow:deps
Visualize dependency graph with critical path.
Shows:
- Story dependencies
- Dependency chain
- Critical path
- Circular dependencies
- Blockers
Workflow Automation
/AgileFlow:auto
Auto-generate stories from PRDs, mockups, or specs.
Input types:
- Product requirements documents
- Design mockups (figma, etc.)
- Technical specifications
- User feedback
Generates:
- Epics and stories
- Acceptance criteria
- Priority ordering
- Story point estimates
/AgileFlow:babysit
Interactive mentor for end-to-end feature implementation.
Guides you through:
- Story creation
- Implementation
- Testing
- Documentation
- Pull request
- Deployment
Project Management
/AgileFlow:blockers
Track and resolve blockers.
Shows:
- Active blockers
- Blocked stories
- Blocker duration
- Suggested actions
- Owner assignment
/AgileFlow:update
Generate stakeholder progress report.
Includes:
- Sprint progress
- Completed stories
- Upcoming work
- Blockers and risks
- Velocity trends
/AgileFlow:retro
Generate retrospective with Start/Stop/Continue format.
Sections:
- What went well (Continue)
- What didn't work (Stop)
- What to try (Start)
- Action items
Configuration
/AgileFlow:setup
Bootstrap entire AgileFlow system in current project.
Creates:
.agileflow/directory structure- Configuration files
- Slash commands
- Agent contracts
/AgileFlow:agent
Onboard a new agent with profile and contract.
Creates:
- Agent profile
- Responsibilities
- Skills
- Command integration
/AgileFlow:template
Create and manage custom document templates.
Template types:
- Story templates
- ADR templates
- PR descriptions
- Documentation
Utilities
/AgileFlow:help
Display AgileFlow system overview and commands.
Shows:
- Command list
- Agent list
- Quick start guide
- Documentation links
/AgileFlow:diagnose
System health diagnostics.
Checks:
- Configuration validity
- File structure
- Dependencies
- Agent availability
- Command registration
/AgileFlow:compress
Compress status.json by removing verbose fields.
Optimizes:
- Removes redundant data
- Keeps tracking metadata
- Reduces file size
- Maintains functionality
/AgileFlow:feedback
Collect and process agent feedback.
Gathers:
- Agent performance
- Command effectiveness
- Workflow issues
- Improvement suggestions
/AgileFlow:handoff
Document work handoff between agents.
Records:
- Work completed
- Current state
- Next steps
- Context for next agent
/AgileFlow:context
Generate context export for web AI tools.
Exports:
- Project structure
- Current stories
- Configuration
- Recent changes
/AgileFlow:session-init
Initialize session harness with test verification.
Sets up:
- Session context
- Test environment
- Verification baseline
- Monitoring
/AgileFlow:resume
Resume work with verification and context loading.
Loads:
- Previous context
- Work in progress
- Pending actions
- Test status
/AgileFlow:story-validate
Validate story completeness before development.
Checks:
- Acceptance criteria present
- Story points estimated
- Dependencies identified
- No blockers
- Testable requirements
Command Tips
Most commands work with the current context. Run them from your project root for best results.
Chaining Commands
Some commands work well together:
Global Options
Many commands support:
--help- Show command help--verbose- Detailed output--quiet- Minimal output--dry-run- Preview without executing