{
  "markdown": "# ai-dev-kit\n\nGit conventions and documentation generation for AI-assisted development. Works with Claude Code, Cursor, Codex, and Gemini.\n\n## Install\n\n### Claude Code\n\n```bash\nclaude install github.com/BenWeekes/ai-dev-kit\n```\n\n### Cursor\n\n```bash\ncursor install github.com/BenWeekes/ai-dev-kit\n```\n\n## How it works\n\nai-dev-kit uses a skill-based architecture:\n\n1. **Session start** — a hook reads `skills/ai-dev-kit/SKILL.md` and injects git conventions into the session context. These are always active — you don't need to invoke anything.\n\n2. **On demand** — detailed workflows (ship, pr, sync, docs) are loaded via the Skill tool when you need them.\n\n### Ambient conventions (always active)\n\nThese rules are injected at session start and apply to every git operation:\n\n- lowercase commit messages\n- no AI tool names in commits\n- present tense (\"add feature\", not \"added feature\")\n- no Co-Authored-By trailers\n- no --no-verify\n\n### Skills (on demand)\n\n| Skill    | What it does                                      |\n| -------- | ------------------------------------------------- |\n| `ship`   | commit staged changes and push to remote          |\n| `pr`     | create a pull request from the current branch     |\n| `sync`   | rebase current branch onto latest main            |\n| `update` | generate progressive disclosure docs for the repo |\n| `test`   | verify generated docs meet the standard           |\n\n## Standards\n\nai-dev-kit includes two standards for AI-assisted development:\n\n- **[Progressive Disclosure Documentation](progressive-disclosure-standard.md)** — a three-level (L0/L1/L2) architecture that makes repos self-describing for AI agents\n- **[Multi-Repo Orchestration](multi-repo-orchestration.md)** — coordination patterns for features that span multiple repos\n\n## Using with other skills\n\nai-dev-kit pairs well with [Superpowers](https://github.com/obra/superpowers) for a complete workflow:\n\n1. spec — capture what you want to build\n2. plan — plan how to build it\n3. tdd — implement with tests\n4. review — review the changes\n5. ship — commit and push (ai-dev-kit conventions enforced)\n6. pr — create a PR\n7. update — update repo docs if needed\n\n## Repo structure\n\n| Path                 | Purpose                                        |\n| -------------------- | ---------------------------------------------- |\n| `skills/ai-dev-kit/` | skill definitions (SKILL.md + sub-skills)      |\n| `hooks/`             | session-start hook and platform wrappers       |\n| `*.md` (root)        | standards (progressive disclosure, multi-repo) |\n| `.claude-plugin/`    | Claude Code plugin config                      |\n| `.cursor-plugin/`    | Cursor plugin config                           |\n| `.codex/`            | Codex install guide                            |\n\n## License\n\nMIT\n",
  "bytes": 2796,
  "sha": "141214b8a9eecf4761f99525a559a20dd473e58f2263248194dc4674b762a62c",
  "repo_slug": "benweekes/ai-dev",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_benweekes_ai_dev_9e2ec25e/readme"
}