집

Skill

생산성 및 작업흐름

orch-build-mvp

affaan-m/ECC

디자인이나 사양 문서를 바탕으로, 얇은 수직 슬라이스를 계획하고 첫 번째 슬라이스의 골격을 구축한 다음, 테스트 주도 개발과 단계별 커밋을 통해 반복적으로 개발하여 작동하는 MVP를 만들어 냅니다.

...모든 것을 확장하십시오

업데이트 된 시간 2026년 10월 3일

# scaffolding # spec driven development # test driven development # gan harness # gated commits # mvp # vertical slices

orch-build-mvp

Actor · action · target: orch · build · mvp. orch-pipeline 내의 공유 엔진을 감싸는 얇은 래퍼입니다.

사용 시점

사용자가 설계/사양 문서 (SDD, PRD, system_design)를 보유하고 있으며, 이를 바탕으로 작동하는 수직 슬라이스를 생성하고자 할 때 사용합니다.
인수로 문서 경로를 받습니다(예: civicpulse/docs/SDD-v0.6.md).

작동 설정

기본 크기 하한: large — 이는 Scaffold를 포함한 전체 파이프라인입니다.
단계 마스크: 0 (사양 읽기) → 1 → 2 (중량) → 3 (스캐폴드) → 4 → 5 → 6.
첫 번째 단계(단계 0 → 2): 문서를 읽고, 범위, 확정된 결정 사항, 기능 목록을 추출한 후, 이를 얇은 수직 슬라이스로 정렬합니다(모든 모델을 먼저 처리한 다음 모든 뷰를 처리하는 방식이 아니라, 하나의 종단 간 경로를 먼저 처리). 단계 3에서는 그 첫 번째 슬라이스를 구축합니다.

작동 원리

위의 설정으로 orch-pipeline 엔진을 실행합니다.
반복 루프를 직접 작성하는 대신 기존 GAN 하네스를 재사용합니다:
- SDD를 gan-harness/spec.md + gan-harness/eval-rubric.md로 변환합니다 (이는 gan-planner가 생성할 내용을 대신하는 것으로, 사양은 이미 준비되어 있습니다).
- /gan-build "" --skip-planner명령어로 빌드를 실행합니다 . (기본값: --max-iterations 15, --pass-threshold 7.0, --eval-mode playwright; UI가 아닌 슬라이스의 경우 --eval-mode code-only를 사용하십시오).
- 이 명령어는 gan-generator → gan-evaluator 루프를 실행하고, 점수가 통과하거나 정체될 때까지 gan-harness/feedback/feedback-NNN.md 파일을 작성합니다.
게이트 1 (슬라이스 계획)과 게이트 2 (커밋 전)에서 중지합니다. 스캐폴드와 각 슬라이스를 별도의 feat: 커밋으로 커밋합니다.
보안 트리거와 관련된 슬라이스가 있는 경우 security-reviewer를 추가하십시오.

예시

orch-build-mvp: civicpulse/docs/SDD-v0.6.md
→ SDD 읽기 → 슬라이스 목록(수직) → 슬라이스 1 스캐폴드  [게이트 1: 승인]
→ /gan-build --skip-planner (생성기 → 평가기 루프) 점수 대 사양 → 검토
→ feat 커밋:  [게이트 2: 확인] → 다음 슬라이스

GitHub에서 보기

---
name: orch-build-mvp
description: Turn a design or spec document into a working MVP by planning thin vertical slices, scaffolding the first slice, then building iteratively with test-driven development and gated commits.
---

# orch-build-mvp

Actor · action · target: **orch · build · mvp**. Thin wrapper over the shared
engine in [`orch-pipeline`](../orch-pipeline/SKILL.md).

## When to Use

- The user has a **design / spec document** (SDD, PRD, system_design) and wants a
  working vertical slice bootstrapped from it.
- Takes a doc path as its argument, e.g. `civicpulse/docs/SDD-v0.6.md`.

## Operation settings

- **Default size floor:** large — this is the full pipeline including Scaffold.
- **Phase mask:** 0 (read the spec) → 1 → 2 (heavy) → 3 (scaffold) → 4 → 5 → 6.
- **First move (phase 0 → 2):** read the doc; extract scope, locked decisions,
  and the feature list; order it into **thin vertical slices** (one end-to-end
  path first, not all-models-then-all-views). Phase 3 stands up that first slice.

## How It Works

1. Run the `orch-pipeline` engine with the settings above.
2. **Reuse the existing GAN harness** instead of hand-rolling an iterate loop:
   - Translate the SDD into `gan-harness/spec.md` + `gan-harness/eval-rubric.md`
     (this stands in for what `gan-planner` would generate — you already have the spec).
   - Drive the build with `/gan-build "<one-line brief>" --skip-planner`
     (defaults: `--max-iterations 15`, `--pass-threshold 7.0`,
     `--eval-mode playwright`; use `--eval-mode code-only` for non-UI slices).
   - That command runs the `gan-generator` → `gan-evaluator` loop and writes
     `gan-harness/feedback/feedback-NNN.md` until the score passes or plateaus.
3. Stop at **Gate 1** (slice plan) and **Gate 2** (pre-commit). Commit the
   scaffold and each slice as separate `feat:` commits.
4. Add `security-reviewer` for any slice touching a security trigger.

## Example

```
orch-build-mvp: civicpulse/docs/SDD-v0.6.md
→ read SDD → slice list (vertical) → scaffold slice 1  [GATE 1: approve]
→ /gan-build --skip-planner (generator → evaluator loop) scores vs spec → review
→ commit feat:  [GATE 2: confirm] → next slice
```