ns-harness-bootstrap-brownfield

既存プロジェクトの初期分析

SDD 計画の前に、既存プロダクトのアーキテクチャを調査します。

出力はエージェント向けの高密度な形式（表、件数、ギャップ一覧）で、人間向けのエッセイではありません。references/agent-dense.md を参照し、保存前に ../ns-harness/references/agent-artifact-compress.md を適用してください。

ハーネスの調査

../ns-harness/references/harness-discovery.md を参照してください。{harness_root}/rules/*.md からルールを読み込みます。まず architecture-rules.md を読んでください。レガシー環境では、{harness_root} が存在しない場合に限り .cursor/rules/*.mdc を使用します。ルールが存在する場合は、調査結果を正規ルールと照合してください。ルールがない場合、チェックは参考情報です。マップに規約一式をコピーしないでください。リンクしてください。

使用するタイミング

• 「既存プロジェクトを分析」／「ブラウンフィールドの初期分析」
• コードはあるが requirements.md がないリポジトリで、初めて SDD 計画を行う場合
• レガシーコードに対して ns-sdd-requirements-generator を実行する前

ワークフロー

ステップ 1 — 構成の検出

{product_root} の下（およびレガシーなレイアウトの場合はリポジトリルートも対象にし、不整合を記録します）：

バックエンドのシグナル： composer.json、artisan、モジュール化された app/Modules/、docker-compose.yml、.env.example

フロントエンドのシグナル： package.json、tsconfig.json、src/modules/、cypress/、バンドラー設定

レイアウト： backend/ と frontend/ を含むモノレポか、単一アプリか

ステップ 2 — モジュールのマッピング

ドメインを列挙します：

• バックエンド：モジュール、コントローラー、モデル、モジュールごとのマイグレーション
• フロントエンド：モジュールごとのページ、ストア、サービス

ステップ 3 — ルールへの準拠（任意）

ハーネスルールが存在する場合は、それらと照合します。対象は、バックエンドのモジュールレイアウト、マルチテナンシー、フロントエンドのパターン、テストです。行ごとに ✅／⚠️／❌ を付けます。

ハーネスルールがない場合は、技術スタックに依存しないチェックを使用します。

ステップ 4 — レポート

references/brownfield-map.template.md と references/agent-dense.md を使って、{product_root}/docs/context/brownfield-map.md の草案を作成します。

作成ルール：

• 表または一行の記述のみ。概要の段落は書きません。
• 技術スタックは architecture-rules.md への参照とし、必要に応じて差分を一行で記載します。
• ギャップは優先度順の表にします。次の計画は最大 3 項目の箇条書きにします。

保存前（必須）： ../ns-harness/references/agent-artifact-compress.md（caveman ultra）を適用してから、圧縮したファイルを書き込みます。

ステップ 5 — 提示

チャットでは要約のみを提示します（3～5 項目：日付、重大なギャップ、次のスキル）。マップ本文をチャットに貼り付けないでください。

重要なルール

• 読み取り専用 — コードは変更しません
• レポートの保存先は {product_root}/docs/context/ のみです
• brownfield-map.md をコンテキストとして ns-sdd-requirements-generator に渡します
• 既存のマップがある場合は重複させず、更新します
• architecture-rules.md の技術スタック全体を重複して記載しません

関連スキル

• ns-harness-architecture-rules — 規約（技術スタック／レイアウトの信頼できる情報源）
• ns-harness-codebase-reverse-spec — ビジネス動作の抽出（初期分析より詳細）
• ns-sdd-requirements-generator — 初期分析後の次のステップ
• ns-sdd-clarify-requirements — スコープがまだ曖昧な場合

参考資料

ファイル	使用時期
references/brownfield-map.template.md	ステップ 4 のひな形
references/agent-dense.md	作成上の制約
../ns-harness/references/agent-artifact-compress.md	保存前の圧縮（必須）