plan-2-draft

name	plan-2-draft
description	기획 시작 스킬. "기획 시작", "기획 시작해주세요", "플래닝 시작", "새 기획", "기획 킥오프" 등의 요청 시 트리거. plan-1이 확정한 프로젝트의 Memory(용어집·플로우차트)를 로드하고, 기존 플로우/로직과의 정합성을 검사하여 기획 초안을 작성한다. AI Driven Development 파이프라인의 2단계.
compatibility	notion-fetch MCP 툴 필요

기획 시작 (AI Driven Development Step 2/6)

이 스킬은 AI Driven Development 파이프라인의 두 번째 단계이다. 완료 후 사용자에게 Step 3: Edge Case 검사 스킬 사용을 안내한다.

전제 조건

Step 1(브레인스토밍)의 로컬 md 파일(.claude/docs/brainstorm-*.md)이 존재해야 한다. 파일이 없으면 사용자에게 "먼저 '아이디어 정리해주세요'로 Step 1을 완료해 주세요"라고 안내한다.

로컬 md 파일에 Notion 상세 문서 링크가 있으면 해당 Notion 페이지도 notion-fetch로 로드한다.

Memory Bootstrap (공통)

이 스킬은 Notion Memory를 읽기 전용으로 참조한다. 실행 시 아래 순서로 Memory URL을 확보한다.

1. .claude/docs/brainstorm-*.md의 프론트매터에서 아래 값을 읽는다:
   • project_name
   • glossary_url
   • flowchart_url
   • principle_url
   • constraint_url
2. 이 단계에서 사용할 memory: glossary_url, flowchart_url
3. URL이 누락되었으면 해당 검사를 스킵하고 사용자에게 보고한다. ("이 프로젝트의 glossary URL이 없어 용어 정합성 검사를 스킵합니다")
4. 프론트매터 자체가 없으면 "plan-1부터 다시 실행해 주세요" 안내 후 중단.

출력 전략

토큰 절감과 가독성을 위해 출력 채널을 분리한다.

채널	용도	내용
터미널	대화 전용	질문, 응답, 간단한 요약 (3줄 이내)
Notion	상세 문서	기획 초안 전문, 정합성 검사 결과, 기능 상세
로컬 md	파이프라인 입력	plan-3-edge-case가 참조할 구조화된 요약 + Memory URL 프론트매터 계승

터미널 출력 규칙

• 정합성 검사 결과: 이슈가 있는 항목만 터미널에 요약. 전체 결과는 Notion에 작성.
• 기획 초안: 기능 목록 요약만 터미널에 출력. 기능 상세는 Notion에 작성.
• 완료 시: Notion 링크와 로컬 파일 경로만 터미널에 출력.

Notion 저장

Step 1에서 확보한 Notion 페이지에 이어서 작성한다. Step 1의 로컬 md 파일에서 Notion 페이지 URL을 읽어온다.

로컬 md 파일

• 저장 경로: 프로젝트 루트의 .claude/docs/draft-{기획주제}.md

• 프론트매터는 plan-1의 값을 그대로 계승하여 기록한다 (plan-3~6 전파용):

  ---
  project_name: {plan-1에서 계승}
  glossary_url: {URL}
  flowchart_url: {URL}
  principle_url: {URL}
  constraint_url: {URL}
  ---
  

• 본문은 plan-3-edge-case 및 plan-6-document가 참조할 수 있도록 아래 구조로 작성:

  • 기획 주제, 목적, 배경, 범위
  • 사용자 정의 (대상 유저 / 행동 특성 / etc. — plan-6 "사용자 정의" 섹션에 사용)
  • 가설 (만약 X가 Y한다면 Z할 것이다 — plan-6 "가설" 섹션에 사용)
  • 기능 목록 (F-ID, 기능명, 우선순위)
  • 정합성 검사 결과 요약
  • 검증 계획 초안
  • Notion 상세 문서 링크

1단계: 참조 문서 로드 (Memory 기반)

Memory Bootstrap으로 확보한 URL을 순서대로 notion-fetch로 읽는다.

1-1. Glossary 로드

glossary_url을 fetch하여 용어 정의 표를 확보한다. 페이지 본문에서 용어명·정의·금지 표기를 파싱한다.

1-2. Flowchart 로드 (2단계 fetch)

flowchart_url을 fetch한다. 반환 결과에 <database inline="true"> 태그가 있으면 데이터베이스 형태이다:

