Add judgment-layer mistake entries to AGENTS.md

.modonome/snapshot/badge.json

@@ -1 +1 @@
-{"color":"blue","label":"snapshot","message":"1028 files, 135721 tok","schemaVersion":1}
+{"color":"blue","label":"snapshot","message":"1029 files, 135721 tok","schemaVersion":1}

.modonome/snapshot/map.md

@@ -2,8 +2,8 @@
 
 Modonome snapshot. Read this before reading the repo. Tier 0 (signature.json) is the fingerprint: if merkle_root matches your last read, nothing changed. Tier 1 (map.json / map.md) lists modules, public API signatures, import edges, and attention ranking. Cite anchors (F: for files, S: for symbols); each resolves to a path and line so you can act without re-reading the whole repo.
 
-Merkle root: sha256:62a6e870efbe7c63703b73f821d612775640a9ee75f8943294157dd250b4acef
-Files: 1028  Bytes: 3801669  Map tokens: 135721/120000
+Merkle root: sha256:77f438f5f02372a26baf9b3f1e7ebccf8c303be25ed47f16122ccc4c80ee0f41
+Files: 1029  Bytes: 3805193  Map tokens: 135721/120000
 
 ## Modules
 
@@ -2717,54 +2717,54 @@ Files: 1028  Bytes: 3801669  Map tokens: 135721/120000
 
 ## Attention (centrality + pagerank)
 
-1. scripts/lib/messages.mjs centrality=63 pagerank=0.039184
-2. scripts/lib/message-catalog/index.mjs centrality=58 pagerank=0.011805
-3. design-system/src/lib/cx.ts centrality=32 pagerank=0.02673
-4. design-system/src/components/Icon/Icon.tsx centrality=23 pagerank=0.017328
-5. design-system/src/index.ts centrality=48 pagerank=0.000703
-6. scripts/lib/yaml-lite.mjs centrality=21 pagerank=0.017011
-7. scripts/lib/jsonschema.mjs centrality=15 pagerank=0.019814
-8. scripts/agent/run-cycle.mjs centrality=25 pagerank=0.005153
-9. scripts/validate-config.mjs centrality=16 pagerank=0.004996
-10. apps/control-panel/src/state/types.ts centrality=13 pagerank=0.006797
-11. design-system/src/components/HelpHint/HelpHint.tsx centrality=12 pagerank=0.005897
-12. design-system/src/components/StatusPill/StatusPill.tsx centrality=12 pagerank=0.004204
-13. scripts/lib/learnings.mjs centrality=11 pagerank=0.004622
-14. scripts/agent/resolve-role.mjs centrality=11 pagerank=0.003587
-15. scripts/lib/canonical-json.mjs centrality=10 pagerank=0.003566
-16. scripts/lib/snapshot-core.mjs centrality=13 pagerank=0.001176
-17. design-system/src/components/Button/Button.tsx centrality=9 pagerank=0.00339
-18. scripts/lib/detect-attribution.mjs centrality=7 pagerank=0.00386
-19. scripts/validate-work-item.mjs centrality=9 pagerank=0.002614
-20. scripts/lib/config-validate.mjs centrality=7 pagerank=0.003548
-21. design-system/src/components/IconButton/IconButton.tsx centrality=6 pagerank=0.003934
-22. scripts/validate-knowledge-packet.mjs centrality=8 pagerank=0.002477
+1. scripts/lib/messages.mjs centrality=63 pagerank=0.039157
+2. scripts/lib/message-catalog/index.mjs centrality=58 pagerank=0.011797
+3. design-system/src/lib/cx.ts centrality=32 pagerank=0.026711
+4. design-system/src/components/Icon/Icon.tsx centrality=23 pagerank=0.017316
+5. design-system/src/index.ts centrality=48 pagerank=0.000702
+6. scripts/lib/yaml-lite.mjs centrality=21 pagerank=0.016999
+7. scripts/lib/jsonschema.mjs centrality=15 pagerank=0.0198
+8. scripts/agent/run-cycle.mjs centrality=25 pagerank=0.00515
+9. scripts/validate-config.mjs centrality=16 pagerank=0.004993
+10. apps/control-panel/src/state/types.ts centrality=13 pagerank=0.006792
+11. design-system/src/components/HelpHint/HelpHint.tsx centrality=12 pagerank=0.005893
+12. design-system/src/components/StatusPill/StatusPill.tsx centrality=12 pagerank=0.004201
+13. scripts/lib/learnings.mjs centrality=11 pagerank=0.004619
+14. scripts/agent/resolve-role.mjs centrality=11 pagerank=0.003584
+15. scripts/lib/canonical-json.mjs centrality=10 pagerank=0.003564
+16. scripts/lib/snapshot-core.mjs centrality=13 pagerank=0.001175
+17. design-system/src/components/Button/Button.tsx centrality=9 pagerank=0.003388
+18. scripts/lib/detect-attribution.mjs centrality=7 pagerank=0.003857
+19. scripts/validate-work-item.mjs centrality=9 pagerank=0.002613
+20. scripts/lib/config-validate.mjs centrality=7 pagerank=0.003546
+21. design-system/src/components/IconButton/IconButton.tsx centrality=6 pagerank=0.003931
+22. scripts/validate-knowledge-packet.mjs centrality=8 pagerank=0.002475
 23. apps/control-panel/src/App.tsx centrality=10 pagerank=0.001001
