ai-devkit provides git conventions and documentation generation as skills for AI coding agents.
| Path | Purpose |
|---|---|
skills/ai-devkit/SKILL.md |
entry point — conventions + skill directory |
skills/ai-devkit/git/ |
git workflow skills (ship, pr, sync) |
skills/ai-devkit/docs/ |
documentation skills (generate, update, test) |
hooks/ |
session-start hook, platform wrappers |
docs/ |
documentation standard + orchestration guide |
.claude-plugin/ |
Claude Code plugin config |
.cursor-plugin/ |
Cursor plugin config |
.codex/ |
Codex install guide |
gemini-extension.json |
Gemini extension config |
- AGENTS-first delivery — the progressive disclosure standard's
AGENTS.mdtemplate is the primary portable way to deliver git conventions and doc commands across repos. - Plugin injection — for supported plugin setups,
hooks/session-startreadsskills/ai-devkit/SKILL.mdand injects git conventions plus the skill directory into the session context at startup. - On-demand skills — detailed workflows (ship, pr, sync, docs) are loaded via the Skill tool when invoked.
- Commit messages: conventional commits (
feat:,fix:,chore:,test:,docs:), lowercase after prefix, present tense, no AI tool names. - Branch names:
type/short-description— lowercase, hyphen-separated (e.g.feat/token-refresh). - Spec before plan, plan before code. Separate WHAT from HOW.
- Test driven development. Write the test first, verify it fails, implement, verify it passes.
- Review before commit. AI review checks spec compliance and code quality.
The AGENTS.md template defined in section 4.7 of the progressive disclosure standard is the primary way repos adopt git conventions and doc commands. Any repo that creates an AGENTS.md from that template gets conventions without installing ai-devkit as a plugin. The plugin (skills + hooks) is a convenience for tools that support it.
- Superpowers — spec, plan, TDD, review workflow