Aiwg rollback-workspace

Restore the .aiwg/ directory from a migrate-workspace backup, listing available backups when none is specified

install

source · Clone the upstream repo

git clone https://github.com/jmagly/aiwg

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/rollback-workspace" ~/.claude/skills/jmagly-aiwg-rollback-workspace && rm -rf "$T"

manifest: .agents/skills/rollback-workspace/SKILL.md

source content

Rollback Workspace

You restore the

.aiwg/

directory from a backup created by

migrate-workspace

. Lists available backups when no specific backup is named. The restore is safe — it will not overwrite artifacts that were created after the migration.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

"undo the migration" → rollback to most recent backup
"restore my workspace" → rollback to most recent backup
"what backups do I have?" → list available backups
"revert aiwg directory" → rollback to most recent backup

Trigger Patterns Reference

Pattern	Example	Action
Rollback latest	"roll back the workspace migration"	Run `aiwg rollback-workspace`
List backups	"what workspace backups exist?"	Run `aiwg rollback-workspace --list`
Specific backup	"restore from the backup made on April 1st"	Run `aiwg rollback-workspace --from .aiwg/.backup-20260401-1423`
Dry run	"preview the rollback"	Run `aiwg rollback-workspace --dry-run`
Force	"rollback workspace, skip confirmation"	Run `aiwg rollback-workspace --yes`

Behavior

When triggered:

List backups before restoring unless a specific backup is named or the user has already confirmed:
- Run
```
aiwg rollback-workspace --list
```
  to show what is available.
- If only one backup exists, propose it directly.
- If multiple backups exist, ask which one to restore.
Extract arguments:
- Is
```
--list
```
  requested? Show backups and stop.
- Is a specific
```
--from <path>
```
  given? Use that backup.
- Is
```
--dry-run
```
  requested? Show what would be restored, no changes.
- Has the user confirmed? Use
```
--yes
```
  to skip the interactive prompt.

Run the appropriate command:

# List available backups
aiwg rollback-workspace --list

# Preview rollback (no changes)
aiwg rollback-workspace --dry-run

# Rollback to most recent backup (prompts for confirmation)
aiwg rollback-workspace

# Rollback to specific backup
aiwg rollback-workspace --from .aiwg/.backup-20260401-1423

# Rollback, skip prompt
aiwg rollback-workspace --yes

Safety behaviour:
- Will not overwrite files that were created after the backup timestamp (new artifacts added post-migration are preserved).
- Conflicting files (same path, newer mtime) are reported rather than silently overwritten — the user decides.
- If no backup exists, reports clearly and suggests contacting support.
Report the result — confirm what was restored, list any skipped conflicts, and remind the user to run
```
aiwg status
```
to verify.

Examples

Example 1: List backups first

User: "Roll back my workspace migration"

Extraction: Rollback requested — list backups before applying

Action (step 1):

aiwg rollback-workspace --list

Response:

Available workspace backups:

  1. .aiwg/.backup-20260401-1423   (created 2026-04-01 14:23 UTC — before migration)
  2. .aiwg/.backup-20260320-0900   (created 2026-03-20 09:00 UTC — before migration)

Which backup would you like to restore from? (default: 1 — most recent)

After user selects → run

aiwg rollback-workspace --from .aiwg/.backup-20260401-1423

Example 2: Single backup, confirm and restore

User: "Undo the migration"

Extraction: One backup found, propose it

Action:

aiwg rollback-workspace --list
# One result → propose it
aiwg rollback-workspace --dry-run

Preview response:

Rollback Preview (from .aiwg/.backup-20260401-1423)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Would restore:
  .aiwg/frameworks/sdlc-complete/requirements/ → .aiwg/requirements/
  .aiwg/frameworks/sdlc-complete/architecture/ → .aiwg/architecture/
  (+ 6 more directories)

Files added after migration (will NOT be overwritten):
  .aiwg/requirements/UC-015.md  (newer than backup)

Proceed? [y/N]

After user confirms →

aiwg rollback-workspace --yes

Example 3: Dry run only

User: "Preview a workspace rollback"

Extraction: Dry-run only

Action:

aiwg rollback-workspace --dry-run

Response: Shows the planned restore table (as above) and stops. Does not prompt for confirmation.

Example 4: No backups available

User: "Roll back my workspace"

Extraction: No backups found

Action:

aiwg rollback-workspace --list

Response: "No workspace backups found in

.aiwg/

. Backups are created automatically when you run

aiwg migrate-workspace

. If you have a manual backup, specify its path with

aiwg rollback-workspace --from <path>

Example 5: Specific backup path

User: "Restore from the backup at .aiwg/.backup-20260320-0900"

Extraction: Explicit backup path given

Action:

aiwg rollback-workspace --from .aiwg/.backup-20260320-0900

Response: Runs the restore, reports what was moved back and any skipped conflicts. Confirms with

aiwg status

recommendation.

Clarification Prompts

If the user's intent is ambiguous:

"Which backup would you like to restore from? I found:
```
.backup-20260401-1423
```
,
```
.backup-20260320-0900
```
."
"Would you like me to preview the rollback first before applying it?"
"Files created after the migration will not be overwritten — is that OK, or do you need to handle those manually?"

References

@$AIWG_ROOT/src/cli/handlers/workspace.ts —
```
rollback-workspace
```
command handler
@$AIWG_ROOT/docs/cli-reference.md — CLI reference
@$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/migrate-workspace/SKILL.md — The migration this reverses