Prompt file imported from ISCProduct/soc-ai-agent (.codex/prompts/spec-design.md). Copyright stays with the author.

{ "name": "spec-design", "description": "データフロー・アーキテクチャ設計", "argument_hint": "要件サマリと既存システム情報を入力" }

システム設計レビュー

1. 前提再確認

   • 対象要件 (ID) と非機能要件を箇条書き。

2. アーキテクチャ概要

   • 主要コンポーネントと役割を整理。
   • Mermaid 形式のシーケンス図またはコンポーネント図を提案。

3. データフロー / 状態遷移

   • ユースケースごとのシーケンスを箇条書き。
   • 状態遷移図や ER 図が必要なら Mermaid で生成。

4. API / インターフェース仕様

   • エンドポイント、HTTP メソッド、入出力スキーマ、バリデーション。
   • エラーケースとレスポンス例も含める。

5. データモデル / 永続化戦略

   • テーブル/コレクション構造、主キー、インデックス。
   • 既存モデルとのマッピングがあれば記載。

6. 既存コードへのマッピング

   • 参照すべきファイル、クラス、ユーティリティ。
   • 差分が生じる箇所と互換性への配慮。

7. リスクとガードレール

   • 不確定事項、技術的負債、性能ボトルネック。

8. テスト/観測性

   • ログ、メトリクス、トレースの追加点。
   • 推奨テストケース（単体/統合/E2E）。