Query-Shaped Storage
The principle underneath every level of Retrieval Maturity Levels: how data will be accessed and recalled determines how you should put it in. You work backwards from the question — reverse-engineer the schema, folder layout, and retrieval style from how you intend to ask later, not from how the data happens to arrive. The analogy: you know a basketball hoop is round, so you'd never design the ball as a giant square — start with the end in mind. In practice this is what makes the level choice per-folder (Semantic Retrieval vs a plain markdown file vs Knowledge Graph Retrieval) a design decision rather than a default: ask "what type of questions will I ask of this data?" first, then pick the storage that answers them cheaply and accurately.
This is why the same failure recurs when it's ignored — e.g. chunking a meeting transcript into vectors when the question you'll actually ask is "summarize the whole meeting" (chunk retrieval can't see the whole document). The concrete tactic Nate recommends: ask the agent — "here's my data, here's how I want to use it; markdown files or semantic search?" — and let the query shape the decision.
Claims
- How it will be accessed and recalled determines how you store it — design storage backwards from the question. principle — durable: the query is the fixed constraint (the round hoop); the storage is what you shape to fit it.
- Decide retrieval style per-folder by the questions you'll ask, not by one house style. best practice — context: heterogeneous stores; "best" is matching each folder's storage to its query shape, which only holds once you've actually named the questions.
- When you can't name the query yet, ask the agent to help choose the storage from the intended use. best practice — context: designing a new folder's retrieval; useful when the operator knows the use case but not the retrieval mechanics.
- When the query shape is mixed (natural language and exact identifiers), the storage answer is both channels — Hybrid Retrieval. best practice — context: a memory store you can't guarantee will be queried one way; naming the query as "mixed" is what makes hybrid the fitted choice rather than a default.
- Flat vs structured is itself a query-shape decision: keep a store flat when you want the agent to search everything cheaply; let folder structure emerge only when a source naturally splits and the structure aids retrieval. best practice — context: a compiled Compiled Knowledge Base whose reader is an agent that crawls the whole store; the source keeps his meeting-transcript wiki flat ("sometimes flat is better" so the AI can search it all) while his YouTube-transcript wiki grew subfolders. "Best" is flat when breadth-search dominates; premature folders hurt more than they help, so structure should be earned by the data, not imposed up front.
Related
- Retrieval Maturity Levels — the level you pick is the storage shape the query demands.
- Semantic Retrieval — chosen (or rejected) based on whether the question needs meaning- match or whole-document context.
- Knowledge Graph Retrieval — chosen when the questions are relationship chains.
- Context Routing — the storage-time answer to "how will this be retrieved?" at level 1.
- Hybrid Retrieval — the fitted storage answer when the query shape is mixed.
- AI Second Brain — the store this principle shapes.
- Compiled Knowledge Base — flat-vs-structured is decided by how the agent will search the compiled wiki.
- Distillate: Every Level of a Claude Second Brain Explained
- Distillate: How AI Agents Search Their Memory — Hybrid Retrieval, in Practice (OpenClaw)
- Distillate: Fable 5 + Karpathy's LLM Wiki is Basically Cheating — flat meeting-wiki vs structured YouTube-wiki, chosen by search shape.
- Organize by Actionability — the sibling design-backwards principle: PARA fixes the constraint at the action the material serves, where this concept fixes it at the query.
- Distillate: Second Brain Explained for Engineers and Knowledge Workers
Linked from
- AI Second Brain
- Capture-Storage-Retrieval Pipeline
- Compiled Knowledge Base
- Context Routing
- Context Substrate
- Evergreen vs Volatile Context
- Every Level of a Claude Second Brain Explained
- Fable 5 + Karpathy's LLM Wiki is Basically Cheating
- How AI Agents Search Their Memory — Hybrid Retrieval, in Practice (OpenClaw)
- Hybrid Retrieval
- Incremental Indexing
- This Week
- Knowledge Graph Retrieval
- Organize by Actionability
- Retrieval Maturity Levels
- Second Brain Explained for Engineers and Knowledge Workers
- Semantic Retrieval