project-conventionslisted

## Root Files | File | Committed | Owns | | ----------------- | --------- | ------------------------------------------------------------------------------------------ | | `README.md` | Yes | Everything true for both humans and agents: what the project is, install, commands, usage. | | `CLAUDE.md` | Yes | Contains exactly `@AGENTS.md` and nothing else. | | `AGENTS.md` | Yes | Instructions only an agent needs: architecture, conventions, workflow. | | `CLAUDE.local.md` | No | Contains exactly `@AGENTS.local.md` and nothing else. | | `AGENTS.local.md` | No | User-specific agent instructions that must not be committed. | | `mise.toml` | Yes | Tool versions, tasks, and environment that version files can't express. Conditional. | | `mise.local.toml` | No | Secrets and machine-specific environment variables. | ALWAYS create `README.md`, `CLAUDE.md`, and `AGENTS.md` in every project. Create the local files only when there's local content to put in them. ## Ownership Never duplicate content between `README.md` and `AGENTS.md`. If something is useful to a human, it goes in the README even when agents also need it. `AGENTS.md` holds only what a hu