archive

archive スキルは、ship（シップ）時にアクティブなステージング仕様書をリビングドキュメントに統合し、プロジェクト記録を整理・保管するために実行されます。

主な役割

1. リビングドキュメントの同期: docs/staging/specs/YYYY-MM-DD-<topic>.md を docs/tech-spec.md（または docs/specs/ 配下のサブ仕様書）に統合します。
2. ステージングのクリーンアップ: 変更が検証されマージされた後、ステージング仕様書と計画ファイルを削除します。
3. 意思決定記録の保存: 調査過程で生成された知識アーティファクトやアーキテクチャの意思決定を docs/decisions/ に保存します。
4. ロードマップと変更履歴: docs/ROADMAP.md のマイルストーン状態（[x]）を更新し、CHANGELOG.md にバージョン履歴を記録します。

ワークフローゲート

<gate> アーカイブを行う前に、ステージング仕様書が実際のコードの挙動を正確に反映している必要があります。リビングドキュメントの更新は、標準フィールド形式（purpose, user, use-case, architecture, stack, entry, contract, flow, invariant, constraint, convention）に従う必要があります。 </gate>