parallel-prototypes
Skill16 starsChanged 7 months agoMITView on GitHub
Run 2-3 prototype variants of a UX decision in parallel instead of iterating sequentially. Cagan calls this the "freshest observation" enabled by AI tooling. Triggers only when asked, with "/parallel-prototypes", "parallel prototypes", "try both as prototypes" or "compare designs side by side". It does not start on everyday phrases like "should it be X or Y".
In this repository45 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/agents.mdAGENTS.md
- .claude/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- actSkill
- security-checkSkill
- environment-checkSkill
- run-verificationSkill
- refactorSkill
- debug-session-archivedSkill
- generate-guardsSkill
- check-anthropicSkill
- code-reviewerSkill
- code-reviewSkill
- debug-sessionSkill
- end-sessionSkill
- evolve-checkSkill
- evolveSkill
- fix-bugSkill
- forgetSkill
- frontend-designSkill
- guardSkill
- kit-healthSkill
- learnSkill
- map-codebaseSkill
- modeSkill
- planSkill
- powershell-safeSkill
- product-riskSkill
- progress-reportSkill
- prototype-hypothesisSkill
- recallSkill
- refactoring-uiSkill
- scan-codebaseSkill
- scan-conventionsSkill
- search-firstSkill
- search-memorySkill
- shadow-codeSkill
- skill-creatorSkill
- smart-resumeSkill
- start-sessionSkill
- strategic-compactSkill
- tourSkill
- ux-heuristicsSkill
- verification-loopSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Use when the user is debating between 2-3 approaches to the same problem and would normally pick one to try first.
- Distinctive: line 21
Instead of picking one approach to iterate on, build 2-3 versions of the same screen/component side-by-side.
- Distinctive: line 33
DO NOT use when:
- Distinctive: line 60
Action: Delete v1 and v3. Iterate on v2 if needed.
- Distinctive: line 76
After picking a winner:
- Distinctive: line 77
Delete losing variant files immediately
- Distinctive: line 78
Don't keep them "just in case" — they become noise
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Skill: parallel-prototypes
Trigger
Use when the user is debating between 2-3 approaches to the same problem and would normally pick one to try first.
Common phrases:
- "should it be X or Y"
- "I'm torn between A and B"
- "should we try the modal or the slide-out?"
- "purple button or green?" (only if it's actually a hypothesis worth testing — see prototype-hypothesis skill)
- "let me try the WhatsApp style first" (push back: "Let's try 3 styles in parallel")
What this skill does
Instead of picking one approach to iterate on, build 2-3 versions of the same screen/component side-by-side. Then evaluate them against the same hypothesis at the same time.
This works because AI prototyping costs are now so low that building 3 variants takes ~30% more time than building 1, but eliminates the sequential iteration cycle.
When to use
Use when:
- The decision affects user behavior (UX layout, copy, payment flow, onboarding)
- The right answer isn't obvious from existing patterns
- You can articulate the hypothesis the variants will test
- The cost of building each variant is under ~20 minutes
DO NOT use when:
- One approach is clearly correct from prior decisions (decisions.md)
- The decision is technical, not user-facing (use the right architecture, don't A/B it)
- You haven't run
prototype-hypothesisfirst — variants without a hypothesis = 3x learning theater
How to run it
- State the hypothesis — what are all variants testing for?
- Define the variants — 2 or 3 approaches that genuinely differ on the variable being tested
- Build each as a separate file — e.g.,
app_v1.html,_v2.html,_v3.html— same structure, different on the tested variable - Test against the same user/narrative — Carol uses all 3, you watch what happens
- Pick the winner — log result to
prototype_log.md, delete the losers - Iterate sequentially on the winner — parallel exploration is for the macro decision; refinement is sequential
Example
Hypothesis: Where should the "Honor someone" CTA live to maximize the rate of dedications?
Variants:
- v1: Persistent ❤ button in compose bar
- v2: Subtle text link below feed ("Want to honor someone?")
- v3: First-row card always at top of feed
Test: Carol opens each version. Where does she click first when thinking of Patricia?
Result: v2 wins because Carol said "I don't want a button shouting at me. The link feels like a friend tapping me on the shoulder."
Action: Delete v1 and v3. Iterate on v2 if needed.
Why this exists
From Cagan's article:
"Today it's not unusual to quickly create several prototypes each exploring several different approaches to solving the problem, that we can then test simultaneously, and then continue to improve the most promising sequentially."
A product iterated sequentially through 10 sessions of UX revision. Some of those 10 sessions could have been compressed into 2-3 parallel-prototype sessions if the macro decisions had been tested in parallel. The cost of NOT doing parallel exploration is more discovery sessions than necessary.
Related
prototype-hypothesis— required before any variant gets builtproduct-risk— the four-risks evaluation runs at the project level; parallel-prototypes runs at the decision level
Cleanup
After picking a winner:
- Delete losing variant files immediately
- Don't keep them "just in case" — they become noise
- Log to
prototype_log.mdwith the hypothesis + variants + winner + reason
The losers are valuable as evidence, not as code. Keep the evidence in the log, not the codebase.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

