gsd-map-codebase

並列の gsd-codebase-mapper エージェントを使用して既存のコードベースを分析し、構造化されたコードベース文書を作成します。

各マッパーエージェントは担当領域を調査し、.planning/codebase/ に文書を直接書き込みます。オーケストレーターが受け取るのは完了確認のみで、コンテキストの使用量を最小限に抑えます。

出力：コードベースの状態に関する7つの構造化文書を含む .planning/codebase/ フォルダー。

<execution_context> @{{PLATFORM_ROOT}}/get-shit-done/workflows/map-codebase.md </execution_context>

担当領域：$ARGUMENTS（任意。指定すると、特定のサブシステムに集中するようエージェントに指示します）

存在する場合はプロジェクトの状態を読み込みます： .planning/STATE.md を確認します。プロジェクトがすでに初期化されている場合は、コンテキストを読み込みます。

このコマンドを実行できるタイミング：

• {{COMMAND_PREFIX}}new-project の前（ブラウンフィールドのコードベース）— 最初にコードベースマップを作成します
• {{COMMAND_PREFIX}}new-project の後（グリーンフィールドのコードベース）— コードの進化に合わせてコードベースマップを更新します
• コードベースの理解を更新するときはいつでも

<when_to_use> map-codebase を使用する場合：

• 初期化前のブラウンフィールドプロジェクト（まず既存のコードを把握します）
• 大幅な変更後にコードベースマップを更新するとき
• 不慣れなコードベースへのオンボーディング時
• 大規模なリファクタリングの前（現状を把握します）
• STATE.md に古いコードベース情報が記載されている場合

map-codebase を省略する場合：

• コードがまだないグリーンフィールドプロジェクト（マップ対象がありません）
• 単純なコードベース（ファイルが5個未満） </when_to_use>

1. `.planning/codebase/` がすでに存在するか確認します（更新またはスキップを提案します） 2. `.planning/codebase/` のディレクトリー構造を作成します 3. gsd-codebase-mapper エージェントを4つ並列で起動します： - エージェント1：技術に注目 → STACK.md、INTEGRATIONS.md を作成 - エージェント2：アーキテクチャに注目 → ARCHITECTURE.md、STRUCTURE.md を作成 - エージェント3：品質に注目 → CONVENTIONS.md、TESTING.md を作成 - エージェント4：懸念事項に注目 → CONCERNS.md を作成 4. エージェントの完了を待ち、完了確認を収集します（文書の内容は収集しません） 5. 7つすべての文書が存在することを行数とともに確認します 6. コードベースマップをコミットします 7. 次のステップ（通常は {{COMMAND_PREFIX}}new-project または {{COMMAND_PREFIX}}plan-phase）を提案します

<success_criteria>

• .planning/codebase/ ディレクトリーが作成されている
• 7つすべてのコードベース文書がマッパーエージェントによって作成されている
• 文書がテンプレートの構造に従っている
• 並列エージェントがエラーなく完了している
• ユーザーが次のステップを把握している </success_criteria>