Brummel
8e586f493f
The per-iter journal under docs/journals/ duplicated the iter commit body's substance and accumulated as Verlauf-Doku with no Future-Use. Sweep across all live control documents: CLAUDE.md, the 7 SKILL.md files, the 11 agent files, design/INDEX.md and the contracts/models that referenced journals, docs/roadmap.md, and the handful of source comments + tests that pointed at journal files for rationale. Mechanism changes: - Standing-reading-lists in every agent now read `git log -N --format=full` for recent project state, never per-iter journal files. The architect reads `git log <prev-milestone-close>..HEAD --format=full` for audit scope. - implement-orchestrator no longer writes a journal file. DONE outcomes emit just code + stats; the end-report is the per-task summary the Boss uses to write the commit body. PARTIAL/BLOCKED outcomes emit BLOCKED.md at the repo root — uncommitted by convention, Boss removes on repair or discard. New iron-law line + four-rationalisation row + red-flag bullet codify it. - audit ratify mechanic: --update-baseline is now paired with an explicit ratify paragraph in the audit-close commit body, not a separate JOURNAL ratify entry. - design/contracts/honesty-rule.md: "history and rationale lives in docs/journals/" → "lives in git log (iter and audit commit bodies)". Pinned phrase preserved verbatim. - CLAUDE.md "Roles of …" section reframed: design/, git log, journal-archive.md (content-frozen), roadmap.md, specs/, plans/. No docs/journals/ slot anymore. - roadmap.md context-lines that pointed at per-iter journals are dropped where the spec/commit already carries the rationale, or rephrased to "shipped in the <iter> iter commit" / "docs/journal- archive.md (<date> entry)" for pre-2026-05-11 references. What stays (this commit): - docs/journals/ directory and contents are NOT touched. Removing the contents is a separate follow-up. - docs/journals/2026-05-19-design-decision-records.md still has live readers (docs_honesty_pin.rs Z 108 + parse.rs + duplicate_ctor_pin.rs + 3 roadmap mentions) — also follow-up. - docs/journal-archive.md still exists; its self-pointer header has been updated to drop the "see docs/journals/INDEX.md" mention. Workspace builds, full test suite green.
30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# The honesty rule this ledger holds itself to
|
|
|
|
`design/` describes what AILang **is now**: schema, semantics,
|
|
invariants, runtime contracts. It is present-tense by construction.
|
|
Two things never belong in a contract or model file:
|
|
|
|
- **Forward intent** (anything stated as planned, intended, or
|
|
expected of a future iteration rather than true today) — that
|
|
lives in `docs/roadmap.md`.
|
|
- **History and rationale** (how a prior draft read, what changed
|
|
since, why one option was chosen, why another was rejected, what
|
|
was dropped in some iteration) — that lives in `git log` (iter
|
|
and audit commit bodies). Decision-records are commit-body
|
|
content, not ledger content; this is the honesty rule it holds
|
|
itself to.
|
|
|
|
A cross-reference that does belong stays: it is a formal,
|
|
file-relative Markdown link into the durable tier (`design/` or
|
|
source), enforced by the body-link durability gate in
|
|
[`design_index_pin.rs`](../../crates/ailang-core/tests/design_index_pin.rs).
|
|
A reference that cannot be expressed as such a link is, by that
|
|
fact, the history-or-rationale prose the rule above removes.
|
|
|
|
The single legitimate exception is a present-tense reserved or
|
|
deliberately-excluded claim that is explicitly and correctly
|
|
labelled. The discriminator is not whether a sentence mentions past
|
|
or future, but whether the document asserts something exists, works, or changed that does not.
|
|
|
|
Ratified by: `crates/ailang-core/tests/docs_honesty_pin.rs`.
|