kiss-maplisted

# KISS — Map Finding things by reading the codebase is expensive and unreliable: a wide grep plus a long read burns thousands of tokens, and a missed search invites a confident wrong guess. The map fixes both. **Consult the map first; never guess about what exists.** ## The artifact: `.kiss/inert.md` A single generated markdown file — the project's distilled source of truth for *what exists and where*. One compact entry per symbol: ``` file · section · symbol · signature · line · one-line synopsis ``` It is **inert** (no runtime effect), **generated** (never hand-edited), **gitignored** (cannot ship, cannot drift in history), and the agent's **first stop**. ## Discipline - **Consult `.kiss/inert.md` first.** Before editing: look up the symbol → jump straight to `file:line`. Before creating: check for a **twin** (duplicate → reuse) or **relative** (related → extend/compose). This is the twin/relative check `kiss-plan` calls for. - **Grep it, don't read it whole.** Look up the one entry you need; do not load the entire map. That keeps it cheap at any project size. - **It is the source of truth for existence.** "I don't think that exists" → check the map, don't guess. If the map disagrees with reality, the map is **stale, not wrong** — regenerate it. - **Regenerate when stale.** One pass, cheap. Do it after adding/removing/renaming symbols, or whenever in doubt. Never hand-patch the map. ## Generating ``` python tools/kiss/kiss-map-gen.py <repo-root> ``` Writ