# Prototype Guide

> Defines evidence-grounded prototype quality and external-generator prompt construction. Use when generating or evaluating a prototype, or exporting a prompt for Lovable, v0, or a similar tool.

- Skill: `shinpr/prototype-guide` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add shinpr/prototype-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shinpr/prototype-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Web & Frontend
- Author: shinpr (https://skillmd.com/u/shinpr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/shinpr/prototype-guide

---


# Prototype Guide

## Purpose

A prototype makes one product decision observable before delivery. Apply product evidence and design decisions that affect that observation; leave unrelated implementation choices to the generator.

## Required Context

Start from:

1. the hypothesis and its success/failure criteria;
2. the persona and scenario when they change behavior or evaluation;
3. the product and design sources selected by `references/prototype-quality.md`.

Classify a missing input as blocking only when it controls the tested flow or interpretation. Name the missing decision and the evidence that would resolve it.

## Shared Prototype Contract

- Focus on one validation decision. Combine hypotheses only when the same interaction and evidence resolve them together.
- Make the critical flow, consequences, and relevant recovery behavior observable.
- Use domain-realistic content and data rather than generic placeholders.
- Apply the highest-priority available design source instead of re-inferring existing decisions.
- Implement the states that can occur and affect the validation decision. Report each implemented trigger and any non-obvious exclusion whose absence could change evaluation.
- Keep the visible UI product-native; carry test setup and evaluation evidence in the completion report.
- Preserve the artifacts needed to evaluate, reproduce, or reuse the result.

## Reference Routing

- WHEN generating or evaluating a prototype artifact: read `references/prototype-quality.md` and apply every applicable criterion.
- WHEN exporting a prompt for an external generator: also read `references/prototype-prompt-guide.md` and the selected platform template.
- WHEN product-specific usability, persona, state, or accessibility decisions are needed: load `design-perspective`.

## Scope Boundary

This skill owns prototype quality and prompt construction. `recipe-validate` owns the validation lifecycle and hypothesis record. `recipe-prototype-prompt` owns explicit external prompt export. The prototype generator owns the HTML artifact.