sdd-design

sdd-design

アーキテクチャ上の決定、データフロー、ファイル変更計画を含む技術設計を作成します。

トリガー: /sdd-design <change-name>、技術設計、変更アーキテクチャ、sdd 設計

---

目的

設計では、仕様でシステムに求められていることをどのように実装するかを定義します。要件とコードをつなぐ橋渡しとなります。技術的な決定とその根拠を記録します。

スキルの解決

オーケストレーターがこのサブエージェントを起動すると、スキルのパスをプロジェクトローカル、グローバルの順に解決します。

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

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

---

---

Claude の実行設定

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

• ステップ 0 の事前読み込み — skills/_shared/sdd-phase-common.md のセクション F （プロジェクトコンテキストの読み込み）とセクション G（仕様コンテキストの事前読み込み）に従います。ブロッキングではありません。
• アーティファクトの読み込み — 提案と仕様には、ハーネスの Read("docs/sdd/{change-name}/<artifact>.md") ツールを使用します。ディスク上にファイルがない場合（レガシー変更）は、 mem_search(query: "sdd/{change-name}/<artifact>") → mem_get_observation(id) の順にフォールバックします。どちらも存在せず、Engram に到達できない場合は、 オーケストレーターからコンテンツがインラインで渡されます。
• スキルレジストリとの相互参照 — ツールに依存しない「プロジェクトの技術ガイダンス」は、~/.claude/skills/ のグローバルカタログと、プロジェクトローカルの .claude/skills/ に解決されます。プロジェクトに登録されていないカタログスキルには、[optional — not registered in project; add via /skill-create <name>] のマークを付けます。
• 設計の永続化 — まずハーネスの Write("docs/sdd/{change-name}/design.md", <full design markdown>) を使ってアーティファクトを書き込み、その後、topic_key: sdd/{change-name}/design、 type: architecture、project: {project}、content = "path: docs/sdd/{change-name}/design.md\n\n{1-3 sentence summary}" を指定して、ポインターと要約を mem_save で保存します。Engram MCP に到達できない場合も、ディスク上のアーティファクトは書き込み、Engram のポインターの保存のみを省略します。
• ADR の生成（ステップ 4） — ハーネスのファイルツール（Read／Write／Edit）を使ってコピーと編集を行います。ブロッキングではなく、失敗しても警告のみです。
• オーケストレーターへの出力 — オーケストレーターが想定する JSON ブロックとして、ツールに依存しない出力契約を返します。アーティファクト一覧には、ディスク上のパスとともに Engram ポインター engram:sdd/{change-name}/design を記載し、次の手動ステップは /sdd-tasks <change-name> とします。