agileforagents 0.3.0

Zero-config MCP server that turns prompts into verified agile task boards for AI coding agents

AgileForAgents

Turn any project prompt into a verified, sprint-ready agile task board — right inside your AI coding agent.

AgileForAgents is a zero-config MCP server for Claude Code, Cursor, Codex CLI, and any MCP-compatible host. You describe a project in your IDE as you normally would; AgileForAgents turns it into a structured agile board (epics → sprints → user stories → subtasks) where every subtask has an observable done-criteria and every assumption is made explicit — following Andrej Karpathy's Spec methodology.

How it works

┌──────────────────────────┐   stdio    ┌────────────────────────┐   HTTPS    ┌──────────────────────────────┐
│  Your IDE                │◀──────────▶│  agileforagents        │───────────▶│  Hosted backend (HF Space)   │
│  Claude Code / Cursor /  │  MCP tool  │  MCP server            │  /api/     │  • runs a free HF model       │
│  Codex — you type here   │  call      │  (stdlib-only client)  │  generate  │  • holds the token server-side│
└──────────────────────────┘            └────────────────────────┘◀───────────│  • returns a verified board   │
                                                                                └───────────────┬──────────────┘
                                                                                                │ logs metrics
                                                                                                ▼
                                                                                  ┌──────────────────────────┐
                                                                                  │  Gradio Control Panel     │
                                                                                  │  (monitoring dashboard,   │
                                                                                  │   no prompt input)        │
                                                                                  └──────────────────────────┘

• You never leave your IDE. Prompts come from your editor through the MCP tool — not from a web form.
• No API key, no token, no heavy dependencies. The MCP server installs with just the MCP SDK + pydantic. All model inference happens on the hosted backend, which holds the Hugging Face token as a server-side secret.
• The Gradio Space is a control panel, not an input form — it shows how the generator is performing (volume, average verification score, recent activity).
• Works offline, degraded. If the backend is unreachable, a local heuristic fallback still returns a valid scaffold board so the tool never hard-fails.

Install

pip install agileforagents

Then register the agileforagents stdio server with your MCP host.

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

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

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

Tools

Tool	What it does
generate_agile_tasks	Turn a prompt into a verified agile board. Args: prompt, format (claude | json | cursor), detail_level (standard | detailed).
get_agent_rules	Return the AgileForAgents working protocol to paste into CLAUDE.md / .cursorrules.
feedback_stats	Local generation count + backend health.

Configuration (optional)

The MCP server works with no configuration. For self-hosting or testing you can override:

Env var	Purpose	Default
AFA_BACKEND_URL	Hosted backend base URL	https://vooom-agileforagents.hf.space
AFA_BACKEND_TIMEOUT	Request timeout (seconds)	120

Repository layout

Path	Purpose
src/agileforagents/	The installable stdio MCP server (thin client + formatters + fallback).
space/	The Hugging Face Space: FastAPI inference backend + Gradio monitoring dashboard.
tests/	Unit + E2E tests.

Development

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

License

MIT