Skip to content

docs(readme): the diary sections become key points - #27

Merged
xoai merged 1 commit into
mainfrom
readme-simplify
Jul 15, 2026
Merged

docs(readme): the diary sections become key points#27
xoai merged 1 commit into
mainfrom
readme-simplify

Conversation

@xoai

@xoai xoai commented Jul 15, 2026

Copy link
Copy Markdown
Owner

The three sections the README grew during the measurement program — What we measured (86 lines), Hybrid Loading (44), Session Resilience (79) — read as developer diaries: correction sagas, version-by-version narratives, instrument-bug war stories. Users need the key points; the full story lives in docs/eval-baseline.md and stays linked.

209 lines → ~70 (README 1053 → 914), keeping every honest number and claim:

  • test-first 3/3 vs 0/3 because it's a hook; prose rules tie a bare agent at ~1.6×
  • multi-session: ties on correctness at a few times the cost (resume ~4× published, actively being cut)
  • the three loading layers, the 177-line eager budget held by CI
  • resume via the generated brief + authority order; the edge stated as determinism, not correctness

Nothing measured was dropped — only the journey to it. Docs-only; truth-table + context-budget validators green; the #what-we-measured anchor still resolves.

'What we measured' (86 lines), 'Hybrid Loading' (44), and 'Session Resilience'
(79) had grown into developer diaries — correction sagas, version-by-version
narratives, instrument-bug war stories. Users need the key points; the full
story already lives in docs/eval-baseline.md and is linked.

Rewritten to ~70 lines total (README 1053 -> 914) keeping every honest number
and claim: test-first 3/3 vs 0/3 because it's a hook; prose ties bare at ~1.6x;
multi-session ties at a few times the cost (resume ~4x published, being cut);
the three loading layers + the 177-line budget; resume via the generated brief
+ authority order, determinism not correctness as the edge. Nothing measured
was dropped — only the journey to it.
@xoai
xoai merged commit d771244 into main Jul 15, 2026
19 checks passed
@xoai
xoai deleted the readme-simplify branch July 17, 2026 12:50
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