Skip to content

docs: LINEAGE.md — the row-by-row ledger of where the ideas come from #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
joyful-ii-V-I merged 7 commits into from
Aug 3, 2026
+465 −3
Merged

docs: LINEAGE.md — the row-by-row ledger of where the ideas come from #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
6d4ccd9
docs: LINEAGE.md — the row-by-row ledger of every idea folded in
joyful-ii-V-I Aug 3, 2026
fef4196
README: the lineage sentence, and arm (E) that pins its three counts
joyful-ii-V-I Aug 3, 2026
4ccf149
docs: index the LINEAGE row, and correct the entry count to eight
joyful-ii-V-I Aug 3, 2026
2736c73
docs(lineage): the twelve rows verifier V8 found wrong, and the count…
joyful-ii-V-I Aug 3, 2026
7dabd8f
test(readmedrift): arms E6/E7/E8 — the set claim, not just the arithm…
joyful-ii-V-I Aug 3, 2026
096e868
docs(lineage): the non-peer-reviewed note counts rows, not sources
joyful-ii-V-I Aug 3, 2026
2977580
docs(lineage): --around is not capped at two hops, it defaults to two
joyful-ii-V-I Aug 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ of milliseconds from a warm index — and labels every count it cannot prove is

[Quickstart](#quickstart) · [What it answers](#what-it-answers) · [Real runs](#real-runs) ·
[Measured](#measured) · [Tokens saved](#what-it-saves-you-in-tokens) ·
[Honesty contract](#the-honesty-contract) · [Agent setup](#set-it-up-in-your-coding-agent) ·
[Lineage](#standing-on-the-whole-field) · [Honesty contract](#the-honesty-contract) ·
[Agent setup](#set-it-up-in-your-coding-agent) ·
[Prompt loops](#improve-it-with-your-agent) · [Docs](#documentation)

---
Expand Down Expand Up @@ -242,6 +243,17 @@ appendix.

---

## Standing on the whole field

Almost none of the ideas here are new; the combination and the constraints are. Lessons folded from
**27 repositories and 27 papers** into one deterministic executable, alongside a labelled
survey of 220 tools that folded nothing and are catalogued separately — the two sets are disjoint,
so they add rather than nest. The row-by-row ledger, each with the lesson taken and where it lives, is
[`docs/LINEAGE.md`](docs/LINEAGE.md). Those three counts are derived from that document's own tables
by `test/readmedriftcheck.sh`, which fails if this sentence and those tables disagree.

---

## The honesty contract

The differentiator is not a number, it is a discipline: **a measurement you cannot check is a claim,
Expand Down Expand Up @@ -406,6 +418,7 @@ behind `--mentions`; Office and PDF join them through an optional bridge.
| Pipeline, data model, determinism contract, output-honesty contract | [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) |
| Every published number, its instrument, and what is *not* published | [`docs/EVALS.md`](docs/EVALS.md) |
| The method, as something transferable | [`docs/METHODOLOGY.md`](docs/METHODOLOGY.md) |
| Where every idea came from, and where each one lives in the code | [`docs/LINEAGE.md`](docs/LINEAGE.md) |
| C++ house style, the G1–G5 guardrails, gate discipline, the submission checklist | [`CONTRIBUTING.md`](CONTRIBUTING.md) |
| Orientation for a coding agent working *on* this repository | [`CLAUDE.md`](CLAUDE.md) / [`AGENTS.md`](AGENTS.md) |
| User-visible capabilities, behaviour changes, known limits | [`CHANGELOG.md`](CHANGELOG.md) |
Expand Down
Loading
Loading