Maison

Skill

Productivité et flux de travail

orch-build-mvp

affaan-m/ECC

Transformez un document de conception ou de spécifications en un MVP fonctionnel en planifiant des tranches verticales étroites, en mettant en place l'infrastructure de la première tranche, puis en développant de manière itérative grâce au développement piloté par les tests et à des commits conditionnels.

...Développer tout

Heure mise à jour 3 octobre 2026

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

orch-build-mvp

Acteur · action · cible : orch · build · mvp. Fine couche d'encapsulation au-dessus du moteur partagé dans orch-pipeline.

Quand l’utiliser

L’utilisateur dispose d’un document de conception / de spécifications (SDD, PRD, system_design) et souhaite obtenir une tranche verticale fonctionnelle générée à partir de celui-ci.
Prend un chemin d’accès au document comme argument, par exemple civicpulse/docs/SDD-v0.6.md.

Paramètres de l'opération

Taille minimale par défaut : large — il s’agit du pipeline complet, y compris Scaffold.
Masque de phase : 0 (lecture des spécifications) → 1 → 2 (lourd) → 3 (Scaffold) → 4 → 5 → 6.
Première étape (phase 0 → 2) : lire la documentation ; extraire le périmètre, les décisions figées et la liste des fonctionnalités ; les organiser en fines tranches verticales (un chemin de bout en bout d’abord, et non pas « tous les modèles puis toutes les vues »). La phase 3 met en place cette première tranche.

Fonctionnement

Exécutez le moteur orch-pipeline avec les paramètres ci-dessus.
Réutilisez le harnais GAN existant au lieu de créer manuellement une boucle itérative :
- Traduisez le SDD en gan-harness/spec.md + gan-harness/eval-rubric.md (cela remplace ce que gan-planner générerait — vous disposez déjà de la spécification).
- Lancez la compilation avec /gan-build "" --skip-planner (valeurs par défaut : --max-iterations 15, --pass-threshold 7.0, --eval-mode playwright; utilisez --eval-mode code-only pour les tranches sans interface utilisateur).
- Cette commande exécute la boucle gan-generator → gan-evaluator et écrit le fichier gan-harness/feedback/feedback-NNN.md jusqu’à ce que le score soit satisfaisant ou atteigne un plateau.
Arrêtez-vous à la porte 1 (plan de tranche) et à la porte 2 (pré-validation). Validez le squelette et chaque tranche sous forme de commits feat: distincts.
Ajoutez un « security-reviewer » pour toute tranche touchant un déclencheur de sécurité.

Exemple

orch-build-mvp: civicpulse/docs/SDD-v0.6.md
→ lire le SDD → liste des tranches (verticale) → échafaudage de la tranche 1  [ÉTAPE 1 : approuver]
→ /gan-build --skip-planner (boucle générateur → évaluateur) scores par rapport aux spécifications → révision
→ valider le feat :  [ÉTAPE 2 : confirmer] → tranche suivante

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