framework-upgradelisted
Install: claude install-skill joris887/exosuit
______________________________________________________________________
## framework-upgrade
Upgrades the Exosuit framework to a newer version while preserving all project-specific customizations (skills, rules, hooks, settings).
### Phase 0: Validate & Discover
1. **Fetch new framework version:**
- **Default (no argument or `--branch <branch>`):** Clone the framework repo from GitHub into a temp directory. Use `main` branch unless `--branch` specifies otherwise.
```bash
FRAMEWORK_REPO="https://github.com/joris887/exosuit.git"
TEMP_DIR=$(mktemp -d)
git clone --depth 1 [--branch <branch>] "$FRAMEWORK_REPO" "$TEMP_DIR"
```
- **Local path override:** If `$ARGUMENTS` is a directory path, use it directly (for testing local changes before pushing).
- **Validate:** The source (cloned or local) must contain `.claude/skills/`, `.claude/hooks/`, `CLAUDE.md`.
1. **Current version** — Read `SKILLS_INVENTORY.md`, extract `Framework Version:` line. Record as `CURRENT_VERSION`.
1. **New version** — Read `<source>/CHANGELOG.md` or `<source>/.claude/skills/SKILLS_INVENTORY.md` for version. Record as `NEW_VERSION`.
1. **Git safety** — Verify working tree is clean (`git status --porcelain`). If dirty, HALT: "Commit or stash changes before upgrading."
1. **Report**: "Upgrading framework: v{CURRENT} → v{NEW}. Source: {GitHub main | GitHub branch | local path}. Branch: {branch}."
1. **Parse Version Log:**
Read `CHANGELOG.md` from the new framework version.