sdd-archive

sdd-archive

完了した SDD 変更をクローズし、アーカイブレポートを保存します。

トリガー: /sdd-archive <change-name>、変更をアーカイブ、SDD サイクルを完了、変更をクローズ、SDD アーカイブ

---

目的

アーカイブは、SDD サイクルの最終ステップです。完全性を検証し、完了記録を保存して、プロジェクトのメモリレイヤーを更新します。これは取り消せないため、実行前にユーザーに確認します。

スキルの解決

プロジェクトローカル → グローバルの順です。

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

アルゴリズムの詳細については、docs/SKILL-RESOLUTION.md を参照してください。

---

---

Claude の実行設定

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

• 完全性／レガシーへのフォールバック — ディスク上のファイルの有無を優先します。ディスク上にファイルがない場合は、mem_search(query: "sdd/{change-name}/{type}") にフォールバックします。mem_search が結果を返した場合、成果物は存在するとみなします。
• 検証レポートの読み取り — ハーネスの Read("docs/sdd/{change-name}/verify-report.md") を使用します。 ディスク上にファイルがない場合（レガシー変更）、mem_search(query: "sdd/{change-name}/verify-report") → mem_get_observation(id) にフォールバックします。
• ステップ 4 の完了記録の保存 — まずディスクに保存し、その後で Write("docs/sdd/{change-name}/archive-report.md", <closure summary>) を実行し、次に topic_key: sdd/{change-name}/archive-report、 type: architecture、project: {project} を指定して mem_save でポインターを保存します。Engram MCP に到達できない場合は、ディスク上の成果物のみを書き込み、Engram のポインターはスキップします。
• ステップ 5 のメモリ更新 — ~/.claude/skills/memory-manage/SKILL.md を読み、「update」プロセスをインラインで実行します。失敗しても処理はブロックされません。
• ステップ 6 の前提条件 (a) — mem_search(topic_key: "sdd/<change>/archive-report", project: <canonical-project>) を呼び出します。見つからない場合は、ブロックする前に mem_save をもう一度試します。移動には Write("docs/sdd/_archived/<change>-archive-report.md", ...) を使用し、削除には git rm -r docs/sdd/<change>/ の後に rm -rf docs/sdd/<change>/ を実行します。
• 対応可能なティアへの委任 — 軽量ティアは model: haiku です。成果物の作成サブステップ（ステップ 3）は、新しく起動する model: fable のサブエージェントに必ず委任する必要があります（オーケストレーターはモデルのフォールバックチェーンに従って sonnet に置き換えます）。それ以外のサブステップはすべて model: haiku のままです。作成された成果物が ~/.claude/ に配置されるのは、手動で install.sh を実行した後です。
• オーケストレーターの出力 — オーケストレーターが期待する JSON ブロックとして、中立的な出力コントラクトを返します。artifacts には engram:sdd/{change-name}/archive-report が含まれます。