| ํญ๋ชฉ | ๋ด์ฉ |
|---|---|
| Invoke | /product |
| Category | pipeline |
| Complexity | high |
/product โ ํ๋ก์ ํธ ์ ๊ณผ์ ํ ๋ฒ์ ๋๋ฆฌ๊ธฐ#
ํ๋ก์ ํธ ์ค๋ช ํ ์ค๋ง ์ฃผ๋ฉด, ์กฐ์ฌ๋ถํฐ ์ถ์๊น์ง 7๋จ๊ณ ์ ์ฒด๋ฅผ ์์๋๋ก ์งํํฉ๋๋ค.
ํ๋ง๋๋ก#
๊ธฐ๋ฅ ํ๋๋ฅผ "์กฐ์ฌ โ ๋ช ์ธ โ ๊ธฐํ โ ์ค๊ณ โ ์ค๋น โ ๊ฐ๋ฐ โ ์ถ์"๊น์ง, ์ ํด์ง ์์๋๋ก ์๋์ผ๋ก ๋ฐ์ด์ฃผ๋ ์ข ํฉ ์งํ ๋ฒํผ์ ๋๋ค. ์ง์ ์ง๋ ๋ฐ ๋น์ ํ๋ฉด, ๋ถ์ง ์กฐ์ฌ๋ถํฐ ์ ์ฃผ๊น์ง ์ ๊ณต์ ์ ํ ๋ช ์ ์ด๊ด ๊ฐ๋ ์ด ๋จ๊ณ๋ณ๋ก ์ฑ๊ฒจ ์ฃผ๋ ๊ฒ๊ณผ ๊ฐ์์.
๋๊ฐยท์ธ์ ์ฐ๋์#
- ์ ํ๋ก์ ํธ๋ฅผ ์ฒ์๋ถํฐ ๋๊น์ง ํ ๋ฒ์ ์งํํ๊ณ ์ถ์ ๋
- ์ฌ๋ฌ ๋จ๊ณ๋ฅผ ๋ฐ๋ก๋ฐ๋ก ๋ถ๋ฅด์ง ์๊ณ , ์ ์ฒด ํ๋ฆ์ ํ ๋ฒ์ ๋งก๊ธฐ๊ณ ์ถ์ ๋
๐ ํ๋ก์ ํธ ๊ท๋ชจ(๋์ด๋)์ ๋ฐ๋ผ ์ผ๋ถ ๋จ๊ณ๋ ์๋์ผ๋ก ๊ฑด๋๋๋๋ค. ์๋ฅผ ๋ค์ด ์์ ๋ฒ๊ทธ ์์ ์ ์กฐ์ฌยท๋ช ์ธยท์ถ์ ๋จ๊ณ๋ฅผ ์๋ตํฉ๋๋ค.
๋ฌด์์ ํด์ฃผ๋์#
ํ๋ก์ ํธ ์งํ ์ํ๋ฅผ .pipeline/(ํ๋ก์ ํธ์ด๋ฆ).yaml ํ์ผ์ ๊ธฐ๋กํ๋ฉด์, ๊ฐ ๋จ๊ณ๊ฐ ๋๋ ๋๋ง๋ค ๊ฒฐ๊ณผ๋ฌผ์ด ์ฐจ๊ณก์ฐจ๊ณก ์์
๋๋ค. ๋ํ์ ์ผ๋ก:
- ์กฐ์ฌ ๊ฒฐ๊ณผ โ
docs/discovery-(ํ๋ก์ ํธ์ด๋ฆ).md - ๋ช
์ธ ๊ฒฐ๊ณผ โ
docs/seed-spec-(ํ๋ก์ ํธ์ด๋ฆ).md๋ฑ - ๊ธฐํ ๊ฒฐ๊ณผ โ PRD/๊ธฐ์ ๋ช ์ธ + BDD ์ธ์ ์กฐ๊ฑด
- ์ค๊ณ ๊ฒฐ๊ณผ โ ์ํคํ ์ฒ ๋ฌธ์ + UX ๋ช ์ธ
- ๊ฐ๋ฐ ๊ฒฐ๊ณผ โ ๊ตฌํ ์ฝ๋ + PR
- ์ถ์ ์ ๋ต โ
docs/gtm-(ํ๋ก์ ํธ์ด๋ฆ).md
๋ง์ง๋ง์๋ ์ ์ฒด ํ์ดํ๋ผ์ธ ์์ฝ ๋ณด๊ณ ์๋ฅผ ์ ๋ฆฌํด ์ค๋๋ค.
์ด๋ป๊ฒ ์ฐ๋์#
# ์ ์ฒด ํ์ดํ๋ผ์ธ
/product " ์ปค๋ฎค๋ํฐ ๊ธฐ๋ฅ ๊ฐ๋ฐ "
# ๋์ด๋(level) ์ง์ โ ๊ฑด๋๋ฐ๊ธฐ ๊ท์น์ ์ํฅ
/product --level 3 " ์ปค๋ฎค๋ํฐ ๊ธฐ๋ฅ ๊ฐ๋ฐ "
# ํน์ ๋จ๊ณ๋ถํฐ ์์
/product --from specify " ์ปค๋ฎค๋ํฐ ๊ธฐ๋ฅ ๊ฐ๋ฐ "
/product --from design " ์ปค๋ฎค๋ํฐ ๊ธฐ๋ฅ ๊ฐ๋ฐ "
# ํน์ ๋จ๊ณ๊น์ง๋ง ์งํ
/product --to epic " ์ปค๋ฎค๋ํฐ ๊ธฐ๋ฅ ๊ฐ๋ฐ "
--level: BMAD ํ๋ก์ ํธ ๋์ด๋(0~4). ๋น์ ๋๋ฉด ์๋์ผ๋ก ํ๋จํฉ๋๋ค.--from: ์ด๋ ๋จ๊ณ๋ถํฐ ์์ํ ์ง. ์ค๊ฐ์ ๋ฉ์ท๋ ์์ ์ ์ด์ด์ ํ ๋๋ ์ฌ์ฉํฉ๋๋ค.--to: ์ด๋ ๋จ๊ณ๊น์ง๋ง ์งํํ ์ง.--skip: ๊ฑด๋๋ธ ๋จ๊ณ๋ฅผ ์ผํ๋ก ๋์ดํฉ๋๋ค.
์์์ ๋ฌด์จ ์ผ์ด ๋ฒ์ด์ง๋์#
๊ฐ ๋จ๊ณ๊ฐ ๋๋ ๋๋ง๋ค ๊ฒฐ๊ณผ๋ฌผ์ ํ์ธํ๊ณ , ๋ค์ ๋จ๊ณ๋ก ๋์ด๊ฐ๊ธฐ ์ ์ ์ฌ์ฉ์์๊ฒ ํ ๋ฒ์ฉ ํ์ธ์ ๋ฐ์ต๋๋ค.
- ์ค๋น โ ํ๋ก์ ํธ ์ด๋ฆ(์ฌ๋ฌ๊ทธ)์ ๋ง๋ค๊ณ , ๋์ด๋๋ฅผ ์๋ ํ๋จํ ๋ค ์ํ ํ์ผ๊ณผ
docs/ํด๋๋ฅผ ์ค๋นํฉ๋๋ค. - ์กฐ์ฌ(Discovery) โ ์ฌ์ฉ์ยท์์ฅยท์์ด๋์ด๋ฅผ ์กฐ์ฌํฉ๋๋ค. (์์ ์์ ์ด๋ฉด ์๋ต)
- ๋ช ์ธ(Specification) โ ๋ฌด์์ ๋ง๋ค์ง ๋ชจํธํจ ์์ด ๋ชป ๋ฐ์ต๋๋ค. (์์ ์์ ์ด๋ฉด ์๋ต)
- ๊ธฐํ(Planning) โ ์ ํ ๋ธ๋ฆฌํยทPRD/๊ธฐ์ ๋ช ์ธ์ ์ธ์ ์กฐ๊ฑด์ ์ ๋ฆฌํฉ๋๋ค.
- ์ค๊ณ(Design) โ ์ํคํ ์ฒ์ UX๋ฅผ ์ค๊ณํฉ๋๋ค.
- ์ค๋น(Scaffold) โ ์ฝ๋ ๋ผ๋์ ํ ์คํธ ํ์ ์๋์ผ๋ก ๋ง๋ค์ด ๋ก๋๋ค. (์์ ์์ ์ด๋ฉด ์๋ต)
- ์ด์ ์์ฑ(Epic) โ ZenHub์ Epic๊ณผ Story๋ฅผ ๋ง๋ค๊ณ ์คํ๋ฆฐํธ๋ฅผ ๊ณํํฉ๋๋ค.
- ๊ฐ๋ฐ(Development) โ Story๋ฅผ ํ๋์ฉ ์ค์ ๋ก ๊ตฌํํ๊ณ PR์ ๋ง๋ญ๋๋ค.
- ์ถ์(Launch) โ ์์ฅ ์ง์ ์ ๋ตยท๋ฉ์์ง์ ์ค๋นํฉ๋๋ค. (๋ด๋ถ ๊ธฐ๋ฅ์ด๋ฉด ์๋ต)
- ๋ง๋ฌด๋ฆฌ โ ์ํ ํ์ผ์ ๊ฐฑ์ ํ๊ณ ์ ์ฒด ์์ฝ ๋ณด๊ณ ์๋ฅผ ์ถ๋ ฅํฉ๋๋ค.
์ค๊ฐ์ ๊ฒ์ดํธ(ํ์ง ๊ด๋ฌธ) ํต๊ณผ ์คํจ๋ ์ค๋จ์ด ์๊ธฐ๋ฉด, ๋ง์ง๋ง ์์น๋ฅผ ๊ธฐ๋กํด ๋์๋ค๊ฐ --from ์ต์
์ผ๋ก ๋ค์ ์ด์ด์ ์งํํ ์ ์์ต๋๋ค.
โ๏ธ ์์ธ ์ต์ ยท์คํ ๋ช ์ธ (๊ฐ๋ฐ์ / AI ์์ด์ ํธ์ฉ)
Triggers#
- When progressing a new project from start to finish
- When full lifecycle orchestration is needed
Usage#
# Full pipeline
/product " Community feature development "
# Specify level (affects skip rules)
/product --level 3 " Community feature development "
# Start from a specific stage
/product --from specify " Community feature development "
/product --from design " Community feature development "
# Up to a specific stage only
/product --to epic " Community feature development "Parameters#
| Parameter | Required | Description | Example |
|---|---|---|---|
description | โ | Project description | "Community feature development" |
Options#
| Option | Default | Description |
|---|---|---|
--level | Auto-determined | BMAD project level (0-4) |
--from | discovery | Starting stage |
--to | launch | Ending stage |
--skip | None | Stages to skip (comma-separated) |
Execution Flow#
Step 1: Project Initialization#
- Generate slug from project description (kebab-case)
- Auto-determine BMAD project level
- Level 0: Simple bug fix โ Skip Discovery/Specification/Launch
- Level 1: Small-scale feature addition โ Skip Discovery/Specification
- Level 2: Medium-scale feature โ Full execution
- Level 3: Large-scale feature/new module โ Full execution
- Level 4: New project โ Full execution (deep)
- Create
.pipeline/{slug}.yamlstate file - Verify/create
docs/directory
Step 2: Discovery (Analysis)#
Skip condition: Level 0-1
โ /product:discover " {description} "- cc-product: User interview, assumption validation, experiment design
- cc-product: Competitive analysis, vision formulation
- cc-product: /product:research, /product:brainstorm
- Artifacts:
docs/discovery-{slug}.md
Step 3: Specification (Spec Verification)#
Skip condition: Level 0-1
โ /product:specify " {description} "- cc-spec-clarity: Socratic interview, Seed spec, ambiguity evaluation
- cc-spec-clarity: Contrarian review + Simplifier simplification (parallel)
- cc-spec-clarity: 3-stage evaluation (mechanical/semantic/consensus)
- Gate: Specification Gate (ambiguity โค 0.2, convergence โฅ 0.95, Contrarian 0, consensus 3/3)
- Artifacts:
docs/seed-spec-{slug}.md,docs/socratic-discovery-{slug}.md,docs/decision-log-{slug}.md,docs/spec-evaluation-{slug}.md
Step 4: Planning#
โ /product:plan- cc-product: /product:product-brief, /product:prd or /product:tech-spec
- cc-product: Business model
- cc-product Analyst: Requirements analysis, BDD Acceptance Criteria
- Gate: BMAD Analysis Gate
- Artifacts: PRD/Tech Spec + BDD Acceptance Criteria
Step 5: Design#
โ /product:design- cc-product: /product:architecture, /product:create-ux-design
- cc-product Architect + UX Designer: Parallel review
- Gate: BMAD Solutioning Gate
- Artifacts: Architecture Doc + UX Spec
Step 5.5: Scaffold#
Skip condition: Level 0-1
โ /product:scaffold- cc-bricks-feature: Mason brick scaffolding per feature (co-bricks)
- cc-flutter-dev: /bdd:generate for each feature + co-test-gen build_runner
- Gate: Scaffold Gate (brick output, .feature files, test gen, step stubs)
- Artifacts: Scaffolded feature directories, .feature files, widget + patrol test stubs
Step 6: Epic Creation#
โ /product:epic- cc-dev-cycle: /zenhub:epic
- cc-product: /product:create-story, /product:sprint-planning
- cc-product PM: Story points, labeling
- Gate: BMAD Planning Gate
- Artifacts: ZenHub Epic + linked Stories
Step 7: Development#
โ /product:develop --epic {epic_number}- Iterate through Stories within Epic, execute cc-dev-cycle 13 steps for each
- cc-product: /product:dev-story
- cc-product Flutter/Backend Dev: Implementation review
- Gate: BMAD Implementation Gate
- Artifacts: Implementation code + PR
Step 8: Launch#
Skip condition: Internal features, minor improvements
โ /product:launch- cc-product: GTM strategy, ICP definition, messaging
- cc-product: A/B testing, cohort analysis
- Artifacts:
docs/gtm-{slug}.md
Step 9: Completion#
- Final state file update
- Full pipeline summary report output
- Artifact list cleanup
Stage Transitions#
After each stage completion:
- Verify artifact existence
- Verify gate passage (if applicable)
- Update state file
- Request user confirmation before entering next stage
Error Handling#
- Gate failure: Display failure reason, guide to retry after fix
- Source plugin not installed: Warn and guide manual progression of that stage
- Interruption: Record last position in state file, resume later with
--fromoption