AI-driven agile development for Claude Code, Cursor, Windsurf, OpenAI Codex CLI, and more. Combining Scrum, Kanban, ADRs, and docs-as-code principles into one framework-agnostic system.

Quick Start

Installation

npx agileflow@latest setup

That's it! The npx command always fetches the latest version.

Updates:

npx agileflow@latest update

After Setup

/agileflow:help              # View all commands
/agileflow:babysit           # Interactive mentor for implementation
/agileflow:configure         # Configure hooks, status line, etc.

Supported IDEs

| IDE | Status | Config Location | |-----|--------|-----------------| | Claude Code | Supported | .claude/commands/agileflow/ | | Cursor | Supported | .cursor/commands/agileflow/ | | Windsurf | Supported | .windsurf/workflows/agileflow/ | | OpenAI Codex CLI | Supported | .codex/skills/ and ~/.codex/prompts/ |

Why AgileFlow?

AgileFlow combines three proven methodologies:

• Agile (Scrum/Kanban) - Break work into Epics → Stories → Acceptance Criteria
• ADRs - Record architectural decisions so future teams don't re-debate
• Docs-as-Code - Humans and AI agents coordinate via versioned files

Key Benefits:

• Clear priorities and testable increments
• Durable memory and decision history
• Multi-agent collaboration via message bus
• Works with any tech stack or framework

Core Components

| Component | Count | Description | |-----------|-------|-------------| | Commands | 94 | Slash commands for agile workflows | | Agents/Experts | 55 | Specialized agents with self-improving knowledge bases | | Skills | Dynamic | Generated on-demand with /agileflow:skill:create |

Documentation

Full documentation lives in docs/04-architecture/:

Reference

• Commands - All 94 slash commands
• Agents/Experts - 55 specialized agents with self-improving knowledge
• Skills - Dynamic skill generator with MCP integration

Architecture

• AgileFlow CLI Overview - System architecture
• Agent Expert System - Self-improving agents
• Multi-Expert Orchestration - Parallel expert analysis
• Multi-Session Coordination - Parallel Claude Code sessions

Configuration

• Configuration System - 8 configuration agents
• Hooks System - Event-driven automation
• Session Harness - Test verification and sessions
• PreCompact Context - Context preservation during compacts

Examples

Create an Epic with Stories

/agileflow:epic EPIC=EP-0001 TITLE="User Authentication" OWNER=AG-API GOAL="Secure login"

Work on a Story

/agileflow:assign STORY=US-0001 NEW_OWNER=AG-UI NEW_STATUS=in-progress
# ... implement ...
/agileflow:status STORY=US-0001 STATUS=in-review SUMMARY="Login form complete"

Use Multi-Expert Analysis

/agileflow:multi-expert Is this authentication implementation secure?

Work in Parallel Sessions

/agileflow:session:new       # Create isolated workspace
/agileflow:session:status    # View all sessions

Project Structure

After running agileflow setup:

docs/
  00-meta/             # Templates, conventions
  01-brainstorming/    # Ideas and sketches
  02-practices/        # Testing, git, CI practices
  03-decisions/        # ADRs
  04-architecture/     # Architecture documentation
  05-epics/            # Epic definitions
  06-stories/          # User stories
  07-testing/          # Test cases
  08-project/          # Roadmap, backlog
  09-agents/           # Agent status, message bus
  10-research/         # Research notes

Online Documentation

Visit docs.agileflow.projectquestorg.com for the full documentation site.

License

MIT

Support

For issues or questions, visit the GitHub repository.