spin-wheel

Generate runnable prototypes from a SPEC.md while teaching architectural trade-offs.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/KaivinC/openwheel --skill spin-wheel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spin-wheel
Source: https://github.com/KaivinC/openwheel/tree/main/spin-wheel
Command: npx skills add https://github.com/KaivinC/openwheel --skill spin-wheel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building a working prototype often forces developers to make many architectural choices without understanding trade-offs, leaving beginners with code they can't explain or iterate on. Spin-wheel solves this by generating the project while pausing at each fork to teach the consequences of each choice, so the user ends with a running app and a clear mental model of why it was built that way.

Core Features & Use Cases

  • Guided decision-making: Walks the user through one architectural decision at a time (language/framework, database, auth, hosting, real-time), explaining trade-offs in plain language and recommending a default.
  • Spec-driven prototype generation: Reads a wheel SPEC.md (local or from GitHub), summarizes requirements, and scaffolds a complete, runnable prototype with no placeholders.
  • Use case: Quickly produce a personal Notion-style notes app for single-user local use, learning why SQLite or Next.js was chosen at each step.

Quick Start

Invoke /spin-wheel notion-clone to generate a running prototype while the AI explains and pauses for each trade-off decision.

Frequently Asked Questions about spin-wheel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a runnable MVP prototype while understanding the architectural trade-offs?

Spec-driven prototype generation reads a SPEC.md file, summarizes requirements, and walks you through interactive architectural decisions one at a time. It scaffolds a complete, runnable MVP codebase while teaching the engineering trade-offs behind each choice.

What is spec-driven code generation and how does it help single developers?

Spec-driven code generation reads a specification file and scaffolds a complete project automatically. For single-developer MVPs, it prevents architectural choices without context by pausing at each decision fork to explain trade-offs, leaving you with code you can confidently explain and iterate on.

Can I use a prototype generator for small team experiments and personal projects?

Yes, this prototype generator is designed for single-developer MVPs and small team experiments. It reads your spec, guides you through framework and database decisions interactively, and outputs a fully runnable codebase suitable for personal projects like a local Notion-style notes app.

Do I need a SPEC.md file to scaffold a prototype?

Yes, a SPEC.md file is required to scaffold a prototype. The tool reads this specification file, either locally or from GitHub, summarizes your requirements, and uses it to walk through interactive decisions before generating the complete project files and running bash operations.

What architectural decisions are covered when scaffolding an MVP?

When scaffolding an MVP, the guided decision-making covers language and framework selection, database, authentication, hosting, and real-time features. It explains the trade-offs for each in plain language and recommends a default choice before proceeding with code generation.

Why does prototype generation pause for interactive decision prompts?

Interactive decision prompts pause prototype generation to teach the engineering trade-offs shaping your project. This prevents beginners from ending up with code they cannot explain, ensuring they understand the consequences of architectural choices like choosing SQLite or Next.js at each step.