prototype

Prototype

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

分岐を選ぶ

どの問いに答えようとしているのかを特定します — ユーザーのプロンプト、周辺のコード、あるいはユーザーが対応可能なら直接尋ねることで判断します:

• 「このロジック / 状態モデルはしっくりくるか?」 → LOGIC.md。紙の上では考えにくいケースを通して状態機械を動かす、小さな対話的ターミナルアプリを作ります。
• 「これはどう見えるべきか?」 → UI.md。1つのルート上に大きく異なる複数のUIバリエーションを生成し、URLの検索パラメータとフローティングのボトムバーで切り替えられるようにします。

2つの分岐は全く異なる成果物を生み出します — これを取り違えるとプロトタイプ全体が無駄になります。問いが本当に曖昧でユーザーにも連絡が取れない場合は、周辺コードによりよく合致する分岐をデフォルトに選び（バックエンドモジュール → logic、ページやコンポーネント → UI）、その前提をプロトタイプの先頭に明記します。

両方に適用されるルール

1. 初日から使い捨てであり、それと明確にわかるようにする。 プロトタイプコードは実際に使われる場所の近く（プロトタイプ対象のモジュールやページの隣）に置いてコンテキストを明らかにします — ただし、何気なく読む人にもプロダクションではなくプロトタイプだとわかる名前を付けます。使い捨てのUIルートでは、プロジェクトが既に使っているルーティング規約に従い、新しいトップレベル構造を発明しないこと。
2. 1コマンドで実行できる。 プロジェクトの既存のタスクランナーがサポートするもの — pnpm <name>、python <path>、bun <path> など。ユーザーが何も考えずに起動できるようにします。
3. デフォルトでは永続化しない。 状態はメモリ上に存在します。永続化はプロトタイプが 検証している 対象であって、依存すべきものではありません。問いが明示的にデータベースを含む場合は、スクラッチDBや「PROTOTYPE — wipe me」のような明確な名前のローカルファイルに当てます。
4. 磨き込みは省く。 テストなし、プロトタイプを 実行可能 にする以上のエラーハンドリングなし、抽象化なし。要点は素早く何かを学び、それから削除することです。
5. 状態を表に出す。 すべてのアクション後（logic）またはバリアント切り替えのたび（UI）に、関連する状態を完全に出力・描画して、ユーザーが何が変わったかを見られるようにします。
6. 終わったら削除または吸収する。 プロトタイプが問いに答えたら、削除するか、検証済みの判断を実コードに織り込むかします — リポジトリに腐ったまま残さないこと。

終わったとき

プロトタイプから残す価値があるのは 答え だけです。答えと、それが答えていた問いを、どこか永続的な場所（コミットメッセージ、ADR、issue、またはプロトタイプの隣の NOTES.md）に記録します。ユーザーが対応可能ならこの記録はちょっとした会話で済みます。そうでなければプレースホルダーを残し、プロトタイプを削除する前に（次のパスで自分が、あるいはユーザーが）結論を埋められるようにします。