project-init documentation
project-init scaffolds agentic-development infrastructure: one command
drops a .agents/ layout (memory, docs, hooks, skills, curated MCPs, a
GitHub lifecycle) into any project so Claude Code — and other agents — are
productive and governed from the first prompt.
uv tool install project-init # or one-off: uvx project-init .
New here? Start with:
- Using project-init — install, wizard, day-to-day usage
- Positioning — how it compares to other scaffolders and plugins
- README on GitHub — full flag reference and agent-support tiers
For contributors and AI agents
| Path | Purpose |
|---|---|
adr/ |
Architecture Decision Records — why decisions were made |
development/ |
Contributing, standards, testing, template system |
guides/ |
How-to guides for users and contributors |
For active agent workflow rules, start with CLAUDE.md in the repo (AGENTS.md
redirects there); .github/copilot-instructions.md covers GitHub Issues, PR
titles, PR bodies, and board behavior.
Adding an ADR
- Copy the format from an existing ADR
- Increment the number:
adr-NNN-<topic>.md - Update this README's table
- Commit alongside the code change it documents