CLAUDE.md

1# CLAUDE.md — Claude Code pointer
2 
3> Claude Code auto-discovers `CLAUDE.md` at the repository root (and additional `CLAUDE.md` files in subdirectories). This file is a **pointer** — the authoritative rules live in [`.ai/`](.ai/) and per-directory `.ai/instruct.md` files. Do not duplicate rules into `CLAUDE.md`.
4 
5## Project rules location
6 
7This project uses the **Depth-Priority Hierarchical AI-INSTRUCT V5** system. **The deepest `.ai/instruct.md` always wins.**
8 
9Before suggesting any change, read in this order:
10 
111. [.github/dev-specs.md](.github/dev-specs.md) — **CRITICAL**: Are we in Template Development or Production mode? Then: developer OS, shell, language versions, frameworks.
122. [.github/copilot-instructions.md](.github/copilot-instructions.md) — meta: how the layering works.
133. [.hi/index.md](.hi/index.md) — master index of every instruction section.
144. [.hi/instruct.md](.hi/instruct.md) — workspace-root authority.
155. `[current-directory]/.hi/instruct.md` and every ancestor — **the deepest is authoritative**, shallower files are background context only.
16 
17## Cross-cutting rules
18 
19| Topic | Canonical file |
20|-------|---------------|
21| Naming, file organization | [.hi/conventions.md](.hi/conventions.md) |
22| Archive / never-delete / never-reset-db | [.hi/maintenance.md](.hi/maintenance.md) |
23| Credentials, `.env`, `.gitignore` | [.hi/credentials.md](.hi/credentials.md) |
24 
25## Do not
26 
27- Do not put project rules into this `CLAUDE.md` — they belong in the appropriate `.hi/` file.
28- Do not duplicate content from `.hi/` here. If Claude Code needs additional context, add a one-line pointer that links to the canonical file.
29- If you create per-module `CLAUDE.md` files, keep them as pointers to the matching `[module]/.hi/instruct.md` — never restate rules.
30