デモレビューフロー は何をしますか?
テストとコードレビューはメカニズムの正当性を証明します。しかし、メニューの位置が間違っている、クローズが一瞬点滅する、アイコンが2px低い——これらはユーザーにしかわかりません。したがって、見た目や操作の変更は、製品コードを書く前に、機能ごとにユーザーが承認する動作するデモとして設計し、実際のアプリでユーザーが受け入れたときにのみクローズします。レビューボード(共有データベースを持つArtifactページ)は、すべての機能を6つのステータスで追跡します。
プロジェクト設定: .claude/demo-board.md(ボードURL、エリアごとの参照アプリ、確認する幅、ライブアプリ+それが実際のデータを保持するかどうか、ワークスペースコピーのポート、ゲートコマンド、仕様ファイル)。ない場合→先にボードを作成:references/board-setup.md。
どのパスか
- 何かの見た目、配置、操作方法を変更する → このフロー。規模や期限による例外はありません。
- 仕様または承認済みデモで既に定義されている動作を復元する(クラッシュ、誤ったデータ、オーバーフロー、リグレッション) → デモなしでTDDで直接修正。ユーザーにどのパスと判断したかを伝えてください。
- 出荷済みのボード項目に関して報告されたバグ →
portingに戻り、修正し、ライブで確認、shipped。見た目を変える修正 → 新しいデモラウンド。
フロー
- 最初に参照。 エリアごとに、ユーザーが既に知っているアプリを確認します(設定にリストされています)。コントロールの位置、各キー、モーション(終了を含む)を記録します。理由を明示した場合のみ逸脱を許可します。シミュレートされたユーザーの調査でオプション間の選択を行いますが、参照を置き換えることはありません。
- 実際のUIを測定。 変更が影響する出荷済み画面を、ユーザーの指定幅で読み取り専用でスクリーンショットし、ガター、サイズ、配置を測定します。そのレイアウト上で設計します。
- デモを作成 実際に動作する
feat()エントリとして:クリック、キー、モーション(終了を含む)、ライト+ダーク、狭い幅。→references/add-feature.md - 記録:
changes行とfeatures/<id>→review。 - 引き継いで停止。 リンク+確認すべき点。この項目の製品コードは
approvedになるまで書きません。「異論がなければ進めて構いません」は承認ではありません。期限までに承認が得られない場合、既に出荷できるものをユーザーに提供します——先に作ってはいけません。 - 決定を拾う すべてのUIセッションの開始時と、ユーザーがレビューしたと言ったとき:
featuresを読む。approved→ 7へ。changes→noteがリクエスト → 3へ。ユーザーが承認したと言うがDBが一致しない場合 → クリックが保存されていない:その旨を伝え、設定してあげます。 - すぐに移植 — ユーザーは計画をレビューしません。彼らの基準はステップ9です。
portingに設定。references/port-brief.mdに従って簡潔に。ファイルエリアごとに1つの移植エージェント。マイグレーションはワークスペースコピーで実行。明示的な承認とバックアップがある場合のみライブデータで実行。 - ライブでの証拠がある場合のみ出荷(測定値、フレームごとのモーション、両テーマ、ユーザーの幅):
shipped+changes行 + 確認すべき点。 - 検証はユーザーの判断 — ユーザーのAcceptクリック、またはチャットでこの項目が受け入れられたと言った場合(その場合あなたが設定します)。曖昧な「良さそう」 → どの項目か尋ねてください。自分の判断で行わないでください。
ステータス、設定者、DBスキーマ、書き込み → references/lifecycle.md。ブレインストーミング、計画作成、サブエージェント駆動開発、検証、ブランチの仕上げとの連携 → references/superpowers-integration.md。
ライブチェックの安全性
実際のデータを持つライブアプリ上で:読み取り専用で閲覧、正確なラベルのみクリック、削除/削除/編集は決して行わない — データを変更するチェックはすべてワークスペースコピーで実行します。
理屈
| 考え | 現実 |
|---|---|
| 「小さい/元に戻すのは簡単」 | 規模はテスト基準ではありません。見た目か操作かが基準です。小さなUI変更こそ配置ミスが発生します。 |
| 「明日が期限だ」 | デモラウンドは数分。間違った配置を出荷してデモで修正する方がコストがかかります。順序を守り、タイムラインを明示してください。 |
| 「スクリーンショットを見せて、異論がなければ進める」 | 沈黙は承認ではなく、完成したビルドのスクリーンショットは操作可能なデモではありません。 |
| 「正しい場所は第一原理から明らかだ」 | 参照アプリを指名してください。「ユーザーが見る場所」こそ、見つけられないスイッチが出荷された理由です。 |
| 「テスト、レビュー、ビルドが通ったから完了だ」 | それはporting完了です。shippedにはライブでの証拠が必要です。verifiedにはユーザーの承認が必要です。 |
| 「『まあいい感じ』は受け入れられた意味」 | 受け入れは項目ごとです。どの項目か尋ねてください。 |
| 「どうせ承認されるから、期限に備えて先に作っておこう」 | 未承認のコードは無駄です。今日出荷できるものを示し、承認された瞬間に移植してください。 |
| 「もっと明確なステータスを自分で作ろう」 | 6つのステータスのみ。ページとユーザーはこれらを読んでいます。 |
| 「移植とデモを一緒にやって時間を節約しよう」 | approvedの項目だけが製品コードを取得します。 |
レッドフラグ — 停止
- デモがデザインを示す前に製品コンポーネントを開く。
- 名前付きの参照アプリがない、または実際のUIの測定がないデザイン。
- ライブ証拠なしの
shipped。その項目に関するユーザーの言葉なしのverified。 - 実際のデータを保持するアプリで「削除」「削除」「保存」をクリックする。
- 同じファイルに対して2つの移植エージェントが作業している。ライブデータでマイグレーションを実行する。