Context Loading Policy

KISS: load on change, not on every turn. Context loading is event-driven, not per-turn or per-handoff. Do not re-read AGENTS.md, CONTEXT.md, SPEC.md, ROADMAP.md, or broad repository history on every mission, turn, or session merely because a new one started. Read wider context only when a concrete event or trigger requires it.

Cold start

On a genuine cold start, read ONLY:

  1. the repository rules needed to operate safely (the repository’s AGENTS.md), once;
  2. the owning Issue/PR;
  3. the current branch/HEAD.

Read CONTEXT.md, SPEC.md, ROADMAP.md, or broader history only when:

Warm continuation

On warm continuation, reuse already-loaded context and fingerprints. Read only:

Do NOT reload all bootstrap or context files merely because a new agent turn, session, or handoff started.

Reload triggers

A broad reload is allowed only on:

A new PR number, milestone, turn, or session alone is not a reload trigger.

Agent OS is the canonical home for this rule. Child and downstream repositories should LINK to this policy rather than copy it, mirroring how repositories point to the Connector Safety Gate. A downstream repository may keep a short distilled pointer to this policy, but Agent OS remains the canonical home for the cold-start and warm-continuation rule.

Safety invariants

Loading less context never lowers safety or authority requirements.

These invariants stay consistent with the repository AGENTS.md and the Context Loading Economy for Agent Handoffs playbook; nothing here overrides an explicit no-go gate or enforced control.