-24. scripts/agent/render-prompt.mjs centrality=7 pagerank=0.00276
-25. design-system/src/components/WorkItemCard/WorkItemCard.tsx centrality=8 pagerank=0.002053
-26. apps/control-panel/server/modonomeWriter.mjs centrality=8 pagerank=0.001788
-27. design-system/src/tokens/tokens.ts centrality=6 pagerank=0.002457
-28. scripts/lib/lang-adapters/index.mjs centrality=8 pagerank=0.001176
-29. scripts/agent/providers.mjs centrality=3 pagerank=0.004266
-30. scripts/lib/graph.mjs centrality=5 pagerank=0.002889
-31. scripts/lib/branch-name.mjs centrality=4 pagerank=0.003367
-32. design-system/src/components/Tooltip/Tooltip.tsx centrality=3 pagerank=0.003817
-33. scripts/snapshot.mjs centrality=8 pagerank=0.000703
-34. design-system/src/components/WorkItemDrawer/WorkItemDrawer.tsx centrality=7 pagerank=0.001311
-35. apps/control-panel/src/lib/confirm.tsx centrality=6 pagerank=0.00178
-36. scripts/lib/secret-patterns.mjs centrality=4 pagerank=0.002983
-37. apps/control-panel/src/lib/messages.ts centrality=6 pagerank=0.001686
-38. design-system/src/components/Card/Card.tsx centrality=5 pagerank=0.002053
-39. design-system/src/lib/format.ts centrality=5 pagerank=0.002052
-40. scripts/agent/openai-client.mjs centrality=5 pagerank=0.002024
-41. design-system/src/components/LeaseTable/LeaseTable.tsx centrality=6 pagerank=0.001311
-42. scripts/lib/commit-identity.mjs centrality=3 pagerank=0.00314
-43. scripts/agent/review-diff.mjs centrality=5 pagerank=0.001576
-44. scripts/lib/work-item-validate.mjs centrality=4 pagerank=0.002118
+24. scripts/agent/render-prompt.mjs centrality=7 pagerank=0.002758
+25. design-system/src/components/WorkItemCard/WorkItemCard.tsx centrality=8 pagerank=0.002052
+26. apps/control-panel/server/modonomeWriter.mjs centrality=8 pagerank=0.001787
+27. design-system/src/tokens/tokens.ts centrality=6 pagerank=0.002455
+28. scripts/lib/lang-adapters/index.mjs centrality=8 pagerank=0.001175
+29. scripts/agent/providers.mjs centrality=3 pagerank=0.004263
+30. scripts/lib/graph.mjs centrality=5 pagerank=0.002887
+31. scripts/lib/branch-name.mjs centrality=4 pagerank=0.003365
+32. design-system/src/components/Tooltip/Tooltip.tsx centrality=3 pagerank=0.003814
+33. scripts/snapshot.mjs centrality=8 pagerank=0.000702
+34. design-system/src/components/WorkItemDrawer/WorkItemDrawer.tsx centrality=7 pagerank=0.00131
+35. apps/control-panel/src/lib/confirm.tsx centrality=6 pagerank=0.001779
+36. scripts/lib/secret-patterns.mjs centrality=4 pagerank=0.002981
+37. apps/control-panel/src/lib/messages.ts centrality=6 pagerank=0.001684
+38. design-system/src/components/Card/Card.tsx centrality=5 pagerank=0.002052
+39. design-system/src/lib/format.ts centrality=5 pagerank=0.002051
+40. scripts/agent/openai-client.mjs centrality=5 pagerank=0.002022
+41. design-system/src/components/LeaseTable/LeaseTable.tsx centrality=6 pagerank=0.00131
+42. scripts/lib/commit-identity.mjs centrality=3 pagerank=0.003137
+43. scripts/agent/review-diff.mjs centrality=5 pagerank=0.001575
+44. scripts/lib/work-item-validate.mjs centrality=4 pagerank=0.002116
 45. apps/control-panel/src/screens/SettingsScreen.tsx centrality=6 pagerank=0.000797
 46. apps/control-panel/src/state/adapter.ts centrality=6 pagerank=0.000797
