orch-build-mvp
SkillDocs & knowledgeorch-build-mvp is a skill that turns a design or spec document into a working MVP. It reads an SDD or PRD, orders the work into thin vertical slices, scaffolds the first end-to-end slice, and then runs a generator-evaluator build loop until the code passes review. Changes pause at approval gates before being committed.
Available today. Use it from your connected AI after setup.
No other account needed.
Have a design or spec document (SDD, PRD, or system_design) ready and note its path.
Then ask your AI: use the orch-build-mvp skill
What your AI can do with it
- Reads an SDD or PRD and extracts scope, locked decisions, and the feature list
- Orders work into thin vertical slices, starting with one end-to-end path
- Scaffolds the first vertical slice as a running MVP
- Translates the spec into gan-harness/spec.md and gan-harness/eval-rubric.md
- Drives the gan-generator to gan-evaluator loop via /gan-build --skip-planner
- Stops at Gate 1 (slice plan) and Gate 2 (pre-commit) for approval
Getting started
- Have a design or spec document (SDD, PRD, or system_design) ready and note its path.
- Add the orch-build-mvp skill so the agent can use it.
- Invoke the skill with the document path as its argument, e.g. orch-build-mvp: civicpulse/docs/SDD-v0.6.md.
- Review the slice plan at Gate 1 and approve it to continue.
- Review the build results and confirm each feat: commit at Gate 2 before the next slice.
What this skill tells your AI
The instructions your AI receives, as published by affaan-m/ecc in skills/orch-build-mvp/SKILL.md and read by ahel’s review.
Actor · action · target: orch · build · mvp. Thin wrapper over the shared
engine in orch-pipeline.
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
- Run the
orch-pipelineengine with the settings above. - 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 whatgan-plannerwould 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-onlyfor non-UI slices). - That command runs the
gan-generator→gan-evaluatorloop and writesgan-harness/feedback/feedback-NNN.mduntil the score passes or plateaus.
- Translate the SDD into
- Stop at Gate 1 (slice plan) and Gate 2 (pre-commit). Commit the
scaffold and each slice as separate
feat:commits. - Add
security-reviewerfor 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
Signals
- GitHub stars
- 268k
- Forks
- 40k
- Last commit
- Sep 2026
Questions
- What input does it need?
- A design or spec document path, such as an SDD, PRD, or system_design file, passed as the argument when invoking the skill.
- What are the default build loop settings?
- The /gan-build loop defaults to --max-iterations 15, --pass-threshold 7.0, and --eval-mode playwright. Use --eval-mode code-only for non-UI slices.
- When should I use it?
- When a design or spec document must become a running MVP through planned vertical slices.
- Does it commit code automatically?
- No. The scaffold and each slice are committed as separate feat: commits only after you confirm at Gate 2.
Advanced
- Item type
- skill
- Key
orch-build-mvp- Source
- github.com/affaan-m/ecc