prototype

プロトタイプ

プロトタイプとは、問いに答えるための使い捨てコードです。形は問いによって決まります。

分岐を選ぶ

どの問いに答えるのかを特定します。ユーザーのプロンプトや周辺のコードから判断するか、ユーザーに確認できる場合は尋ねてください。

• 「このロジック／状態モデルは適切でしょうか？」 → LOGIC.md。共有できる単一の HTML ファイルを作成します。自由に操作できるボタンと、タブ切り替え式のガイド付きウォークスルーを用意し、紙上では考えにくいケースでステートマシンを動かします。また、開発者でなくても操作できるようにします。
• 「これはどのような見た目にすべきでしょうか？」 → UI.md。単一のルートで大きく異なる UI のバリエーションを複数生成し、URL の検索パラメーターと画面下部のフローティングバーで切り替えられるようにします。

2 つの分岐では成果物が大きく異なります。選択を誤ると、プロトタイプ全体が無駄になります。問いが本当に曖昧で、ユーザーに連絡できない場合は、周辺のコードにより合う分岐を選びます（バックエンドモジュールならロジック、ページやコンポーネントなら UI）。その前提をプロトタイプの冒頭に明記してください。

両方に適用されるルール

1. 最初から使い捨てとし、そのことを明確に示します。 プロトタイプのコードは実際に使用される場所の近く（対象のモジュールやページの隣）に配置し、文脈がすぐに分かるようにします。ただし、ひと目でプロトタイプと分かる名前を付け、本番コードと混同されないようにしてください。使い捨ての UI ルートでは、既存のプロジェクトのルーティング規約に従い、新しいトップレベル構造を作らないでください。
2. 簡単に実行できるようにします。 UI プロトタイプは、プロジェクトのタスクランナーから 1 つのコマンドで起動できるようにします。例：pnpm <name>、python <path>、bun <path> など。ロジックのデモは、ユーザーがダブルクリックするだけで開ける単一の HTML ファイルにします。どちらの場合も、起動方法を考える必要がないようにしてください。
3. デフォルトでは永続化しません。 状態はメモリ上に保持します。プロトタイプで検証するのは永続化そのものなので、永続化に依存させないでください。問いにデータベースが明示的に関わる場合は、スクラッチ DB または「PROTOTYPE — wipe me」という分かりやすい名前を付けたローカルファイルを使用してください。
4. 作り込みは省きます。 テストや、プロトタイプを 実行可能にする ために必要な範囲を超えるエラー処理、抽象化は不要です。目的は、すばやく知見を得ることです。
5. 状態を見えるようにします。 操作のたびに（ロジック）、またはバリエーションを切り替えるたびに（UI）、関連する状態全体を出力または描画し、何が変わったかをユーザーが確認できるようにします。
6. 完了したら記録します。 検証済みの判断を実際のコードに反映したうえで、プロトタイプ自体も一次資料として記録します。使い捨てブランチにコミットし、main ブランチには含めず、そのブランチへの参照を実装の課題に残してください。答えも、結論と解決した問いを課題またはコミットに記録します。main ブランチに残すのは、検証済みの判断のみです。

---

mattpocock/skills を基に改変。MIT © 2026 Matt Pocock。このファイルをコピーする場合は、この行を残してください。