Pipeline Guide — Full Workflow Guide

한마디로 (비개발자용)#

cc-product은 제품 하나를 처음 아이디어부터 출시까지 데려가는 "조립 라인 관리자"예요. 공장에서 원재료가 여러 작업대를 순서대로 거쳐 완성품이 되듯, 이 도구는 프로젝트를 7개의 단계(발견 → 명세 → 기획 → 설계 → 작업 묶음 만들기 → 개발 → 출시)를 차례로 통과시킵니다. 각 단계 사이에는 "품질 검문소(Gate)"가 있어서, 기준을 통과해야 다음 단계로 넘어갈 수 있어요. 이미 만들어 둔 여러 전문 도구들을 위에서 지휘하기만 할 뿐, 그 도구들을 직접 고치지는 않습니다.

핵심 용어 사전 (비개발자용)#

Overview#

cc-product is an orchestration plugin that manages the Cocode team's project lifecycle through a 7-stage pipeline. It coordinates existing plugins (cc-product, cc-spec-clarity, cc-product, cc-dev-cycle) from above without modifying them.

Pipeline Flow#

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  Discovery  │───▶│Specification│───▶│  Planning   │───▶│   Design    │
│  (Analysis) │    │(Spec Verify)│    │ (Planning)  │    │  (Design)   │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
                          │                  │                   │
                   Specification       Analysis Gate      Solutioning Gate
                       Gate                  │                   │
                          │           ┌─────────────┐    ┌─────────────┐
                          │           │   Launch    │◀───│ Development │
                          │           │  (Launch)   │    │(Development)│
                          │           └─────────────┘    └─────────────┘
                          │                                      │
┌─────────────┐           │                               Implementation
│Epic Creation│───────────┘                                   Gate
│ (Creation)  │
└─────────────┘
       │
  Planning Gate

Getting Started#

New Project#

/product  " project description "

This command:

1. Generates project slug
2. Automatically determines BMAD level
3. Sequentially executes 7 stages (skippable stages auto-determined)

Individual Stage Entry#

Each stage can be executed independently:

/product:discover  " feature description " 
 /product:specify  " feature description " 
 /product:plan
/product:design
/product:epic
/product:develop --epic 42
/product:launch

Previous stage artifacts are automatically referenced if available.

Stage Details#

Stage 1: Discovery (Analysis)#

Performs user research, competitive analysis, and ideation.

• Source: cc-product, cc-product, cc-product
• Artifacts: docs/discovery-{slug}.md
• Skip: Level 0-1

Stage 2: Specification (Spec Verification)#

Exposes hidden assumptions through Socratic interviews, then creates Seed specs and ambiguity evaluation to secure implementation-quality specifications.

• Source: cc-spec-clarity (/spec:interview, /spec:seed, /spec:ambiguity, /spec:evaluate)
• Agents: contrarian (contrarian review), simplifier (complexity reduction) — parallel execution
• Gate: Specification Gate
• Artifacts: docs/seed-spec-{slug}.md, docs/socratic-discovery-{slug}.md, docs/decision-log-{slug}.md, docs/spec-evaluation-{slug}.md
• Skip: Level 0-1

Stage 3: Planning#

Writes product briefs, PRD/technical specifications, and defines BDD Acceptance Criteria.

• Source: cc-product, cc-product
• Gate: Analysis Gate
• Artifacts: docs/prd-{slug}.md, docs/tech-spec-{slug}.md, docs/bdd-{slug}.md

Stage 4: Design#

Designs architecture and UX, then performs parallel review.

• Source: cc-product (Architect + UX Designer personas)
• Gate: Solutioning Gate
• Artifacts: docs/architecture-{slug}.md, docs/ux-spec-{slug}.md
• Skip: Level 0

Stage 5: Epic Creation#

Creates ZenHub Epics and Stories based on design artifacts.

• Source: cc-dev-cycle, cc-product
• Gate: Planning Gate
• Artifacts: ZenHub Epic + linked Stories
• Skip: Level 0

Stage 6: Development#

Iterates through Stories within an Epic, executing the 13-step development cycle for each.

• Source: cc-dev-cycle, cc-product
• Gate: Implementation Gate (per Story)
• Artifacts: Implementation code + PR
• Parallel mode: --parallel option for parallel development of independent Stories via Agent Teams

Stage 7: Launch#

Establishes GTM strategy, messaging, and analytics plan.

• Source: cc-product, cc-product
• Artifacts: docs/gtm-{slug}.md, docs/analytics-plan-{slug}.md
• Skip: Level 0-1

BMAD Level Guide#

Level 0: Hotfix (Simple Bug Fix)#

Planning → Development

Skips Discovery, Specification, Design, Epic Creation, and Launch.

Level 1: Minor Feature (Small-scale Feature Addition)#

Planning → Design → Epic Creation → Development

Skips Discovery, Specification, and Launch.

Level 2-3: Feature / Major Feature#

Discovery → Specification → Planning → Design → Epic Creation → Development → Launch

Executes the full pipeline.

Level 4: New Project#

Discovery (deep) → Specification → Planning → Design → Epic Creation → Development → Launch

Executes Discovery in deep mode.

Gates#

Each gate is a quality checkpoint.

Specification Gate (Specification → Planning)#

• Ambiguity score ≤ 0.2
• Convergence ≥ 0.95
• Contrarian unresolved Critical: 0
• Consensus: 3/3 unanimous

Analysis Gate (Planning → Design)#

• Requirement clarity
• Scope appropriateness
• Acceptance Criteria testability

Solutioning Gate (Design → Epic Creation)#

• Architect: Clean Architecture, DI, API, security
• UX Designer: CoUI, layout, interaction, accessibility

Planning Gate (Epic Creation → Development)#

• Epic/Story structure
• Story points
• Labeling
• Dependencies

Implementation Gate (Development, per Story)#

• Lint passed
• Tests passed
• Code review passed
• Branch naming convention

State Management#

Pipeline state is stored in .pipeline/{slug}.yaml.

# Check status
/product:status

# Specific project
/product:status community

# All projects
/product:status --all

Artifact Management#

All artifacts are stored in the project's docs/ directory:

Suspend and Resume#

The pipeline can be suspended and resumed at any time:

# Check status after suspension
/product:status community

# Resume from Design stage
/product --from design  " community feature "

The state file records the last position, so previous artifacts are automatically referenced.

Dependent Plugins#