From 168e1a24e49d9fde05f1665e5db55ee8c7e0245d Mon Sep 17 00:00:00 2001 From: Artur Shiriev Date: Sat, 19 Sep 2026 14:34:04 +0300 Subject: [PATCH] docs(adr): point the fact-placement link at a heading that exists --- docs/adr/README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/adr/README.md b/docs/adr/README.md index 214b568..7378e89 100644 --- a/docs/adr/README.md +++ b/docs/adr/README.md @@ -56,7 +56,9 @@ boundary of the decision; a reviewer is what enforces that. ## Where other facts go -This is one of four homes, and the narrowest. See -[`../../AGENTS.md`](../../AGENTS.md#where-a-fact-goes) for the admission check -that decides between code, an `INVARIANT:`-marked test, an ADR here, and a -GitHub issue for real work that is not scheduled. +This is one of four homes, and the narrowest. Anything an agent can read out of +`app/` stays in the code; a claim a wrong change could silently break belongs in +an `INVARIANT:`-marked test; a rejected alternative, with the reasoning that +would otherwise be re-litigated, is an ADR here; real work that is not scheduled +is a GitHub issue. [`../../AGENTS.md`](../../AGENTS.md#workflow) defines the +last two.