mb-map-codebase

mb-map-codebase — ブラウンフィールド：リポジトリ → メモリバンク

• 概要： 既存のリポジトリをスキャンし、スコープを限定したワーカーからの証拠を統合して、現状のままのメモリバンク文書を作成します。
• 使用する場面： コードがすでに存在し、変更を計画する前に信頼できるベースラインが必要な場合です。
• 入力： リポジトリのルートと、初期化済みの .memory-bank/。
• 出力： 現行システムを記述するプロダクト、アーキテクチャ、テスト、ランブック、コントラクトの文書。推測に基づくタスク計画は含みません。

前提条件

• リポジトリのルートにいること。
• .memory-bank/ のスケルトンが存在すること（存在しない場合は mb-init を実行します）。

プロセス

1) プロトコルとタスクフォルダーを開始する

作成するファイル：

• .protocols/MAP-CODEBASE/plan.md
• .protocols/MAP-CODEBASE/progress.md
• .protocols/MAP-CODEBASE/verification.md（マッピングの完全性と証拠）
• .protocols/MAP-CODEBASE/handoff.md
• .protocols/MAP-CODEBASE/decision-log.md（任意）

作成するフォルダー：

• .tasks/TASK-MB-MAP/

計画には MB-SYNC を必ず含めてください（.memory-bank/workflows/mb-sync.md へのリンク）。

2) スキャンするサブエージェントを並列で起動する

基本となるワーカープロンプトには ./agents/shared-repo-scanner.md を使用します。

ルール：

• 並列サブエージェントは最大 5～7 個です。
• スコープが重複しないようにします（競合を避けるため）。
• 呼び出しを適切に行うため、各ワーカーは自分の glob が実在するファイルに一致することを検証します。

スコープの例：

• S-01 ツール／CI
• S-02 バックエンド／サービス
• S-03 フロントエンド／UI
• S-04 データレイヤー
• S-05 テスト／品質

各サブエージェントが作成するファイル：

• .tasks/TASK-MB-MAP/TASK-MB-MAP-S-0X-final-report-<code|docs>-01.md

3) ファンイン（必須）

最終文書を作成する前に：

• すべてのワーカーレポートを読む
• 1 つのアウトラインにまとめる
• 矛盾を解決する（または「要確認」として記録する）
• 次の内容を含む短いファンインメモを .protocols/MAP-CODEBASE/progress.md に記録する：
  • 使用したレポート
  • 矛盾した内容とその解決方法
  • 未解決の質問

4) メモリバンクを統合する（現状のまま）

ファンインで得た情報を使用して、以下を作成／更新します：

• プロダクト概要（.memory-bank/product.md）
• アーキテクチャの概要（.memory-bank/architecture/）
• 証拠によって裏付けられる場合は規範的なルーティング文書（.memory-bank/spec-index.md、.memory-bank/glossary.md、.memory-bank/invariants.md）
• ランブック（.memory-bank/runbooks/）
• コントラクト（.memory-bank/contracts/）
• コード、ワークフロー、またはテストからライフサイクル／状態のルールが明らかな場合は状態（.memory-bank/states/）
• テスト戦略（.memory-bank/testing/index.md）
• インデックス（.memory-bank/index.md）

references/synthesis-checklist.md を使用します。

PRD がない場合のルール（必須）：prd.md が存在しない場合、以下を作成または記入してはなりません：

• .memory-bank/epics/*
• .memory-bank/features/*
• 実際のロードマップタスクを含む .memory-bank/tasks/*.task.json

ブートストラップ時に作成された空のスケルトンファイル／フォルダーは問題ありません。

マッピングは現行システムの文書化であり、計画ではありません。

概要文書では、以下を明確に分けてください：

• 事実（証拠：パス／コマンド／ログ／テスト）
• 推論（仮説であることを明記）

5) PRD の差分を依頼する

ベースラインとなるメモリバンクができたら：

• 変更または追加する内容を記述した prd.md をユーザーに依頼します。
• その後、mb-from-prd を実行し、ベースラインを踏まえて差分を計画します。

6) レビューゲート

新しいコンテキストで mb-review を実行します。

7) MB-SYNC

.memory-bank/workflows/mb-sync.md に従い、変更履歴のエントリーを追記します。

完了の定義

• .tasks/TASK-MB-MAP/ にスコープ別のレポートが含まれている。
• .memory-bank/ に証拠とともにシステムの現状が記述されている。
• 矛盾と未解決の質問が記録されている。
• PRD の差分についてユーザーに依頼している。