Guide

Context Construction

Context construction is the skill of deciding what the agent should know, what it should not assume, and what should survive the handoff.

Source: docs/context-construction.md

Context Construction

Context construction is the skill of deciding what the agent should know, what it should not assume, and what should survive the handoff.

More context is not automatically better. Useful context is selected, structured, provenance-backed, and small enough to govern.

Learn

A context pack should answer:

  • What is the task identity?
  • What outcome is this work meant to move?
  • What files, systems, or users are in scope?
  • What constraints are hard, soft, or assumed?
  • What prior attempts or landmines matter?
  • What evidence already exists?
  • What should trigger stop, dissent, or salvage?

This is where The Context Stack enters the curriculum. The agent should not infer strategy from a messy transcript. The human should construct a context object the agent and reviewer can inspect.

Practice

Use templates/context-pack.md.

Build the pack before /aim or /execute:

  1. Name the intent.
  2. List relevant subsystems and files.
  3. Separate hard constraints from soft constraints.
  4. Mark assumptions that should be tested.
  5. Add provenance for claims.
  6. Add stop, dissent, and salvage triggers.

Keep the pack short enough that a reviewer can challenge it.

Artifact

Use templates/context-pack.md. A context pack must preserve:

FieldWhy it matters
Task identityKeeps later skills from solving the wrong problem.
Selected sources with provenanceLets reviewers challenge authority and freshness.
Hard, soft, and assumed constraintsSeparates rules from preferences and assumptions.
Evidence available nowGrounds the run in observable reality.
Landmines and prior attemptsPrevents repeated dead ends.
Stop, dissent, and salvage triggersNames when the agent must pause instead of improvising.

The pack is consumed by /aim, /problem-space, /problem-statement, /solution-space, /execute, /review, and /dissent.

Review check

Reject a context pack if:

  • it hides provenance;
  • it dumps files without explaining why they matter;
  • constraints are mixed with preferences;
  • it contains unverified claims as facts;
  • it does not name stop conditions;
  • the agent would still need to infer the actual task.

Go deeper