← ClaudeAtlas

para-upgradelisted

Bring a vault in line with a newer para-os template revision - reads the vault's template marker, diffs it against a para-os clone at an explicit ref, then applies the intervening changelog entries as a reviewed migration (structure, skeleton files, stale rule and integration-script copies, and rule-driven content violations). Use when the user asks to "upgrade the vault", "align this vault to para-os", "is this vault on the latest structure", "apply the new para-os structure", or types /para-upgrade.
Vinedine/para-os · ★ 4 · Data & Documents · score 73
Install: claude install-skill Vinedine/para-os
# Para upgrade Aligns one vault to a para-os template revision. This is the **migration** skill: it changes what the vault's rules *are*. `/para-deep-clean` is the **conformance** skill: it checks the vault against the rules it already has. Run this one first when both are due, or the deep clean audits against a stale contract. ## Arguments | Arg | Behavior | |---|---| | *(none)* | Full flow against the default ref | | `--ref <git-ref>` | Read the master from this ref instead of the default (a branch, tag, or commit). Also accepted as a bare positional argument (`/para-upgrade feat/revision-x`) or with a leading qualifier word (`local feat/revision-x`) - either resolves to `<git-ref>` in the clone, same as `--ref`. | | `audit` | Read-only. Reports the delta and what would change; never modifies a file | | `--test` | Test run, see [para-shared/test-run.md](../para-shared/test-run.md). | | any other `--` argument | Stops the run: name it and show this table. Never read as a ref, bare or not. | ## Preconditions 1. **A local para-os clone.** Ask the user for its path if it isn't obvious; do not guess. Every master is read from it, per [references/delta.md](references/delta.md). 2. **An explicit ref, defaulting to `origin/stable`,** what users get; `origin/main` is where work merges before a release. Run `git fetch` first so `origin/stable` is current. With no ref named, a clone not on `stable` (the Phase 0 scan's `clone.checked_out.branch`, or its exit 5) was made before rel