docs(architecture): the spine told once — narrative out, numbers to the ledger, one tree drawing#447
Merged
Merged
Conversation
…ve measured numbers to the ledger architecture.md 888 -> 668 lines: the session-narrative section and the executed consolidation checklist are gone (§11/§12 folded into the ledger pointer), Gate-A/Gate-B definitions are pointers to their canonical homes (interpretations §5 / learning-flywheel.md), §13/§14 merge into one picture book with a single tree drawing, and the command-hierarchy section now states its built status (ask_parent/answer_question at coordination.ts:159-160) with corrected anchors (types.ts:49, runtime.ts:1517). The vocabulary law moves to glossary.md; every measured number lives in .evolve/current.json + the memory ledger, with the domain-boundary and honesty laws kept verbatim.
tangletools
approved these changes
Jul 2, 2026
tangletools
left a comment
Contributor
There was a problem hiding this comment.
✅ Auto-approved drewstone PR — f36b57bf
This PR was opened by the trusted drewstone account.
The full PR reviewer audit still runs separately and will publish findings if it detects issues.
tangletools · auto-approval · reason: drewstone_author · 2026-07-02T22:21:12Z
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
The spine-cluster consolidation from the grounded DX evaluation: architecture.md is the decreed canonical spine, but it told the atom/tree/timescales 3x each, carried dated session narrative, and mirrored every gate number that already lives in the ledger.
.evolve/current.json+ the memory ledger; the wins-on-conflict rule stays). The session-narrative §0 is deleted (each locked decision verified restated: atom -> §1, selector != judge -> §1/§7, scaffold-then-GEPA -> §9, moat -> §8, sandbox driver -> §3). Gate-A/Gate-B inline definitions become pointers to their canonical homes (interpretations §5 / learning-flywheel.md). §11 collapses to a ledger pointer keeping only the two timeless laws verbatim (domain-boundary, honesty). §12 is deleted (executed to-do list; the vocabulary law moves to glossary.md;bench/src/{refine-loop,run-pool,directives}.tsverified present). §13/§14 merge into ONE picture book with a single tree drawing.ask_parent/answer_questionare shipped (src/mcp/tools/coordination.ts:159-160, priority-queued on the event bus); and two anchors re-verified against code (Agentatsupervise/types.ts:49, not :51;createExecutoratsupervise/runtime.ts:1517, not :1137).architecture.md §11cite now points at the ledger.Every deleted number was verified present in
.evolve/current.jsonor the memory ledger before deletion; the one missing cluster (the FinSearchComp SOTA breakdown) was appended to the ledger first. concepts.md, execution-model.md, and canonical-api §1/§1.5 are untouched per the evaluation verdicts.Note for external readers: architecture.md §11/§12 deep-links now resolve to the ledger pointer; the picture book keeps the §13 number.
Checks
pnpm run docs:check— green (freshness gate: version pins, 10 citations, prose symbols across the 3 curated docs)pnpm run lint/pnpm run typecheck— greengrep -c '2026-' docs/architecture.md-> 0; cross-file grep for refs to deleted sections -> 0