THE CARD AS TEXT · FOR EYES AND FOR MACHINES
THE CONTEXT CARD · The working-set seat: the files that bear on a task, ranked with reasons, budgeted and packed.
WAKES WHEN An agent is reading the whole repository for a change that touches three files. · Someone wants to know what to paste into a chat for this task and how much it costs. · A context window keeps filling and the agent forgets the start. · A set of files must be handed to a fresh session with every line traceable.
THE LOOP
- Rank the files by the task, with why
- Budget the set in estimated tokens
- Pack it with a header per file
- Say the estimate is an estimate
NEVER
- Never packs a secret file
- Never calls a file relevant without saying why
- Never passes an estimate off as a model's count
- Never claims a certainty it does not have
IT MAKES rank — rank every text file for the task; each line shows the score and why; budget — the working set that fits: ranked files added in order until the limit, the rest LEFT OUT and counted; pack — write the set as one file with a header per file (path, bytes, estimated tokens, why it is here); explain — print the set as a table: in or LEFT OUT, score, tokens, why; scan — list every text file with its size and estimated tokens; secrets and binaries NOT PACKABLE.
THE LAW The right context is the smallest set that lets the task be done well. Every file in it has a reason the machine can print; everything left out is counted, not forgotten; the token numbers are estimates and say so.
IN THE BOX SKILL.md · CARD.md · ▣ scripts/context.py (machine) · ▣ scripts/evals.py (test runner) · tests/EVALS.json (9 tests) · references/ (schema + fictional demo) · START-HERE.md · system/ doors · MY-LEDGER.md · LICENSE-NOTE.md · card.svg · card.json · card.html · AUDIT.md · MANIFEST.md · WITNESS.md · SELFTEST.md.
PROOF SELFTEST 12/12 · witnessed in Claude 2026-10-14 on fictional fixtures · the test prompts in fresh chat, 9/9 · Edition 2.
THE SEAL 98 of 100 · LEGENDARY · WITNESSED · Trigger 5 · Machinery 5 · Law 5 · Portability 5 · Proof 5
IT CAN BE WRONG an AI reading a text file: it can be wrong and can invent a number, a rule, a name or a date; check what matters against your own records and the source; the risk is yours. LICENSE-NOTE.md rides in the packet and is the licence.
THE PUNCH · SHA-256 OF SKILL.MD · 4E14D848B6B8C1BFCBE05DB4
THE CONTEXT CARD
The working-set seat: the files that bear on a task, ranked with reasons, budgeted and packed.
RANK · BUDGET · PACK · EXPLAIN · SCAN
LEGENDARYWITNESSEDIN CLAUDEIN LUNDRIN CHATGPT
WITNESSED — the studio saw this card run and produce what its tin promises, and wrote the date down. What the marks mean →