# DevTools ドキュメント作成・管理ガイド

`.agents/skills/devtools` に含まれる開発用スキルによって作成・更新されるドキュメントの内容、関係性、および管理手順についてまとめます。

---

## 1. 作成されるドキュメントと構成内容

開発プロセスにおいて以下のドキュメントが定義・作成されます。各ドキュメントへのリンクは、プロジェクトルートからの相対パスとして記載しています。

### ドキュメント構成表

| ドキュメント名 | ドキュメントの短い説明 | 入力ドキュメント名 | 出力ドキュメント名 |
| :--- | :--- | :--- | :--- |
| [docs/CONCEPT.md](../../../docs/CONCEPT.md) | プロジェクトの概要、主要な機能、動作環境などの各種ドキュメントを作成する土台となる情報をまとめた文書。 | なし | [docs/REQUIREMENTS.md](../../../docs/REQUIREMENTS.md)<br>[docs/SECURITY.md](../../../docs/SECURITY.md)<br>[docs/SCHEMA.md](../../../docs/SCHEMA.md)<br>[README.md](../../../README.md) |
| [docs/SECURITY.md](../../../docs/SECURITY.md) | セキュリティ方針、リスク対策、およびセキュリティ設計ガイドラインをまとめた文書。 | [docs/CONCEPT.md](../../../docs/CONCEPT.md) | [docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md)<br>[docs/DESIGN.md](../../../docs/DESIGN.md) |
| [docs/REQUIREMENTS.md](../../../docs/REQUIREMENTS.md) | プロジェクトのコンセプトを参照して要件定義をまとめた文書。 | [docs/CONCEPT.md](../../../docs/CONCEPT.md) | [docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md)<br>[docs/DESIGN.md](../../../docs/DESIGN.md)<br>[docs/PLAN.md](../../../docs/PLAN.md)<br>[docs/SPEC.md](../../../docs/SPEC.md)<br>[README.md](../../../README.md) |
| [docs/SCHEMA.md](../../../docs/SCHEMA.md) | データベース全体の設計方針、ネーミングルール、マイグレーション方針、および全体ER図をまとめた文書。 | [docs/CONCEPT.md](../../../docs/CONCEPT.md)<br>[docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md) | [docs/models/&lt;table-name&gt;.md](../../../docs/models/) |
| [docs/models/&lt;table-name&gt;.md](../../../docs/models/) | `docs/SCHEMA.md` の設計方針に基づき、テーブルごとに個別に分割して作成するテーブル定義書。 | [docs/SCHEMA.md](../../../docs/SCHEMA.md) | [docs/DESIGN.md](../../../docs/DESIGN.md)<br>[docs/services/&lt;service-name&gt;.md](../../../docs/services/) |
| [docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md) | 要件の達成やセキュリティリスクを考慮した開発の基盤（構成、技術スタック等）をまとめた文書。 | [docs/REQUIREMENTS.md](../../../docs/REQUIREMENTS.md)<br>[docs/SECURITY.md](../../../docs/SECURITY.md) | [docs/SCHEMA.md](../../../docs/SCHEMA.md)<br>[docs/DESIGN.md](../../../docs/DESIGN.md)<br>[docs/services/&lt;service-name&gt;.md](../../../docs/services/)<br>[docs/SPEC.md](../../../docs/SPEC.md)<br>[docs/PLAN.md](../../../docs/PLAN.md)<br>[backlog/WBS.md](../../../backlog/WBS.md) |
| [docs/services/&lt;service-name&gt;.md](../../../docs/services/) | 共通のビジネスロジックと、その通信・データ受け渡し用データ構造（DTO）を定義した仕様書。 | [docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md)<br>[docs/models/&lt;table-name&gt;.md](../../../docs/models/) | [docs/SPEC.md](../../../docs/SPEC.md) |
| [docs/DESIGN.md](../../../docs/DESIGN.md) | 開発プラットフォーム、言語、フレームワーク、ディレクトリ構成など具体的なソフトウェア設計書。 | [docs/REQUIREMENTS.md](../../../docs/REQUIREMENTS.md)<br>[docs/SECURITY.md](../../../docs/SECURITY.md)<br>[docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md)<br>[docs/models/&lt;table-name&gt;.md](../../../docs/models/) | [docs/SPEC.md](../../../docs/SPEC.md)<br>[docs/PLAN.md](../../../docs/PLAN.md)<br>[backlog/WBS.md](../../../backlog/WBS.md) |
| [docs/SPEC.md](../../../docs/SPEC.md) | アプリケーションのすべての機能、コンポーネント、入出力、画面構成などの詳細仕様をまとめた文書。 | [docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md)<br>[docs/REQUIREMENTS.md](../../../docs/REQUIREMENTS.md)<br>[docs/DESIGN.md](../../../docs/DESIGN.md)<br>[docs/services/&lt;service-name&gt;.md](../../../docs/services/) | [docs/TEST_SPEC.md](../../../docs/TEST_SPEC.md)<br>[backlog/WBS.md](../../../backlog/WBS.md) |
| [docs/TEST_SPEC.md](../../../docs/TEST_SPEC.md) | 仕様書を参照して作成される、すべての機能・画面を検証するためのテストケース一覧。 | [docs/SPEC.md](../../../docs/SPEC.md) | [test/checklists/UNIT_CHECKLIST-{XXXX}.md](../../../test/checklists/)<br>[test/checklists/INTEGRATION_CHECKLIST-{XXXX}.md](../../../test/checklists/) |
| [test/checklists/UNIT_CHECKLIST-{XXXX}.md](../../../test/checklists/) | 機能ごとに単体テスト（Unit Test）の実行項目と結果を記録するチェックリスト。 | [docs/TEST_SPEC.md](../../../docs/TEST_SPEC.md) | なし |
| [test/checklists/INTEGRATION_CHECKLIST-{XXXX}.md](../../../test/checklists/) | 機能・画面を横断した結合テスト（Integration Test）の実行項目と結果を記録するチェックリスト。 | [docs/TEST_SPEC.md](../../../docs/TEST_SPEC.md) | なし |
| [docs/PLAN.md](../../../docs/PLAN.md) | カテゴリごとの開発計画（フロントエンド、バックエンド、ライブラリ、統合）をまとめた実装計画書。 | [docs/REQUIREMENTS.md](../../../docs/REQUIREMENTS.md)<br>[docs/DESIGN.md](../../../docs/DESIGN.md)<br>[docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md) | [backlog/WBS.md](../../../backlog/WBS.md) |
| [backlog/BACKLOG.md](../../../backlog/BACKLOG.md) | プロジェクトの課題（ISSUE）やタスク（TASK）の管理・運用ルールを定義した親文書。 | なし | [backlog/issues/ISSUE-XXXX.md](../../../backlog/issues/)<br>[backlog/tasks/TASK-XXXX.md](../../../backlog/tasks/) |
| [backlog/WBS.md](../../../backlog/WBS.md) | 各開発工程をタスクに分解し、スケジュールを管理するワークブレイクダウンストラクチャー。 | [docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md)<br>[docs/DESIGN.md](../../../docs/DESIGN.md)<br>[docs/SPEC.md](../../../docs/SPEC.md)<br>[docs/PLAN.md](../../../docs/PLAN.md) | [backlog/issues/ISSUE-XXXX.md](../../../backlog/issues/) |
| [backlog/issues/ISSUE-XXXX.md](../../../backlog/issues/) | 発生したプロジェクト上の問題、要改善項目、機能追加要請などを管理する課題票。 | [backlog/BACKLOG.md](../../../backlog/BACKLOG.md)<br>[backlog/WBS.md](../../../backlog/WBS.md) | [backlog/tasks/TASK-XXXX.md](../../../backlog/tasks/) |
| [backlog/tasks/TASK-XXXX.md](../../../backlog/tasks/) | 起票された課題を解決するための具体的な作業手順書。 | [backlog/BACKLOG.md](../../../backlog/BACKLOG.md)<br>[backlog/issues/ISSUE-XXXX.md](../../../backlog/issues/) | なし |
| [README.md](../../../README.md) | プロジェクトの概要、インストール方法、使い方、ライセンス情報をまとめたファイル。 | [docs/CONCEPT.md](../../../docs/CONCEPT.md)<br>[docs/REQUIREMENTS.md](../../../docs/REQUIREMENTS.md) | なし |

