| name | gene-first-debug |
| description | Route bugfixes through engineering gene cluster, navigation map, and hot files before repo-wide search. |
Gene-first debug
When to use
Bugfix or incident in a non-trivial area (multi-file subsystem).
Steps
- GENE_COMPRESSION_MAP.md — Cluster Engineering.
- repo.engineering.controlled_changes.gen1 — no throwaway bulk patches.
- AI_NAVIGATION_MAP.md → nearest AI_INDEX.md.
- Open 1–2 hot files; then scoped grep.
Do not
- Start with repo-wide
grep when map/index exists.
- Open more than 3 gene files before reading the map.