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 doc, plan thin vertical slices, scaffold the first end-to-end slice, then TDD-implement, review, and gated commit. Use to turn an SDD/PRD into a running starting point. Use when a design or spec document must become a running MVP through planned vertical slices.

NewUpdated Sep 9, 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

76

Completeness

62

Summary

Orchestrates bootstrapping an MVP from a design or specification document by ingesting the doc, planning thin vertical slices, scaffolding the first end-to-end slice, then TDD-implementing it using a generative build harness. It wraps the shared `orch-pipeline` engine with gated stages and integrates with the GAN (Generative AI Native) build system to iteratively generate and evaluate code against the specification.

Detected Capabilities

file read (spec documents)project scaffolding and code generationintegration with external orchestration engine (orch-pipeline)integration with generative build system (gan-build, gan-generator, gan-evaluator)markdown generation (spec.md, eval-rubric.md, feedback reports)gated workflow management (approval gates)security reviewer integration

Trigger Keywords

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

bootstrap mvp from specvertical slice scaffoldingsdd to implementationtdd-driven generationprd architecture validation

Use Cases

  • Convert a system design document (SDD/PRD) into a working MVP scaffold with minimal manual setup
  • Plan and implement the first vertical slice of a feature end-to-end using test-driven development
  • Automatically generate and evaluate code against specification criteria using the GAN build harness
  • Structure large projects into thin, reviewable vertical slices with gated approval stages
  • Bootstrap a new project from a specification with integrated security review triggers for sensitive components

Quality Notes

  • Skill is well-scoped: focuses on a single orchestration pattern (SDD → MVP) with clear entry point (design doc path)
  • Prerequisite dependencies are documented but somewhat implicit — assumes familiarity with orch-pipeline and gan-build; would benefit from more detailed setup instructions
  • Error handling guidance is minimal — does not explain what to do if the spec is malformed, the slice plan is rejected at Gate 1, or generation fails repeatedly
  • Edge cases not covered: e.g., very large specs, non-standard SDD formats, projects where first slice cannot be TDD-driven
  • Integration points are clear (orch-pipeline, gan-harness, gan-build) but the skill delegates heavily to external engines; the skill itself is relatively thin
  • Gating strategy is documented (Gate 1, Gate 2) but approval criteria and rollback procedures are not defined
  • Strength: concise, focused scope with a practical workflow example that shows the expected input/output flow
  • Skill correctly delegates heavy lifting to the GAN engine, keeping the orchestration layer lightweight and composable
Model: claude-haiku-4-5-20251001Analyzed: Sep 9, 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. v2.0

    Contract changed: description

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

    triggering2026-09-09

    LATEST
  2. v1.1

    Content updated

    ✦ AINo observable behavioral changes between versions.

    2026-07-14

    View This Version
  3. 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...