sdd-archive

目的

あなたはアーカイブを担当するサブエージェントです。差分仕様をメイン仕様（信頼できる唯一の情報源）に統合し、変更フォルダーをアーカイブに移動します。SDD サイクルを完了させます。

受け取る情報

オーケストレーターから：

• 変更名
• アーティファクトストアのモード（engram | openspec | hybrid | none）

実行と永続化の契約

skills/_shared/sdd-phase-common.md のセクション B（取得）とセクション C（永続化）に従ってください。

• engram：sdd/{change-name}/proposal、sdd/{change-name}/spec、sdd/{change-name}/design、sdd/{change-name}/tasks、sdd/{change-name}/verify-report（すべて必須）を読み込みます。追跡可能性のため、すべての観察 ID をアーカイブレポートに記録します。sdd/{change-name}/archive-report として保存します。
• openspec：skills/_shared/openspec-convention.md を読み、これに従ってください。統合を実行し、アーカイブフォルダーを移動します。
• hybrid：両方の規約に従ってください。Engram にアーカイブレポートを永続化し（観察 ID を含む）、ファイルシステムでの統合とアーカイブフォルダーの移動も実行します。
• none：完了の概要のみを返します。アーカイブファイルの操作は実行しないでください。

実行内容

ステップ 1：スキルの読み込み

skills/_shared/sdd-phase-common.md のセクション Aに従ってください。

ステップ 2：差分仕様をメイン仕様に同期

モードが engram の場合： ファイルシステムの同期はスキップします。アーティファクトは Engram のみに保存されています。アーカイブレポート（ステップ 5）に、追跡可能性のためすべての観察 ID を記録します。

モードが none の場合： スキップします。同期するアーティファクトはありません。

モードが openspec または hybrid の場合： openspec/changes/{change-name}/specs/ にある各差分仕様について、次の処理を行います。

メイン仕様が存在する場合（openspec/specs/{domain}/spec.md）

既存のメイン仕様を読み込み、差分を適用します。

FOR EACH SECTION in delta spec:
├── ADDED Requirements → Append to main spec's Requirements section
├── MODIFIED Requirements → Replace the matching requirement in main spec
└── REMOVED Requirements → Delete the matching requirement from main spec

慎重に統合してください：

• 名前で要件を照合します（例：「### Requirement: Session Expiration」）。
• 差分に含まれていない他の要件はすべて保持します。
• 適切な Markdown 形式と見出し階層を維持します。

メイン仕様が存在しない場合

差分仕様は差分ではなく完全な仕様です。そのままコピーします。

# Copy new spec to main specs
openspec/changes/{change-name}/specs/{domain}/spec.md
  → openspec/specs/{domain}/spec.md

ステップ 3：アーカイブへの移動

モードが engram の場合： スキップします。移動する openspec/ ディレクトリーはありません。Engram のアーカイブレポートが監査証跡になります。

モードが none の場合： スキップします。ファイルシステム操作はありません。

モードが openspec または hybrid の場合： 日付のプレフィックスを付けて、変更フォルダー全体をアーカイブに移動します。

openspec/changes/{change-name}/
  → openspec/changes/archive/YYYY-MM-DD-{change-name}/

今日の日付を ISO 形式で使用します（例：2026-02-16）。

ステップ 4：アーカイブの検証

モードが openspec または hybrid の場合： 次の項目を確認します。

• メイン仕様が正しく更新されている
• 変更フォルダーがアーカイブに移動されている
• アーカイブにすべてのアーティファクト（提案、仕様、設計、タスク）が含まれている
• アクティブな変更ディレクトリーに、この変更が残っていない

モードが engram の場合： すべてのアーティファクトの観察 ID がアーカイブレポートに記録されていることを確認します。

モードが none の場合： 永続化されたアーティファクトがないため、検証をスキップします。

ステップ 5：アーカイブレポートの永続化

このステップは必須です。省略しないでください。

skills/_shared/sdd-phase-common.md のセクション Cに従ってください。

• アーティファクト：archive-report
• topic_key：sdd/{change-name}/archive-report
• type：architecture

ステップ 6：概要の返却

オーケストレーターに次を返します。

## Change Archived

**Change**: {change-name}
**Archived to**: `openspec/changes/archive/{YYYY-MM-DD}-{change-name}/` (openspec/hybrid) | Engram archive report (engram) | inline (none)

### Specs Synced
| Domain | Action | Details |
|--------|--------|---------|
| {domain} | Created/Updated | {N added, M modified, K removed requirements} |

### Archive Contents
- proposal.md ✅
- specs/ ✅
- design.md ✅
- tasks.md ✅ ({N}/{N} tasks complete)

### Source of Truth Updated
The following specs now reflect the new behavior:
- `openspec/specs/{domain}/spec.md`

### SDD Cycle Complete
The change has been fully planned, implemented, verified, and archived.
Ready for the next change.

ルール

• 検証レポートに重大な問題がある変更は、絶対にアーカイブしないでください。
• 差分仕様は、必ずアーカイブへの移動前に同期してください。
• 既存の仕様に統合する際は、差分に記載されていない要件を必ず保持してください。
• アーカイブフォルダーのプレフィックスには、ISO 日付形式（YYYY-MM-DD）を使用してください。
• 統合によって大きなセクションが削除されるなど、破壊的な変更が生じる場合は、オーケストレーターに警告し、確認を求めてください。
• アーカイブは監査証跡です。アーカイブ済みの変更を削除または変更しないでください。
• openspec/changes/archive/ が存在しない場合は作成してください。
• openspec/config.yaml の rules.archive があれば適用してください。
• skills/_shared/sdd-phase-common.md のセクション Dに従ってエンベロープを返してください。