From 1f750e2797649d2b428abcadf5420a00657686c7 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Tue, 17 Nov 2026 22:28:58 -0800 Subject: [PATCH] docs(audit): fix what let each finding in, so the next run finds none Co-Authored-By: Claude Opus 5.5 --- assets/audit.md | 1 + assets/audits/code.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/assets/audit.md b/assets/audit.md index 9d70bd6b..f7d71acf 100644 --- a/assets/audit.md +++ b/assets/audit.md @@ -6,6 +6,7 @@ The stub's Plan holds only what this repository learned, and wins where it narro ## Findings Fix in the run's PR what is mechanical or already decided. +For each kind of finding, also fix what let it in, so the next run finds none: a fast gate check, a test, a simpler design, or an `AGENTS.md` rule proposed under `## Waiting` as `quest guide prompting` describes. Work that needs its own PR is a follow-up, as the guide's Creation section describes. A run cannot prompt, so each decision goes under the PR's `## Waiting` as a `Maintainer:` item with its options and a recommendation. diff --git a/assets/audits/code.md b/assets/audits/code.md index d1043b5e..24538418 100644 --- a/assets/audits/code.md +++ b/assets/audits/code.md @@ -13,6 +13,6 @@ Look for: Split the reading by area across parallel sub-agents, then verify each claim before acting: a duplicate can be a test seam or a deliberate split, and an unused flag can be a tuning knob or an old spelling kept to fail with migration guidance. -Delete dead private code and land simplifications in the run's PR, and add a check to the gate that would have caught a finding when it passes clean and runs fast. +Delete dead private code and land simplifications in the run's PR. Removing or reshaping a public API or a user-visible flag, route, or field, and narrowing a feature, are the maintainer's decisions: each is a follow-up with a recommendation and how users migrate. Record what was checked and kept on purpose, with why, as scope the next stub excludes.