product:develop

Stage 6: Development — Iterate through Stories in an Epic, executing the 13-step development cycle

항목	내용
Invoke	/product:develop
Category	pipeline
Complexity	high
MCP Servers	zenhub

/product:develop — 실제로 "만드는" 단계#

파이프라인 6단계(Development). Epic 안에 나눠 둔 작업(Story)을 하나씩 꺼내, 코드 작성부터 리뷰·병합까지 정해진 절차로 실제 구현합니다.

한마디로#

설계도와 작업 목록이 다 준비된 뒤, 현장 인부들이 실제로 벽돌을 쌓아 집을 짓는 단계입니다. 작업 목록(Story)을 하나씩 가져와, 코드를 짜고 검사하고 합치는 13단계 절차를 반복합니다.

누가·언제 쓰나요#

Epic(작업 묶음)과 그 안의 Story(개별 작업)가 이미 만들어져, 이제 실제 구현만 남았을 때
특정 Epic 전체나 개별 이슈 하나를 직접 개발하고 싶을 때

👉 건너뛰는 경우는 거의 없습니다: 이 단계가 곧 실제 코드를 만드는 핵심 작업이기 때문입니다. 다만 시작하려면 앞 단계(Epic Creation)가 끝나 ZenHub에 Epic과 Story가 등록돼 있어야 합니다.

무엇을 해주나요#

실제 동작하는 코드 — Story마다 브랜치를 따서 작업하고, PR(코드 리뷰 요청)을 거쳐 병합(merge)까지 마칩니다.
완료된 Story 목록 — .pipeline/{slug}.yaml 파일에 어떤 Story가 끝났는지 기록됩니다.

어떻게 쓰나요#

# Epic 전체를 한 번에 개발
/product:develop --epic 42

# 이슈 하나만 개발
/product:develop --issue 1810

# 파이프라인 맥락에서 자동 진행 (Epic 번호 자동 인식)
/product:develop

# 서로 독립적인 Story들을 동시에 개발 (Agent Teams 필요)
/product:develop --epic 42 --parallel

--epic(Epic 번호) 또는 --issue(이슈 번호) 중 하나는 반드시 지정해야 합니다. 급할 때는 --skip-review(리뷰 건너뛰기)나 --skip-tests(테스트 건너뛰기)를 붙일 수 있고, --parallel은 독립적인 작업을 여러 팀이 나눠 동시에 처리합니다(Agent Teams 환경 필요).

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

Epic 안의 Story들을 하나씩, 또는 동시에 처리하면서 정해진 개발 절차를 반복합니다.

할 일 목록 정리 — ZenHub에서 Epic 안의 Story 목록을 가져와 의존 순서대로 정렬하고, 이미 끝난 것은 건너뜁니다.
한 건씩 구현 — 각 Story마다 ① 상세 분석·구현 계획 → ② 코드 작성부터 검사·병합까지의 13단계 개발 사이클 실행 → ③ 구현 품질·설계 준수 검토를 차례로 진행합니다.
동시 진행(선택) — --parallel을 쓰면 서로 겹치지 않는 파일을 다루는 Story들을 그룹으로 묶어, 사용자 승인을 받은 뒤 여러 팀이 동시에 개발합니다. 서로 의존하는 작업은 줄을 세워 순서대로 처리합니다.
품질 통과 확인 — Story마다 린트·테스트·코드 리뷰·브랜치 규칙(Implementation Gate)을 통과했는지 점검하고, 진행 상황을 파일에 기록합니다.

끝나면 모든 Story가 병합되고 품질 검사를 통과한 뒤, 다음 단계인 출시(/product:launch) 로 넘어갑니다. 작업이 길어 대화가 늘어났다면 대화를 비우고(/clear) 새로 시작하는 것을 권장합니다 — 결과는 파일에 남아 있어 사라지지 않습니다.

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

Triggers#

When starting development after Epic Creation completion
When implementation of a specific Epic or Issue is needed

Usage#

# Full Epic development
/product:develop --epic 42

# Single issue development
/product:develop --issue 1810

# Auto from pipeline context
/product:develop

# Parallel development of independent Stories (Agent Teams)
/product:develop --epic 42 --parallel

Parameters#

Parameter	Required	Description	Example
`--epic`	✅*	Epic number	`42`
`--issue`	✅*	Single issue number	`1810`

