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

$3

``bash
npx agileflow@latest setup
`

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

Updates:
`bash
npx agileflow@latest update
`

$3

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

$3

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

---

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 | 91 | Slash commands for agile workflows |
| Agents/Experts | 47 | Specialized agents with self-improving knowledge bases |
| Skills | Dynamic | Generated on-demand with /agileflow:skill:create |

---

Documentation

Full documentation lives in docs/04-architecture/:

$3

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

$3

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

$3

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

---

Examples

$3

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

$3

`bash
/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"
`

$3

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

$3

`bash
/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.