iter or.1.tidy: audit-driven sweep of stale JOURNAL.md references in live docs

This commit is contained in:
2026-05-11 12:03:01 +02:00
parent e46bc540eb
commit c252b1aa28
4 changed files with 23 additions and 20 deletions
+7 -6
View File
@@ -105,8 +105,8 @@ not as immutable scripture.
use approach X or Y?") — that is orchestrator work.
- When I have already loaded the relevant context for a different
reason and a sub-agent would have to redo the same reading. In
that case I do the small change inline and note in the JOURNAL
why I bypassed the agent.
that case I do the small change inline and note in the per-iter
journal why I bypassed the agent.
### Design rationale ≠ implementation effort
@@ -264,7 +264,7 @@ Existing entries are not retroactively renamed.
current: adding new entries, reprioritising, removing items
that are done or dropped. Entries are checkbox lines; finished
items get checked off, then removed (with a one-line mirror in
JOURNAL) once they stop being interesting context.
the per-iter journal) once they stop being interesting context.
- **`docs/specs/<milestone>.md`** (since 2026-05-09): per-milestone
design spec produced by `skills/brainstorm`. Hard-gate before any
@@ -282,6 +282,7 @@ Existing entries are not retroactively renamed.
rules (in particular: no internals, lead with the change).
Together these answer three questions: "what is the language right
now?" (DESIGN), "how did we get here?" (JOURNAL, specs, plans),
and "what's next?" (roadmap). `WhatsNew.md` is the user-facing
mirror of the JOURNAL — the same history, told without internals.
now?" (DESIGN), "how did we get here?" (per-iter journals, specs,
plans), and "what's next?" (roadmap). `WhatsNew.md` is the
user-facing mirror of the journals — the same history, told without
internals.