### [docs/CONCEPT.md](../../../docs/CONCEPT.md) (コンセプト)

*   **対応スキル**: [skills/create-concept.md](skills/create-concept.md)
*   **内容**: プロジェクトの概要、主要な機能、動作環境などの各種ドキュメントを作成する土台となる情報をまとめた文書。
*   **構成項目**:
    *   概要：プロジェクトの概要
    *   対象ユーザー・背景：ターゲットユーザー層や解決したい課題の背景、開発の目的
    *   機能：主要な機能
    *   動作環境：動作環境

### [docs/SECURITY.md](../../../docs/SECURITY.md) (セキュリティ定義・ポリシー)

*   **対応スキル**: [skills/create-security.md](skills/create-security.md)
*   **内容**: `docs/CONCEPT.md` を参照して、プロジェクトにおけるセキュリティ方針、リスク対策、およびセキュリティ設計ガイドラインをまとめた文書。
*   **構成項目**:
    *   セキュリティポリシー：プロジェクト全体のセキュリティ基本方針
    *   認証・認可：認証方式、アクセス制御の方針
    *   データの保護：暗号化方式、個人情報の取り扱い
    *   脆弱性対策：入力値検証、各種攻撃対策
    *   シークレット管理：APIキーやパスワード等の管理・運用の仕組み

