OpenSkillIndex← back to search
claude-code

Aiwg snapshot

Capture, list, show, or replay point-in-time workflow snapshots so execution state can be preserved and reproduced

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/snapshot" ~/.claude/skills/jmagly-aiwg-snapshot && rm -rf "$T"
manifest: .agents/skills/snapshot/SKILL.md
source content

Snapshot

You capture, list, show, or replay point-in-time workflow snapshots so that any execution state can be preserved and reproduced exactly.

Triggers

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

  • "freeze this state" → capture a snapshot
  • "show me all snapshots" → list snapshots
  • "what's in snapshot X" → show snapshot details
  • "run from that snapshot" → replay a snapshot
  • "save current state" → capture a snapshot

Trigger Patterns Reference

PatternExampleAction
Capture (named)"snapshot this as baseline-v1"Run 
aiwg snapshot capture --name baseline-v1
Capture (anonymous)"take a snapshot"Run 
aiwg snapshot capture
List"what snapshots exist?"Run 
aiwg snapshot list
Show details"show snapshot abc123"Run 
aiwg snapshot show abc123
Replay"replay snapshot baseline-v1"Run 
aiwg snapshot replay baseline-v1

Behavior

When triggered:

  1. Extract intent:

    • Which subcommand: 
      capture
      , 
      list
      , 
      show
      , or 
      replay
      ?
    • Is a name or snapshot ID provided?
    • For replay, does the user want to preview first or go directly?

  2. Run the appropriate subcommand:

    # Capture — anonymous
aiwg snapshot capture

# Capture — named
aiwg snapshot capture --name <name>

# List all snapshots
aiwg snapshot list

# Show details of a specific snapshot
aiwg snapshot show <id>

# Replay from a snapshot
aiwg snapshot replay <id>

  3. Snapshot contents: Each snapshot records:

    • AIWG version at capture time
    • Installed frameworks and their versions
    • Active execution mode and seed
    • Artifact checksums (
      .aiwg/
      directory)
    • Timestamp and optional name

  4. Storage: Snapshots are stored in 

    .aiwg/snapshots/
    as JSON files with a short content-addressed ID.

  5. Report the result — on capture, confirm the snapshot ID and name; on list, summarize available snapshots; on replay, confirm what is being restored.

Examples

Example 1: Capture a named snapshot

User: "Take a snapshot before we start the architecture phase — call it pre-arch"

Extraction: Capture subcommand, name 

pre-arch

Action:

aiwg snapshot capture --name pre-arch

Response: "Snapshot 

pre-arch
captured (ID: 
snap_a3f92d
). Recorded AIWG v2026.3.15, 2 frameworks, execution mode 
strict
, seed 42, and checksums for 14 artifacts. Stored at 
.aiwg/snapshots/snap_a3f92d.json
."

Example 2: List available snapshots

User: "What snapshots do we have?"

Extraction: List subcommand

Action:

aiwg snapshot list

Response:

ID            Name           Date                  AIWG Version
snap_a3f92d   pre-arch       2026-03-28 14:22:05   2026.3.15
snap_c71b4e   post-sad       2026-03-29 09:11:42   2026.3.15
snap_00f813   (unnamed)      2026-03-30 16:05:17   2026.3.15

Example 3: Show snapshot details

User: "What's in snapshot post-sad?"

Extraction: Show subcommand, ID/name 

post-sad

Action:

aiwg snapshot show post-sad

Response: "Snapshot 

post-sad
(ID: 
snap_c71b4e
) captured 2026-03-29 09:11:42. AIWG v2026.3.15, frameworks: sdlc-complete v2026.3.15, ring-methodology v2026.3.10. Execution mode: 
strict
, seed: 42. 18 artifacts checksummed."

Example 4: Replay a snapshot

User: "Replay from pre-arch"

Extraction: Replay subcommand, name 

pre-arch

Action:

aiwg snapshot replay pre-arch

Response: "Restoring from snapshot 

pre-arch
(snap_a3f92d). AIWG v2026.3.15 verified. Execution mode reset to 
strict
, seed 42. Artifact state restored. Ready to re-run the workflow from this point."

Clarification Prompts

If the user's intent is ambiguous:

  • "Should I capture a new snapshot, list existing ones, or replay a specific one?"
  • "Which snapshot would you like to replay? Run 
    aiwg snapshot list
    to see what's available."

References

  • @$AIWG_ROOT/src/cli/handlers/subcommands.ts — Snapshot command handler
  • @$AIWG_ROOT/docs/cli-reference.md — CLI reference
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/checkpoint/SKILL.md — Lightweight mid-workflow checkpoints (compare to snapshots)