Agentic Atlas patterns for agentic design
current field map
  1. example of Reference Data

    The Runbook Shelf

    Hook

    an 800-document shelf cannot enter a 200k-token window; one incident-code query admits one answer-sized runbook

    Thesis

    An 800-runbook shelf of 1,293,600 fixture tokens cannot enter a declared 200,000-token window, yet one incident-code query admits one 1,617-token runbook that returns the expected recovery: a too-big corpus is not a too-big answer.

    Laws & fences

    • Here the obstacle is corpus size rather than uncertain need: deferring the same fixed payload only moves the impossible load later, and the payload must become addressable.
    • Search does not make the corpus smaller; it makes corpus size cease to be the admission unit, so the shelf can grow while only the returned slice must stay bounded.
    • Shelf, question, answer, window budget, and fetch unit are held fixed and only the admission decision changes; the search step selects source bytes and mints nothing, so no summary, embedding, rewrite, or child execution can claim the delta.

    When to reach

    • Reach for it when an authored corpus, such as a policy library, schema catalog, or standards collection, exceeds the window and its queries share vocabulary with answer-sized source units.
    • Do not read it as proof that a model will choose the right query, that lexical search reaches conceptually phrased questions, or that the returned procedure is true of a live system; the fixture makes vocabulary match perfect on purpose.
  2. Reference Data

The card, in place · its connections drawn edges from atlas_links runbook-shelf

Context

context.md

An event-relay operator asks one question: How do I recover incident ERR-0713? The answer lives in a runbook shelf with these fixed properties:

  • 800 Markdown runbooks, one incident code per file;
  • one recovery procedure per runbook;
  • distinctive incident codes shared by queries and headings; and
  • a declared 200,000-token window budget.

demo.py builds the shelf deterministically in a temporary directory. Its token denomination is stated in code: one whitespace-delimited fixture word is one token. This is not a claim about a production tokenizer. It is a controlled unit that makes the before→after attributable to one admission decision.

Problem signal

problem-signal.md

The runbook is available, but the corpus cannot become resident whole. The checked fixture contains 1,293,600 tokens across 800 documents (demo.py, run 2026-08-07), more than six times the declared window budget. Frontloading therefore fails before the operator's question is answered.

The obstacle is corpus size, not uncertain need. Deferring the same fixed 1.29-million-token payload until ERR-0713 appears only moves the impossible load later. The fixed-payload ladder has run out; the payload must become addressable.

Choice

choice.md

Apply Reference Data: leave the shelf on disk, search it by the incident code already present in the question, then admit the matching runbook.

The baseline and the shift hold the shelf, question, answer, window budget, and fetch unit fixed. One decision changes: admit the complete corpus, or search before admission. No summary, embedding, rewrite, or child execution is introduced, so neither distillation nor subagent offload can claim the delta.

Before

before.md

The baseline treats the shelf as one payload:

episode starts → admit all 800 runbooks → answer ERR-0713

The admission guard rejects it:

Input Measured fixture tokens Declared budget Verdict
Complete runbook shelf 1,293,600 200,000 cannot admit

The answer exists on disk and remains unusable. Availability has been coupled to residency, so a corpus larger than the window might as well not exist.

Implementation

implementation.md

The shifted arm treats the shelf as reference data:

episode starts → search disk for ERR-0713 → admit one matching runbook → answer

The exact lexical scan reads the current files and returns one path. Only that path's document crosses the admission seam. The runbook arrives verbatim; the search step selects source bytes and mints nothing.

Run it from the example directory:

python3 demo.py

The script builds the shelf, measures both arms, asserts the budget boundary, asserts a single match, and checks the returned recovery procedure. The generated files disappear with the temporary directory after the run.

Result

result.md

The checked run changes feasibility without changing the answer:

Arm Resident input Tokens admitted Outcome
Frontload complete shelf 1,293,600 rejected before work
Search first ERR-0713 runbook 1,617 expected recovery returned

The query-shaped arm admits 0.125% of the corpus. The remaining 799 runbooks stay available on disk without occupying the window. The benefit is not that search made the corpus smaller; it made corpus size cease to be the admission unit.

Verification

verification.md

The deterministic checks are executable:

  • the full shelf exceeds the declared window budget;
  • the exact query returns one and only one document;
  • the admitted document fits the same budget; and
  • its Recovery: line equals the expected procedure.

Those checks prove the placement claim. They do not prove that a model will choose the right query, that lexical search reaches conceptually phrased questions, or that the returned procedure is true of a live system. The fixture makes vocabulary match perfect on purpose. Misses and broad-query floods remain Reference Data's probabilistic residue; this example isolates the earlier boundary where frontloading is not an available posture at all.

Lessons

lessons.md

A too-big corpus is not a too-big answer. Once admission is query-shaped, the shelf can grow without forcing every runbook through the window. What must stay bounded is the returned slice.

The incident codes are furniture. The decision travels to policy libraries, schema catalogs, standards collections, and any authored corpus whose queries share vocabulary with answer-sized source units.

The relationships ledger

Evidence-bearing references

Relationships

Every connection keeps the section where it was found. The map above orients; this ledger carries the evidence.

Outbound references 2

  1. in-slice · occurrence 1

    Reference Data

    the authored-heavy specialization: disk-resident, grep-addressable — pay for the size of the answer

    Evidence: Choice · occurrence 1

  2. in-slice · occurrence 1

    Reference Data

    the authored-heavy specialization: disk-resident, grep-addressable — pay for the size of the answer

    Evidence: Verification · occurrence 1

Inbound references 2

  1. in-slice · occurrence 1

    Reference Data

    an 800-document shelf cannot enter a 200k-token window; one incident-code query admits one answer-sized runbook

    Evidence: Examples · occurrence 1

  2. in-slice · occurrence 1

    Reference Data

    an 800-document shelf cannot enter a 200k-token window; one incident-code query admits one answer-sized runbook

    Evidence: Open questions / TODO · occurrence 1

↑ back to the top ← the survey

Node runbook-shelf · corpus 31de4cb · Catalog revision 35263c4c415da742953d0462804fb14424e2244dae4c63efd27e468988de70ab