review

レビューオーケストレーター

アプリケーションレビューの単一のエントリーポイントです。重要な点をトリアージし、1つ以上のドメインレビューを実行して、統合レポートにまとめます。各ドメインは references/<domain>.md に記載され、選択された場合にのみ読み込まれます。

使用する場面

• ユーザーがレビューを希望しているものの、どの種類が必要か分からない場合
• リリース前の準備状況評価
• インシデント発生後のレビュー計画
• 特定のドメインに関する依頼（「アプリのセキュリティを確認して」「SEO をレビューして」）

モード

• トリアージ（デフォルト、/review） — コンテキストに関する質問をし、計画を提案して実行します。
• 全項目（/review --all） — 該当するすべてのドメインを実行します。
• 対象指定（/review <domain>） — トリアージを省略して、1つのドメインをすぐに実行します。例：/review security、/review seo。深度フラグ（--quick / --thorough）を任意で指定できます。

ドメイン

各行は参照ファイルに対応しています。ドメインが選択された場合にのみ、そのファイルを読み込んでください。

ドメイン	参照ファイル	実行する場面…（トリガーとなる兆候）
security	references/security.md	認証／ログインの変更、機密データ、OWASP、ヘッダー／CORS／CSP、サプライチェーン
privacy	references/privacy.md	PII の収集、トラッキング／分析、同意バナー、GDPR／CCPA
compliance	references/compliance.md	規制対象業界、監査準備、HIPAA／SOC 2／PCI-DSS／GDPR、決済データまたは健康データ
design	references/design.md	デザイナー不在での UI リリース、レスポンシブ対応、アクセシビリティ、タイポグラフィ、i18n
resilience	references/resilience.md	エラー処理、ネットワーク／API 障害、空状態／エッジケース、縮退運転
performance	references/performance.md	ページの遅さ、Core Web Vitals、バンドルサイズ、実行時／レンダリングのパフォーマンス
seo	references/seo.md	公開サイト、メタタグ、構造化データ、クロール可能性、サイトマップ
geo	references/geo.md	AI アシスタントによる発見、LLM の引用されやすさ、llms.txt、エンティティの明確さ

共通の規約（フェーズ、スコアリング、信頼度、重大度、出力パス）は references/report-format.md に記載されています。すべてのドメインでこれに従ってください。

手順

1. コンテキストを収集する

• プロジェクトを確認します：技術スタック、フレームワーク、package.json、ルート、コンポーネント。
• 最近の変更を確認するため、git diff を確認します。
• shiplight/reports/ に既存のレポートがないか確認します。
• コンプライアンス関連のマーカーを自動検出します（HIPAA／PHI、PCI／決済フィールド、GDPR／Cookie 同意）。

/review <domain> として呼び出された場合は、この手順を省略して、そのドメインの手順 4 に進みます。

2. 対象を絞った質問をする（最大4つ）

自動検出した既定値を使い、1つずつ質問します。

1. アプリケーションの種類は何ですか？（SaaS、医療、フィンテック、E コマース、社内ツール、マーケティングサイト、API 専用）
2. 今回のレビューのきっかけは何ですか？（リリース前、新機能、依存関係の更新、セキュリティインシデント、監査準備、定期レビュー）
3. コンプライアンス要件はありますか？（なし、HIPAA、SOC2、PCI-DSS、GDPR、複数） — コードベースから自動検出します
4. 具体的な懸念事項はありますか？（自由回答、任意）

3. レビュープランを作成する

該当する各ドメインを CRITICAL（必須）、RECOMMENDED （大きな価値がある）、または OPTIONAL（実施すると望ましい）に分類し、推定深度 （クイック／標準／徹底）を設定します。

製品の種類に応じた SEO と GEO の優先順位：

製品の種類	SEO	GEO
開発者向けツール、API 製品、SaaS	RECOMMENDED	CRITICAL
E コマース、地域ビジネス、マーケットプレイス	CRITICAL	OPTIONAL
コンテンツ／メディア、ドキュメント、ブログ	CRITICAL	CRITICAL
社内ツール	—	—

判断マトリクスを提示します。

レビュー	優先度	理由	深度
security	CRITICAL	新しい認証機能 + SaaS アプリ	thorough
privacy	CRITICAL	ユーザーの PII を扱い、GDPR が適用される	standard
…

4. 実行する

「CRITICAL のレビューをすべて今すぐ実行しますか？ [Y/n] または、特定のレビューを選んでください。」と尋ねます。

選択された各ドメインについて、references/<domain>.md を読み、その5つの フェーズに従ってください。スコアリング、重大度、出力パスには references/report-format.md を適用します。ドメインは順番に実行し、次に進む前にそれぞれの後で簡単な要約を表示します。

5. 統合レポート

選択したドメインのレビューが完了したら、各ドメインのレポートをまとめて、 shiplight/reports/review-{date}.md に保存します。

• 全体の準備状況スコア（0～10）とドメインごとのスコア
• 全ドメインの重大度別の主な指摘事項トップ5
• 回帰テストの概要（生成されたYAMLテストの合計数。保存先は shiplight/tests/）

ヒント

• 大規模なローンチの前に、毎回 /review を実行してください。
• 必要なドメインがすでにわかっている場合は、/review <domain> が最短の方法です。
• レポートは shiplight/reports/ に蓄積され、オーケストレーターで傾向を確認できます。
• レビューで生成されたYAML回帰テストは shiplight/tests/ に蓄積されます。