From a15689f2a2fca335f87f35e05f0053edbe4fb690 Mon Sep 17 00:00:00 2001 From: zbl1998-sdjn <259537290+zbl1998-sdjn@users.noreply.github.com> Date: Thu, 16 Jul 2026 00:44:59 +1000 Subject: [PATCH] docs(setup): fix pre-Magpie migration steps that became no-ops The "Migrating a pre-Magpie adopter" section in docs/setup/install-recipes.md tells an adopter how to move off the old apache-steward layout, but the steward -> magpie rename sweep also replaced the source-side names. The steps now move/rename paths to themselves; step 3 reads "move ~/.config/apache-magpie/ to ~/.config/apache-magpie/", a no-op. Restore the old-layout (source-side) names to apache-steward. The mapping is the one recorded in d856ce2 (#440): the XDG config dir moved ~/.config/apache-steward/ -> ~/.config/apache-magpie/, and it is still the migration skills/setup/upgrade.md performs. Destination paths stay apache-magpie. Applies the same source-side fix to the section heading/intro, step 1, and step 2's overrides-preserve clause; the TOC anchor is updated to match the renamed heading. Fixes #867 --- docs/setup/install-recipes.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/setup/install-recipes.md b/docs/setup/install-recipes.md index 6df992b4..095af580 100644 --- a/docs/setup/install-recipes.md +++ b/docs/setup/install-recipes.md @@ -11,7 +11,7 @@ - [Method 3 — git branch (defaults to `main`)](#method-3--git-branch-defaults-to-main) - [After any recipe — let the skill take over](#after-any-recipe--let-the-skill-take-over) - [Subsequent runs and drift detection](#subsequent-runs-and-drift-detection) - - [Migrating a pre-Magpie (`apache-magpie`) adopter](#migrating-a-pre-magpie-apache-magpie-adopter) + - [Migrating a pre-Magpie (`apache-steward`) adopter](#migrating-a-pre-magpie-apache-steward-adopter) @@ -262,26 +262,26 @@ and updates the local lock. See [`setup/upgrade.md`](../../skills/setup/upgrade.md) for the full flow. -## Migrating a pre-Magpie (`apache-magpie`) adopter +## Migrating a pre-Magpie (`apache-steward`) adopter A repo that adopted the framework **before** it was renamed from -`apache-magpie` to **Apache Magpie** is on the old layout: a committed -`.claude/skills/magpie-setup/` skill, an `.apache-magpie/` snapshot, -`.apache-magpie.lock` / `.apache-magpie-overrides/`, un-prefixed -framework symlinks, and `~/.config/apache-magpie/`. The framework +`apache-steward` to **Apache Magpie** is on the old layout: a committed +`.claude/skills/setup-steward/` skill, an `.apache-steward/` snapshot, +`.apache-steward.lock` / `.apache-steward-overrides/`, un-prefixed +framework symlinks, and `~/.config/apache-steward/`. The framework **no longer ships an automated migration** for this layout — migrate by hand: -1. Remove the legacy in-repo artefacts: `.apache-magpie*` (snapshot, +1. Remove the legacy in-repo artefacts: `.apache-steward*` (snapshot, locks, overrides), any un-prefixed framework symlinks under the - skills dir, and the committed `.claude/skills/magpie-setup/` skill. + skills dir, and the committed `.claude/skills/setup-steward/` skill. 2. Re-adopt from scratch with `/magpie-setup` (see [`setup/adopt.md`](../../skills/setup/adopt.md)) so the current `.apache-magpie*` layout and `magpie-`-prefixed symlinks are written - fresh. Preserve any `.apache-magpie-overrides/*.md` you want to keep + fresh. Preserve any `.apache-steward-overrides/*.md` you want to keep by moving them into the new `.apache-magpie-overrides/` first. -3. Move `~/.config/apache-magpie/` (per-user) to - `~/.config/apache-magpie/`, and update any `~/.config/apache-magpie/` +3. Move `~/.config/apache-steward/` (per-user) to + `~/.config/apache-magpie/`, and update any `~/.config/apache-steward/` entry in your Claude Code sandbox allowlist (project `.claude/settings.local.json` / `.claude/settings.json` or user-scope `~/.claude/settings.json`) to `~/.config/apache-magpie/` — otherwise