Prototyping
A prototype answers one question and dies: the code is disposable; the answer is what you keep.
When to use
- A specific question is uncertain and faster to build than to argue: does this algorithm work, can this UI be built, render, or perform as designed, does this library do what its docs claim.
- Skip when you already know the answer, or the question is vague.
- Skip a layout or variant choice:
ui-ux-designowns it.
Step 1: Pre-register
- Write one question, the falsifiable pass/fail observation, the time-box and size-box, and what decision each result changes. If any of these is vague, do not build.
- Name the workspace and artifacts this probe owns, its environment, the data class it touches. Prefer isolated synthetic data.
- Before building, settle how the probe will be disposed of: what it may access and affect, what evidence is kept, the exact cleanup targets and whether each can be recovered, who cleans up, and the current authority for creating and removing them.
- Production-like data, real services, live traffic, running systems, and destructive cleanup each need explicit authorization, with protections proportional to the risk.
Step 2: Build and observe
- Build the smallest disposable probe: driver, fixtures, instrumentation only. No reusable abstraction, production integration, or generality. Install dependencies in the probe's workspace at the project's locked versions, never into its manifest, lockfile, or installed packages.
- For a logic question, build a tiny driver or an executable assertion on the uncertain behavior. For a UI feasibility question, build only the smallest populated surface the registered question needs.
- Stop at the declared boundary. Record raw observations, environment,
limitations, and
passed / failed / inconclusiveagainst the predeclared criterion. Never move the threshold after seeing the result.
Step 3: Retain the result, dispose of the code
- Store the question, the evidence, the limitations, and which decision the
result changes. If a caller is waiting on the answer, return these for the
caller's artifact's ledger: the add-only record kept outside that
artifact. If no caller is waiting, write them to
.sdlc-skills/evidence/{{YYYY-MM-DD}}-{{topic}}/prototype.mdunless the user names another path. If the result settles a load-bearing choice and no caller is waiting, REQUIRED SUB-SKILL: invokearchitecture-decisionsand apply its entry conditions. - A UI experiment informs
ui-ux-design; it does not select the product direction or authorize its implementation. Before scratch cleanup, retain any frame or artifact the approved design binds as immutable evidence. Product implementation, when authorized, rebuilds behavior under its normal gates; never lift prototype code. - Remove only the scratch artifacts registered in Step 1 inside the
disposable boundary, and only under current authority for those exact
targets. To dispose of a repository branch, worktree, ref, or workspace,
invoke
finishing-a-branch; never do it from this skill. External or destructive cleanup needs its own decision, current and scoped to that cleanup. Otherwise preserve what remains and report cleanup as pending. - Never delete pre-existing, shared, user-owned, or ownership-uncertain state.
Gotchas
- A prototype's answer kept only in the conversation dies with the session, and the settled question gets argued again.
- A probe that wrote outside its registered scratch targets leaves those writes behind when cleanup removes only the registered ones.