name: sync version: "1.0.0" description: Syncs WDS skills from the current project (_bmad/wds/) to ~/.claude/commands/ so they work in any project. Called automatically on every agent activation.

agents: [saga, freya, mimir]

WDS Sync

Keeps ~/.claude/commands/ current with the WDS installation in the active project. Agents call this silently on every activation. Users can also call it directly.

Entry points

On agent activation — silent mode

First time (no global commands exist): ask the user once, then sync.
Subsequent activations: compare files, sync silently if changed, skip if identical.
Never block activation. If sync fails for any reason, continue.

Direct user request ("sync", "update WDS", "sync skills", "check for updates") — verbose, report each step.

Steps

1 — Locate project installation

Find _bmad/wds/ relative to the current project root.

If _bmad/wds/ does not exist:

Silent mode: stop silently.
Verbose mode: ⚠️ WDS not installed in this project. Run: npx bmad-method install

Store the source root: WDS_SRC = {project-root}/_bmad/wds

2 — Detect home directory

# Mac / Linux
HOME_DIR="$HOME"

# Windows (PowerShell)
$HOME_DIR = $env:USERPROFILE

Destination directories:

Commands: {HOME_DIR}/.claude/commands/
Tools: {HOME_DIR}/.claude/wds/tools/memory/
Data: {HOME_DIR}/.claude/wds/data/

3 — Check sync state

Check if {HOME_DIR}/.claude/commands/wrap.md exists.

First time (file missing): go to step 4 — ask user.

Already synced: compare {HOME_DIR}/.claude/commands/wrap.md to {WDS_SRC}/skills/wrap.md.

# Mac / Linux
diff -q "{HOME_DIR}/.claude/commands/wrap.md" "{WDS_SRC}/skills/wrap.md"

# Windows
Compare-Object (Get-Content "{HOME_DIR}\.claude\commands\wrap.md") (Get-Content "{WDS_SRC}\skills\wrap.md")

If identical: finish silently. If different: go to step 5 — sync silently.

4 — First time: ask user

Print exactly:

WDS is installed in this project but skills are not yet available globally.
Sync now? Adds /saga /freya /mimir /start /wrap /handoff to all Claude Code sessions.
[Y/n]

If n: stop. Do not ask again this session. If y (or Enter): go to step 5.

5 — Sync files

Create destination directories if they don't exist:

# Mac / Linux
mkdir -p "{HOME_DIR}/.claude/commands"
mkdir -p "{HOME_DIR}/.claude/wds/tools/memory"
mkdir -p "{HOME_DIR}/.claude/wds/data"

# Windows
New-Item -ItemType Directory -Force "{HOME_DIR}\.claude\commands"
New-Item -ItemType Directory -Force "{HOME_DIR}\.claude\wds\tools\memory"
New-Item -ItemType Directory -Force "{HOME_DIR}\.claude\wds\data"

Copy agent commands:

Source	Destination
`{WDS_SRC}/skills/saga.activation.md`	`{HOME_DIR}/.claude/commands/saga.md`
`{WDS_SRC}/skills/freya.activation.md`	`{HOME_DIR}/.claude/commands/freya.md`
`{WDS_SRC}/skills/mimir.activation.md`	`{HOME_DIR}/.claude/commands/mimir.md`
`{WDS_SRC}/skills/start.md`	`{HOME_DIR}/.claude/commands/start.md`
`{WDS_SRC}/skills/wrap.md`	`{HOME_DIR}/.claude/commands/wrap.md`
`{WDS_SRC}/skills/handoff.md`	`{HOME_DIR}/.claude/commands/handoff.md`

Copy tools and data:

Source	Destination
`{WDS_SRC}/tools/memory/SKILL.md`	`{HOME_DIR}/.claude/wds/tools/memory/SKILL.md`
`{WDS_SRC}/data/wds-glossary.md`	`{HOME_DIR}/.claude/wds/data/wds-glossary.md`
`{WDS_SRC}/data/agent-contracts.md`	`{HOME_DIR}/.claude/wds/data/agent-contracts.md`
`{WDS_SRC}/data/shared-activation.md`	`{HOME_DIR}/.claude/wds/data/shared-activation.md`

Skip any source file that does not exist — do not error.

6 — Report

First-time / direct call:

✓ WDS skills synced to ~/.claude/commands/
  /saga  /freya  /mimir  /start  /wrap  /handoff

Silent update (changes detected):

✓ WDS skills updated.

No changes (direct call only):

WDS skills are up to date.

Silent mode with no changes: no output.

SKILL.md 4.1 KB Riwayat Mentahan