Context Master
복잡한 작업, 긴 세션 및 다중 파일 프로젝트를 위한 범용 컨텍스트 관리 및 계획 스킬입니다. Web 앱, API 또는 Claude Code CLI에서 동일하게 작동합니다. CLI 전용 추가 기능은 references/claude-code-cli.md에 있습니다.
이 SKILL.md는 의도적으로 짧게 유지됩니다. 자세한 내용은 references/에 있으니 필요한 것만 로드하세요.
활성화 시점
요청이 다음 중 하나와 일치할 때 사전에 활성화하세요:
- 다중 파일 프로젝트 (3개 이상의 관련 파일, 웹사이트, 앱, API, 문서 세트)
- 아키텍처 또는 기술 결정 ("X를 써야 할까 Y를 써야 할까", "어떤 접근 방식이…")
- 연구 / 비교 / 트레이드오프 분석
- 리팩토링 또는 마이그레이션 작업
- 컨텍스트 효율성이 중요한 긴 코딩 세션
- 3단계 이상의 순차적 단계 또는 공유 종속성이 있는 모든 작업
요청이 단일 파일이고 종속성이 없다면 이 스킬을 건너뛰세요.
5단계 워크플로우 (암기하세요)
모든 다중 파일 프로젝트(웹사이트, 앱, API, 문서 세트)에 대해 다음 5단계를 순서대로 실행하세요:
- STOP — 아직 어떤 파일도 생성하지 마세요.
- PLAN — 확장 사고 또는 계획 문서를 사용하세요 (둘 다 동등하게 유효, 자세한 내용은
references/multi-file-planning.md참조). - ANNOUNCE — 파일 목록과 생성 순서를 사용자에게 알리세요.
- CREATE — 최적의 순서로 파일을 작성하세요 (기초 파일을 종속 파일보다 먼저).
- VERIFY — 모든 참조가 해결되었는지 확인하고, 문제를 수정한 후 완료를 선언하세요.
작업 예시 (포트폴리오 웹사이트)
사용자: "홈, 소개, 프로젝트, 연락처 페이지가 있는 포트폴리오를 만들어 주세요."
1단계 STOP -- index.html부터 시작하지 마세요.
2단계 PLAN -- "아키텍처에 대해 깊이 생각하세요: 5개의 파일이 필요하고,
styles.css는 공유 종속성입니다."
3단계 ANNOUNCE -- "다음 순서로 생성합니다:
1. styles.css (공유 스타일링)
2. index.html (styles.css 참조)
3. about.html
4. projects.html
5. contact.html"
4단계 CREATE -- 해당 순서로 파일을 작성합니다.
5단계 VERIFY -- 모든 HTML 파일이 styles.css를 링크하며, 네비게이션이 정상 작동합니다.
결과: 리팩토링, 재내보내기, 끊어진 링크가 없습니다.
전체 템플릿, 프로젝트 유형별 최적 순서 패턴 (웹사이트 / React / 백엔드 API 등), 그리고 확인 체크리스트는 references/multi-file-planning.md에 있습니다.
핵심 원칙 (각 한 줄씩)
- 쓰기 전에 계획하세요 — 확장 사고 또는 계획 문서, 둘 다 건너뛰지 마세요.
- 기초부터 먼저 — 공유 종속성 (CSS, 설정, 기본 클래스, 스키마)이 종속 파일보다 먼저입니다.
- 심층 분석은 격리된 컨텍스트에 위임하세요 — 서브에이전트(CLI) 또는 사고 아티팩트(Web/API)가 메인 스레드를 깔끔하게 유지합니다.
- 단계 경계를 명확히 하세요 — 각 단계의 이름을 지정하세요 ("1단계 완료, 2단계로 이동: …") 그래야 컨텍스트가 흐려지지 않습니다.
- 인라인 콘텐츠보다 아티팩트를 사용하세요 — 긴 코드나 문서는 채팅 기록이 아닌 아티팩트/파일에 저장하세요.
- 점진적 공개 — 한 번에 한 조각씩 요청하고, 관련 없는 단계를 배치로 처리하지 마세요.
- 리셋 신호 — 방향을 바꿀 때 "이전 접근 방식을 제쳐두고…"라고 말하세요.
- 대규모 프로젝트 후에는 회고하세요 — 계획대로 진행되었나요? 참조가 깨졌나요?
references/multi-file-planning.md의 프로젝트 후 체크리스트를 사용하세요.
모든 원칙에 대한 전체 설명과 예시: references/universal-best-practices.md.
토큰 절감 경험 법칙
| 프로젝트 크기 | 계획 없음 | 계획 있음 | 절감율 |
|---|---|---|---|
| 소규모 (3-4 파일) | ~6,000 토큰 | ~2,500 토큰 | ~58% |
| 중간 (7-8 파일) | ~12,000 토큰 | ~4,500 토큰 | ~63% |
| 대규모 (20+ 파일) | ~35,000 토큰 | ~12,000 토큰 | ~66% |
200K 토큰 컨텍스트 창에는 계획을 사용하면 약 16-17개의 중간 프로젝트가 들어가고, 계획 없이는 7-8개가 들어가며, 이는 2.1배의 실질적인 증가입니다. 수치 및 방법론은 references/multi-file-planning.md에 있습니다.
수동 심층 사고 아키텍처
컨텍스트 효율성을 위한 가장 강력한 패턴: 깊은 추론을 격리된 공간으로 보내고 짧은 요약만 메인 스레드로 반환합니다.
- Claude Code CLI:
/agent deep-analyzer "[결정]에 대해 울트라씽크"— 약 5K 토큰의 추론이 대역외에서 발생하며, 메인 컨텍스트는 약 200 토큰 요약만 수신(~23배 효율성). - Web / API:
"깊이 분석 아티팩트를 만들고 [결정]에 대해 울트라씽크"— 동일한 아이디어, 서브에이전트 대신 아티팩트 사용.
트리거, 안티패턴 및 기성 프롬프트: references/thinking-delegation.md.
일반 워크플로우 (포인터만)
각 항목에 대한 단계별 절차는 references/workflows.md에 있습니다:
- 워크플로우 0 — 다중 파일 웹사이트/프로젝트 생성 (기본값 — 위 5단계와 동일하며 추가 세부 정보 포함).
- 워크플로우 1 — 복잡한 의사 결정 (아키텍처, 기술 선택).
- 워크플로우 2 — 복잡한 기능 개발 (분석 → 설계 → 구현 → 테스트 → 통합).
- 워크플로우 3 — 연구 및 기술 평가.
- 워크플로우 4 — 아티팩트를 통한 코드 생성 및 반복.
- 워크플로우 5 — 격리된 분석을 통한 리팩토링.
안티패턴 (피해야 할 것)
빠른 목록 — 예시와 해결 방법은 references/anti-patterns.md에 있습니다:
- 계획 없이 파일 생성 — 리팩토링에 컨텍스트를 낭비합니다.
- 모든 것을 한 번에 요청 — 컨텍스트에 과부하를 주고 얕은 결과물을 생성합니다.
- 채팅에 긴 코드/문서를 인라인으로 포함 — 기록을 비대하게 만듭니다. 아티팩트/파일을 사용하세요.
- 메인 스레드에서 깊은 추론을 수행 — 약 5K 토큰이 약 200토큰이 될 수 있는 비용을 발생시킵니다.
- 단계 경계 없음 — 관련 없는 하위 작업 간에 컨텍스트가 흐려집니다.
문제 해결
세션이 표류할 때 (응답이 집중되지 않음, 대화가 너무 길어짐, 코드가 편집 대신 재생성됨, 확장 사고가 활성화되지 않음) Web/API와 CLI를 각각 다루는 증상 → 해결책 표가 있는 references/troubleshooting.md를 참조하세요.
Claude Code CLI 추가 기능
Claude Code CLI에서 실행 중인 경우 다음도 사용할 수 있습니다:
/clear,/compact,/continue— 내장 컨텍스트 제어./agent <name>— 격리된 서브에이전트에 위임.CLAUDE.md— 영구 프로젝트 메모리.CLAUDE.md및 서브에이전트 정의 생성을 위한 도우미 스크립트.
자세한 내용, 스크립트 호출 및 심층 분석 위임 패턴: references/claude-code-cli.md.
스킬-서브에이전트 통합 패턴 (둘 다 사용 가능한 경우)은 references/agent-skills-integration-2025.md에 있습니다. 장문 컨텍스트 전략 및 서브에이전트 프롬프트 패턴: references/context_strategies.md 및 references/subagent_patterns.md.
참조 맵
| 파일 | 사용 시점 |
|---|---|
references/multi-file-planning.md | 계획 템플릿, 프로젝트 유형별 최적 순서 패턴, 확인 체크리스트, 프로젝트 후 회고. |
references/universal-best-practices.md | 8가지 핵심 원칙에 대한 근거나 예시가 필요할 때. |
references/workflows.md | 특정 시나리오(의사 결정, 기능, 연구, 리팩토링)에 대한 단계별 절차가 필요할 때. |
references/thinking-delegation.md | 심층 분석 위임을 설계하거나 사고 프롬프트를 작성할 때. |
references/anti-patterns.md | 현재 접근 방식이 컨텍스트를 낭비하고 있는지 검토할 때. |
references/troubleshooting.md | 세션이 표류하거나, 느리거나, 너무 많은 설명을 생성할 때. |
references/claude-code-cli.md | Claude Code CLI에서 실행 중이며 서브에이전트 / CLAUDE.md 도구를 원할 때. |
references/agent-skills-integration-2025.md | CLI에서 스킬과 서브에이전트를 결합할 때. |
references/context_strategies.md | 장문 전략 노트. |
references/subagent_patterns.md | 서브에이전트 프롬프트 패턴. |
성공 지표
- 파일을 생성하기 전에 계획을 발표했습니다.
- 기초 파일 (CSS, 설정, 스키마)이 종속 파일보다 먼저 작성되었습니다.
- 첫 번째 실행에서 참조가 깨지지 않았으며 리팩토링이 필요하지 않았습니다.
- 깊은 추론이 서브에이전트 또는 아티팩트에서 발생했으며 메인 스레드에서 발생하지 않았습니다.
- 단계를 넘어갈 때마다 단계 이름을 지정했습니다.
위 중 하나라도 실패했다면, 다음 작업 전에 references/anti-patterns.md와 references/multi-file-planning.md의 프로젝트 후 섹션을 다시 살펴보세요.