sdd-explore

sdd-explore

変更に着手する前に、アイデアやコードベースの領域を調査・分析します。

トリガー: /sdd-explore <topic>、探索、コードベースの調査、変更前の分析、機能のリサーチ

---

目的

EXPLORE は、そこから先に進む SDD サイクルにおいて必須のゲートです。propose、spec、design、tasks、apply の前に実行され、引用を含む永続化された成果物を生成します。EXPLORE が成果物をディスクに書き込むまで、後続のフェーズを開始できません。コードは作成せず、何も変更しません。読み取りと分析のみを行います。

スキルの解決

オーケストレーターがこのサブエージェントを起動すると、次の方法でスキルのパスを解決します。

1. .claude/skills/sdd-explore/SKILL.md     (project-local — highest priority)
2. ~/.claude/skills/sdd-explore/SKILL.md   (global catalog — fallback)

プロジェクトローカルのスキルは、グローバルカタログより優先されます。完全なアルゴリズムについては、docs/SKILL-RESOLUTION.md を参照してください。

---

---

Claude の実行設定

以下の注記では、上記のツールに依存しないロジックを Claude Code ハーネスに結び付けます。 これは、ほかのツールには移植できない実行レイヤーです。

• ステップ 0 の事前読み込み — skills/_shared/sdd-phase-common.md のセクション F （プロジェクトコンテキストの読み込み）とセクション G（Spec コンテキストの事前読み込み）に従います。どちらもブロッキングではありません。EXPLORE 固有のオーバーライド（ai-context/features/<domain>.md と ai-context/architecture.md の読み取りを必ず試み、不在の場合は表示可能な INFO: 注記を出力すること）は意図的なものであり、 _shared/sdd-phase-common.md のセクション G は変更しません。
• 引き継ぎコンテキストの事前読み込み — engram に事前シードされた proposal があるか mem_search(query: "sdd/<slug>/proposal") で確認し、存在する場合は mem_get_observation(id) で取得します。Handoff context loaded from engram: sdd/<slug>/proposal をログに記録します。ブロッキングではありません。
• 過去の試行のスキャン — mem_search(query: "sdd/archive-report", project: "{project}") で engram を検索し、関連する結果をそれぞれ mem_get_observation(id) で取得して、結果を確認します。
• 成果物の永続化（ステップ 8、ディスクを一次保存先とする） — skills/_shared/sdd-phase-common.md のセクション Cに従います。最初に Write("docs/sdd/{change-name}/explore.md", <full exploration markdown>) を実行し、次に topic_key: sdd/{change-name}/explore、 type: architecture、project: {project} を指定してポインターと要約を mem_save します。Engram MCP に到達できない場合も、ディスク上の成果物（信頼できる情報源）は書き込み、engram のポインターの作成のみを省略します。
• オーケストレーターへの出力 — オーケストレーターが期待する JSON ブロックとして、中立的な Output Contract を返します。artifacts にはディスクのパスとともに engram:sdd/{change-name}/explore を含め、手動で行う次のステップは /sdd-propose とします。