SkillRepo
Sign InSign Up
Catalog
affaan-m/orch-build-mvp

affaan-m

orch-build-mvp

Orchestrate bootstrapping a working MVP from a design or spec document — ingest the SDD/PRD, plan thin vertical slices, scaffold the first end-to-end slice, then drive a generator-evaluator build loop with review and gated feat commits. Use when a design or spec document must become a running MVP through planned vertical slices.

NewUpdated Sep 27, 2026

orch-build-mvp

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

  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
Files1
1 files · 1.0 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

Grades are signals, not a certification. Always review a skill yourself before use.

Safety

78

Quality

68

Clarity

75

Completeness

65

Summary

Orchestrates building an MVP from a design or specification document by breaking it into thin vertical slices, scaffolding the first slice, and then driving an iterative build loop with generated code evaluated against the spec. The skill wraps the shared orch-pipeline engine and reuses the gan-harness generator-evaluator loop, with gated review points before commits.

Detected Capabilities

file read (spec/SDD documents)git commits (feat: branches)command execution (gan-build, orch-pipeline)code generation (via gan-generator)automated evaluation (via gan-evaluator)code review triggering (security-reviewer integration)

Trigger Keywords

Phrases that agents use to match this skill to user intent.

mvp from specbuild vertical slicedesign to codespec-driven developmentscaffold from sdd

Risk Signals

WARNING

Implicit dependency on external skills (orch-pipeline, gan-harness, gan-generator, gan-evaluator, security-reviewer) without bundled implementations or fallback documentation

SKILL.md: entire content
INFO

Phase mask and operation settings reference undocumented magical values (0→1→2→3→4→5→6) with unclear semantics

SKILL.md: Operation settings section
INFO

No explicit error handling or rollback strategy if gan-build loop fails to reach pass-threshold

SKILL.md: How It Works, step 2
INFO

Conditional security review ('any slice touching a security trigger') is vague — no definition of what constitutes a 'trigger'

SKILL.md: How It Works, step 4

Use Cases

  • Convert design document to working MVP through staged vertical slices
  • Bootstrap a first end-to-end feature from a PRD or SDD
  • Plan and execute vertical slice development with spec-driven validation
  • Drive iterative code generation with evaluation feedback loops
  • Stage MVP development with gated architectural reviews

Quality Notes

  • Strengths: clear use case, concise structure, explicit gating points (Gate 1, Gate 2) for human review, practical example workflow
  • Strengths: well-defined when-to-use guidance helps users understand scope
  • Strengths: emphasizes vertical slicing discipline (one end-to-end path first, not all-models-then-all-views), a valuable architectural pattern
  • Weakness: heavily depends on external skill implementations without explaining fallback or standalone behavior
  • Weakness: phase mask (0→1→2→3→4→5→6) is a magic number reference that requires readers to consult orch-pipeline spec — should be self-contained or explained
  • Weakness: no discussion of iteration limits, cost bounds, or convergence guarantees (what if gan-build never reaches threshold?)
  • Weakness: assumes gan-harness exists and can be written to; no guidance on handling missing or incompatible harness
  • Weakness: security-reviewer trigger condition is undefined; unclear when to activate it
Model: claude-haiku-4-5-20251001Analyzed: Sep 27, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Version History

  1. v3.0

    Contract changed: description

    ✦ AIReplaces TDD-implement with generator-evaluator build loop for first MVP slice. Emphasizes SDD/PRD intake and gated feature commits.

    triggering2026-09-27

    LATEST
  2. v2.0

    Contract changed: description

    ✦ AISkill description expanded to clarify activation trigger: design or spec document requiring planned vertical-slice implementation.

    triggering2026-09-09

    View This Version
  3. v1.1

    Content updated

    ✦ AINo observable behavioral changes between versions.

    2026-07-14

    View This Version
  4. v1.0

    2026-06-07

    View This VersionInitial version

Use affaan-m/orch-build-mvp in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...