### [docs/REQUIREMENTS.md](../../../docs/REQUIREMENTS.md) (要件定義書)

*   **対応スキル**: [skills/create-requirements.md](skills/create-requirements.md)
*   **内容**: `docs/CONCEPT.md` を参照して要件定義をまとめた文書。設計・開発の詳細やセキュリティについてはここでは含めない。
*   **構成項目**:
    *   機能一覧（※機能要件のみを定義し、非機能要件は ARCHITECTURE.md に記述）
    *   画面一覧

### [docs/SCHEMA.md](../../../docs/SCHEMA.md) (データベース全般・ER図)

*   **対応スキル**: [skills/create-schema.md](skills/create-schema.md)
*   **内容**: データベース全体の設計方針、ネーミングルール、マイグレーション方針、および全体ER図をまとめた文書。
*   **構成項目**:
    *   データベース概要：データベースの種類、バージョン、ホスティング環境
    *   ネーミングルール：テーブル、カラム、インデックス、外部キーの命名規則
    *   全体ER図：Mermaidを用いた全体のエンティティ関連（ER図）表現
    *   マイグレーション方針：テーブル変更管理ルール、マスタデータ投入方法

### [docs/models/&lt;table-name&gt;.md](../../../docs/models/%3Ctable-name%3E.md) (物理モデル・テーブル定義)

*   **対応スキル**: [skills/create-model.md](skills/create-model.md)
*   **内容**: `docs/SCHEMA.md` の設計方針に基づき、テーブルごとに個別に分割して作成するテーブル定義書。
*   **構成項目**:
    *   モデル概要：テーブル物理名、論理名、役割・責責
    *   カラム定義：物理名、論理名、型、制約(PK/FK/Null)、デフォルト値、説明
    *   インデックス定義：プライマリキー、ユニークキー、外部キーインデックスなどの設計情報
    *   アソシエーション（関連）：他テーブルとのリレーションシップ（1対多、多対多など）

