Demo Skill

This skill manages the spec-kit staged demo environment using git worktrees and phase tags.

When to Use

Use this skill when the user asks to:

• •Set up / bootstrap / prepare the demo
• •Jump to / go to / switch to a phase
• •Clean up / delete / remove a demo
• •Reset the demo

Setup

Run from the repository root to create the demo environment:

# Auto-numbered (demo-01, demo-02, etc.)
.\.github\skills\demo\setup-demo.ps1

# Named demo
.\.github\skills\demo\setup-demo.ps1 -Name mcaps

This creates a demo folder (e.g., ../sdd-health-plan-chat-mcaps/) containing:

1. •live/ — Editable worktree for the demo
2. •phase-00-init/, phase-01-constitution/, etc. — Checkpoint worktrees (for offline resilience)

Setup Options

Jump to Phase

From within the live worktree, jump between phases while preserving work:

.\.github\skills\demo\jump-to-phase.ps1 -Phase <phase>

Safety:

• •The script refuses to run on main/master.
• •In a demo worktree, it runs without extra prompts.
• •Outside a worktree, it prints a warning (because changes may affect your main repo).

State preservation: When jumping away from a phase, uncommitted changes are stashed. When returning, they're automatically restored.

Stash identity: Stashes are labeled as demo[<name>]:<phase-tag>.

• •If you are on a demo/<name> branch, <name> comes from the branch.
• •Otherwise (common in spec-kit demos), <name> is derived from the demo folder name (e.g., ../sdd-health-plan-chat-dry-run/live → dry-run).

Phase Identifiers

Jump Options

Examples

# Jump to plan phase (preserves current work)
.\.github\skills\demo\jump-to-phase.ps1 -Phase plan

# Jump to phase 5.3 and discard changes
.\.github\skills\demo\jump-to-phase.ps1 -Phase 5.3 -Reset

# Jump using full tag name
.\.github\skills\demo\jump-to-phase.ps1 -Phase phase/03-plan

After Setup

1. •Open the live worktree: code ../sdd-health-plan-chat-<name>/live
2. •Jump between phases as needed during the demo
3. •Use -Reset on setup-demo.ps1 to start fresh

Cleanup

Remove a demo environment (folders, branch, and stashes):

# Clean up a specific demo
.\.github\skills\demo\cleanup-demo.ps1 -Name mcaps

# Clean up all demos
.\.github\skills\demo\cleanup-demo.ps1 -All

Cleanup Options