Git conventions and documentation generation for AI-assisted development. Works with Claude Code, Cursor, Codex, and Gemini.
claude install github.com/BenWeekes/ai-dev-kitcursor install github.com/BenWeekes/ai-dev-kitai-dev-kit uses a skill-based architecture:
-
Session start — a hook reads
skills/ai-dev-kit/SKILL.mdand injects git conventions into the session context. These are always active — you don't need to invoke anything. -
On demand — detailed workflows (ship, pr, sync, docs) are loaded via the Skill tool when you need them.
These rules are injected at session start and apply to every git operation:
- lowercase commit messages
- no AI tool names in commits
- present tense ("add feature", not "added feature")
- no Co-Authored-By trailers
- no --no-verify
| Skill | What it does |
|---|---|
ship |
commit staged changes and push to remote |
pr |
create a pull request from the current branch |
sync |
rebase current branch onto latest main |
update |
generate progressive disclosure docs for the repo |
test |
verify generated docs meet the standard |
ai-dev-kit includes two standards for AI-assisted development:
- Progressive Disclosure Documentation — a three-level (L0/L1/L2) architecture that makes repos self-describing for AI agents
- Multi-Repo Orchestration — coordination patterns for features that span multiple repos
ai-dev-kit pairs well with Superpowers for a complete workflow:
- spec — capture what you want to build
- plan — plan how to build it
- tdd — implement with tests
- review — review the changes
- ship — commit and push (ai-dev-kit conventions enforced)
- pr — create a PR
- update — update repo docs if needed
| Path | Purpose |
|---|---|
skills/ai-dev-kit/ |
skill definitions (SKILL.md + sub-skills) |
hooks/ |
session-start hook and platform wrappers |
*.md (root) |
standards (progressive disclosure, multi-repo) |
.claude-plugin/ |
Claude Code plugin config |
.cursor-plugin/ |
Cursor plugin config |
.codex/ |
Codex install guide |
MIT