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