-47. examples/demo-app/src/index.js centrality=6 pagerank=0.000703
-48. scripts/build-policy-attestation.mjs centrality=6 pagerank=0.000703
-49. design-system/src/components/ActivationLadder/ActivationLadder.tsx centrality=5 pagerank=0.001311
-50. design-system/src/components/CostPanel/CostPanel.tsx centrality=5 pagerank=0.001311
+47. examples/demo-app/src/index.js centrality=6 pagerank=0.000702
+48. scripts/build-policy-attestation.mjs centrality=6 pagerank=0.000702
+49. design-system/src/components/ActivationLadder/ActivationLadder.tsx centrality=5 pagerank=0.00131
+50. design-system/src/components/CostPanel/CostPanel.tsx centrality=5 pagerank=0.00131
 

.modonome/snapshot/signature.json

@@ -1 +1 @@
-{"commands":{"build":"","lint":"","test":"npm test"},"entrypoints":["bin/modonome.mjs"],"generated_at":"2026-07-08T16:55:44.941Z","generated_for":"modonome","governance":{"armed":false,"autonomy_enabled":false,"dry_run":true},"instructions":["AGENTS.md","CLAUDE.md","CODEX.md","CONTRIBUTING.md","README.md"],"language_mix":{"(none)":12,"cff":1,"css":50,"diff":18,"html":9,"js":19,"json":138,"jsonl":8,"md":144,"mjs":351,"patch":40,"png":5,"py":4,"sh":1,"svg":2,"tf":4,"toml":2,"ts":61,"tsx":98,"txt":18,"webmanifest":1,"webp":1,"woff2":9,"xml":1,"yaml":9,"yml":22},"merkle_root":"sha256:62a6e870efbe7c63703b73f821d612775640a9ee75f8943294157dd250b4acef","preamble":"Modonome snapshot. Read this before reading the repo. Tier 0 (signature.json) is the fingerprint: if merkle_root matches your last read, nothing changed. Tier 1 (map.json / map.md) lists modules, public API signatures, import edges, and attention ranking. Cite anchors (F: for files, S: for symbols); each resolves to a path and line so you can act without re-reading the whole repo.","protected_paths":[".github",".github/CODEOWNERS","package-lock.json"],"schema_version":1,"size":{"bytes":3801669,"files":1028},"snapshot_version":47,"stack":{"name":"Node or TypeScript","pm":"npm"},"tier_hashes":{"map":"sha256:b96657a3bac92cf922d26b72444bd89ed1b01392f401971e6d3a22dd559ad2df","map_md":"sha256:e89b6166557a4346be076a1e91ae6a98b124cab126aad0595c6e6217b6b44554"}}
+{"commands":{"build":"","lint":"","test":"npm test"},"entrypoints":["bin/modonome.mjs"],"generated_at":"2026-07-16T02:18:05.384Z","generated_for":"modonome","governance":{"armed":false,"autonomy_enabled":false,"dry_run":true},"instructions":["AGENTS.md","CLAUDE.md","CODEX.md","CONTRIBUTING.md","README.md"],"language_mix":{"(none)":12,"cff":1,"css":50,"diff":18,"html":9,"js":19,"json":139,"jsonl":8,"md":144,"mjs":351,"patch":40,"png":5,"py":4,"sh":1,"svg":2,"tf":4,"toml":2,"ts":61,"tsx":98,"txt":18,"webmanifest":1,"webp":1,"woff2":9,"xml":1,"yaml":9,"yml":22},"merkle_root":"sha256:77f438f5f02372a26baf9b3f1e7ebccf8c303be25ed47f16122ccc4c80ee0f41","preamble":"Modonome snapshot. Read this before reading the repo. Tier 0 (signature.json) is the fingerprint: if merkle_root matches your last read, nothing changed. Tier 1 (map.json / map.md) lists modules, public API signatures, import edges, and attention ranking. Cite anchors (F: for files, S: for symbols); each resolves to a path and line so you can act without re-reading the whole repo.","protected_paths":[".github",".github/CODEOWNERS","package-lock.json"],"schema_version":1,"size":{"bytes":3805193,"files":1029},"snapshot_version":48,"stack":{"name":"Node or TypeScript","pm":"npm"},"tier_hashes":{"map":"sha256:c20fea6d25c684bdfe1869f9bbf38795af8e115fd20319f2a0b9ff74c2aa384b","map_md":"sha256:4b9306d71a881e0734759dd869e5e3d6db6007af9c93a7cb84cbd327f9f91edf"}}

.modonome/work-items/WI-054-judgment-layer-mistake-entries.json

