AgileForAgents

Turn any project idea into a structured, sprint-ready task board — instantly, inside your AI coding agent.

Stop starting with a blank file. Describe what you want to build and AgileForAgents hands your agent a complete, verified plan: epics broken into sprints, user stories, subtasks with clear done-criteria, and every assumption made explicit — so your agent executes with precision instead of guessing.

Works in Claude Code, Cursor, Codex CLI, and any MCP-compatible environment. No account, no API key, no configuration required.

Install

pip install agileforagents

Requires Python 3.11 or later.

Then register it with your MCP host.

Claude Code (~/.claude/mcp.json or your project's .mcp.json):

{
  "mcpServers": {
    "agileforagents": {
      "command": "agileforagents"
    }
  }
}

Cursor / Codex CLI: point your MCP config at the agileforagents command. No environment variables required.

What you get

How to use it

Just describe your project naturally — AgileForAgents handles the planning:

"Build a subscription billing system with Stripe, user portal, and email receipts"

Your agent receives back a complete board with epics, sprints, user stories, and subtasks — each with an observable done-criteria — ready to execute immediately.

Example output (abbreviated):

## Project Goal
Deliver a subscription billing system with Stripe payments, self-service
user portal, and transactional email receipts.

## Sprint 1 — Core Billing
- [ ] Integrate Stripe Checkout for plan selection
  Done: Checkout session created, webhook receives payment confirmation
- [ ] Store subscription state in Postgres
  Done: subscriptions table seeded, status transitions tested
...

Offline mode

If the backend is temporarily unavailable, AgileForAgents returns a heuristic scaffold automatically — no error, no interruption. The board is marked as offline mode so you know to review it before executing.

Note: The first request after a period of inactivity may take up to 60 seconds while the backend warms up. Subsequent requests are fast.

Troubleshooting

Board generation hangs for 60+ seconds on first use The backend may be cold-starting. Wait up to 90 seconds; it will complete. Subsequent requests in the same session are fast.

Board returned says "Generated in offline mode" The backend was temporarily unreachable. The heuristic scaffold is a useful starting point — review and refine before handing to your agent.

agileforagents command not found after install Ensure the Python scripts directory is on your PATH. With a virtual environment: activate it first. With pipx: pipx install agileforagents.

MCP host shows the tool but calls fail Restart your MCP host after installing or upgrading. Claude Code: /mcp → reconnect. Cursor: reload window.

Development

pip install -e ".[dev]"
make format-check && make lint && make typecheck && make test

Changelog

See CHANGELOG.md.

License

MIT