# Project rules  ->  CLAUDE.md  (repo root)

<!-- Loaded every session IN THIS REPO. This is where the things you are tired
     of repeating in chat go. Rule of thumb: said it twice? Put it here. -->

# [Project name]

[One paragraph: what this is, who uses it, what breaks if it goes down.]

## Architecture facts that are not obvious from the code
- [e.g. "The X service writes to Y, not Z, despite the name."]
- [e.g. "Anything under /legacy is frozen. Do not refactor it."]

## Commands
- Build:  `[command]`
- Test:   `[command]`
- Deploy: `[command]`   <!-- name the ONE correct way, so it stops guessing -->

## Rules specific to this codebase
- [The rule you have repeated most in chat this month.]
- [The mistake it made that cost you time. State it as a rule.]

## Always persist what you learn
Whenever you research something non-obvious about this project (how a subsystem
works, where a thing lives, a deploy step, a gotcha, WHY something is the way it
is) write it down as a memory file immediately. Treat "I just looked this up" as
the trigger to save it. The goal: every lookup happens at most once.