Prototype

Build throwaway exploratory code designed to answer a single load-bearing architectural, state machine, or UI question rapidly without production overhead.

Core Invariants

1. Throwaway By Construction: Prototypes must be explicitly marked throwaway with zero production persistence or abstraction overhead.
2. Branch Isolation: Separate logic/state-machine prototypes (LOGIC.md) from visual UI variant explorations (UI.md).
3. Single-Command Launch: UI prototypes run with one command (pnpm dev, bun run ...); logic prototypes are single double-clickable HTML/JS files.
4. Transparent State Exposure: Every action or transition must visually expose the complete underlying state payload.
5. Decisions-Only Mainline Merge: Merge only the validated decision/type into main; commit the prototype code to a separate scratch branch.

Architecture & Map of Content (MOC)