### [docs/ARCHITECTURE.md](../../../docs/ARCHITECTURE.md) (基本設計・アーキテクチャ)

*   **対応スキル**: [skills/create-architecture.md](skills/create-architecture.md)
*   **内容**: `docs/REQUIREMENTS.md` と `docs/SECURITY.md` を参照して、要件の達成やセキュリティリスクを考慮した開発の基盤をまとめた文書。
*   **構成項目**:
    *   作成するアプリケーションおよびライブラリのリスト
    *   コードマップ：主要なディレクトリやファイルの説明
    *   技術スタック：使用している技術スタック（フレームワーク、ライブラリ、ツールなど）
    *   システム構成図（Mermaidで表現）
    *   コアロジック：主要なロジックの説明
    *   ワークフロー：基本的な機能の処理フロー（要点を絞った説明）
    *   セキュリティ：`docs/SECURITY.md` に基づくセキュリティ設計方針やリスク対策の説明
    *   非機能要件：性能目標、可用性、スケーラビリティ、運用・保守方針などの非機能要件への対応方針

### [docs/services/&lt;service-name&gt;.md](../../../docs/services/%3Cservice-name%3E.md) (共通サービス・DTO仕様)

*   **対応スキル**: [skills/create-service.md](skills/create-service.md)
*   **内容**: 複数の画面から横断的に呼び出される共通のビジネスロジック（Shared Services）と、その通信・データ受け渡し用データ構造（DTO）を定義した仕様書。
*   **構成項目**:
    *   サービス概要：サービスの役割、公開インターフェースとしての責務
    *   インターフェース定義：メソッドシグネチャ、引数、戻り値、例外処理、処理フロー
    *   DTO定義：レイヤー間（`Controller <- DTO <- Service`）でやり取りするDTOの各フィールドの物理名、論理名、データ型、およびバリデーションルール

### [docs/DESIGN.md](../../../docs/DESIGN.md) (詳細設計・ソフトウェア設計)

*   **対応スキル**: [skills/create-design.md](skills/create-design.md)
*   **内容**: アプリケーションの具体的な設計書。複数アプリケーションで構成される場合は `docs/<Application>/DESIGN.md` に作成する。
*   **構成項目**:
    *   開発プラットフォーム
    *   開発言語
    *   フレームワーク
    *   ライブラリ
    *   ディレクトリ構成
    *   主要なコンポーネント概要と関係図

### [docs/SPEC.md](../../../docs/SPEC.md) (仕様書)

*   **対応スキル**: [skills/create-spec.md](skills/create-spec.md)
*   **内容**: アプリケーションの具体的な仕様書。複数アプリケーションで構成される場合は `docs/<Application>/SPEC.md` に作成する。
*   画面設計および画面仕様は、個別の画面ID（最大24文字）を付与し、`docs/specs/<ID>.md` または `docs/<Application>/specs/<ID>.md` に作成する。
*   **構成項目**:
    *   すべての機能一覧
    *   すべてのコンポーネント一覧
    *   機能ごとの入力と出力
    *   すべての画面一覧
    *   画面固有の仕様（各画面仕様内に `ViewModel` や画面固有の `Service` の詳細仕様を内包して定義）

### [docs/TEST_SPEC.md](../../../docs/TEST_SPEC.md) (テスト仕様書)

*   **対応スキル**: [skills/create-testspec.md](skills/create-testspec.md)
*   **内容**: 仕様書を参照して作成されるテストケース一覧。複数アプリケーションで構成される場合は `docs/<Application>/TEST_SPEC.md` に作成する。
*   **構成項目**:
    *   すべての機能、画面ごとの機能を検証するテストケース

### [test/checklists/UNIT_CHECKLIST-{XXXX}.md](../../../test/checklists/UNIT_CHECKLIST-%7BXXXX%7D.md) (単体テストチェックリスト)

