Emile Masterplan — Development skill for Claude Code

emile-masterplan

[Claude Code](https://claude.com/claude-code) skill for tracking large, multi-plan bodies of work across sessions.

여러 개의 plan으로 나뉘는 큰 작업 묶음에 대해, 세션이 바뀌어도 흐름이 끊기지 않도록 **고정 진입점** 문서(마스터플랜)를 만들고 유지하는 Claude Code 스킬입니다.

마스터플랜은 **지도이지 설계가 아닙니다.** 설계 결정은 각 슬라이스의 spec이, 구현 절차는 각 슬라이스의 plan이 소유합니다. 이 문서는 이전 세션 기억이 없는 새 세션이 "지금 어디까지 왔고 다음에 무엇을 해야 하는가"를 복원하는 용도만 갖습니다.

superpowers 워크플로에서의 위치

이 스킬은 [obra/superpowers](https://github.com/obra/superpowers)의 워크플로를 전제로 설계되었으며, 그 스킬 세트를 대체하지 않습니다.

brainstorming ──(범위가 plan 1개를 넘음)──> emile-masterplan ──> writing-plans (슬라이스 1개)
                                                  ↑                          │
                                                  └── 슬라이스 종료 시 갱신 ──┘

• 설계(spec)는 superpowers:brainstorming이 소유합니다.
• 슬라이스 plan은 superpowers:writing-plans가 소유합니다.
• 실행은 superpowers:subagent-driven-development 또는 superpowers:executing-plans가 소유합니다.
• 이 스킬은 그 사이를 잇는 슬라이스 단위 장기 기억만 소유합니다.

superpowers 없이도 스킬 자체는 동작하지만, 위 워크플로 스킬들이 함께 있을 때를 기준으로 설계되었습니다.

When it triggers

• brainstorming/writing-plans가 "범위가 커서 여러 plan으로 나눠야 한다"고 판단했을 때
• 이미 나눠 놓은 plan들을 새 세션에서 이어서 진행할 때
• 슬라이스 하나를 끝내고 진행 상황을 기록해야 할 때
• 사용자가 "마스터플랜", "master plan", "전체 로드맵" 등을 요청할 때

**쓰지 않을 때:** plan 1개로 끝나는 작업. 슬라이스가 하나뿐이면 마스터플랜은 순수 오버헤드입니다 — 그냥 writing-plans로 갑니다.

Modes

호출될 때마다 어떤 파일을 쓰기 전에 먼저 상태를 판별합니다.

판별 결과	모드
사용자가 인자로 파일/주제를 지정	지정 우선
docs/masterplans/ 후보 0개	NEW — 새로 작성
브랜치로 좁힌 후보 1개	RESUME — 이어서 진행
후보 2개 이상	정지 — 목록을 보여주고 사용자 지정을 기다림

소유 문서가 확정된 뒤 슬라이스를 하나 끝냈거나 갱신을 요청받으면 **UPDATE** 모드로 진행 상황표를 갱신합니다.

What it produces

산출물은 **그 작업 묶음의 브랜치가 체크아웃된 워크트리** 기준 `docs/masterplans/{YYYYMMDD}-{HHMM}-{제목}-master-plan.md`입니다(워크트리가 없는 브랜치면 리포 루트). 현재 작업 디렉터리는 기준이 아닙니다. (스킬 디렉터리 자체에는 절대 쓰지 않습니다.)

소유자는 헤더의 `- 브랜치:` 줄입니다. 스킬은 이 줄을 파싱해 RESUME 후보를 고르므로 형식을 바꾸지 않습니다. 사용자에게 묻는 경우는 브랜치가 아직 정해지지 않았거나 슬라이스가 여러 브랜치에 걸칠 때뿐입니다.

템플릿은 필수 9개 섹션 + 조건부 섹션으로 구성됩니다.

• 목적/배경, 왜 나