Skip to content

docs: master design index, flat-model reference, roadmap SSOT + fleet-program intents - #95

Merged
thorwhalen merged 1 commit into
masterfrom
claude/flat-docs-and-roadmap
Aug 21, 2026
Merged

thorwhalen merged 1 commit into
masterfrom
claude/flat-docs-and-roadmap

Conversation

@thorwhalen

Copy link
Copy Markdown
Member

What

A navigable design-doc set for the post-#86 architecture, readable by humans and agents:

  • misc/docs/README.md — master index: the two architectures in two paragraphs, reading paths for four audiences, full doc index with status labels.
  • misc/docs/dol_flat_model.md — the flat model reference: a wrap is (leaf, spec, stack), the flat compiled codec stack, spec/loudness machinery, codec laws, scope limits, the Q0–Q5 decision table, code map.
  • misc/docs/dol_roadmap.md — sequencing SSOT (tracks A–E), superseding the dol_issues_report.md waves; records the four new maintainer intents as issues Fleet usage ledger: a versioned record of who uses dol, how, and at which commit #91–Cruft audit: relocate fleet-unused, low-value members (xdol / tests / recipes) #94.
  • Supersession banners on dol_design.md / general_design.md / dol_issues_report.md; dol_misc_docs_guide.md absorbed into README.md; CLAUDE.md index refreshed.

Verification

Related: #86, #90, #91, #92, #93, #94.

https://claude.ai/code/session_01FLZ8T5a6Y4P3u25yC1JD9R

…program intents (#91-#94)

- misc/docs/README.md: master index — big picture (two architectures), reading
  paths per audience, full doc index with status labels. Absorbs and replaces
  dol_misc_docs_guide.md.
- misc/docs/dol_flat_model.md: the flat model reference (Option G) — (leaf,
  spec, stack), flatten-and-compile, loudness, codec laws, scope limits, the
  Q0-Q5 decisions, code map. Adversarially verified against code (example
  executed verbatim; one caching overclaim corrected).
- misc/docs/dol_roadmap.md: sequencing SSOT — tracks A-E, supersedes the
  issues-report waves; links the new intent issues #91 (fleet ledger),
  #92 (vocabulary horizon), #93 (layer kinds + fast-ops), #94 (cruft audit).
- Targeted supersession banners: dol_design.md (4 sections + corrected the
  refuted pickling claim), general_design.md (layers: semantic vs runtime),
  dol_issues_report.md (historical snapshot).
- CLAUDE.md: doc index refreshed (README/flat-model/roadmap rows, #16 marked
  shipped, dependents count 76 -> 85 per the 2026-08-03 scan).

Claude-Session: https://claude.ai/code/session_01FLZ8T5a6Y4P3u25yC1JD9R
@thorwhalen
thorwhalen merged commit dc9303a into master Aug 21, 2026
12 checks passed
@thorwhalen
thorwhalen deleted the claude/flat-docs-and-roadmap branch August 21, 2026 12:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant