From ed971842ca3269cc86845693cb203330a32b67bb Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Fri, 1 May 2026 19:23:24 +0100 Subject: [PATCH] Tighten documentation drift guardrail --- AGENTS.md | 6 +++++- docs/architecture/agent-state-variable-glossary.md | 8 +++----- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 507d5c2..1de7696 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -112,4 +112,8 @@ When the user says to prepare for imminent compaction: - Before handoff, compaction, or phase boundaries, sync `state/map.yaml`, add distilled evidence when the lesson changes future belief, refresh `notes/fresh-workspace-handoff.md`, and make the next action explicit. - +- In documentation, describe the live system and current rule directly. Do not + write victory laps, scar tours, or clever autopsies about what the project no + longer does. If rejected history matters, keep it short, explicit, and + decision-relevant; otherwise cut it. The docs are not a trophy case for + yesterday's wrong machine. diff --git a/docs/architecture/agent-state-variable-glossary.md b/docs/architecture/agent-state-variable-glossary.md index 7325574..eb5bfd4 100644 --- a/docs/architecture/agent-state-variable-glossary.md +++ b/docs/architecture/agent-state-variable-glossary.md @@ -35,11 +35,9 @@ This means the agent is not generally high in the variable, the baseline is not very easy to change, but the variable is strongly activated right now. Translation: this is a situation, not a personality transplant. -Canonical character state does not include `certainty`. If Ghostlight is -defining a character, uncertainty about that definition is not part of the -character. It belongs in workflow provenance, drafts, imported-source notes, or -review status. Otherwise the schema confuses the person with our confidence in -our paperwork, which is how bureaucracies get haunted. +Canonical character state does not include `certainty`. If a generated or +imported profile is provisional, track that in workflow provenance, draft +status, imported-source notes, or review status. Perceived or inferred state can use `confidence`, because that is explicitly about an observer's or classifier's read: