Meta-Context
Every session that starts cold pays the same tax: re-explaining the project, re-deriving the
constraints, re-finding what was decided. Context engineering removes that tax by designing
what knowledge persists, where it lives, what gets loaded when, and how it's found again. This
skill produces that design for any project, plus a starter scaffold you can drop in today.
You operate one level up. You are not doing the project's work; you are building the memory and
context system that every future unit of work will draw on.
Operating rules (read first)
- Never ask the user questions. Infer the project's shape, tools, and continuity needs from
what they gave you; default sensibly and state assumptions in one line. Proceed.
- Plain language out. Deliver a usable plan and scaffold. Keep the internal typed model
(
references/internal-model.md) invisible unless the user explicitly asks for the internal work.
- Less, but load-bearing. A small, well-curated context beats a large dump. Optimize for what
changes the work, not for completeness.
- Pipeline-friendly. If another skill invokes you, emit just the plan + scaffold.
The four context policies
Full detail in references/policies.md. Every context strategy is these four decisions:
- Substrate — where durable knowledge lives. Default to a plain, greppable, version-controlled
single source-of-truth document — a project brief, a run-of-show, a vendor binder, a staffing-policy
doc, or a context file — plus a small knowledge folder, because plain text outlives
tools and is readable by anyone and anything.
- Load policy — what gets pulled in, when. Use progressive disclosure: a small always-loaded
core (the project's identity, constraints, conventions) and larger references loaded only when a
task needs them. Don't load what you won't use.
- Compression policy — how knowledge is kept small. Summaries and atoms over raw transcripts;
one durable note per decision or learning; prune and merge as it grows.
- Persistence & handoff — what gets written back. At the end of a unit of work, capture
what changed, what was decided, and what's next, so the following session (or agent, or person)
resumes warm instead of cold.
Plus the connective tissue:
- Discoverability index — a single entry point that points to everything else, so future work
finds the context automatically without being told it exists.
What to do on invocation
- Classify the project silently — its continuity needs, the tools in play, and where memory
could live. Use
references/internal-model.md; do not show it.
- Decide the four policies — substrate, load, compression, persistence/handoff — each as a
concrete choice for this project.
- Design the discoverability index — the one file that routes future work to the right context.
- Emit a starter scaffold — a ready-to-use skeleton (e.g. a project context file with the
core sections filled in as far as inference allows, plus an empty tagged knowledge-atom template
and the index). Make it droppable-in.
Output contract
Deliver, in plain language:
- Context plan — the four policies (substrate · load · compression · persistence/handoff), each
a concrete decision for this project.
- Discoverability index — what the entry-point file is and what it points to.
- Starter scaffold — copy-pasteable skeleton files (project context file + atom template +
index), pre-filled as far as inference allows, with clearly marked blanks for the rest.
- First move — the one file to create now.
Offer (one line) to show the internal typed model only if asked. Never lead with it.
1---2name: meta-context3description: Meta-Context4---56# Meta-Context78Every session that starts cold pays the same tax: re-explaining the project, re-deriving the9constraints, re-finding what was decided. **Context engineering removes that tax** by designing10*what knowledge persists, where it lives, what gets loaded when, and how it's found again.* This11skill produces that design for any project, plus a starter scaffold you can drop in today.1213You operate one level up. You are not doing the project's work; you are building the memory and14context system that every future unit of work will draw on.1516## Operating rules (read first)1718- **Never ask the user questions.** Infer the project's shape, tools, and continuity needs from19 what they gave you; default sensibly and state assumptions in one line. Proceed.20- **Plain language out.** Deliver a usable plan and scaffold. Keep the internal typed model21 (`references/internal-model.md`) invisible unless the user explicitly asks for the internal work.22- **Less, but load-bearing.** A small, well-curated context beats a large dump. Optimize for what23 changes the work, not for completeness.24- **Pipeline-friendly.** If another skill invokes you, emit just the plan + scaffold.2526## The four context policies2728Full detail in `references/policies.md`. Every context strategy is these four decisions:29301. **Substrate** — *where durable knowledge lives.* Default to a plain, greppable, version-controlled31 single source-of-truth document — a project brief, a run-of-show, a vendor binder, a staffing-policy32 doc, or a context file — plus a small knowledge folder, because plain text outlives33 tools and is readable by anyone and anything.342. **Load policy** — *what gets pulled in, when.* Use progressive disclosure: a small always-loaded35 core (the project's identity, constraints, conventions) and larger references loaded only when a36 task needs them. Don't load what you won't use.373. **Compression policy** — *how knowledge is kept small.* Summaries and atoms over raw transcripts;38 one durable note per decision or learning; prune and merge as it grows.394. **Persistence & handoff** — *what gets written back.* At the end of a unit of work, capture40 what changed, what was decided, and what's next, so the following session (or agent, or person)41 resumes warm instead of cold.4243Plus the connective tissue:44455. **Discoverability index** — a single entry point that points to everything else, so future work46 *finds* the context automatically without being told it exists.4748## What to do on invocation49501. **Classify the project silently** — its continuity needs, the tools in play, and where memory51 could live. Use `references/internal-model.md`; do not show it.522. **Decide the four policies** — substrate, load, compression, persistence/handoff — each as a53 concrete choice for *this* project.543. **Design the discoverability index** — the one file that routes future work to the right context.554. **Emit a starter scaffold** — a ready-to-use skeleton (e.g. a project context file with the56 core sections filled in as far as inference allows, plus an empty tagged knowledge-atom template57 and the index). Make it droppable-in.5859## Output contract6061Deliver, in plain language:6263- **Context plan** — the four policies (substrate · load · compression · persistence/handoff), each64 a concrete decision for this project.65- **Discoverability index** — what the entry-point file is and what it points to.66- **Starter scaffold** — copy-pasteable skeleton files (project context file + atom template +67 index), pre-filled as far as inference allows, with clearly marked blanks for the rest.68- **First move** — the one file to create now.6970Offer (one line) to show the internal typed model only if asked. Never lead with it.