*Either epic or issue is required. In pipeline context, epic number is automatically referenced.

Options#

Option	Default	Description
`--parallel`	`false`	Parallel execution of independent Stories (requires Agent Teams)
`--skip-review`	`false`	Skip code review (urgent)
`--skip-tests`	`false`	Skip tests (urgent)

Prerequisites#

Epic Creation stage completed (Planning Gate passed)
ZenHub Epic and Stories exist
For --parallel: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 environment variable required

Execution Flow#

Epic Mode (--epic)#

0. Agent Teams Prerequisite Check (for `--parallel`)

if --parallel:
  Check helpers.md#Check-Agent-Teams-Available
  if teams_available = false:
    ⚠ Agent Teams not available. Falling back to sequential mode.
    → Auto-switch to sequential processing

1. Story List Retrieval

Fetch Story list within Epic from ZenHub
Sort by dependency order
Check status (skip already completed Stories)

2-A. Sequential Execution (default)

For each Story:

a. Story implementation preparation (cc-product: /product:dev-story)

Story detailed analysis
Implementation plan creation
Required files/components identification

b. 13-step development cycle (cc-dev-cycle: /dev:run {issue_number})

Steps 1-12 sequential execution

c. Implementation review (cc-product: Flutter/Backend Dev persona)

Implementation quality verification
Architecture compliance check

2-B. Parallel Execution (`--parallel`, when Agent Teams active)

Phase 1: Dependency Analysis + File Ownership Boundary Analysis

1. Build Story dependency graph
   - Check each Story ' s dependencies field
   - Identify blocking relationships

2. File ownership boundary analysis
   - Map Story → source directory from architecture docs
   - Detect overlapping file areas
   - If overlap found → move those Stories to sequential queue

3. Identify independent Story groups (max 3 teams)
   ┌─ Group A: [STORY-001, STORY-003] — independent file areas
   ├─ Group B: [STORY-002]            — independent file areas
   └─ Sequential Queue: [STORY-004]   — depends on STORY-001

Phase 2: User Approval (plan confirmation)

╔════════════════════════════════════════════════════════════════╗
║  Parallel Development Plan                                     ║
╠════════════════════════════════════════════════════════════════╣
║                                                                ║
║  Parallel Teams (Agent Teams):                                 ║
║    Team 1: STORY-001, STORY-003                                ║
║      └─ Files: lib/src/feature/author/                         ║
║    Team 2: STORY-002                                           ║
║      └─ Files: lib/src/feature/book/                           ║
║                                                                ║
║  Sequential Queue (dependencies):                              ║
║    STORY-004 (depends on STORY-001)                            ║
║                                                                ║
║  Estimated teammates: 2                                        ║
║                                                                ║
╚════════════════════════════════════════════════════════════════╝

Proceed with this plan? (y/n)

Phase 3: Delegate to /product:team-dev

Independent Story groups → delegate to /product:team-dev
  - helpers.md#Spawn-BMAD-Teammate (developer role)
  - helpers.md#Create-Team-Task-List
  - Pass file ownership boundaries to each teammate
  - Separate branches per teammate

After completion, Lead performs integration verification:
  - helpers.md#Collect-Team-Results
  - helpers.md#Team-Quality-Gate

Phase 4: Sequential Queue Processing

Stories with dependencies execute sequentially after parallel work completes:
  for story in sequential_queue:
    /dev:run {story.issue_number}

3. Progress Tracking

Update .pipeline/{slug}.yaml on each Story completion
Record failed Stories

Single Issue Mode (--issue)#

Directly execute cc-dev-cycle 13 steps
Update pipeline state

Implementation Gate#

BMAD Implementation Gate verification (per Story):

Lint passed (dart analyze, dcm analyze)
Tests passed
Code review passed
Branch naming convention followed

Artifacts#

Implementation code (per Story: branch → PR → merge)
Completed Story list in .pipeline/{slug}.yaml

After Completion#

Verify all Stories completed
Verify Implementation Gate passed
Update .pipeline/{slug}.yaml state
Present context-clear handoff:

✅ Development stage complete (all Implementation Gates PASSED).
  {completed_count}/{total_count} Stories merged.

**Option 1 (Recommended)**: Clear context and continue to Launch
  /clear
  Then run: /product:launch

**Option 2**: Continue in current context
  Proceed directly to /product:launch