Heim

Skill

Produktivität und Workflow

orch-build-mvp

affaan-m/ECC

Verwandeln Sie ein Design- oder Spezifikationsdokument in ein funktionsfähiges MVP, indem Sie schmale vertikale Abschnitte planen, den ersten Abschnitt als Gerüst aufbauen und dann iterativ mit testgetriebener Entwicklung und gated Commits weiterentwickeln.

...Alle erweitern

Zeit aktualisiert 3. Oktober 2026

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

orch-build-mvp

Aktor · Aktion · Ziel: orch · Build · MVP. Dünne Hülle über der gemeinsamen Engine in orch-pipeline.

Anwendungsfälle

Der Benutzer verfügt über ein Design- oder Spezifikationsdokument (SDD, PRD, system_design) und möchte einen daraus erstellten funktionsfähigen „Vertical Slice“.
Nimmt einen Dokumentpfad als Argument entgegen, z. B. civicpulse/docs/SDD-v0.6.md.

Betriebseinstellungen

Standard-Mindestgröße: „large“ – dies ist die vollständige Pipeline einschließlich Scaffold.
Phasenmaske: 0 (Spezifikation lesen) → 1 → 2 (aufwendig) → 3 (Scaffold) → 4 → 5 → 6.
Erster Schritt (Phase 0 → 2): Dokument lesen; Umfang, feststehende Entscheidungen und die Feature-Liste extrahieren; in schmale vertikale Slices ordnen (zuerst einen End-to-End-Pfad, nicht erst alle Modelle und dann alle Ansichten). Phase 3 richtet dieses erste Slice ein.

So funktioniert es

Führen Sie die Orch-Pipeline-Engine mit den oben genannten Einstellungen aus.
Verwenden Sie den vorhandenen GAN-Harness wieder, anstatt eine Iterationsschleife von Hand zu erstellen:
- Übersetzen Sie die SDD in „gan-harness/spec.md“ + „gan-harness/eval-rubric.md“ (dies ersetzt das, was „gan-planner“ generieren würde – Sie haben die Spezifikation bereits).
- Starten Sie den Build mit /gan-build „ “ --skip-planner (Standardwerte: --max-iterations 15, --pass-threshold 7.0, --eval-mode playwright; verwende --eval-mode code-only für Nicht-UI-Slices).
- Dieser Befehl führt die Schleife „gan-generator → gan-evaluator“ aus und schreibt gan-harness/feedback/feedback-NNN.md, bis die Punktzahl den Schwellenwert überschreitet oder sich ein Plateau einstellt.
Halten Sie bei Gate 1 (Slice-Plan) und Gate 2 (Pre-Commit) an. Committen Sie das Scaffold und jeden Slice als separate „feat: commits“.
Füge einen „security-reviewer“ für jeden Slice hinzu, der einen Sicherheitstrigger auslöst.

Beispiel

orch-build-mvp: civicpulse/docs/SDD-v0.6.md
→ SDD lesen → Slice-Liste (vertikal) → Scaffold für Slice 1 erstellen  [GATE 1: genehmigen]
→ /gan-build --skip-planner (Generator → Evaluator-Schleife) Ergebnisse vs. Spezifikation → Überprüfung
→ „feat“ committen:  [GATE 2: bestätigen] → nächster Slice

Auf GitHub ansehen

---
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
```