Repository navigation
Cool Idea: consolidate the design-doc corpus into a cited Echo Tome #535
Description
Activity
🔗 Related PRs
#145 - AIΩN bridge doc + tick receipts (
#144) [merged]
#178 - TT0 (#166) TimeStreams + wormholes spec lock [merged]
#309 - feat: add Doghouse PR flight recorder [merged]
#326 - Echo contract hosting roadmap [merged]
#385 - docs(backlog): two follow-ups from the 2026-05-30 merge session [merged]
📝 Issue Planner
Check the box below or use the
@coderabbitai plancommand to generate an implementation plan and prompts that you can use with your favorite coding assistant.- Create Plan
🧪 Issue enrichment is currently in open beta.
You can configure auto-planning by selecting labels in the issue_enrichment configuration.
To disable automatic issue enrichment, add the following to your
.coderabbit.yaml:issue_enrichment: auto_enrich: enabled: false
💬 Have feedback or questions? Drop into our discord!
Context
Echo carries ~309 markdown docs. The authoritative surfaces (
docs/spec/,docs/quickstart-local-contract-host.md,ARCHITECTURE.md) are excellent butswim in a much larger sea of historical design packets, and external
consumers can't tell which layer they're reading. Two concrete failure modes
observed while building Graft's Echo integration witness:
and never mentioned the session-proto EINT v2 (fixed in Worktree-safe verify-local stamps; SPEC-0009 EINT v1/v2 layer clarification #534) — doc drift
that only source-validation caught.
distinguish "contract you can build against" from "design history."
Idea
quickstart, ARCHITECTURE), living direction (BEARING, NORTHSTAR, METHOD),
and historical design packets (the long tail).
Wesley's
docs/END_TO_END.md+docs/TECHNICAL_TEARDOWN.md— domaindictionary, golden paths, payload anatomy, authority boundaries — built
from tier-1 docs and live source.
docs/design/archive/with an indexmanifest mapping each to its landing PR/commit, excluded from the
"current truth" reading path.
[<filepath>#<line>@<git sha>]; CI (docs-truth style, as Wesley alreadydoes) flags dangling paths so drift like the EINT v2 gap fails loudly
instead of silently.
First step
Generate an inventory (path, title, status marker, last-touched commit) and
propose the tier split as a reviewable PR — no deletions, moves only.
Filed from the Graft integration lane under the standing cool-ideas grant.