プロジェクトディレクトリマップビルダー

指定されたディレクトリ範囲について、高シグナル対ノイズ比のディレクトリ説明ドキュメントを生成または増分更新します。

コアなルール

• ユーザーがスキャンするフォルダー範囲を指定できるようにする必要があります。リポジトリ全体のスキャンをデフォルトにすることは禁止です。
• 範囲が大きすぎる場合は、コンテキストのリスクを警告し、ユーザーに確認または範囲の縮小を促します。
• 出力言語は、ユーザーの現在の言語と一致している必要があります。
• ドキュメントのファイル名は PROJECT_MAP.md に固定です。
• 出力場所に PROJECT_MAP.md が既に存在する場合は、更新モード（増分更新のみ）に入ります。
• 存在しない場合は、アクティブなガイダンスモード（最初に範囲を確認してから新規作成）に入ります。

出力場所のルール

• 単一ディレクトリ：PROJECT_MAP.md をそのディレクトリのルートに書き込みます。
• 複数ディレクトリ：
  • まず尋ねます：結合されたドキュメントを生成するか、各ディレクトリにそれぞれ生成するか。
  • 結合：プロジェクトのルートディレクトリに書き込みます。
  • 分割：各ディレクトリのルートにそれぞれ PROJECT_MAP.md を書き込みます。

ユーザーに尋ねるべき最小限の質問

• どのフォルダーをスキャンしますか？
• 複数のフォルダーの場合：1つのドキュメントに結合しますか、それともそれぞれ複数のドキュメントを生成しますか？
• 範囲が大きい、または不明確な場合：範囲を確認しますか？

ワークフロー

A) アクティブなガイダンスモード（PROJECT_MAP.md が存在しない場合）

1. スキャン範囲と出力戦略を確認します。
2. 指定されたディレクトリのファイルリストを素早く列挙します。
3. エントリポイントと主要なファイル（例：manifest、メインエントリ、サービススレッド、UI、設定、ストレージ、テスト、ドキュメント）を識別します。
4. 職責と関係を説明するために「主要なファイル」のみを開き、全量読み込みを避けます。
5. 構造テンプレートに従って PROJECT_MAP.md を生成します。
6. 不明な点は明示的にマークする必要があります（例：「仮定」「未確認」）。

B) 更新モード（PROJECT_MAP.md が既に存在する場合）

1. 既存の PROJECT_MAP.md を読み込みます。
2. ユーザーが指定したディレクトリ範囲のみを再スキャンします。
3. 「現在の会話コンテキスト」とファイルリストの差異を組み合わせて、更新が必要な段落を特定します。
4. 増分パッチ更新のみを行い、全量書き換えは行いません。
5. 「今回の更新」セクション（日付 + 範囲 + 変更点）を追加します。

スキャンルール

• 優先的に高速ファイルリストコマンド（例：rg --files または Get-ChildItem）を使用します。
• すべてのファイルを開かず、主要なファイルのみを読み込みます。
• より詳細な情報が必要な場合は、まずユーザーに掘り下げるサブディレクトリを確認します。

ドキュメント構造テンプレート（PROJECT_MAP.md）

必要に応じて調整可能ですが、以下を含めることを推奨します。

1. プロジェクト概要（一文）
2. 適用範囲（今回のスキャン対象フォルダーリスト）
3. エントリポイントと実行パス（簡易版）
4. 主要な設定とストレージキー（該当する場合）
5. ディレクトリとファイルの説明（ディレクトリ階層順）
6. 主要なモジュール関係/呼び出しチェーン
7. リスク/レガシー/不確定な点
8. 今回の更新（更新モードのみ）

複数ディレクトリ出力ルール

• 結合ドキュメント：「適用範囲」に各ディレクトリをリストし、各ディレクトリについて独立したセクションを記述します。
• 分割ドキュメント：各ディレクトリは自身の範囲のみを記述し、ディレクトリ間の結合は行いません。

更新モードルール（増分のみ）

• 既存の構造と表現をできるだけ保持します。
• 新規追加/削除されたファイルまたは新しいコンテキストに関連する部分のみを変更します。
• 明らかな誤りでない限り、古いコンテンツは削除しません。
• 「今回の更新」には日付、範囲、変更の概要を記録します。

安全性と明確性

• 確認できない動作やルールは「仮定/未確認」とマークする必要があります。
• レガシーと思われるファイルは「レガシーの可能性あり」とマークし、ユーザーが要求しない限り削除を推奨しません。