*   **対応スキル**: [skills/create-checklist.md](skills/create-checklist.md)
*   **内容**: テスト仕様書に基づき、機能ごとに単体テスト（Unit Test）の実行項目と結果（`TODO`, `OK`, `NG`, `SKIP`）を記録する表形式のファイル。
*   **構成項目**:
    *   `| ID1 | ID2 | ID3 | 大項目 | 中項目 | 小項目 | 確認日 | 版 | 確認者 | 結果 | 備考 |`

### [test/checklists/INTEGRATION_CHECKLIST-{XXXX}.md](../../../test/checklists/INTEGRATION_CHECKLIST-%7BXXXX%7D.md) (結合テストチェックリスト)

*   **対応スキル**: [skills/create-checklist.md](skills/create-checklist.md)
*   **内容**: テスト仕様書に基づき、機能・画面を横断した結合テスト（Integration Test）の実行項目と結果（`TODO`, `OK`, `NG`, `SKIP`）を記録する表形式のファイル。
*   **構成項目**:
    *   `| ID1 | ID2 | ID3 | 大項目 | 中項目 | 小項目 | 確認日 | 版 | 確認者 | 結果 | 備考 |`

### [docs/PLAN.md](../../../docs/PLAN.md) (実装計画書)

*   **対応スキル**: [skills/create-plan.md](skills/create-plan.md)
*   **内容**: アプリケーションの開発計画。複数アプリケーションで構成される場合は `docs/<Application>/PLAN.md` に作成する。
*   **構成項目**:
    *   カテゴリごとの開発計画（フロントエンド、バックエンド、ライブラリ、統合の4カテゴリ）

### [backlog/BACKLOG.md](../../../backlog/BACKLOG.md) (バックログ運用定義)

*   **対応スキル**: なし (※手動作成)
*   **内容**: プロジェクトの課題（ISSUE）やタスク（TASK）の管理・運用ルールを定義した親文書。
*   **構成項目**:
    *   ディレクトリ構成、課題・タスクの起票フロー、ID体系定義（4桁連番、0パディング）。
    *   ※GitHub IssuesやBacklogなどのSaaSを用いる場合の運用方針（ローカルの `issues/` の代わりにSaaSを使用する旨など）。

### [backlog/WBS.md](../../../backlog/WBS.md) (Work breakdown Structure)

*   **対応スキル**: [skills/create-wbs.md](skills/create-wbs.md)
*   **内容**: 各開発工程をタスクに分解し、期日や担当者、優先度、工数を設定してスケジュールを管理する表形式のバックログファイル。
*   **構成項目**:
    *   `| ID1 | ID2 | ID3 | 大項目 | 中項目 | 小項目 | 期日 | 優先度 | 工数 | 担当者 | 備考 |` (ID形式は `<ID1>-<ID2>-<ID3>`)

### [backlog/issues/ISSUE-XXXX.md](../../../backlog/issues/ISSUE-XXXX.md) (課題)

*   **対応スキル**: なし (※手動起票)
*   **内容**: 発生したプロジェクト上の問題、要改善項目、機能追加要請などを管理する課題票。
*   **構成項目**:
    *   テンプレートは `backlog/config/ISSUE-TEMPLATE.md` を使用。
    *   起票した課題は `backlog/issues/index.md` の目次に追記。
    *   ※GitHub IssuesやBacklog等のSaaSを利用する場合は、ローカルでのファイル作成は行わず、SaaS上のチケットで課題管理を行います。

### [backlog/tasks/TASK-XXXX.md](../../../backlog/tasks/TASK-XXXX.md) (タスク)

