evolve-claude-md

Review the current session and update the project's canonical agent-guidance file with anything durable that it doesn't yet know. ## Target file `CLAUDE.md` by default — but some repos keep a thin `CLAUDE.md` stub that redirects to a canonical `AGENTS.md` (the cross-tool convention scaffolded by `/repo-init`). Resolve the target before editing: A **redirect stub** is a `CLAUDE.md` whose only content is the redirect to AGENTS.md plus pointer lines (the shape `/repo-init` scaffolds) — nothing project-specific. A stray substantive line in an otherwise-stub file is *residue*: migrate it into `AGENTS.md` as part of this run and leave the stub clean. | Repo state | Edit | |---|---| | `CLAUDE.md` substantive, no `AGENTS.md` (the most common state) | `CLAUDE.md` | | `CLAUDE.md` is a redirect stub | `AGENTS.md` — leave the stub untouched (create `AGENTS.md` if the stub points at a missing file) | | No `CLAUDE.md`, but `AGENTS.md` exists | `AGENTS.md` | | Both exist with substantive content | `CLAUDE.md`, and flag the split-brain to the user so they can consolidate | | Neither exists | Create `CLAUDE.md` | ## What belongs in the canonical file Promote only knowledge that is: - **Permanent** — true beyond this session (not current task state) - **Project-level** — relevant to anyone working in this repo - **Non-obvious** — not derivable from reading the code directly Good candidates: renamed or new variables, corrected definitions, newly understood warn patterns, confirmed pipeli...