Upgrade Skill

Updates your vault's system files to the latest version while preserving all your personal content.

Usage

/upgrade          # Interactive upgrade with backup and diff review
/upgrade check    # Preview what's changed without making modifications

What Gets Updated (System Files)

• .claude/skills/*/SKILL.md, Skill definitions
• .claude/agents/*.md, Agent configurations
• .claude/hooks/*.sh, Automation scripts
• .claude/rules/*.md, Convention rules
• .claude/output-styles/*.md, Output style definitions
• .claude/settings.json, Permissions and hook config
• CLAUDE.md, Root context file (merged carefully)
• Templates/*.md, Note templates

What Never Gets Touched (Your Content)

• Daily Notes/**, Your daily journal entries
• Goals/**, Your goal files and reviews
• Projects/**, Your project folders and CLAUDE.md files
• Archives/**, Your archived content
• Inbox/**, Your captured items
• CLAUDE.local.md, Your personal overrides
• vault-config.json, Your preferences

Upgrade Process

Step 1: Check for Updates

Read the current version from CLAUDE.md (look for "System Version:" line).

Compare with the upstream repo. If using git:

git fetch origin
git log HEAD..origin/main --oneline

If not a git repo or no remote, inform user they need to download the latest vault-template/ manually.

Step 2: Create Backup

Before any changes, create a timestamped backup:

BACKUP_DIR=".backup/upgrade-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BACKUP_DIR"
cp -r .claude "$BACKUP_DIR/"
cp CLAUDE.md "$BACKUP_DIR/"
cp -r Templates "$BACKUP_DIR/" 2>/dev/null

Tell the user: "Backup created at $BACKUP_DIR"

Step 3: Diff Review