From 0a6522aa629cb3f6a53296585b352cca1c969ab4 Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Sun, 15 Nov 2026 13:29:49 +0100 Subject: [PATCH] =?UTF-8?q?Answer=20stability=20round=201:=200=20?= =?UTF-8?q?=F0=9F=94=B4,=203=20=F0=9F=9F=A1=20(0=20misread);=20the=20secti?= =?UTF-8?q?on=20reader=20stops=20at=20its=20section's=20end,=20the=20test?= =?UTF-8?q?=20listing=20matches=20indented=20tests=20and=20prefixed=20legs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 942272a..331038d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -181,16 +181,19 @@ Per chunk: the PR summary names each fix no round reviewed. 3. Merge the PR (standing authorization, this repo only, granted by the maintainer), report, stop. -A chunk reads these files in part. One call prints a `## ` section by a fragment of its title: -`awk -v h='' '/^## /{p=index($0,h)>0} p' <file> | head -80`. +A chunk reads these files in part. `grep -n '^#' <file>` lists the headings. This prints the first +`## ` section whose title holds the fragment, so one call reads a section whole, and the fragment +holds no apostrophe: `awk -v h='<fragment>' '/^## /{if(p)exit; p=index($0,h)>0} p' <file>`. A `###` +section, or one past 80 lines, is read in ranges. - `CHANGELOG.md`: `## Unreleased` only, the one section a chunk edits. - `MIGRATION.md`: the top `## From` section, the release being built. - `README.md`: `## Goals`, `## Audience` and the sections the chunk changes or cites. -- `docs/decisions.md`: the entries the chunk cites, found by the titles indexed above, never the file. +- `docs/decisions.md`: only the entries the chunk cites, by their titles under `## Decisions` above. - `spec/flavour.md`, `spec/html.md`: the sections the chunk changes or cites. -- A test file or `ci.sh`: its titles or legs, from `grep -n '^test(\|^leg' <file> | cut -c1-110`, - then a ranged read of the ones the chunk touches. +- A test file or `ci.sh`: its tests or legs, from + `grep -nE '^\s*test\(|^(\w+=\S+ )*leg ' <file> | cut -c1-110`, then a ranged read of the ones the + chunk touches. Reserved for the maintainer whatever any rule here says: changing `version` in `package.json` (a bump on `main` publishes, `docs/decisions.md` §Publish on a version bump — every release is the