Context Master
Universal context management and planning skill for complex tasks, long sessions, and multi-file projects. Works the same way whether you are in the Web app, the API, or Claude Code CLI; CLI-specific bonuses live in references/claude-code-cli.md.
This SKILL.md is intentionally short. Detailed material lives in references/ — load only what you need.
When to activate
Activate proactively whenever the request matches one of:
- Multi-file project (3+ related files, websites, apps, APIs, doc sets).
- Architecture or technology decision ("should we use X or Y", "which approach…").
- Research / comparison / tradeoff analysis.
- Refactoring or migration work.
- Long coding session where context efficiency matters.
- Any task with 3+ sequential steps or shared dependencies.
If the request is a single file with no dependencies, skip this skill.
The 5-step workflow (memorize this)
For any multi-file project — websites, apps, APIs, documentation sets — run these five steps in order:
- STOP — do not create any files yet.
- PLAN — use extended thinking or a planning document (both equally valid; see
references/multi-file-planning.md). - ANNOUNCE — state the file list and creation order to the user.
- CREATE — write files in optimal order (foundations before dependents).
- VERIFY — check that every reference resolves; fix issues before declaring done.
Worked example (portfolio website)
User: "Create a portfolio with home, about, projects, and contact pages."
Step 1 STOP -- do not start with index.html.
Step 2 PLAN -- "Think hard about architecture: 5 files needed,
styles.css is the shared dependency."
Step 3 ANNOUNCE -- "I'll create:
1. styles.css (shared styling)
2. index.html (references styles.css)
3. about.html
4. projects.html
5. contact.html"
Step 4 CREATE -- write files in that order.
Step 5 VERIFY -- every HTML file links styles.css; navigation resolves.
Result: no refactor, no re-export, no broken links.
The full template, optimal-order patterns by project type (website / React / backend API / etc.), and verification checklists are in references/multi-file-planning.md.
Core principles (one line each)
- Plan before you write — extended thinking or planning doc, never both skipped.
- Foundations first — shared dependencies (CSS, config, base classes, schemas) precede dependents.
- Delegate deep analysis to isolated contexts — subagents (CLI) or thinking artifacts (Web/API) keep the main thread clean.
- Phase boundaries — name each phase ("Phase 1 complete; moving to Phase 2: …") so context doesn't blur.
- Artifacts over inline content — long code or docs live in artifacts/files, not chat history.
- Progressive disclosure — ask for one slice at a time; don't batch unrelated steps.
- Signal resets — say "setting aside the previous approach…" when changing direction.
- Reflect after large projects — was it planned? Did references break? Use the post-project checklist in
references/multi-file-planning.md.
Full rationale and examples for every principle: references/universal-best-practices.md.
Token-savings rule of thumb
| Project size | Without planning | With planning | Savings | |---|---|---|---| | Small (3-4 files) | ~6,000 tokens | ~2,500 tokens | ~58% | | Medium (7-8 files) | ~12,000 tokens | ~4,500 tokens | ~63% | | Large (20+ files) | ~35,000 tokens | ~12,000 tokens | ~66% |
A 200K-token context window holds roughly 16-17 medium projects with planning, 7-8 without — a 2.1x effective increase. Numbers and methodology in references/multi-file-planning.md.
Passive deep-thinking architecture
The single most powerful pattern for context efficiency: route deep reasoning into an isolated space and return a short summary to the main thread.
- Claude Code CLI:
/agent deep-analyzer "Ultrathink about [decision]"— ~5K tokens of reasoning happens out-of-band; main context receives a ~200-token summary (~23x efficiency). - Web / API:
"Create a deep-analysis artifact and ultrathink about [decision]"— same idea, artifact instead of subagent.
Triggers, anti-patterns, and ready-made prompts: references/thinking-delegation.md.
Common workflows (pointers only)
Each of these has a step-by-step procedure in references/workflows.md:
- Workflow 0 — Multi-file website/project creation (the default — same 5 steps above with extra detail).
- Workflow 1 — Complex decision-making (architecture, tech choice).
- Workflow 2 — Complex feature development (analysis → design → implement → test → integrate).
- Workflow 3 — Research and technology evaluation.
- Workflow 4 — Code generation and iteration via artifacts.
- Workflow 5 — Refactoring with isolated analysis.
Anti-patterns (avoid these)
Quick list — examples and fixes in references/anti-patterns.md:
- Creating files before planning — wastes context on refactors.
- Asking for everything at once — overloads context and produces shallow output.
- Inlining long code/docs in chat — bloats history; use artifacts/files.
- Letting deep reasoning happen in main thread — costs ~5K tokens that could be ~200.
- No phase boundaries — context blurs across unrelated subtasks.
Troubleshooting
When sessions drift (responses unfocused, conversations getting too long, code regenerating instead of editing, extended thinking not engaging), see references/troubleshooting.md for a symptom → remedy table covering Web/API and CLI separately.
Claude Code CLI bonuses
If you are running in Claude Code CLI, you also get:
/clear,/compact,/continue— built-in context controls./agent <name>— delegate to an isolated subagent.CLAUDE.md— persistent project memory.- Helper scripts for generating
CLAUDE.mdand subagent definitions.
Details, script invocations, and the deep-analysis delegation patterns: references/claude-code-cli.md.
Skill–subagent integration patterns (when both are available) live in references/agent-skills-integration-2025.md. Long-form context strategies and subagent prompt patterns: references/context_strategies.md and references/subagent_patterns.md.
Reference map
| File | Use when |
|---|---|
| references/multi-file-planning.md | Planning template, optimal-order patterns by project type, verification checklists, post-project reflection. |
| references/universal-best-practices.md | Need the rationale or examples for any of the 8 core principles. |
| references/workflows.md | Need a step-by-step procedure for a specific scenario (decision, feature, research, refactor). |
| references/thinking-delegation.md | Designing a deep-analysis delegation or writing the thinking prompt. |
| references/anti-patterns.md | Reviewing whether the current approach is wasting context. |
| references/troubleshooting.md | Session is drifting, slow, or producing too much explanation. |
| references/claude-code-cli.md | Running in Claude Code CLI and want subagent / CLAUDE.md tooling. |
| references/agent-skills-integration-2025.md | Combining skills with subagents in CLI. |
| references/context_strategies.md | Long-form strategy notes. |
| references/subagent_patterns.md | Subagent prompt patterns. |
Success indicators
- You announced the plan before creating any file.
- Foundation files (CSS, config, schemas) were written before dependents.
- No reference broke on first run; no refactor was needed.
- Deep reasoning happened in a subagent or artifact, not the main thread.
- Phases were named as you crossed them.
If any of those failed, walk back through references/anti-patterns.md and references/multi-file-planning.md post-project section before the next task.