name	demo
description	Bootstrap and navigate the spec-kit demo environment. Use this when asked to set up the demo, bootstrap the demo, jump to a phase, go to a phase, switch phases, or clean up a demo.

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:

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

Setup Options

Option	Description
`-Name <name>`	Name for the demo (creates `<repo>-<name>`)
`-SkipCheckpoints`	Create only the live worktree
`-Reset`	Remove existing worktrees and recreate
`-WorktreeRoot <path>`	Override full path for demo folder

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

Number	Name	Tag
`0`	`init`	`phase/00-init`
`1`	`constitution`	`phase/01-constitution`
`2`	`spec`	`phase/02-spec`
`3`	`plan`	`phase/03-plan`
`4`	`tasks`	`phase/04-tasks`
`5.1`	`setup`	`phase/05-implement/01-setup`
`5.2`	`foundational`	`phase/05-implement/02-foundational`
`5.3`	`us1`	`phase/05-implement/03-ask-plan-questions`
`5.4`	`us2`	`phase/05-implement/04-handle-missing-answers`
`5.5`	`us3`	`phase/05-implement/05-ui`
`5.6`	`docs`	`phase/05-implement/06-documentation`

Jump Options

Option	Description
`-Phase <id>`	Phase number, name, or full tag
`-Reset`	Discard changes instead of stashing; skip restore

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

Open the live worktree: code ../sdd-health-plan-chat-<name>/live
Jump between phases as needed during the demo
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

Option	Description
`-Name <name>`	Name of the demo to remove
`-All`	Remove all demo environments
`-KeepStashes`	Preserve stashes (only remove folders and branches)

name	demo
description	Bootstrap and navigate the spec-kit demo environment. Use this when asked to set up the demo, bootstrap the demo, jump to a phase, go to a phase, switch phases, or clean up a demo.