orch-build-mvp
Makes your agent turn a design document into a working product. It plans and builds essential software parts quickly.
What it does
This tool turns a design or specification document into a working prototype (MVP). It plans the project parts into small, functional steps, builds the first step, and then uses an automated system to build and test until it works.
When to use it
- ✓You have a document with the design or specifications for software.
- ✓You want to quickly create a first working version (MVP) from that document.
- ✓You prefer the work to be broken down into small, end-to-end functional pieces.
Example of what to ask your AI
“Turn this design document into a working MVP, focusing on small functional slices: [path to your document]”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool reads your document to understand what needs to be done and divides the work into small functional pieces. It then uses an automated process to build and test each piece, ensuring it works before moving to the next.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add affaan-m/ECC --skill orch-build-mvpOr download just the file:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/orch-build-mvp/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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
- 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
FAQ
What is an MVP?
MVP stands for 'Minimum Viable Product'. It's the simplest version of a product that already delivers value and can be used by early customers.
What are 'vertical slices'?
These are small parts of the project that work end-to-end, meaning they include everything from user input to the final output, even if in a simplified way.
What does 'bootstrapping' mean?
It means starting a project from scratch, creating the foundation and the first functional parts so it can begin to exist and be developed.
Details
Original description by the author
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.
repo: affaan-m/ECC
Popularity
- GitHub stars
- 280k
- Ranking position
- #248
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
accessibility
Helps your agent create interfaces that everyone can use. Ensures websites and apps work well for people with disabilities, like those who are blind or have reduced mobility.
affaan-m/ECC
agent-architecture-audit
Makes your agent check if everything is working correctly. It finds and fixes problems in AI systems, ensuring they perform as expected.
affaan-m/ECC
agent-eval
Helps your agent compare different AI coding tools. It measures which one is faster, cheaper, and more reliable for specific tasks.
affaan-m/ECC
agent-harness-construction
Makes your agent better understand how to perform tasks. It optimizes the tools and instructions the agent uses to increase its chances of success.
affaan-m/ECC
Similar skills
git-workflow-and-versioning
Organizes code work using Git. Helps save progress, manage different versions, and avoid conflicts when working in a team.
addyosmani/agent-skills
observability-and-instrumentation
Adds tools to monitor what the code does in production. Helps understand if something went wrong and why, making fixes easier.
addyosmani/agent-skills
github-pr-workflow
Prepares GitHub pull requests, ensuring code quality and documentation.
paperclipai/paperclip