# Manage Context

> Repair and maintain `.project/context/` so it reflects current project reality. Use when context files are stale, contradictory, still template-like, after major scope or architecture changes, before handoff, or when execution friction suggests context debt.

- Skill: `majesteitbart/manage-context` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add majesteitbart/manage-context`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majesteitbart/manage-context/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majesteitbart (https://skillmd.com/u/majesteitbart)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/majesteitbart/manage-context

---


# 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/*.md` files 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.sh`
- `bash .agents/scripts/pm/status.sh`
- `bash .agents/scripts/pm/search.sh "<term>"`

## Execution assets
- `references/runbook.md`
- `references/context-audit-checklist.md`
- `templates/context-debt-report.md`
- `templates/context-refresh-summary.md`