Checkpoint

要約: 開発作業のセーフポイントを提供。作成・復元・比較をサポート。

📌 コマンド

/checkpoint create (REQ-CP-001)

WHEN /checkpoint create <name> 実行
DO 以下を順次実行

•Quick検証（/verify quick）
•Git commit/stash作成
•ログ記録

bash

# 未コミット変更がある場合
git stash push -m "checkpoint: <name>"
# または
git add -A && git commit -m "checkpoint: <name>"

出力:

code

📍 Checkpoint: <name>
━━━━━━━━━━━━━━━━━━━━
✅ Verification: PASS
✅ Git: abc1234
✅ Logged
━━━━━━━━━━━━━━━━━━━━
Time: 2026-01-25 14:30

/checkpoint verify (REQ-CP-002)

WHEN /checkpoint verify <name> 実行
DO チェックポイントとの差分を報告

項目	計算
変更ファイル数	`git diff --stat <sha>..HEAD`
テスト合格率	現在 vs チェックポイント時
カバレッジ	現在 vs チェックポイント時
ビルド状態	現在のビルド結果

出力:

code

📊 Verify: <name> (abc1234)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| Metric   | Checkpoint | Current | Change |
|----------|------------|---------|--------|
| Tests    | 42/42      | 45/45   | +3 ✅  |
| Coverage | 85%        | 87%     | +2% ✅ |
| Build    | PASS       | PASS    | -      |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Status: ✅ Quality maintained

/checkpoint list (REQ-CP-003)

WHEN /checkpoint list 実行
DO 全チェックポイントを表示

code

📋 Checkpoints
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| Name                    | Time       | SHA     |
|-------------------------|------------|---------|
| feature-auth-complete   | 01-25 14:30| abc1234 |
| before-migration        | 01-25 10:00| def5678 |
| fix-123-done            | 01-24 16:45| ghi9012 |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/checkpoint restore (REQ-CP-004)

WHEN /checkpoint restore <name> 実行
DO 安全に復元

復元前チェック:

•未コミット変更 → stash/commit確認
•復元後 → /verify quick 提案

📁 Storage (REQ-CP-005)

パス	内容
`~/.musubix/checkpoints/checkpoints.log`	メタデータ
保持数	最新10件（超過時は古いものを整理）

ログ形式: YYYY-MM-DD-HH:MM | <name> | <sha>

🏷️ 命名規則

パターン	例
`feature-<name>-<state>`	`feature-auth-complete`
`fix-<issue>-<state>`	`fix-123-done`
`before-<action>`	`before-migration`
`after-<action>`	`after-refactor`

トレーサビリティ

•REQ-CP-001: Checkpoint Creation
•REQ-CP-002: Checkpoint Verification
•REQ-CP-003: Checkpoint Listing
•REQ-CP-004: Checkpoint Restore
•REQ-CP-005: Checkpoint Retention & Location