家

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

アクター・アクション・ターゲット：orch・ビルド・MVP。 orch-pipeline の共有エンジンを覆う薄いラッパー。

使用すべき場面

ユーザーが設計／仕様書（SDD、PRD、system_design）を保有しており、そこから起動可能なバーティカルスライスを生成したい場合。
引数としてドキュメントのパス（例：civicpulse/docs/SDD-v0.6.md）を受け取ります。

操作設定

デフォルトのサイズ下限:large — これは Scaffold を含む完全なパイプラインです。
フェーズマスク：0（仕様書の読み込み）→ 1 → 2（高負荷）→ 3（Scaffold）→ 4 → 5 → 6。
最初の処理（フェーズ 0 → 2）：ドキュメントを読み込み、スコープ、確定した決定事項、および機能リストを抽出します。それらを薄い垂直スライスに整理します（まず 1 つのエンドツーエンドパスを優先し、すべてのモデルを先に処理してからすべてのビューを処理する順序とはしません）。フェーズ 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のスキャフォールド  [GATE 1: 承認]
→ /gan-build --skip-planner（ジェネレータ → 評価器のループ）によるスコアと仕様の比較 → レビュー
→ feat: をコミット  [GATE 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
```