Context

Management

Keeping the context your agents read current as decisions and conventions change.

The question
Is the context an agent reads current, or three sprints stale?
The discipline

What your agent collected on day one quietly goes out of date. Conventions get revised, specs get superseded, architectural decisions get reversed, and the documents that record all of it drift the moment they stop being anyone's job. Management is the discipline of catching that drift: the CLAUDE.md that still names last quarter's stack, the decision the team walked back but never wrote down, the spec that says one thing while the code does another.

When what the agent reads matches what is true now, it stops heading down paths the team has already abandoned. Your team stops paying for stale context in rework, and the agent's decisions land right because they rest on the system as it is, not as it was.

The investment tiers

Exploratory

Docs exist, but no one owns keeping them current, so they rot.

Enables
A first read on which docs actually go stale fast enough to matter. Watching context rot in real time tells you where freshness is worth paying for and where it never will be.
Deficiencies
Stale artifacts steer the agent wrong, outdated conventions get reapplied, and trust in the docs erodes until people stop reading them.
Cost to maintain
Wasted agent effort on dead ends and rework, paid quietly and continuously.

Techniques

None yet. Manual and ad hoc.

Expert-led

One engineer stays on top of the key docs and fixes drift whenever they happen to notice it.

Enables
The core artifacts stay reasonably current, and the agent can trust the parts that person watches.
Deficiencies
Only their corner stays fresh while the rest rots, and what changed lives in their head rather than on the record.
Cost to maintain
That person's attention, a background tax that scales with the number of docs.

Techniques

  • . Auto-loaded files (CLAUDE.md, README) the agent reads first, so it opens every session already knowing your stack and conventions.
  • . Template files with placeholders for runtime context, so the same workflow encodes the current state and adapts to a new issue without a rewrite.

Documented

A written policy says what gets updated and when, with a clear owner for each area.

Enables
Systematic currency on a schedule the team can see, no longer dependent on one person happening to notice.
Deficiencies
Still manual and reliant on follow-through, so gaps open between a planned update and the change that already shipped.
Cost to maintain
Writing the policy once, then the ongoing work of the updates themselves.

Techniques

  • . Auto-loaded files (CLAUDE.md, README) stamped with refresh dates, so anyone can see when a doc was last held against the code.
  • . When-to-read tables maintained as part of sprint work, so the routing layer refreshes on the same cadence as the code it points at.
  • . One file per service or entity, each with a named owner, so every area of the corpus has someone accountable for its freshness.

Structural

Docs update themselves as part of the work, and currency is enforced rather than remembered.

Enables
Near-zero manual maintenance, docs that stay in sync with the code automatically, and drift caught as soon as it appears.
Deficiencies
It needs tight integration, mis-tuned rules raise false positives, and an over-strict check can slow the work it guards.
Cost to maintain
Upfront engineering to hook docs into the build and tooling, plus ongoing tuning as the rules meet real changes.

Techniques

  • . Hooks in the commit and CI path that update or validate docs against the code as the work lands, so orientation files and indexes cannot silently drift.
  • . Standardized host scripts (lint, test, e2e) the agent runs and reads the exit code from, so checks fire before a human sees the output.
  • . Config plus install scripts that propagate a skill or doc from one place to every project, so an update in one repo lands in all of them.
Discipline overlap

Management rarely stands alone. Where it overlaps a sibling discipline, an investment on one side quietly depends on the other. The Context domain page lays these out in full.

  • Management and Collection

    Collection gets an artifact in the door; Management keeps it true. The wider Collection reaches, the more surface Management has to hold current, and gathering aggressively without the upkeep just delivers stale context at scale.

    Fund both and a broad corpus stays trustworthy; fund only the first and you have paid to mislead the agent faster.

  • Management and Disclosure

    Management makes sure an artifact is still true; Disclosure makes sure the agent reads it at the right moment. The leanest, best-routed context is still wrong if it points at a doc that went stale months ago.

    Currency without routing buries the truth; routing without currency delivers a falsehood on time.

Browse the framework
You are here
Context

The agent has what it needs to act.

  • CollectionGetting context in: gathering the artifacts an agent needs to orient.
  • Management (current page)Keeping the context your agents read current as decisions and conventions change.
  • DisclosureFeeding context in efficiently: routing the agent to the slice it needs, not a data dump.