rollback

Rollback Skill

User-invocable skill for checkpoint management and PDCA state rollback.

Arguments

Argument	Description	Example
(none)	List available checkpoints (same as list)	/rollback
list	List all available checkpoints	/rollback list
to <checkpoint-id>	Restore to a specific checkpoint	/rollback to cp-1710842700000
phase	Rollback to previous PDCA phase	/rollback phase
reset <feature>	Reset feature to initial (idle) state	/rollback reset user-auth

Action Details

list (Default)

List all available checkpoints for the current or specified feature.

1. Read checkpoint metadata from .bkit/checkpoints/
2. Filter by current active feature (or show all if no active feature)
3. Sort by timestamp (newest first)
4. Display formatted checkpoint list

Checkpoint Metadata Schema:

{
  "id": "cp-1710842700000",
  "feature": "user-auth",
  "phase": "design",
  "type": "auto",
  "timestamp": "2026-03-19T10:30:00.000Z",
  "description": "Auto-checkpoint before Do phase",
  "pdcaStatus": { "phase": "design", "matchRate": 0, "iterationCount": 0 },
  "files": ["docs/02-design/features/user-auth.design.md"]
}

Output Format:

--- Checkpoints: user-auth ------------------------
ID                    Phase    Type   Date                Description
cp-1710842700000      design   auto   2026-03-19 10:30   Before Do phase
cp-1710839100000      plan     auto   2026-03-19 09:25   Before Design phase
cp-1710835500000      idle     manual 2026-03-19 08:15   Manual save point
---------------------------------------------------
Total: 3 checkpoints

Usage: /rollback to cp-1710842700000

to

Restore state to a specific checkpoint.

1. Validate the checkpoint ID exists in .bkit/checkpoints/
2. Read the checkpoint metadata and saved state
3. Display what will be restored (phase, files, status)
4. Require user confirmation via AskUserQuestion (always, regardless of automation level)
5. On confirmation: a. Create a safety checkpoint of current state (before rollback) b. Restore pdca-status.json to the checkpoint's saved state c. Restore any saved file snapshots d. Write audit log: checkpoint_restored e. Display confirmation with restored state
6. On rejection: Cancel and display current state