spin-wheel

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.