Rules
Rules are markdown files Claude reads at the start of every session in a repo. The claude repo shares two; each project repo adds its own beside them.
| Rule | Enforces |
|---|---|
| Git workflow | Branches named TICKET-ID/description from origin/main, commits as TICKET-ID | Description, no commits to main, no AI attribution, files staged by name, hooks never skipped |
| Self-documenting | How skills write to a repo's architecture.md: one technical fact per line with its file path, no business context, history or ticket references |
architecture.mdβ
Each project repo has its own .claude/rules/architecture.md. /read, /implement and /review add what they learn about the code, so later sessions don't have to rediscover it. It's committed in the project repo and corrected by PR like any other file.
Permissionsβ
The shared .claude/settings.json pre-approves the routine commands skills run (the Linear scripts, Biome, tests, the type check, and the skills themselves), so they run without a prompt each time.
Releasesβ
There are no versions. Changes land on main and every linked repo gets them on the next git pull. Every Friday, a summary of the week's changes posts to #devex-releases. Weeks with nothing to report post nothing.