1. DB의 data source URL(collection://...)을 이용해 전체 row 목록을 조회한다 (row 필터 없음 — 상태/검토 여부 속성 무시).
2. 각 row의 title을 모아 기획 주제 키워드와 매칭되는 row만 개별 notion-fetch로 Mermaid 본문까지 읽는다.
3. 직접 매칭되지 않더라도 인접 영역(관련 화면·엔티티)의 row는 추가 로드 대상으로 사용자에게 제안할 수 있다.

페이지 형태(인라인 DB가 없는 단일 Mermaid 페이지)라면 본문을 한 번에 확보한다.

1-3. 오류 처리

• 401/404: Notion 커넥터(OAuth) 연결 및 페이지 권한 재확인 안내.
• URL 누락: 해당 검사(용어 정합성 또는 플로우 매핑) 스킵 공지 후 계속 진행.

2단계: 기획 주제 및 범위 확인

사용자에게 다음을 확인한다.

2-1. 기본 정보

1. 어떤 기능 / 화면 / 서비스에 대한 기획인지
2. 기획의 목적과 배경 (신규 기능, 개선, 실험 등)
3. 특별히 강조하거나 포함해야 할 내용이 있는지
4. 이번 기획의 범위 — 포함할 것과 제외할 것

2-2. 사용자 정의 (plan-6 "사용자 정의" 섹션 입력 소스)

대상 유저를 구체적으로 정의하기 위해 아래 항목을 질문한다. 답변은 다음 단계에서 표로 정리된다.

항목	질문
대상 유저	"이번 시도의 대상이 되는 유저는 누구입니까? (예: 신규 가입자, 헤비 유저, 휴면 사용자 등)"
행동 특성	"그 유저가 가진 특징적인 행동 패턴은 무엇입니까? (예: 매일 앱 실행, 앨범 5개 이상 보유 등)"
etc.	"그 외 추가로 정의해야 할 특성이 있습니까? (예: 디바이스, 지역, 가입 경로 등 — 없으면 생략 가능)"

대상 유저가 여러 그룹이면 각각을 별도 행으로 분리하여 받는다.

2-3. 가설 (plan-6 "가설" 섹션 입력 소스)

이번 시도로 검증하고자 하는 가설을 아래 형식으로 받는다.

만약 (대상)가(이) (특정 행동)을 한다면, (기대 하는 결과)할 것이다.

• 사용자가 자유 서술로 답변한 경우 위 형식으로 LLM이 변환한 후 사용자에게 다시 보여 확인을 받는다.
• 가설이 여러 개면 우선순위(P0/P1/P2 등)를 함께 받는다.
• 가설이 명확히 정의되지 않으면 brainstorm-*.md의 "해결 방향"을 참조하여 LLM이 초안을 제시하고 사용자가 수정한다.

3단계: 기존 플로우/로직 정합성 검사

로드된 참조 문서를 기반으로 아래를 수행한다.

3-1. 기존 플로우 매핑

Flowchart DB에서 로드한 row들 중 이번 기획과 관련된 기존 흐름을 식별한다.

관련 기존 플로우 (row)	연결 지점	영향
(row 제목)	(Mermaid 노드 중 어디에서 분기/합류하는지)	(추가/변경/없음)

3-2. 기존 기능 연계 확인

Flowchart DB의 각 row 제목과 Mermaid 본문이 곧 기능/화면 카탈로그 역할을 한다. 이번 기획과 겹치거나 영향받는 기능을 row 단위로 식별한다.

기존 기능 (row)	관계	영향도	비고
(row 제목)	(확장/변경/의존)	(높음/중간/낮음)	(Mermaid 내 구체 노드 언급)

3-3. 용어 정합성

사용자 설명에 사용된 용어를 Glossary와 대조한다. 금지 표기 사용 또는 정의 불일치가 있으면 권장 표기로 치환을 제안한다.

3-4. 정합성 이슈 보고

검사 결과 충돌이나 주의사항이 있으면 아래 형식으로 사용자에게 보고한다.

이슈 ID	유형	내용	권장 조치
C-001	플로우 충돌 / 기능 중복 / 용어 불일치	(설명)	(제안)

사용자와 논의하여 각 이슈의 처리 방향을 결정한다.

4단계: 기획 초안 작성

정합성 검사를 반영하여 기획 초안을 아래 구조로 작성한다.

기획 초안

항목	내용
기획 주제
목적
배경
범위 - 포함
범위 - 제외

사용자 정의

2-2에서 받은 답변을 표로 정리한다 (plan-6 "사용자 정의" 섹션에 그대로 옮겨진다).

대상 유저	행동 특성	etc.

가설

2-3에서 받은 답변을 옮긴다 (plan-6 "가설" 섹션에 그대로 옮겨진다).

만약 (대상)가(이) (특정 행동)을 한다면, (기대 하는 결과)할 것이다.

가설이 여러 개인 경우 우선순위와 함께 나열한다.

우선순위	가설
P0
P1

기능 목록 (초안)

기능 ID	기능명	연계 기존 기능	우선순위	상태	간략 설명
F-001			must / should / could	신규 / 변경 / 확장

기능 상세 (초안, 기능 ID별 반복)

각 기능에 대해 아래를 작성한다:

선행 조건

#	조건	충족되지 않으면

사용자 입력

입력 항목	설명	필수 여부	제한 사항

사용 흐름

단계	사용자 행동	시스템 반응	다음 단계

성공 결과

결과	사용자가 보는 변화

검증 계획 초안

brainstorming 단계에서 논의된 성공 기준을 기반으로 작성한다. 논의된 내용이 없으면 사용자에게 아래 항목을 직접 질문하여 채운다.

항목	내용
확인할 지표	(예: 앨범 등록 완료율, 등록 후 이탈률)
성공 기준	(예: 기존 대비 완료율 10% 이상 향상)
확인 방법	(예: 앱 내 이벤트 로그 분석, CS 문의량 추이)
검증 시점	(예: 출시 후 2주)

관련 서비스 및 기능

관련 서비스/기능	어떤 관계인지	비고

정합성 검사 결과 요약

이슈 ID	내용	처리 결과

5단계: 사용자 확인 및 다음 단계 안내

기획 초안을 Notion 페이지에 작성하고 로컬 md 파일에 요약 + 프론트매터를 저장한 뒤, 사용자에게 Notion 링크와 로컬 파일 경로를 안내한다. 수정 사항이 있으면 Notion과 로컬 md를 모두 업데이트한다. 합의 후 아래 메시지로 다음 단계를 안내한다:

✅ 기획 초안 완료 (Step 2/6)

다음 단계로 Edge Case 검사를 진행합니다. 아래와 같이 요청해 주세요:

👉 "edge case 검사해주세요"