Add DOMAIN-AWARENESS.md and update SKILL.md files to reference it for code exploration

This commit is contained in:
Matt Pocock 2026-04-28 12:04:01 +01:00
parent ecdadb4076
commit f76e3ba4af
8 changed files with 63 additions and 11 deletions

View file

@ -7,6 +7,8 @@ description: Disciplined diagnosis loop for hard bugs and performance regression
A discipline for hard bugs. Skip phases only when explicitly justified.
Before exploring the codebase, follow [../grill-with-docs/DOMAIN-AWARENESS.md](../grill-with-docs/DOMAIN-AWARENESS.md). Use the `CONTEXT.md` vocabulary to get a clear mental model of the relevant modules.
## Phase 1 — Build a feedback loop
**This is the skill.** Everything else is mechanical. If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause — bisection, hypothesis-testing, and instrumentation all just consume that signal. If you don't have one, no amount of staring at code will save you.