*   **対応スキル**: [skills/create-task.md](skills/create-task.md)
*   **内容**: 起票された `backlog/issues/ISSUE-XXXX.md` （またはSaaS上の課題）を解決するための具体的な作業手順書。ひとつの課題に対して複数タスクがある場合は `TASK-XXXX-Y.md` のように枝番を付与する。
*   **構成項目**:
    *   テンプレートは `backlog/config/TASK-TEMPLATE.md` を使用。
    *   作成したタスクは `backlog/tasks/index.md` の目次に追記。
    *   ※課題の管理にSaaSを利用している場合は、タスクから該当するSaaS上の課題（例: GitHub #123 へのリンク）を参照します。
    *   ※追加のスクリーンショットやテストデータ等の関連ファイルは `backlog/resources/TASK-XXXX/` (または `backlog/resources/ISSUE-XXXX/`) に保存。

### [README.md](../../../README.md)

*   **対応スキル**: [skills/create-readme.md](skills/create-readme.md)
*   **内容**: プロジェクトの概要、インストール方法、使い方、ライセンス情報をまとめたファイル。

---

## 2. ドキュメント関係図

各ドキュメントの入力 (INPUTS) と出力 (OUTPUTS) の関係図です。矢印は「左/上のドキュメントを参照・インプットとして、右/下のドキュメントが作成される」関係を示しています。
※課題の管理にGitHub IssuesなどのSaaSを利用する場合、ローカルの `backlog/issues/` は使用せず、SaaS上の課題を直接参照して `backlog/tasks/TASK-XXXX.md` を作成します。

```mermaid
graph TD
    CONCEPT["docs/CONCEPT.md"] --> REQUIREMENTS["docs/REQUIREMENTS.md"]
    CONCEPT --> SECURITY["docs/SECURITY.md"]
    CONCEPT --> SCHEMA["docs/SCHEMA.md"]
    
    REQUIREMENTS --> ARCHITECTURE["docs/ARCHITECTURE.md"]
    REQUIREMENTS --> DESIGN["docs/DESIGN.md"]
    REQUIREMENTS --> PLAN["docs/PLAN.md"]
    REQUIREMENTS --> README["README.md"]
    CONCEPT --> README
    
    SECURITY --> ARCHITECTURE
    SECURITY --> DESIGN
    
    SCHEMA --> MODEL["docs/models/<table-name>.md"]
    
    ARCHITECTURE --> SCHEMA
    ARCHITECTURE --> DESIGN
    ARCHITECTURE --> SERVICE["docs/services/<service-name>.md"]
    
    MODEL --> DESIGN
    MODEL --> SERVICE
    
    ARCHITECTURE --> SPEC["docs/SPEC.md"]
    REQUIREMENTS --> SPEC
    DESIGN --> SPEC
    SERVICE --> SPEC
    
    DESIGN --> PLAN
    ARCHITECTURE --> PLAN
    
    SPEC --> TEST_SPEC["docs/TEST_SPEC.md"]
    
    TEST_SPEC --> UNIT_CHECKLIST["test/checklists/UNIT_CHECKLIST-{XXXX}.md"]
    TEST_SPEC --> INTEGRATION_CHECKLIST["test/checklists/INTEGRATION_CHECKLIST-{XXXX}.md"]
    
    ARCHITECTURE --> WBS["backlog/WBS.md"]
    DESIGN --> WBS
    SPEC --> WBS
    PLAN --> WBS
    
    BACKLOG["backlog/BACKLOG.md"] -->|"運用定義"| ISSUE["backlog/issues/ISSUE-XXXX.md"]
    BACKLOG -->|"SaaS課題管理"| SAAS["SaaS Issues (GitHub, Backlog)"]
    
    BACKLOG -->|"運用定義"| TASK["backlog/tasks/TASK-XXXX.md"]
    
    ISSUE_TEMP["backlog/config/ISSUE-TEMPLATE.md"] -->|"テンプレート"| ISSUE
    TASK_TEMP["backlog/config/TASK-TEMPLATE.md"] -->|"テンプレート"| TASK
    
    WBS -.->|"スケジュール工程紐付け"| ISSUE
    WBS -.->|"SaaSスケジュール紐付け"| SAAS
    
    ISSUE -->|"課題解決のために作成"| TASK
    SAAS -->|"SaaS上の課題解決のために作成"| TASK
    
    TASK -->|"追記"| TASK_IDX["backlog/tasks/index.md"]
    ISSUE -->|"追記"| ISSUE_IDX["backlog/issues/index.md"]
    
    TASK -.->|"追加リソース"| RESOURCES["backlog/resources/"]
    ISSUE -.->|"追加リソース"| RESOURCES
```

