manage-context
Trigger context
.project/context/still contains starter or placeholder language- implementation reality has drifted from spec, plan, or workstreams
- repeated confusion appears around scope, terminology, ownership, architecture, or testing
- a handoff, restart, or milestone review needs trustworthy context
- a major scope, workflow, or architecture change landed and context was not refreshed
Required inputs
- current
.project/context/files - related project docs (
spec.md,plan.md,workstreams/*.md,decisions.md, progress notes) - recent execution evidence (task state, code changes, review feedback, logs)
Output schema
- updated
.project/context/*.mdfiles where needed - context debt summary
- explicit contradictions or evidence gaps list
- recommended follow-up actions when context cannot be repaired safely
Quality checks
- no obvious template placeholders remain
- context matches current implementation and delivery reality
- terminology is consistent across files
- scope, constraints, and non-goals are explicit
- progress reflects evidence, not aspiration
- unresolved uncertainty is stated plainly instead of being hidden
Failure behavior
- do not invent missing facts
- stop short of rewriting uncertain sections as if they were confirmed
- return evidence gaps and contradiction notes when repair is partial
- prefer an explicit partial refresh over fake completeness
Allowed side effects
- update files under
.project/context/ - remove stale placeholder text from context files
- normalize duplicated or conflicting phrasing across context files
- add concise dated notes when they improve handoff clarity
Script hooks
bash .agents/scripts/pm/validate.shbash .agents/scripts/pm/status.shbash .agents/scripts/pm/search.sh "<term>"
Execution assets
references/runbook.mdreferences/context-audit-checklist.mdtemplates/context-debt-report.mdtemplates/context-refresh-summary.md