diff --git a/CLAUDE.md b/CLAUDE.md index bc9bfa7..2b10caf 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -168,6 +168,15 @@ Before you call any work done, check the row that matches what you touched: | worktree provisioning or the parity overlay | the "both roles read this file" premise — it rests on the worker's worktree being a checkout of this repo | | `.claude/skills/**` | the addendum's skill list, and the "name the playbook" rule | | a new peer kind (non-Claude adapter) | what that peer can read — anything it must obey belongs in its charter, not in the block | +| **anything an operator can use, configure, or observe** — an MCP tool, a `bridged.yaml` knob, an endpoint, a visible behaviour | **[Features](wiki/11-Features.md)** — one entry: what it does · the knob that turns it on · **why it exists** · the gotcha | + +That last row is not bookkeeping. Chapters 1–10 answer *how is this built* and *why this way*; +none of them has a home for *what can it do and how do I turn it on*, so for twenty tickets a +shipped capability landed nowhere and the Roadmap went on claiming the stage was finished. The +*why* line is the one that matters — without it a decision gets re-litigated from scratch a month +later. Internal contract changes go to `wiki/9-Implementation.md` instead; test and coverage work +is a Roadmap line. A change that touches none of the three earns no entry, and that is a normal +outcome rather than an omission. Then **propagate**: the block in this file and the template in the wiki ([Use Cases](https://git.ltms.dev/lms/claude-bridge/wiki/7-Use-Cases) → *The portable `CLAUDE.md`