---

## 3. ドキュメント生成・更新ワークフロー

### ドキュメント生成スキル

*   **[skills/generate-documents.md](skills/generate-documents.md)** (一括生成)
    *   コードベースからドキュメントを作成（リバースエンジニアリング）するため、具象から抽象に遡る順序（Bottom-up）で順次ドキュメントを生成します。
        1. `SPEC.md`
        2. `DESIGN.md`
        3. `ARCHITECTURE.md`
        4. `SECURITY.md`
        5. `REQUIREMENTS.md`
        6. `SCHEMA.md`
        7. `CONCEPT.md`
*   **[skills/generate-document.md](skills/generate-document.md)** (個別生成)
    *   ドキュメント名を指定し、対応する作成用スキルを実行して個別にドキュメントを生成します。個別ドキュメント（各 `models/*.md` や `services/*.md`）も個別に指定して生成できます。

### ドキュメント更新スキル

*   **[skills/update-documents.md](skills/update-documents.md)** (一括更新)
    *   ドキュメント表に定義されているすべてのドキュメントを順次更新します。
*   **[skills/update-document.md](skills/update-document.md)** (個別更新)
    *   指定されたドキュメントの作成スキルを読み込み、そこに記載されている関係ドキュメント（INPUTS）を再読み込みした上で、更新差分を取り込みます。
    *   更新対象ドキュメント：`CONCEPT.md`, `SECURITY.md`, `REQUIREMENTS.md`, `SCHEMA.md`, `ARCHITECTURE.md`, `DESIGN.md`, `README.md`, `SPEC.md`, `TEST_SPEC.md`

### ドキュメントレビュースキル

*   **[skills/review-documents.md](skills/review-documents.md)** (一括レビュー)
    *   ドキュメント表に定義されているすべてのドキュメントを順次レビューします。
*   **[skills/review-document.md](skills/review-document.md)** (個別レビュー)
    *   指定されたドキュメントに対応する個別レビュースキルを実行してドキュメントをレビューします。個別ドキュメント（各 `models/*.md` や `services/*.md`）も個別に指定してレビューできます。
    *   対応スキル：
        *   `CONCEPT.md` -> `skills/review-concept.md`
        *   `SECURITY.md` -> `skills/review-security.md`
        *   `REQUIREMENTS.md` -> `skills/review-requirements.md`
        *   `SCHEMA.md` -> `skills/review-schema.md`
        *   `models/*.md` -> `skills/review-model.md`
        *   `ARCHITECTURE.md` -> `skills/review-architecture.md`
        *   `services/*.md` -> `skills/review-service.md`
        *   `DESIGN.md` -> `skills/review-design.md`
        *   `SPEC.md` -> `skills/review-spec.md`
        *   `TEST_SPEC.md` -> `skills/review-testspec.md`
        *   `UNIT_CHECKLIST-{XXXX}.md` / `INTEGRATION_CHECKLIST-{XXXX}.md` -> `skills/review-checklist.md`
        *   `PLAN.md` -> `skills/review-plan.md`
        *   `README.md` -> `skills/review-readme.md`

---

## 4. 開発・タスク実行ライフサイクル（運用フロー）

開発工程のタスク分割、実装計画の策定、実装・テスト・レビュー・手戻りを含む運用ワークフローの詳細な手順とプロセスについては、[DEVELOPMENT.md](DEVELOPMENT.md) を参照してください。


