LogoSkills

/cc-product:plan — 무엇을·어떻게 만들지 "설계도" 단계

3단계: Planning — 조사 결과를 `docs/prd-*.md`(무엇을 만들지)·`docs/tech-spec-*.md`(어떻게 만들지)·`docs/bdd-*.md`(무엇이 합격인지) 최대 세 문서로 확정합니다.

/cc-product:plan — 무엇을·어떻게 만들지 "설계도" 단계#

항목내용
실행 명령/cc-product:plan
분류파이프라인
난이도●●○ 보통

한마디로#

조사에서 모은 내용을 가지고 "무엇을, 어떻게 만들지"를 문서로 확정하는 단계입니다. 집을 지을 때 본격적인 공사를 시작하기 전에 설계도와 시방서를 완성하는 것과 같아요.

누가·언제 쓰나요#

  • 만들 기능의 방향은 정해졌고, 이제 구체적인 기획서·요구사항을 글로 정리하고 싶은 경우
  • PRD, 기술 명세, 합격 기준(테스트 시나리오)을 한 번에 갖추고 싶을 때
  • 앞 단계(Specification)의 명세 결과를 바탕으로 본격적인 제품 기획을 진행하려 할 때

👉 건너뛰어도 되는 경우: 앞 단계(Specification)에서 이미 충분한 명세가 나와 있다면, 바로 다음 단계로 넘어갈 수 있습니다. (.pipeline/{프로젝트이름}.yaml에서 진행 상태를 확인합니다.)

무엇을 해주나요#

선택한 문서 종류에 따라 최대 세 개의 파일이 만들어집니다.

  • docs/prd-{프로젝트이름}.md — PRD(제품 요구사항 문서): 무엇을 만들지, 어떤 기능이 필요한지
  • docs/tech-spec-{프로젝트이름}.md — 기술 명세서: 어떻게 만들지(성능·보안·데이터 구조 등)
  • docs/bdd-{프로젝트이름}.md — 합격 기준: "이렇게 동작하면 통과"를 시나리오로 적은 문서

어떻게 쓰나요#

# 기본 (PRD 작성)
/cc-product:plan

# 문서 종류를 지정해서 작성
/cc-product:plan --doc prd  " 커뮤니티 기능 " 
 /cc-product:plan --doc tech-spec

--doc로 만들 문서를 고를 수 있습니다 — prd(요구사항), tech-spec(기술 명세), both(둘 다). 합격 기준(BDD)은 기본으로 함께 포함되며, 빼고 싶을 때만 --bdd false를 덧붙이세요.

안에서 무슨 일이 벌어지나요#

크게 네 단계로 진행하며, 마지막에 품질 검증(Gate)을 통과해야 끝납니다.

  1. 제품 기획서 작성 — 조사 결과를 바탕으로 제품 개요, 목표·범위·제약, 성공 기준을 정리합니다.
  2. 상세 문서 작성 — 기능·비기능 요구사항, 사용자 흐름, 데이터 모델 초안을 담은 PRD나 기술 명세를 쓰고, 수익 모델·가치 제안도 함께 점검합니다.
  3. 요구사항 분석 + 합격 기준 — 요구사항이 명확한지·충돌은 없는지 확인하고 우선순위를 매긴 뒤, "이렇게 동작해야 통과"를 Given-When-Then 시나리오로 적습니다.
  4. 품질 검증(Analysis Gate) — 요구사항 명확성·범위 적절성·검증 가능성 등을 점수로 채점하고, 기준 미달이면 피드백을 반영해 문서를 다시 다듬습니다.

검증을 통과하면 기획 문서가 파일로 저장되고, 다음 단계인 설계(/cc-product:design) 로 넘어갑니다.

⚙️ 상세 옵션·실행 명세 (개발자 / AI 에이전트용)

Triggers#

  • When proceeding with product planning based on Specification artifacts
  • When PRD, technical specifications, and BDD scenarios need to be written

Usage#

/cc-product:plan
/cc-product:plan --doc prd  " Community feature " 
 /cc-product:plan --doc tech-spec

Options#

OptionDefaultDescription
--docprdDocument type (prd, tech-spec, both)
--bddtrueInclude BDD Gherkin Acceptance Criteria

Prerequisites#

  • Specification stage completed or skipped (check .pipeline/{slug}.yaml)
  • Discovery/Specification artifacts auto-referenced if available

Execution Flow#

Phase 1: Product Brief#

Source: cc-product

  1. Product brief writing (/cc-product:product-brief)
    • Product overview based on Discovery/Specification artifacts
    • Goals, scope, constraints
    • Success criteria definition

Phase 2: Detailed Document Writing#

Source: cc-product, cc-product

  1. PRD or technical specification (/cc-product:prd or /cc-product:tech-spec)

    • Functional requirements detail
    • Non-functional requirements (performance, security, accessibility)
    • User flows
    • Data model draft

  2. Business model (cc-product: business-model)

    • Revenue model review
    • Cost structure analysis
    • Value proposition summary

Phase 3: Requirements Analysis#

Source: cc-product (Analyst persona)

  1. Requirements analysis

    • Requirement clarity verification
    • Ambiguity and conflict identification
    • Priority assignment

  2. BDD Acceptance Criteria

    • Gherkin format scenario writing
    • Given-When-Then structuring
    • Edge case scenarios included

Phase 4: Analysis Gate + Plan Quality Scoring#

BMAD Analysis Gate verification:

  • Requirement clarity (requirement_clarity)
  • Scope appropriateness (scope_appropriateness)
  • Acceptance Criteria testability (ac_testability)

Plan Quality Scoring (see cc-product/references/phase-gates.md):

  • Clarity ≥ 0.6 (weight 0.25)
  • Completeness ≥ 0.6 (weight 0.25)
  • Specificity ≥ 0.6 (weight 0.20)
  • YAGNI Compliance ≥ 0.6 (weight 0.15)
  • Scope Appropriateness ≥ 0.6 (weight 0.15)
  • Weighted Total ≥ 0.8

Thresholds defined in cc-product/config/thresholds.yaml. Documents are revised with feedback if gate or quality score fails.

Artifacts#

docs/prd-{slug}.md          # PRD (if selected)
docs/tech-spec-{slug}.md    # Technical specification (if selected)
docs/bdd-{slug}.md          # BDD scenarios

After Completion#

  • Verify Analysis Gate passed
  • Update .pipeline/{slug}.yaml state
  • Present context-clear handoff:
✅ Planning stage complete (Analysis Gate PASSED). Artifacts saved:
  - docs/prd-{slug}.md
  - docs/tech-spec-{slug}.md
  - docs/bdd-{slug}.md

**Option 1 (Recommended)**: Clear context and continue to Design
  /clear
  Then run: /cc-product:design

**Option 2**: Continue in current context
  Proceed directly to /cc-product:design