Lar

Skill

Produtividade e fluxo de trabalho

orch-build-mvp

affaan-m/ECC

Transforme um documento de projeto ou especificações em um MVP funcional planejando fatias verticais enxutas, criando uma estrutura para a primeira fatia e, em seguida, desenvolvendo de forma iterativa com desenvolvimento orientado a testes e commits condicionados.

...Expandir tudo

Tempo atualizado 3 de Outubro de 2026

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

orch-build-mvp

Ator · ação · alvo: orch · build · mvp. Uma camada fina de abstração sobre o mecanismo compartilhado no orch-pipeline.

Quando usar

O usuário possui um documento de projeto/especificação (SDD, PRD, system_design) e deseja uma fatia vertical funcional inicializada a partir dele.
Recebe um caminho do documento como argumento, por exemplo, civicpulse/docs/SDD-v0.6.md.

Configurações da operação

Tamanho mínimo padrão: grande — trata-se do pipeline completo, incluindo o Scaffold.
Máscara de fase: 0 (ler a especificação) → 1 → 2 (pesado) → 3 (scaffold) → 4 → 5 → 6.
Primeiro passo (fase 0 → 2): ler a documentação; extrair o escopo, as decisões definidas e a lista de recursos; organizá-los em fatias verticais finas (um caminho de ponta a ponta primeiro, não “todos os modelos e depois todas as visualizações”). A fase 3 implementa essa primeira fatia.

Como funciona

Execute o mecanismo orch-pipeline com as configurações acima.
Reutilize o harness GAN existente em vez de criar manualmente um loop de iteração:
- Converta o SDD em gan-harness/spec.md + gan-harness/eval-rubric.md (isso substitui o que o gan-planner geraria — você já tem a especificação).
- Execute a compilação com /gan-build "" --skip-planner (padrões: --max-iterations 15, --pass-threshold 7.0, --eval-mode playwright; use --eval-mode code-only para fatias sem interface de usuário).
- Esse comando executa o ciclo gan-generator → gan-evaluator e grava gan-harness/feedback/feedback-NNN.md até que a pontuação seja aprovada ou se estabilize.
Pare no Gate 1 (plano da fatia) e no Gate 2 (pré-confirmação). Confirme o esqueleto e cada fatia como commits separados no feat.
Adicione um revisor de segurança para qualquer fatia que acione um gatilho de segurança.

Exemplo

orch-build-mvp: civicpulse/docs/SDD-v0.6.md
→ ler SDD → lista de fatias (vertical) → criar estrutura da fatia 1  [PORTA 1: aprovar]
→ /gan-build --skip-planner (generador → loop do avaliador) pontuações vs. especificação → revisão
→ fazer commit do feat:  [PORTA 2: confirmar] → próxima fatia

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