Metadata-Version: 2.4
Name: agileforagents
Version: 0.3.1
Summary: Turn any project idea into a verified, sprint-ready agile task board — inside your AI coding agent
License: MIT
Project-URL: Homepage, https://github.com/FAJU85/AgileForAgents
Project-URL: Repository, https://github.com/FAJU85/AgileForAgents
Project-URL: Issues, https://github.com/FAJU85/AgileForAgents/issues
Keywords: mcp,agile,ai-agents,claude-code,cursor,codex
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.9.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: ruff>=0.4.0; extra == "dev"
Requires-Dist: mypy>=1.10.0; extra == "dev"
Requires-Dist: pip-audit>=2.7.0; extra == "dev"

# 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

```bash
pip install agileforagents
```

Then register it with your MCP host.

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

```json
{
  "mcpServers": {
    "agileforagents": {
      "command": "agileforagents"
    }
  }
}
```

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

## What you get

| Tool | What it does |
|---|---|
| `generate_agile_tasks` | Takes your idea (however vague) and returns a verified, sprint-ready board. Supports `format`: `claude`, `json`, or `cursor`; and `detail_level`: `standard` or `detailed`. |
| `get_agent_rules` | Returns a ready-to-paste working protocol for your agent — drop it into `CLAUDE.md` or `.cursorrules`. |
| `feedback_stats` | Shows how many boards you've generated locally. |

## 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.

## Development

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

## License

MIT
