# Consolidate Context

> Consolidates CONTEXT.md by removing duplicates and outdated items and tightening the language.

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

---


Consolidate `.mpx/CONTEXT.md` into a concise, future-proof reference. Preserve all important detail while removing noise.

See `skills/shared/DOCUMENTATION_STRATEGY.md` for format details.

## Input Resolution

1. If `$ARGUMENTS` is a file path, use that file.
2. Otherwise, use `.mpx/CONTEXT.md`.
3. If not found, ask the user for the path.

## Process

### Step 1: Read & Analyze

Read every line of the full file against each issue type and build a classified findings list:

| Issue Type | What to Look For |
|---|---|
| **Duplicates** | Terms or features covering the same concept (keep the most current/complete version) |
| **Superseded** | Content explicitly marked as superseded, replaced, or overridden by newer entries |
| **Negative framing** | "must not", "cannot", "never" — convert to positive imperative |
| **Non-content noise** | Implementation notes, deviation notes, historical provenance, issue-tracking meta, "Plan vN" / date labels |
| **Outdated** | Struck-through items, removed parameters still referenced, resolved issue references |
| **Inconsistencies** | Conflicting definitions or specifications |
| **Bloated definitions** | Domain Language definitions exceeding one sentence |
| **Misplaced content** | Architectural decisions that belong in DECISIONS.md, implementation details that belong in epics |

### Step 2: Rewrite

Apply all changes directly and automatically. Produce the consolidated file:

- § Domain Language: one sentence max per definition, definition-list format (`**Term** — Definition.`)
- § Core Features: index only (name + status + epic#), no implementation details
- § Key Constraints: concise bullets
- § Flagged Ambiguities: resolved term conflicts with rationale
- Target 250–300 lines total

**Content rules:**
- Remove implementation/deviation notes (belong in PRs or commit messages)
- Fix inconsistent values (use the most recent/authoritative source)
- Merge sections that were split by version history into unified topics
- Keep full technical detail where it matters: formulas, ranges, defaults
- Move any settled architectural decisions to DECISIONS.md instead

### Step 3: Write Result

Write the consolidated file to the original path (overwrite), then re-read it to confirm the intended sections and retained technical details. Git history preserves the original.

## Report

After writing, summarize:
- Line count: original vs. consolidated (and lines saved)
- Items removed, merged, or rewritten (counts)
- Inconsistencies fixed
- Items moved to DECISIONS.md (if any)