docs: context-economy brainstorm — the graph as the agent's context service - #423
Draft
maxkle1nz wants to merge 1 commit into
Draft
docs: context-economy brainstorm — the graph as the agent's context service#423maxkle1nz wants to merge 1 commit into
maxkle1nz wants to merge 1 commit into
Conversation
…ervice An owner-ratified design direction, captured as a note (explicitly not a frozen PRD): agents need to stop re-reading what did not change, stop receiving what they did not ask for, and stop writing whole files to express small intents. Build order floor → beam → room: per-project isolation (genesis, already the named front), stable node identity (logical descriptor per SCIP's grammar + real sha256 as the version facet — file path demoted to attribute so a move preserves identity), then selective retrieval as an evolution of batch_view with exactly three primitives (select, lod, budget — budget default-on, truncation always declared). Grounded in one day of live measurements (the 6.5k-token fingerprint, the 2.09M-char surgical_context, transplant's 256×, 104 of 133 verbs never called, three foreign brain-replaces) and in verified prior art: SCIP (alive, Apache-2.0), stack-graphs (archived upstream — lesson retained, dependency declined), salsa, Unison (concepts only). External confirmation cited: curated repo context measured at -16.6% output tokens (arXiv 2606.20512). Beyond the retrieval room, the first-user additions: context receipts + diff_since(generation) for O(delta) turns, the write-verb family extending transplant, session working-set resurrection over the existing trail verbs, closure-scoped verification via impact, and enumerable absence as dated claims. Kill gates are falsifiable and pr00f-style; the beam spike's oracle (identity survives a file move; ingest idempotence) is born RED by construction today.
There was a problem hiding this comment.
Pull request overview
Adds a new brainstorm note capturing the owner-ratified direction for “context economy” (graph as an agent-facing context service), with measured evidence, a floor→beam→room build order, and falsifiable kill gates. This fits into the broader docs/ design/PRD ecosystem as an explicitly non-PRD, direction-preserving artifact.
Changes:
- Introduces a draft (explicitly non-PRD) design note documenting the thesis, measurements, and proposed build order.
- Defines “beam” (stable identity + sha256 facet) and “room” (selective retrieval with default-on budget + declared truncation) as the next conceptual layers.
- Records kill gates/oracles intended to keep the approach falsifiable and measurable.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| surface — the retrofit of an enumerable-API guarantee onto languages that will never have | ||
| one natively. | ||
|
|
||
| ## Kill gates (falsifiable, pr00f-style) |
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.
Draft on purpose — this is the owner-ratified direction captured as a note, not a frozen PRD. It exists so the thinking survives sessions and other agents can read it; the PRD comes later, distilled from the Layer-2 spike through the house PRD rite.
One paragraph
Agents need to stop re-reading what did not change, stop receiving what they did not ask for, and stop writing whole files to express small intents. m1nd already holds the graph to serve all three. Build order ratified 2026-07-25: floor (per-project isolation — genesis, already the named open front, proven necessary by three foreign brain-replaces in one day) → beam (stable node identity: SCIP-style logical descriptor + real sha256 as version facet; file path demoted from identity to attribute, so a move preserves identity — the exact cure for transplant's orphaned paint tags) → room (selective retrieval as an evolution of
batch_view:select/lod/budget, budget default-on, truncation always declared).Grounded, not vibed
Live measurements from 2026-07-24 (the 6.5k-token fingerprint, the 2.09M-char
surgical_context, transplant's 256×, 104/133 verbs never called), donors verified via API the same day (SCIP alive; stack-graphs archived upstream — lesson kept, dependency declined; salsa; Unison concepts-only), and external confirmation that context curation measures (−16.6% output tokens, arXiv 2606.20512).What decides its fate
Falsifiable kill gates, pr00f-style: the beam spike's oracle (a claim anchored to a moved item still resolves after re-ingest; ingest idempotence) is born RED today by construction; the room only ships if it beats the current m1nd-trained loop on tokens-to-green over a fixed battery — measured, or it dies.
Docs only. Not armed for auto-merge (draft; the ratified rule: never arm what has no review verdict).