From de11ac401864c4e5b3ea54e0b2602d9ec6c4bf9c Mon Sep 17 00:00:00 2001 From: profit Date: Wed, 22 Apr 2026 21:33:27 -0500 Subject: [PATCH] auditor/README: document audit_lessons + scrum_reviews KB files MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds State section entries for the two KB files that close the feedback loop: audit_lessons.jsonl (findings → recurrence detector) and scrum_reviews.jsonl (scrum output → kb_query surfacing). Touch-commit to trigger re-audit on fresh SHA with the restarted auditor (which now has the fix-loaded code). --- auditor/README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/auditor/README.md b/auditor/README.md index a227b39..057930b 100644 --- a/auditor/README.md +++ b/auditor/README.md @@ -33,6 +33,13 @@ Defaults: polls every 90s, stops on `auditor.paused` file present. - `data/_auditor/state.json` — last-audited head SHA per PR - `data/_auditor/verdicts/{pr}-{sha}.json` — per-run verdict record +- `data/_kb/audit_lessons.jsonl` — one row per block/warn finding, + path-agnostic signature for dedup. Tailed by kb_query on each audit + to surface recurring patterns (2+ distinct PRs with same signature + → info, 3-4 → warn, 5+ → block). This is how the auditor learns. +- `data/_kb/scrum_reviews.jsonl` — scrum-master per-file reviews. If + a file in the current PR has been scrum-reviewed, kb_query surfaces + the review as a finding with the accepted model and attempt count. ## Where YOU edit