# adhd-mcp

ADHD-friendly **Cursor** agent kit: on-demand Q&A, concise replies with status footer, context stats via MCP.

## Install

```bash
cd your-project
npx adhd-mcp init
```

Reload MCP in Cursor → **new Agent chat**.

## What `init` writes

| Path | Role |
|------|------|
| `.cursor/rules/adhd.mdc` | Output baseline + Q&A gate + coding ladder |
| `.cursor/skills/adhd-qa/` | Q&A clarification workflow |
| `.cursor/skills/adhd-output/` | Short reply + footer format |
| `.cursor/skills/frontend-design/` | Distinctive UI (anti–AI-slop) |
| `.cursor/skills/web-design-guidelines/` | Vercel Web Interface Guidelines audit |
| `.cursor/mcp.json` | Merges `adhd_mcp` server |
| `adhd/sessions/` | Q&A session logs |

## MCP tools

- `estimate_context` — context % (reported or ~heuristic)
- `format_status_footer` — `📊 理解 X% │ 进度 Y% │ ctx ~Z%`
- `check_readiness` — block code until understanding ≥95%
- `verify_against_requirement` — after edits: user wording vs coding ladder
- `qa_session_start` / `qa_session_append` — session files

## v1 scope

✅ Rule + Skills + MCP + init  
❌ GitHub search (v2) · hitl integration

## Dev

```bash
npm install
npm run smoke
npm run local-test
node dist/index.js init --cwd /path/to/project --force --local
```

After publish, users run `npx adhd-mcp init` (uses npm; no `--local`).

## License

MIT