@@ -0,0 +1,24 @@
+{
+  "schema_version": 1,
+  "id": "WI-054-judgment-layer-mistake-entries",
+  "state": "checking",
+  "type": "update-docs",
+  "attempts": 0,
+  "max_attempts": 3,
+  "touches_protected_path": false,
+  "allowed_edit_set": [
+    "AGENTS.md",
+    "CHANGELOG.md",
+    "RELEASE-EVIDENCE.md",
+    ".modonome/work-items/WI-054-judgment-layer-mistake-entries.json",
+    ".modonome/snapshot/*",
+    ".modonome/work-items/*"
+  ],
+  "gates": [
+    "node scripts/check-style.mjs .",
+    "npm run verify"
+  ],
+  "queued_at": "2026-07-16",
+  "maker_id": "techseek4vr",
+  "lease_owner": "techseek4vr"
+}

AGENTS.md

@@ -267,6 +267,25 @@ it. Most of these gates exist because the mistake actually happened here.
 18. **Inline site CSP.** Adding a meta CSP tag to `site/*.html`. It broke the live
     host once and was reverted (PR #106). Rule: CSP is enforced at Cloudflare and
     `site/_headers`; the site is a protected path.
+19. **Silent interpretation.** Acting on one reading of a goal that supports two or
+    more materially different readings. Rule: name the readings, recommend one, and
+    wait (ask in session, or add an Open entry with options and a recommendation to
+    `.modonome/DECISIONS.md`); when one reading is clearly intended, proceed and
+    state the assumption in the rationale. Gate: none; this one is on you and the
+    checker.
+20. **Speculative scope.** Building past the stated need: an extra feature, an
+    unrequested config control, an abstraction with a single call site, or handling
+    for inputs that cannot occur. Rule: build the smallest change that solves the
+    stated problem, and propose the simpler approach when you see one; every config
+    control costs four synced representations plus a changelog entry (section 5).
+    Gate: checker review; `max_diff_lines` caps only size.
+21. **Within-file scope drift.** Reformatting, renaming, or polishing adjacent code
+    inside a file the item allows. Entry 9 polices which files change; this entry
+    polices the lines inside them. Rule: every changed line traces to the goal;
+    match the file's existing style even where you would choose differently; flag
+    unrelated dead code in the review instead of deleting it. Removing code your own
+    change orphaned (an import, a variable, a helper) belongs to the change. Gate:
+    checker review; the edit-set gate cannot see inside a file.
 
 ## 5. Quality bar per deliverable
 
@@ -362,7 +381,9 @@ Stop and route to the owner when any of the following applies:
 8. Net-new product, market, architecture, security, legal, or policy claims
    (Tier 4, `GOVERNANCE.md`).
 9. The destination of a produced document is unclear: ask before writing.
-10. Anything Tier 3 or Tier 4 under `GOVERNANCE.md`: public API, schema, migration,
+10. The goal supports two or more materially different readings: present the
+    readings with a recommendation and wait, rather than choosing one silently.
+11. Anything Tier 3 or Tier 4 under `GOVERNANCE.md`: public API, schema, migration,
     CI, auth, secrets, protected docs, autonomous merge enablement, cross-repo
     changes.
 

CHANGELOG.md

@@ -20,7 +20,24 @@ maker/checker loop; deterministic gate-rejection evidence on the demo app; and a
 documentation truth pass (claims reconciled to committed evidence, self-graded benchmark
 framing, honest scope labels). Full detail below, newest first.
 
-### Wire the researcher role into the agent loop (WI-042)
+### Name the judgment-layer mistakes the gates cannot see (WI-054)
+
+- Added three entries to the mistake catalog in `AGENTS.md` (section 4), each in the
+  existing mistake-rule-gate shape: silent interpretation of an ambiguous goal (entry
+  19), speculative scope (entry 20), and within-file scope drift (entry 21). Entry 21
+  complements entry 9: the edit-set gate polices which files change, entry 21 polices
+  the lines inside them, where a deterministic check cannot reach.
+- Added one trigger to the escalation list in `AGENTS.md` (section 6, new item 10): a
+  goal that supports two or more materially different readings routes to the owner
+  with the readings and a recommendation, reusing the options format
+  `.modonome/DECISIONS.md` Open entries already carry. The prior item 10 is now 11.
+- Deliberately added no prose for verification discipline: work-item `gates`, the
+  brief's `fence`, and the section 5 quality bar already enforce it deterministically,
+  and prose restating a live gate invites drift. The shipped prompt modules
+  (`prompts/modules/state-machine.md`, `prompts/modules/adoption.md`) already bind
+  dispatched agents to the same discipline, so `prompts/` is untouched.
+- Documentation only. No script, schema, or config control change; `schema_version`
+  stays at 1. Existing sessions inherit the rules on their next read of `AGENTS.md`.
 
 - Added `prompts/roles/researcher.txt`: reads the repo's own durable state, drafts one
   proposal, runs it past the independent check at Checkpoint 1

RELEASE-EVIDENCE.md

@@ -29,6 +29,7 @@ be added here once the owner arms the loop on this repo.
 
 ## Work queue
 
+- checking: 1
 - done: 45
 - queued: 4