[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-apache-magpie-setup":3,"mdc--j56mi-key":37,"related-org-apache-magpie-setup":3570,"related-repo-apache-magpie-setup":3724},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":19,"repoUrl":20,"updatedAt":21,"license":22,"forks":23,"topics":24,"repo":32,"sourceUrl":35,"mdContent":36},"magpie-setup","adopt and maintain magpie framework","Adopt and maintain the apache-magpie framework in a project\nrepo via the snapshot-based adoption mechanism. The only\nframework skill committed in an adopter's repo; every other\nskill is a symlink the adopt sub-action wires up.\nSub-actions:\n `\u002Fmagpie-setup` - first-time adoption (default; main-checkout only)\n `\u002Fmagpie-setup upgrade` - refresh the gitignored snapshot per the committed lock (main-checkout only)\n `\u002Fmagpie-setup worktree-init` - symlink a worktree's snapshot to the main's\n `\u002Fmagpie-setup verify` - health check + drift detection\n `\u002Fmagpie-setup skill-sources` - fetch\u002Fpin\u002Fsymlink skills from trusted external sources listed in the adopter trust list (main-checkout only)\n `\u002Fmagpie-setup override \u003Cskill>` - open or scaffold an agentic override in `.apache-magpie-overrides\u002F`\n `\u002Fmagpie-setup unadopt` - reverse the adoption (snapshot, locks, symlinks, hook, doc sections); preserves `.apache-magpie-overrides\u002F` by default (main-checkout only)\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"apache","Apache Software Foundation","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fapache.png",[12,16],{"name":13,"slug":14,"type":15},"Architecture","architecture","tag",{"name":17,"slug":18,"type":15},"Engineering","engineering",61,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fmagpie","2026-07-12T08:33:13.756079","Apache-2.0",42,[25,8,26,27,28,29,30,31],"agent-skills","automation","claude-code","cve","security","vulnerability-disclosure","vulnerability-management",{"repoUrl":20,"stars":19,"forks":23,"topics":33,"description":34},[25,8,26,27,28,29,30,31],"Agent-assisted maintainership and development framework for Apache projects — Triage, Mentoring, Drafting (agent-authored fixes with human review), and Pairing (developer-side dev-cycle) skills shipping; Agentic Autonomous (auto-merge) on the roadmap.","https:\u002F\u002Fgithub.com\u002Fapache\u002Fmagpie\u002Ftree\u002FHEAD\u002Fskills\u002Fsetup","---\n# SPDX-License-Identifier: Apache-2.0\n# https:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\nname: magpie-setup\nfamily: setup\nmode: Meta\ndescription: |\n Adopt and maintain the apache-magpie framework in a project\n repo via the snapshot-based adoption mechanism. The only\n framework skill committed in an adopter's repo; every other\n skill is a symlink the adopt sub-action wires up.\n Sub-actions:\n `\u002Fmagpie-setup` - first-time adoption (default; main-checkout only)\n `\u002Fmagpie-setup upgrade` - refresh the gitignored snapshot per the committed lock (main-checkout only)\n `\u002Fmagpie-setup worktree-init` - symlink a worktree's snapshot to the main's\n `\u002Fmagpie-setup verify` - health check + drift detection\n `\u002Fmagpie-setup skill-sources` - fetch\u002Fpin\u002Fsymlink skills from trusted external sources listed in the adopter trust list (main-checkout only)\n `\u002Fmagpie-setup override \u003Cskill>` - open or scaffold an agentic override in `.apache-magpie-overrides\u002F`\n `\u002Fmagpie-setup unadopt` - reverse the adoption (snapshot, locks, symlinks, hook, doc sections); preserves `.apache-magpie-overrides\u002F` by default (main-checkout only)\nwhen_to_use: |\n Invoke when the user says \"adopt apache-magpie\", \"adopt\n apache\u002Fmagpie\", \"set up magpie in this repo\",\n \"follow .claude\u002Fskills\u002Fmagpie-setup\", or follows the\n framework's README adoption instructions. Also for periodic\n maintenance: \"upgrade magpie\", \"verify magpie setup\",\n \"check magpie drift\", \"the snapshot is stale\".\nargument-hint: \"[adopt|upgrade|worktree-init|verify|override skill-name|unadopt]\"\ncapability: capability:platform\nlicense: Apache-2.0\n---\n\n\u003C!-- SPDX-License-Identifier: Apache-2.0\n https:\u002F\u002Fwww.apache.org\u002Flegal\u002Frelease-policy.html -->\n\n\u003C!-- Placeholder convention (see ..\u002F..\u002FAGENTS.md#placeholder-convention-used-in-skill-files):\n \u003Cproject-config> → adopter's `.apache-magpie-overrides\u002F` directory\n \u003Csnapshot-dir> → `.apache-magpie\u002F` (gitignored snapshot of the framework)\n \u003Ccommitted-lock> → `.apache-magpie.lock` (committed — project's pin)\n \u003Clocal-lock> → `.apache-magpie.local.lock` (gitignored — per-machine record)\n \u003Cupstream> → adopter's public source repo (the repo this skill is being run in)\n \u003Cframework-source> → the apache-magpie source we download a snapshot from\n — one of: signed zip from ASF dist, git tag, git branch.\n See [`docs\u002Fsetup\u002Finstall-recipes.md`](..\u002F..\u002Fdocs\u002Fsetup\u002Finstall-recipes.md). -->\n\n# setup\n\nThis skill is **the only framework artefact an adopter\nproject commits**. Every other apache-magpie skill (security,\npr-management, issue) is a gitignored symlink into the gitignored\nsnapshot at `\u003Csnapshot-dir>` that this skill manages.\n\nThe adoption model is **snapshot + agentic overrides + drift-\naware updates** (not submodule, not marketplace, not vendored\ncopy):\n\n- The framework is downloaded into `\u003Csnapshot-dir>` and\n **gitignored** in the adopter repo. The snapshot is a build\n artefact, not source.\n- Three install methods are supported (see\n [`docs\u002Fsetup\u002Finstall-recipes.md`](..\u002F..\u002Fdocs\u002Fsetup\u002Finstall-recipes.md)\n for verbatim copy-pasteable recipes):\n - **svn-zip** — released, signed zip from ASF distribution\n (recommended for production once releases ship).\n - **git-tag** — pinned to a specific git tag.\n - **git-branch** — tracks a branch tip (default: `main`,\n the WIP path).\n- **Two lock files** record the framework version. The\n committed one declares what the project pins to; the local\n one records what each machine actually fetched. Drift\n between them is surfaced and remediated by\n `\u002Fmagpie-setup upgrade`.\n- Symlinks make the framework's skills callable as if they\n lived in the adopter repo. **Each symlink is named\n `magpie-\u003Cframework-skill>`** — every framework skill is\n installed under a `magpie-` prefix so it is namespaced and\n never collides with the adopter's own skills (e.g. the\n snapshot's `skills\u002Fpr-management-triage\u002F` becomes\n `magpie-pr-management-triage`, invoked as\n `\u002Fmagpie-pr-management-triage`). **`.agents\u002Fskills\u002F` is the\n one canonical home**: its `magpie-*` entries link into\n `\u003Csnapshot-dir>\u002Fskills\u002F\u003Cframework-skill>\u002F`. Every other agent\n target (`.claude\u002Fskills\u002F`, `.github\u002Fskills\u002F`, …) gets a thin\n per-skill **relay** symlink that points back at the canonical\n entry (`.claude\u002Fskills\u002Fmagpie-\u003Cn>` →\n `..\u002F..\u002F.agents\u002Fskills\u002Fmagpie-\u003Cn>`) — no matter what layout the\n adopting project previously used (see\n [`agents.md`](agents.md)). The symlinks are\n **gitignored** because their targets disappear on a fresh\n clone before `\u002Fmagpie-setup` runs.\n- Adopter-specific modifications to framework workflows live as\n agent-readable instructions under\n `.apache-magpie-overrides\u002F\u003Cskill-name>.md` (committed). They\n invalidate or change steps the framework's skill would\n otherwise run. See\n [`overrides.md`](overrides.md) for the contract and\n [`docs\u002Fsetup\u002Fagentic-overrides.md`](..\u002F..\u002Fdocs\u002Fsetup\u002Fagentic-overrides.md)\n for the design rationale.\n\n**Local self-adoption (the framework checkout only).** The one\nrepo that cannot be adopted via the snapshot mechanism is the\nApache Magpie framework checkout itself — a remote snapshot of the\nframework into itself would be circular. Instead it **self-adopts**\nwith `method:local`: each canonical `magpie-\u003Cskill>` in\n`.agents\u002Fskills\u002F` is a **committed** symlink into the in-repo\n`..\u002F..\u002Fskills\u002F\u003Cskill>\u002F` source, and every other active agent\ntarget ([`agents.md`](agents.md)) — `.claude\u002Fskills\u002F` (Claude\nCode), `.github\u002Fskills\u002F` (GitHub's skill loader), and any present\nholdout — gets a committed **relay** symlink\n(`magpie-\u003Cskill>` → `..\u002F..\u002F.agents\u002Fskills\u002Fmagpie-\u003Cskill>`) — with\nno snapshot, no remote fetch, and no copy. This makes\nthe framework's own skills callable while developing the framework,\nand every contributor gets them active on a fresh clone with no\nsetup step. `adopt` detects the framework checkout structurally and\nroutes there automatically (see\n[`adopt.md` → Local self-adoption](adopt.md#local-self-adoption-methodlocal)).\n\n## The two lock files\n\nThe framework's lock-file model splits **what the project pins\nto** (committed) from **what this machine actually fetched**\n(local). This split is the foundation of drift detection and\nthe multi-installer support.\n\n### `\u003Ccommitted-lock>` — `.apache-magpie.lock`\n\nCommitted at the adopter repo root. The **project's pin**.\nEdited only by `\u002Fmagpie-setup`; do not modify by hand.\n\n```text\n# .apache-magpie.lock — committed; the project's pin.\n\nmethod: \u003Cgit-branch | git-tag | svn-zip>\nurl: \u003Csee per-method format below>\n\n# For method=git-branch:\nref: main\n\n# For method=git-tag:\nref: v1.0.0 # the tag name\ncommit: \u003CSHA> # the commit the tag pointed to when committed\n\n# For method=svn-zip:\nref: 1.0.0 # the version number\nsha512: \u003Chash> # the released zip's SHA-512 (for re-fetch verification)\n```\n\nThe next adopter who runs `\u002Fmagpie-setup adopt` reads this\nfile and re-installs to the **same version** the project\ndeclared. This is the core of the \"adopt once, all subsequent\nusers get the same thing\" promise.\n\n### `\u003Clocal-lock>` — `.apache-magpie.local.lock`\n\nGitignored at the adopter repo root. The **local snapshot's\nfingerprint**. Records what this machine fetched and when.\n\n```text\n# .apache-magpie.local.lock — gitignored; per-machine.\n\nsource_method: \u003Cgit-branch | git-tag | svn-zip>\nsource_url: \u003CURL the snapshot was actually fetched from>\nsource_ref: \u003Cbranch \u002F tag \u002F version actually fetched>\nfetched_commit: \u003Ccommit SHA on disk now>\nfetched_at: \u003CISO-8601 timestamp>\n```\n\nThe drift check on every framework-skill invocation compares\nthis against `\u003Ccommitted-lock>` and surfaces any mismatch as a\nproposed `\u002Fmagpie-setup upgrade`.\n\n### Source locks — the same split, for trusted external sources\n\nSkills pulled from [trusted external\nsources](..\u002F..\u002Fdocs\u002Fskill-sources\u002FREADME.md) use their **own**\npair of locks with the identical committed-pin \u002F local-fingerprint\nsplit, kept separate from the framework locks so a source re-pin\nnever entangles a framework upgrade:\n\n- **`.apache-magpie.sources.lock`** (committed) — the project's\n per-source pins, one block per source keyed by `id`\n (`method`\u002F`url`\u002F`ref` + `commit`|`sha512`).\n- **`.apache-magpie.sources.local.lock`** (gitignored) — this\n machine's per-source fetch fingerprint.\n\nThey are written and reconciled by\n[`skill-sources.md`](skill-sources.md) and re-fetched on\n`upgrade`; the format and drift semantics live there.\n\n## Detail files in this directory\n\n| File | Purpose |\n|---|---|\n| [`adopt.md`](adopt.md) | First-time adoption walk-through — recognise existing-snapshot vs needs-bootstrap, write the two lock files, ask the user which skill families and MCP servers to install, create the gitignored symlinks, scaffold `.apache-magpie-overrides\u002F`, install the post-checkout hook, update project docs. The default sub-action. |\n| [`upgrade.md`](upgrade.md) | Refresh the gitignored snapshot per the committed lock, reconcile any agentic overrides + symlinks against the new framework structure, surface conflicts. Drives the on-drift remediation flow. |\n| [`verify.md`](verify.md) | Read-only health check — snapshot present + intact, both lock files in sync, symlinks point at live targets, `.gitignore` correct, `.apache-magpie-overrides\u002F` exists, drift status (committed vs local), the `setup` skill itself is current. |\n| [`skill-sources.md`](skill-sources.md) | Fetch\u002Fverify skills from trusted external sources listed in `\u003Cproject-config>\u002Fskill-sources.md`, pin them in the committed `.apache-magpie.sources.lock`, and symlink the provided skills in exactly like framework skills. The runnable half of [trusted external skill sources](..\u002F..\u002Fdocs\u002Fskill-sources\u002FREADME.md); the install gate is the adopter trust list. |\n| [`agents.md`](agents.md) | The agent-target registry — *which* directories framework-skill symlinks land in across vendors, and the **canonical-plus-relay** model: `.agents\u002Fskills\u002F` is the one canonical home (links into the snapshot\u002Fsource); every other target (`claude-code`, `github`, holdout natives like Windsurf \u002F Goose) gets a per-skill relay symlink into `.agents\u002Fskills\u002F`. Defines active-target selection, SKILL.md format portability, and the Claude-Code-only layer (sandbox\u002Fhooks). The source of truth every sub-action consults for the target set. |\n| [`overrides.md`](overrides.md) | Agentic-override file management — open \u002F scaffold an override for a framework skill, list existing overrides, help reconcile when the framework changes the underlying skill's structure on upgrade. |\n| [`unadopt.md`](unadopt.md) | Reverse the adoption — remove snapshot, locks, symlinks, post-checkout hook, `.gitignore` entries, the adoption sections in `README.md` \u002F `AGENTS.md` \u002F `CONTRIBUTING.md`, and the committed `setup` skill itself. Preserves `.apache-magpie-overrides\u002F` by default; `--purge-overrides` removes it too. Surfaces the full removal plan before any write. |\n\n## Golden rules\n\n**Golden rule 1 — never modify the snapshot.** The\n`\u003Csnapshot-dir>` is a build artefact, gitignored, and **read-\nonly** from an adopter's perspective. Every modification an\nadopter wants must go into `.apache-magpie-overrides\u002F` (where\nit is *committed* and survives the next `upgrade`). The skill,\nand any other framework skill consulting overrides at run-time,\n**never** writes to `\u003Csnapshot-dir>`.\n\n**Golden rule 2 — `\u003Ccommitted-lock>` is the project's pin;\n`\u003Clocal-lock>` is per-machine truth.** They serve different\npurposes and live in different places:\n\n- `\u003Ccommitted-lock>` declares what version the *project* uses.\n Edited by the adopter who runs `\u002Fmagpie-setup adopt` first\n (or who later runs `\u002Fmagpie-setup upgrade` and accepts the\n new pin). Bumping it is a deliberate project-level action;\n the bump shows up in the `git diff` of the PR that proposed\n it.\n- `\u003Clocal-lock>` records what *this machine* installed. Updated\n silently by `\u002Fmagpie-setup adopt` and `\u002Fmagpie-setup\n upgrade`. Per-developer, per-checkout, per-worktree.\n\n**Golden rule 3 — drift surfaces, drift gets remediated.**\nEvery framework skill (and `\u002Fmagpie-setup verify`) checks\n`\u003Ccommitted-lock>` vs `\u003Clocal-lock>` at the top of its run.\nOn mismatch the skill surfaces the gap and proposes\n`\u002Fmagpie-setup upgrade`. The user accepts or defers; if they\naccept, `upgrade`:\n\n1. Deletes `\u003Csnapshot-dir>` outright.\n2. Re-installs per the *committed* lock (the new version the\n project chose).\n3. Refreshes the gitignored framework-skill symlinks — adds\n any new framework skills the user's family pick covers,\n removes any framework skills that were renamed away or\n removed.\n4. Reconciles agentic overrides against the new framework\n structure (surfaces conflicts; never auto-rewrites).\n5. Updates `\u003Clocal-lock>` to the new fetch.\n\n**Golden rule 4 — `.gitignore` keeps the adopter repo clean.**\nGitignored in the adopter repo:\n\n- `\u003Csnapshot-dir>` (the entire framework snapshot — gigabytes\n potentially).\n- `\u003Clocal-lock>` (per-machine state).\n- `.apache-magpie-local\u002F` (personal, per-developer override\n directory — see Golden rule 7).\n- The `magpie-*` symlinks `setup adopt` creates in every active\n target dir — the canonical ones in `.agents\u002Fskills\u002F` (they\n target the gitignored snapshot) and the relays in\n `.claude\u002Fskills\u002F` \u002F `.github\u002Fskills\u002F` \u002F holdouts (they target\n the canonical entries) — both would dangle in a fresh clone.\n The one exception un-ignored in each dir is `magpie-setup`.\n- `.apache-magpie-sources\u002F` (the gitignored fetch of every\n trusted external skill source) and\n `.apache-magpie.sources.local.lock` (per-machine source-fetch\n fingerprint), when the adopter trusts any source. See\n [`skill-sources.md`](skill-sources.md).\n\n**Committed**: this skill (`setup`, as the canonical\n`.agents\u002Fskills\u002Fmagpie-setup\u002F` plus its relays), the\n`\u003Ccommitted-lock>`, the **`.apache-magpie.sources.lock`**\nper-source pins (the project's committed vouch for each trusted\nsource), the `.apache-magpie-overrides\u002F` directory, the\n`.gitignore` entries themselves, any project-doc updates the\n`adopt` sub-action makes.\n\n**Golden rule 5 — `.agents\u002Fskills\u002F` is canonical; everything\nelse just relays into it.** Regardless of how an adopting\nproject previously organised its `.claude\u002Fskills\u002F` or\n`.github\u002Fskills\u002F`, `adopt` always wires the framework the same\nway: the canonical `magpie-*` links live in `.agents\u002Fskills\u002F`,\nand every other active target (`.claude`, `.github`, holdouts)\ngets per-skill relay symlinks pointing back at the canonical\nentries (`.claude\u002Fskills\u002Fmagpie-\u003Cn>` →\n`..\u002F..\u002F.agents\u002Fskills\u002Fmagpie-\u003Cn>`). The adopter's own native\n(non-`magpie-`) skills in those dirs are left untouched. See\n[`agents.md`](agents.md).\n\n**Golden rule 6 — copy this skill, symlink the rest; all under\nthe `magpie-` prefix.** This skill (source `skills\u002Fsetup\u002F`) is\nthe **only** framework skill that gets **copied** into an\nadopter repo — committed as the canonical\n`.agents\u002Fskills\u002Fmagpie-setup\u002F`, with committed relay symlinks to\nit from `.claude\u002Fskills\u002Fmagpie-setup` and\n`.github\u002Fskills\u002Fmagpie-setup`. All other framework skills are\n**symlinked** (canonical link into the gitignored snapshot, plus\nrelays), each named `magpie-\u003Cframework-skill>`\n(e.g. `magpie-security-issue-import` → `\u003Csnapshot-dir>\u002Fskills\u002Fsecurity-issue-import\u002F`).\nThe `magpie-` prefix namespaces every framework skill so it\nnever collides with an adopter's own skills. Mixing copy and\nsymlink — copying a security skill, for instance — creates a\nmaintenance hazard: copies drift from the framework's source-\nof-truth, and the drift-detection mechanism (which assumes\nthe framework version is the one in `\u003Csnapshot-dir>`)\nsilently mis-applies.\n\n**Golden rule 7 — agentic overrides are read at run-time.**\nEvery framework skill that supports overrides starts its run\nby consulting **two** directories in precedence order (first\nhit wins):\n\n1. `.apache-magpie-local\u002F\u003Cthis-skill>.md` — personal,\n gitignored. Per-developer overrides that are never\n committed.\n2. `.apache-magpie-overrides\u002F\u003Cthis-skill>.md` — committed,\n project-wide. Overrides shared with every contributor.\n\nBoth files are plain markdown the agent interprets — no\ntemplating engine, no patch tool. The additive-only guardrail\napplies to both: neither may weaken the framework's safety,\nconfidentiality, or privacy baseline. See\n[`docs\u002Fsetup\u002Fagentic-overrides.md`](..\u002F..\u002Fdocs\u002Fsetup\u002Fagentic-overrides.md)\nfor the full contract including the lookup protocol.\n\n**Golden rule 8 — family membership is declared in\nfrontmatter; two families are *always* installed, the rest\nare opt-in.** Every framework skill declares its family in a\n`family:` key in its `SKILL.md` frontmatter (e.g.\n`family: repo-health`). The sub-actions read that key from the\nsnapshot to build the adopt\u002Fupgrade install choice and to wire\neach family's symlinks — **family membership is never inferred\nfrom the skill-name prefix**, because families such as\n`repo-health` and `contributor-growth` deliberately span\nseveral prefixes. The canonical family vocabulary is validated\nby [`skill-and-tool-validator`](..\u002F..\u002Ftools\u002Fskill-and-tool-validator\u002FREADME.md)\n(`ALLOWED_FAMILIES`) and mirrored adopter-facing in\n[`README.md` → Skill families](..\u002F..\u002FREADME.md#skill-families).\n\nTwo families are wired up **unconditionally** on every adopt \u002F\nupgrade \u002F worktree-init run and the user is **never asked**\nabout them:\n\n- **`setup`** — every skill with `family: setup` *except* the\n bootstrap `setup` itself (which is copied as `magpie-setup`\n per Rule 6, not symlinked): `setup-isolated-setup-install`,\n `setup-isolated-setup-update`, `setup-isolated-setup-verify`,\n `setup-isolated-setup-doctor`, `setup-override-upstream`,\n `setup-shared-config-sync`, `setup-status`,\n `setup-upstream-fix`, plus any new `family: setup` skill the\n framework grows — each symlinked as `magpie-setup-*`.\n- **`utilities`** — the meta \u002F discovery family; skills with\n `family: utilities`: `list-skills`, `write-skill`,\n `optimize-skill`, `skill-reconciler`. These are framework\n self-authoring and discovery tools every adopter gets so the\n framework can grow them without re-prompting.\n\nThese two always-on families (`ALWAYS_ON_FAMILIES` in the\nvalidator) are not exposed in the `skill-families:` prompt and\nnot stored as user-selectable in the lock files; every\nsub-action that wires symlinks always covers them **in addition\nto** the user's opt-in family picks. Dropping them is *not* a\nsupported configuration — the secure-setup, discovery, and\nskill-authoring flows the framework ships depend on those\nskills being callable.\n\nEvery **other** family is **opt-in** — offered in the Step 5\nprompt and recorded in the lock files. Today those are:\n`security`, `pr-management`, `issue`, `release-management`,\n`repo-health`, `pairing`, `mentoring`, `contributor-growth`.\nThe set is computed from the `family:` keys present in the\nsnapshot minus the always-on families, so a new opt-in family\nappears in the prompt automatically the run after it ships.\n\n**Golden rule 9 — reload `setup` in-flight after a\nself-update.** When a sub-action changes or creates the\ncontent of the committed `setup` skill (in practice:\n`adopt` recovering an out-of-date bootstrap, or `upgrade`'s\noverwrite-from-snapshot step), the agent **re-reads the\nmodified files of this skill before continuing** the rest of\nthe current run. Concretely: after the copy lands on disk,\nre-load `SKILL.md` and the sub-action file you are\ncurrently executing (and any helper file you have already\nopened, such as `agents.md` or `overrides.md`), then\nresume from the step after the overwrite. The reload runs as\nthe **first thing** that happens after the overwrite, before\nany further reconciliation, symlink work, or doc updates.\nThe reason: the snapshot's skill version may have renamed\nsteps, added new sub-actions, or changed the symlink\ncontract; finishing the run against the *old* in-memory\ncopy of the skill would silently mis-apply the new\nframework version the project just pinned to.\n\n## Sub-actions\n\nThe skill dispatches by the first positional argument:\n\n| Invocation | Loads | Purpose |\n|---|---|---|\n| `\u002Fmagpie-setup` (no args) | [`adopt.md`](adopt.md) | First-time adoption (default; **main-checkout only**). Idempotent — re-running on an already-adopted repo behaves like `verify`. |\n| `\u002Fmagpie-setup adopt` | [`adopt.md`](adopt.md) | Same as no-arg — explicit form. Main-checkout only. |\n| `\u002Fmagpie-setup upgrade` | [`upgrade.md`](upgrade.md) | Refresh snapshot per `\u003Ccommitted-lock>` + reconcile overrides + refresh symlinks. **Main-checkout only** — worktrees pick up upgrades automatically via the symlink installed by `worktree-init`. |\n| `\u002Fmagpie-setup worktree-init` | [`worktree-init.md`](worktree-init.md) | **Worktree-only.** Symlink the worktree's `\u003Csnapshot-dir>` to the main checkout's so this worktree shares one framework state. No fetch, no lock files written; idempotent. |\n| `\u002Fmagpie-setup verify` | [`verify.md`](verify.md) | Read-only health check + drift status report. Works in both main and worktrees. |\n| `\u002Fmagpie-setup skill-sources` (aka `skill-sources add \u003Cid>`) | [`skill-sources.md`](skill-sources.md) | Fetch\u002Fverify\u002Fpin\u002Fsymlink skills from the trusted external sources the adopter listed in `\u003Cproject-config>\u002Fskill-sources.md`. **Main-checkout only** — worktrees share the source snapshots via `worktree-init`. |\n| `\u002Fmagpie-setup override \u003Cskill>` | [`overrides.md`](overrides.md) | Open \u002F scaffold an override file. |\n| `\u002Fmagpie-setup unadopt` | [`unadopt.md`](unadopt.md) | Reverse the adoption. Removes snapshot, locks, symlinks, hook, doc sections, and this skill itself. Preserves `.apache-magpie-overrides\u002F` unless `--purge-overrides` is passed. **Main-checkout only.** |\n\n**Main-checkout-only sub-actions** (`adopt`, `upgrade`, `unadopt`)\ndetect their context via `git rev-parse --git-dir` ≠\n`git rev-parse --git-common-dir` and refuse to run in a worktree\nwith a pointer back to the main checkout. The worktree counterpart\nof `adopt` is `worktree-init`; for `upgrade`, every worktree\nautomatically sees the refreshed snapshot once the main runs\nupgrade, because each worktree's `\u003Csnapshot-dir>` is a symlink to\nthe main's.\n\n**`adopt` and `upgrade` always chain into `worktree-init` on every\nlinked worktree as their final pass.** The chain is unconditional\n— even on a fresh adoption with no linked worktrees yet (the pass\nbecomes a no-op), even on an upgrade where every worktree already\nlooks wired (`worktree-init` is idempotent, repairs broken\nsymlinks, and adds new always-on-family entries the upgrade\nintroduced). The user does not need to remember to `cd` into each\nworktree and re-run anything; the main-checkout sub-action\npropagates state outward to the worktrees by itself. See\n[`adopt.md` Step 12.2](adopt.md#step-12--post-install-sync--worktree-propagation--sandbox-allowlist--sanity-check)\nand\n[`upgrade.md` Step 6c](upgrade.md#step-6c--propagate-to-every-worktree-run-worktree-init-unconditionally).\n\nIf the snapshot is missing (no `\u003Csnapshot-dir>\u002F`) and\n`\u003Ccommitted-lock>` exists, the skill treats any sub-action as\nthe recover-snapshot path: re-install per the committed lock\nfirst, then continue.\n\n## Inputs\n\n| Flag | Effect |\n|---|---|\n| `from:\u003Cgit-ref>` \u002F `from:\u003Cversion>` | Adopt or upgrade from a specific framework ref or version. Used during `adopt` (overrides the user prompt) and `upgrade` (overrides the committed lock for *this run only* — does NOT update the committed lock). |\n| `method:\u003Cgit-branch\\|git-tag\\|svn-zip\\|local>` | Pick the install method explicitly. Default during `adopt`: prompt the user. **`local`** is **framework-checkout only** — it self-adopts by linking the in-repo `skills\u002F` source directly instead of fetching a snapshot (see [`adopt.md` → Local self-adoption](adopt.md#local-self-adoption-methodlocal)). |\n| `agents:\u003Clist>` | Comma-separated **agent targets** to wire symlinks into ([`agents.md`](agents.md) registry ids: `universal`, `claude-code`, `github`, `windsurf`, `goose`, …). Default on `adopt`\u002F`upgrade`: auto — the always-on neutral set (`universal` + `claude-code` + `github`) plus any other registry dir already present in the repo. When passed, **replaces** the auto-detected set for that run, except `universal` (`.agents\u002Fskills\u002F`) which is always retained because it is the canonical home every other target relays into — dropping it would leave the relays dangling. |\n| `skill-families:\u003Clist>` | Comma-separated **opt-in** families to symlink — any of the opt-in families declared by a `family:` frontmatter key in the snapshot (today: `security`, `pr-management`, `issue`, `release-management`, `repo-health`, `pairing`, `mentoring`, `contributor-growth`). Default on `adopt`: prompt (see [`adopt.md` Step 5](adopt.md#step-5--pick-the-skill-families-and-mcp-servers)). Default on `upgrade`: read the families list from `\u003Ccommitted-lock>` \u002F `\u003Clocal-lock>`, **auto-include any opt-in family the framework has introduced since the lock was written** (recorded back into the lock), and **ensure every framework skill in the effective family set has a valid symlink** — create or repair missing \u002F broken symlinks, not just add new ones. The flag never accepts the always-on families (`setup`, `utilities`); per [Golden rule 8](#golden-rules) those are wired up unconditionally on every run and there is no way to ask for them or opt out. |\n| `--purge-overrides` | *(unadopt only)* Also `git rm -r` `.apache-magpie-overrides\u002F`. Default: preserve. |\n| `dry-run` | Show what the skill would do without writing anything. |\n\n## What this skill is NOT for\n\n- Not for installing the secure agent setup (sandbox, hooks,\n pinned tools). That is\n [`setup-isolated-setup-install`](..\u002Fsetup-isolated-setup-install\u002FSKILL.md).\n- Not for upgrading framework tools installed on the host\n (`bubblewrap`, `socat`, `claude-code` itself). That is\n [`setup-isolated-setup-update`](..\u002Fsetup-isolated-setup-update\u002FSKILL.md).\n- Not for syncing the user's `~\u002F.claude-config` across\n machines. That is\n [`setup-shared-config-sync`](..\u002Fsetup-shared-config-sync\u002FSKILL.md).\n- Not for committing framework changes. Framework PRs go\n against `apache\u002Fmagpie` directly — the snapshot is\n read-only.\n\n## Failure modes\n\n| Symptom | Likely cause | Remediation |\n|---|---|---|\n| `\u002Fmagpie-setup verify` reports drift between committed and local locks | Project lead bumped `\u003Ccommitted-lock>` since this machine last fetched, or local snapshot is stale on a `main`-tracking adopter | `\u002Fmagpie-setup upgrade` |\n| Snapshot present but symlinks dangle | Adopter ran `git clone` but not `\u002Fmagpie-setup` after — symlinks are gitignored but persist in their target's absence on disk | `\u002Fmagpie-setup verify --auto-fix-symlinks` (or `\u002Fmagpie-setup adopt`, idempotent) |\n| Worktree off the adopter repo can't find framework skills | Worktrees off the adopter don't auto-inherit the gitignored snapshot | The `adopt` sub-action installs a `post-checkout` git hook that re-runs the snapshot install on worktree creation; verify the hook is present (`\u002Fmagpie-setup verify`) |\n| `git clone` of an upstream PR sees no framework skills | Expected — the snapshot is gitignored, so a fresh clone has no `\u003Csnapshot-dir>`. The clone needs `\u002Fmagpie-setup` once before any framework skill is invocable | `\u002Fmagpie-setup` |\n| Project decided to stop using apache-magpie | The reverse of adoption — remove the snapshot, locks, symlinks, hook, doc sections, and the `setup` skill itself. `.apache-magpie-overrides\u002F` is preserved by default | `\u002Fmagpie-setup unadopt` (add `--purge-overrides` to also drop the overrides directory) |\n",{"data":38,"body":44},{"name":4,"family":39,"mode":40,"description":6,"when_to_use":41,"argument-hint":42,"capability":43,"license":22},"setup","Meta","Invoke when the user says \"adopt apache-magpie\", \"adopt\napache\u002Fmagpie\", \"set up magpie in this repo\",\n\"follow .claude\u002Fskills\u002Fmagpie-setup\", or follows the\nframework's README adoption instructions. Also for periodic\nmaintenance: \"upgrade magpie\", \"verify magpie setup\",\n\"check magpie drift\", \"the snapshot is stale\".\n","[adopt|upgrade|worktree-init|verify|override skill-name|unadopt]","capability:platform",{"type":45,"children":46},"root",[47,54,77,89,369,491,498,517,536,555,567,587,604,616,625,643,649,669,746,770,776,1087,1093,1150,1174,1247,1293,1342,1359,1466,1529,1624,1728,1745,1770,1785,1879,1898,2066,2101,2181,2261,2267,2272,2616,2690,2758,2778,2784,3233,3239,3329,3335],{"type":48,"tag":49,"props":50,"children":51},"element","h1",{"id":39},[52],{"type":53,"value":39},"text",{"type":48,"tag":55,"props":56,"children":57},"p",{},[58,60,66,68,75],{"type":53,"value":59},"This skill is ",{"type":48,"tag":61,"props":62,"children":63},"strong",{},[64],{"type":53,"value":65},"the only framework artefact an adopter\nproject commits",{"type":53,"value":67},". Every other apache-magpie skill (security,\npr-management, issue) is a gitignored symlink into the gitignored\nsnapshot at ",{"type":48,"tag":69,"props":70,"children":72},"code",{"className":71},[],[73],{"type":53,"value":74},"\u003Csnapshot-dir>",{"type":53,"value":76}," that this skill manages.",{"type":48,"tag":55,"props":78,"children":79},{},[80,82,87],{"type":53,"value":81},"The adoption model is ",{"type":48,"tag":61,"props":83,"children":84},{},[85],{"type":53,"value":86},"snapshot + agentic overrides + drift-\naware updates",{"type":53,"value":88}," (not submodule, not marketplace, not vendored\ncopy):",{"type":48,"tag":90,"props":91,"children":92},"ul",{},[93,113,172,190,333],{"type":48,"tag":94,"props":95,"children":96},"li",{},[97,99,104,106,111],{"type":53,"value":98},"The framework is downloaded into ",{"type":48,"tag":69,"props":100,"children":102},{"className":101},[],[103],{"type":53,"value":74},{"type":53,"value":105}," and\n",{"type":48,"tag":61,"props":107,"children":108},{},[109],{"type":53,"value":110},"gitignored",{"type":53,"value":112}," in the adopter repo. The snapshot is a build\nartefact, not source.",{"type":48,"tag":94,"props":114,"children":115},{},[116,118,129,131],{"type":53,"value":117},"Three install methods are supported (see\n",{"type":48,"tag":119,"props":120,"children":122},"a",{"href":121},"..\u002F..\u002Fdocs\u002Fsetup\u002Finstall-recipes.md",[123],{"type":48,"tag":69,"props":124,"children":126},{"className":125},[],[127],{"type":53,"value":128},"docs\u002Fsetup\u002Finstall-recipes.md",{"type":53,"value":130},"\nfor verbatim copy-pasteable recipes):\n",{"type":48,"tag":90,"props":132,"children":133},{},[134,144,154],{"type":48,"tag":94,"props":135,"children":136},{},[137,142],{"type":48,"tag":61,"props":138,"children":139},{},[140],{"type":53,"value":141},"svn-zip",{"type":53,"value":143}," — released, signed zip from ASF distribution\n(recommended for production once releases ship).",{"type":48,"tag":94,"props":145,"children":146},{},[147,152],{"type":48,"tag":61,"props":148,"children":149},{},[150],{"type":53,"value":151},"git-tag",{"type":53,"value":153}," — pinned to a specific git tag.",{"type":48,"tag":94,"props":155,"children":156},{},[157,162,164,170],{"type":48,"tag":61,"props":158,"children":159},{},[160],{"type":53,"value":161},"git-branch",{"type":53,"value":163}," — tracks a branch tip (default: ",{"type":48,"tag":69,"props":165,"children":167},{"className":166},[],[168],{"type":53,"value":169},"main",{"type":53,"value":171},",\nthe WIP path).",{"type":48,"tag":94,"props":173,"children":174},{},[175,180,182,188],{"type":48,"tag":61,"props":176,"children":177},{},[178],{"type":53,"value":179},"Two lock files",{"type":53,"value":181}," record the framework version. The\ncommitted one declares what the project pins to; the local\none records what each machine actually fetched. Drift\nbetween them is surfaced and remediated by\n",{"type":48,"tag":69,"props":183,"children":185},{"className":184},[],[186],{"type":53,"value":187},"\u002Fmagpie-setup upgrade",{"type":53,"value":189},".",{"type":48,"tag":94,"props":191,"children":192},{},[193,195,206,208,214,216,222,224,230,232,238,240,251,253,259,261,267,269,275,277,283,285,290,292,298,300,306,308,317,319,323,325,331],{"type":53,"value":194},"Symlinks make the framework's skills callable as if they\nlived in the adopter repo. ",{"type":48,"tag":61,"props":196,"children":197},{},[198,200],{"type":53,"value":199},"Each symlink is named\n",{"type":48,"tag":69,"props":201,"children":203},{"className":202},[],[204],{"type":53,"value":205},"magpie-\u003Cframework-skill>",{"type":53,"value":207}," — every framework skill is\ninstalled under a ",{"type":48,"tag":69,"props":209,"children":211},{"className":210},[],[212],{"type":53,"value":213},"magpie-",{"type":53,"value":215}," prefix so it is namespaced and\nnever collides with the adopter's own skills (e.g. the\nsnapshot's ",{"type":48,"tag":69,"props":217,"children":219},{"className":218},[],[220],{"type":53,"value":221},"skills\u002Fpr-management-triage\u002F",{"type":53,"value":223}," becomes\n",{"type":48,"tag":69,"props":225,"children":227},{"className":226},[],[228],{"type":53,"value":229},"magpie-pr-management-triage",{"type":53,"value":231},", invoked as\n",{"type":48,"tag":69,"props":233,"children":235},{"className":234},[],[236],{"type":53,"value":237},"\u002Fmagpie-pr-management-triage",{"type":53,"value":239},"). ",{"type":48,"tag":61,"props":241,"children":242},{},[243,249],{"type":48,"tag":69,"props":244,"children":246},{"className":245},[],[247],{"type":53,"value":248},".agents\u002Fskills\u002F",{"type":53,"value":250}," is the\none canonical home",{"type":53,"value":252},": its ",{"type":48,"tag":69,"props":254,"children":256},{"className":255},[],[257],{"type":53,"value":258},"magpie-*",{"type":53,"value":260}," entries link into\n",{"type":48,"tag":69,"props":262,"children":264},{"className":263},[],[265],{"type":53,"value":266},"\u003Csnapshot-dir>\u002Fskills\u002F\u003Cframework-skill>\u002F",{"type":53,"value":268},". Every other agent\ntarget (",{"type":48,"tag":69,"props":270,"children":272},{"className":271},[],[273],{"type":53,"value":274},".claude\u002Fskills\u002F",{"type":53,"value":276},", ",{"type":48,"tag":69,"props":278,"children":280},{"className":279},[],[281],{"type":53,"value":282},".github\u002Fskills\u002F",{"type":53,"value":284},", …) gets a thin\nper-skill ",{"type":48,"tag":61,"props":286,"children":287},{},[288],{"type":53,"value":289},"relay",{"type":53,"value":291}," symlink that points back at the canonical\nentry (",{"type":48,"tag":69,"props":293,"children":295},{"className":294},[],[296],{"type":53,"value":297},".claude\u002Fskills\u002Fmagpie-\u003Cn>",{"type":53,"value":299}," →\n",{"type":48,"tag":69,"props":301,"children":303},{"className":302},[],[304],{"type":53,"value":305},"..\u002F..\u002F.agents\u002Fskills\u002Fmagpie-\u003Cn>",{"type":53,"value":307},") — no matter what layout the\nadopting project previously used (see\n",{"type":48,"tag":119,"props":309,"children":311},{"href":310},"agents.md",[312],{"type":48,"tag":69,"props":313,"children":315},{"className":314},[],[316],{"type":53,"value":310},{"type":53,"value":318},"). The symlinks are\n",{"type":48,"tag":61,"props":320,"children":321},{},[322],{"type":53,"value":110},{"type":53,"value":324}," because their targets disappear on a fresh\nclone before ",{"type":48,"tag":69,"props":326,"children":328},{"className":327},[],[329],{"type":53,"value":330},"\u002Fmagpie-setup",{"type":53,"value":332}," runs.",{"type":48,"tag":94,"props":334,"children":335},{},[336,338,344,346,355,357,367],{"type":53,"value":337},"Adopter-specific modifications to framework workflows live as\nagent-readable instructions under\n",{"type":48,"tag":69,"props":339,"children":341},{"className":340},[],[342],{"type":53,"value":343},".apache-magpie-overrides\u002F\u003Cskill-name>.md",{"type":53,"value":345}," (committed). They\ninvalidate or change steps the framework's skill would\notherwise run. See\n",{"type":48,"tag":119,"props":347,"children":349},{"href":348},"overrides.md",[350],{"type":48,"tag":69,"props":351,"children":353},{"className":352},[],[354],{"type":53,"value":348},{"type":53,"value":356}," for the contract and\n",{"type":48,"tag":119,"props":358,"children":360},{"href":359},"..\u002F..\u002Fdocs\u002Fsetup\u002Fagentic-overrides.md",[361],{"type":48,"tag":69,"props":362,"children":364},{"className":363},[],[365],{"type":53,"value":366},"docs\u002Fsetup\u002Fagentic-overrides.md",{"type":53,"value":368},"\nfor the design rationale.",{"type":48,"tag":55,"props":370,"children":371},{},[372,377,379,384,386,392,394,400,402,407,409,414,416,422,424,432,434,439,441,446,448,452,454,459,461,467,469,475,477,489],{"type":48,"tag":61,"props":373,"children":374},{},[375],{"type":53,"value":376},"Local self-adoption (the framework checkout only).",{"type":53,"value":378}," The one\nrepo that cannot be adopted via the snapshot mechanism is the\nApache Magpie framework checkout itself — a remote snapshot of the\nframework into itself would be circular. Instead it ",{"type":48,"tag":61,"props":380,"children":381},{},[382],{"type":53,"value":383},"self-adopts",{"type":53,"value":385},"\nwith ",{"type":48,"tag":69,"props":387,"children":389},{"className":388},[],[390],{"type":53,"value":391},"method:local",{"type":53,"value":393},": each canonical ",{"type":48,"tag":69,"props":395,"children":397},{"className":396},[],[398],{"type":53,"value":399},"magpie-\u003Cskill>",{"type":53,"value":401}," in\n",{"type":48,"tag":69,"props":403,"children":405},{"className":404},[],[406],{"type":53,"value":248},{"type":53,"value":408}," is a ",{"type":48,"tag":61,"props":410,"children":411},{},[412],{"type":53,"value":413},"committed",{"type":53,"value":415}," symlink into the in-repo\n",{"type":48,"tag":69,"props":417,"children":419},{"className":418},[],[420],{"type":53,"value":421},"..\u002F..\u002Fskills\u002F\u003Cskill>\u002F",{"type":53,"value":423}," source, and every other active agent\ntarget (",{"type":48,"tag":119,"props":425,"children":426},{"href":310},[427],{"type":48,"tag":69,"props":428,"children":430},{"className":429},[],[431],{"type":53,"value":310},{"type":53,"value":433},") — ",{"type":48,"tag":69,"props":435,"children":437},{"className":436},[],[438],{"type":53,"value":274},{"type":53,"value":440}," (Claude\nCode), ",{"type":48,"tag":69,"props":442,"children":444},{"className":443},[],[445],{"type":53,"value":282},{"type":53,"value":447}," (GitHub's skill loader), and any present\nholdout — gets a committed ",{"type":48,"tag":61,"props":449,"children":450},{},[451],{"type":53,"value":289},{"type":53,"value":453}," symlink\n(",{"type":48,"tag":69,"props":455,"children":457},{"className":456},[],[458],{"type":53,"value":399},{"type":53,"value":460}," → ",{"type":48,"tag":69,"props":462,"children":464},{"className":463},[],[465],{"type":53,"value":466},"..\u002F..\u002F.agents\u002Fskills\u002Fmagpie-\u003Cskill>",{"type":53,"value":468},") — with\nno snapshot, no remote fetch, and no copy. This makes\nthe framework's own skills callable while developing the framework,\nand every contributor gets them active on a fresh clone with no\nsetup step. ",{"type":48,"tag":69,"props":470,"children":472},{"className":471},[],[473],{"type":53,"value":474},"adopt",{"type":53,"value":476}," detects the framework checkout structurally and\nroutes there automatically (see\n",{"type":48,"tag":119,"props":478,"children":480},{"href":479},"adopt.md#local-self-adoption-methodlocal",[481,487],{"type":48,"tag":69,"props":482,"children":484},{"className":483},[],[485],{"type":53,"value":486},"adopt.md",{"type":53,"value":488}," → Local self-adoption",{"type":53,"value":490},").",{"type":48,"tag":492,"props":493,"children":495},"h2",{"id":494},"the-two-lock-files",[496],{"type":53,"value":497},"The two lock files",{"type":48,"tag":55,"props":499,"children":500},{},[501,503,508,510,515],{"type":53,"value":502},"The framework's lock-file model splits ",{"type":48,"tag":61,"props":504,"children":505},{},[506],{"type":53,"value":507},"what the project pins\nto",{"type":53,"value":509}," (committed) from ",{"type":48,"tag":61,"props":511,"children":512},{},[513],{"type":53,"value":514},"what this machine actually fetched",{"type":53,"value":516},"\n(local). This split is the foundation of drift detection and\nthe multi-installer support.",{"type":48,"tag":518,"props":519,"children":521},"h3",{"id":520},"committed-lock-apache-magpielock",[522,528,530],{"type":48,"tag":69,"props":523,"children":525},{"className":524},[],[526],{"type":53,"value":527},"\u003Ccommitted-lock>",{"type":53,"value":529}," — ",{"type":48,"tag":69,"props":531,"children":533},{"className":532},[],[534],{"type":53,"value":535},".apache-magpie.lock",{"type":48,"tag":55,"props":537,"children":538},{},[539,541,546,548,553],{"type":53,"value":540},"Committed at the adopter repo root. The ",{"type":48,"tag":61,"props":542,"children":543},{},[544],{"type":53,"value":545},"project's pin",{"type":53,"value":547},".\nEdited only by ",{"type":48,"tag":69,"props":549,"children":551},{"className":550},[],[552],{"type":53,"value":330},{"type":53,"value":554},"; do not modify by hand.",{"type":48,"tag":556,"props":557,"children":562},"pre",{"className":558,"code":560,"language":53,"meta":561},[559],"language-text","# .apache-magpie.lock — committed; the project's pin.\n\nmethod: \u003Cgit-branch | git-tag | svn-zip>\nurl: \u003Csee per-method format below>\n\n# For method=git-branch:\nref: main\n\n# For method=git-tag:\nref: v1.0.0 # the tag name\ncommit: \u003CSHA> # the commit the tag pointed to when committed\n\n# For method=svn-zip:\nref: 1.0.0 # the version number\nsha512: \u003Chash> # the released zip's SHA-512 (for re-fetch verification)\n","",[563],{"type":48,"tag":69,"props":564,"children":565},{"__ignoreMap":561},[566],{"type":53,"value":560},{"type":48,"tag":55,"props":568,"children":569},{},[570,572,578,580,585],{"type":53,"value":571},"The next adopter who runs ",{"type":48,"tag":69,"props":573,"children":575},{"className":574},[],[576],{"type":53,"value":577},"\u002Fmagpie-setup adopt",{"type":53,"value":579}," reads this\nfile and re-installs to the ",{"type":48,"tag":61,"props":581,"children":582},{},[583],{"type":53,"value":584},"same version",{"type":53,"value":586}," the project\ndeclared. This is the core of the \"adopt once, all subsequent\nusers get the same thing\" promise.",{"type":48,"tag":518,"props":588,"children":590},{"id":589},"local-lock-apache-magpielocallock",[591,597,598],{"type":48,"tag":69,"props":592,"children":594},{"className":593},[],[595],{"type":53,"value":596},"\u003Clocal-lock>",{"type":53,"value":529},{"type":48,"tag":69,"props":599,"children":601},{"className":600},[],[602],{"type":53,"value":603},".apache-magpie.local.lock",{"type":48,"tag":55,"props":605,"children":606},{},[607,609,614],{"type":53,"value":608},"Gitignored at the adopter repo root. The ",{"type":48,"tag":61,"props":610,"children":611},{},[612],{"type":53,"value":613},"local snapshot's\nfingerprint",{"type":53,"value":615},". Records what this machine fetched and when.",{"type":48,"tag":556,"props":617,"children":620},{"className":618,"code":619,"language":53,"meta":561},[559],"# .apache-magpie.local.lock — gitignored; per-machine.\n\nsource_method: \u003Cgit-branch | git-tag | svn-zip>\nsource_url: \u003CURL the snapshot was actually fetched from>\nsource_ref: \u003Cbranch \u002F tag \u002F version actually fetched>\nfetched_commit: \u003Ccommit SHA on disk now>\nfetched_at: \u003CISO-8601 timestamp>\n",[621],{"type":48,"tag":69,"props":622,"children":623},{"__ignoreMap":561},[624],{"type":53,"value":619},{"type":48,"tag":55,"props":626,"children":627},{},[628,630,635,637,642],{"type":53,"value":629},"The drift check on every framework-skill invocation compares\nthis against ",{"type":48,"tag":69,"props":631,"children":633},{"className":632},[],[634],{"type":53,"value":527},{"type":53,"value":636}," and surfaces any mismatch as a\nproposed ",{"type":48,"tag":69,"props":638,"children":640},{"className":639},[],[641],{"type":53,"value":187},{"type":53,"value":189},{"type":48,"tag":518,"props":644,"children":646},{"id":645},"source-locks-the-same-split-for-trusted-external-sources",[647],{"type":53,"value":648},"Source locks — the same split, for trusted external sources",{"type":48,"tag":55,"props":650,"children":651},{},[652,654,660,662,667],{"type":53,"value":653},"Skills pulled from ",{"type":48,"tag":119,"props":655,"children":657},{"href":656},"..\u002F..\u002Fdocs\u002Fskill-sources\u002FREADME.md",[658],{"type":53,"value":659},"trusted external\nsources",{"type":53,"value":661}," use their ",{"type":48,"tag":61,"props":663,"children":664},{},[665],{"type":53,"value":666},"own",{"type":53,"value":668},"\npair of locks with the identical committed-pin \u002F local-fingerprint\nsplit, kept separate from the framework locks so a source re-pin\nnever entangles a framework upgrade:",{"type":48,"tag":90,"props":670,"children":671},{},[672,732],{"type":48,"tag":94,"props":673,"children":674},{},[675,684,686,692,694,700,702,708,709,715,717,723,725,731],{"type":48,"tag":61,"props":676,"children":677},{},[678],{"type":48,"tag":69,"props":679,"children":681},{"className":680},[],[682],{"type":53,"value":683},".apache-magpie.sources.lock",{"type":53,"value":685}," (committed) — the project's\nper-source pins, one block per source keyed by ",{"type":48,"tag":69,"props":687,"children":689},{"className":688},[],[690],{"type":53,"value":691},"id",{"type":53,"value":693},"\n(",{"type":48,"tag":69,"props":695,"children":697},{"className":696},[],[698],{"type":53,"value":699},"method",{"type":53,"value":701},"\u002F",{"type":48,"tag":69,"props":703,"children":705},{"className":704},[],[706],{"type":53,"value":707},"url",{"type":53,"value":701},{"type":48,"tag":69,"props":710,"children":712},{"className":711},[],[713],{"type":53,"value":714},"ref",{"type":53,"value":716}," + ",{"type":48,"tag":69,"props":718,"children":720},{"className":719},[],[721],{"type":53,"value":722},"commit",{"type":53,"value":724},"|",{"type":48,"tag":69,"props":726,"children":728},{"className":727},[],[729],{"type":53,"value":730},"sha512",{"type":53,"value":490},{"type":48,"tag":94,"props":733,"children":734},{},[735,744],{"type":48,"tag":61,"props":736,"children":737},{},[738],{"type":48,"tag":69,"props":739,"children":741},{"className":740},[],[742],{"type":53,"value":743},".apache-magpie.sources.local.lock",{"type":53,"value":745}," (gitignored) — this\nmachine's per-source fetch fingerprint.",{"type":48,"tag":55,"props":747,"children":748},{},[749,751,760,762,768],{"type":53,"value":750},"They are written and reconciled by\n",{"type":48,"tag":119,"props":752,"children":754},{"href":753},"skill-sources.md",[755],{"type":48,"tag":69,"props":756,"children":758},{"className":757},[],[759],{"type":53,"value":753},{"type":53,"value":761}," and re-fetched on\n",{"type":48,"tag":69,"props":763,"children":765},{"className":764},[],[766],{"type":53,"value":767},"upgrade",{"type":53,"value":769},"; the format and drift semantics live there.",{"type":48,"tag":492,"props":771,"children":773},{"id":772},"detail-files-in-this-directory",[774],{"type":53,"value":775},"Detail files in this directory",{"type":48,"tag":777,"props":778,"children":779},"table",{},[780,799],{"type":48,"tag":781,"props":782,"children":783},"thead",{},[784],{"type":48,"tag":785,"props":786,"children":787},"tr",{},[788,794],{"type":48,"tag":789,"props":790,"children":791},"th",{},[792],{"type":53,"value":793},"File",{"type":48,"tag":789,"props":795,"children":796},{},[797],{"type":53,"value":798},"Purpose",{"type":48,"tag":800,"props":801,"children":802},"tbody",{},[803,831,851,893,934,996,1015],{"type":48,"tag":785,"props":804,"children":805},{},[806,818],{"type":48,"tag":807,"props":808,"children":809},"td",{},[810],{"type":48,"tag":119,"props":811,"children":812},{"href":486},[813],{"type":48,"tag":69,"props":814,"children":816},{"className":815},[],[817],{"type":53,"value":486},{"type":48,"tag":807,"props":819,"children":820},{},[821,823,829],{"type":53,"value":822},"First-time adoption walk-through — recognise existing-snapshot vs needs-bootstrap, write the two lock files, ask the user which skill families and MCP servers to install, create the gitignored symlinks, scaffold ",{"type":48,"tag":69,"props":824,"children":826},{"className":825},[],[827],{"type":53,"value":828},".apache-magpie-overrides\u002F",{"type":53,"value":830},", install the post-checkout hook, update project docs. The default sub-action.",{"type":48,"tag":785,"props":832,"children":833},{},[834,846],{"type":48,"tag":807,"props":835,"children":836},{},[837],{"type":48,"tag":119,"props":838,"children":840},{"href":839},"upgrade.md",[841],{"type":48,"tag":69,"props":842,"children":844},{"className":843},[],[845],{"type":53,"value":839},{"type":48,"tag":807,"props":847,"children":848},{},[849],{"type":53,"value":850},"Refresh the gitignored snapshot per the committed lock, reconcile any agentic overrides + symlinks against the new framework structure, surface conflicts. Drives the on-drift remediation flow.",{"type":48,"tag":785,"props":852,"children":853},{},[854,866],{"type":48,"tag":807,"props":855,"children":856},{},[857],{"type":48,"tag":119,"props":858,"children":860},{"href":859},"verify.md",[861],{"type":48,"tag":69,"props":862,"children":864},{"className":863},[],[865],{"type":53,"value":859},{"type":48,"tag":807,"props":867,"children":868},{},[869,871,877,879,884,886,891],{"type":53,"value":870},"Read-only health check — snapshot present + intact, both lock files in sync, symlinks point at live targets, ",{"type":48,"tag":69,"props":872,"children":874},{"className":873},[],[875],{"type":53,"value":876},".gitignore",{"type":53,"value":878}," correct, ",{"type":48,"tag":69,"props":880,"children":882},{"className":881},[],[883],{"type":53,"value":828},{"type":53,"value":885}," exists, drift status (committed vs local), the ",{"type":48,"tag":69,"props":887,"children":889},{"className":888},[],[890],{"type":53,"value":39},{"type":53,"value":892}," skill itself is current.",{"type":48,"tag":785,"props":894,"children":895},{},[896,907],{"type":48,"tag":807,"props":897,"children":898},{},[899],{"type":48,"tag":119,"props":900,"children":901},{"href":753},[902],{"type":48,"tag":69,"props":903,"children":905},{"className":904},[],[906],{"type":53,"value":753},{"type":48,"tag":807,"props":908,"children":909},{},[910,912,918,920,925,927,932],{"type":53,"value":911},"Fetch\u002Fverify skills from trusted external sources listed in ",{"type":48,"tag":69,"props":913,"children":915},{"className":914},[],[916],{"type":53,"value":917},"\u003Cproject-config>\u002Fskill-sources.md",{"type":53,"value":919},", pin them in the committed ",{"type":48,"tag":69,"props":921,"children":923},{"className":922},[],[924],{"type":53,"value":683},{"type":53,"value":926},", and symlink the provided skills in exactly like framework skills. The runnable half of ",{"type":48,"tag":119,"props":928,"children":929},{"href":656},[930],{"type":53,"value":931},"trusted external skill sources",{"type":53,"value":933},"; the install gate is the adopter trust list.",{"type":48,"tag":785,"props":935,"children":936},{},[937,948],{"type":48,"tag":807,"props":938,"children":939},{},[940],{"type":48,"tag":119,"props":941,"children":942},{"href":310},[943],{"type":48,"tag":69,"props":944,"children":946},{"className":945},[],[947],{"type":53,"value":310},{"type":48,"tag":807,"props":949,"children":950},{},[951,953,959,961,966,968,973,975,980,981,987,989,994],{"type":53,"value":952},"The agent-target registry — ",{"type":48,"tag":954,"props":955,"children":956},"em",{},[957],{"type":53,"value":958},"which",{"type":53,"value":960}," directories framework-skill symlinks land in across vendors, and the ",{"type":48,"tag":61,"props":962,"children":963},{},[964],{"type":53,"value":965},"canonical-plus-relay",{"type":53,"value":967}," model: ",{"type":48,"tag":69,"props":969,"children":971},{"className":970},[],[972],{"type":53,"value":248},{"type":53,"value":974}," is the one canonical home (links into the snapshot\u002Fsource); every other target (",{"type":48,"tag":69,"props":976,"children":978},{"className":977},[],[979],{"type":53,"value":27},{"type":53,"value":276},{"type":48,"tag":69,"props":982,"children":984},{"className":983},[],[985],{"type":53,"value":986},"github",{"type":53,"value":988},", holdout natives like Windsurf \u002F Goose) gets a per-skill relay symlink into ",{"type":48,"tag":69,"props":990,"children":992},{"className":991},[],[993],{"type":53,"value":248},{"type":53,"value":995},". Defines active-target selection, SKILL.md format portability, and the Claude-Code-only layer (sandbox\u002Fhooks). The source of truth every sub-action consults for the target set.",{"type":48,"tag":785,"props":997,"children":998},{},[999,1010],{"type":48,"tag":807,"props":1000,"children":1001},{},[1002],{"type":48,"tag":119,"props":1003,"children":1004},{"href":348},[1005],{"type":48,"tag":69,"props":1006,"children":1008},{"className":1007},[],[1009],{"type":53,"value":348},{"type":48,"tag":807,"props":1011,"children":1012},{},[1013],{"type":53,"value":1014},"Agentic-override file management — open \u002F scaffold an override for a framework skill, list existing overrides, help reconcile when the framework changes the underlying skill's structure on upgrade.",{"type":48,"tag":785,"props":1016,"children":1017},{},[1018,1030],{"type":48,"tag":807,"props":1019,"children":1020},{},[1021],{"type":48,"tag":119,"props":1022,"children":1024},{"href":1023},"unadopt.md",[1025],{"type":48,"tag":69,"props":1026,"children":1028},{"className":1027},[],[1029],{"type":53,"value":1023},{"type":48,"tag":807,"props":1031,"children":1032},{},[1033,1035,1040,1042,1048,1050,1056,1057,1063,1065,1070,1072,1077,1079,1085],{"type":53,"value":1034},"Reverse the adoption — remove snapshot, locks, symlinks, post-checkout hook, ",{"type":48,"tag":69,"props":1036,"children":1038},{"className":1037},[],[1039],{"type":53,"value":876},{"type":53,"value":1041}," entries, the adoption sections in ",{"type":48,"tag":69,"props":1043,"children":1045},{"className":1044},[],[1046],{"type":53,"value":1047},"README.md",{"type":53,"value":1049}," \u002F ",{"type":48,"tag":69,"props":1051,"children":1053},{"className":1052},[],[1054],{"type":53,"value":1055},"AGENTS.md",{"type":53,"value":1049},{"type":48,"tag":69,"props":1058,"children":1060},{"className":1059},[],[1061],{"type":53,"value":1062},"CONTRIBUTING.md",{"type":53,"value":1064},", and the committed ",{"type":48,"tag":69,"props":1066,"children":1068},{"className":1067},[],[1069],{"type":53,"value":39},{"type":53,"value":1071}," skill itself. Preserves ",{"type":48,"tag":69,"props":1073,"children":1075},{"className":1074},[],[1076],{"type":53,"value":828},{"type":53,"value":1078}," by default; ",{"type":48,"tag":69,"props":1080,"children":1082},{"className":1081},[],[1083],{"type":53,"value":1084},"--purge-overrides",{"type":53,"value":1086}," removes it too. Surfaces the full removal plan before any write.",{"type":48,"tag":492,"props":1088,"children":1090},{"id":1089},"golden-rules",[1091],{"type":53,"value":1092},"Golden rules",{"type":48,"tag":55,"props":1094,"children":1095},{},[1096,1101,1103,1108,1110,1115,1117,1122,1124,1128,1130,1135,1137,1142,1144,1149],{"type":48,"tag":61,"props":1097,"children":1098},{},[1099],{"type":53,"value":1100},"Golden rule 1 — never modify the snapshot.",{"type":53,"value":1102}," The\n",{"type":48,"tag":69,"props":1104,"children":1106},{"className":1105},[],[1107],{"type":53,"value":74},{"type":53,"value":1109}," is a build artefact, gitignored, and ",{"type":48,"tag":61,"props":1111,"children":1112},{},[1113],{"type":53,"value":1114},"read-\nonly",{"type":53,"value":1116}," from an adopter's perspective. Every modification an\nadopter wants must go into ",{"type":48,"tag":69,"props":1118,"children":1120},{"className":1119},[],[1121],{"type":53,"value":828},{"type":53,"value":1123}," (where\nit is ",{"type":48,"tag":954,"props":1125,"children":1126},{},[1127],{"type":53,"value":413},{"type":53,"value":1129}," and survives the next ",{"type":48,"tag":69,"props":1131,"children":1133},{"className":1132},[],[1134],{"type":53,"value":767},{"type":53,"value":1136},"). The skill,\nand any other framework skill consulting overrides at run-time,\n",{"type":48,"tag":61,"props":1138,"children":1139},{},[1140],{"type":53,"value":1141},"never",{"type":53,"value":1143}," writes to ",{"type":48,"tag":69,"props":1145,"children":1147},{"className":1146},[],[1148],{"type":53,"value":74},{"type":53,"value":189},{"type":48,"tag":55,"props":1151,"children":1152},{},[1153,1172],{"type":48,"tag":61,"props":1154,"children":1155},{},[1156,1158,1163,1165,1170],{"type":53,"value":1157},"Golden rule 2 — ",{"type":48,"tag":69,"props":1159,"children":1161},{"className":1160},[],[1162],{"type":53,"value":527},{"type":53,"value":1164}," is the project's pin;\n",{"type":48,"tag":69,"props":1166,"children":1168},{"className":1167},[],[1169],{"type":53,"value":596},{"type":53,"value":1171}," is per-machine truth.",{"type":53,"value":1173}," They serve different\npurposes and live in different places:",{"type":48,"tag":90,"props":1175,"children":1176},{},[1177,1216],{"type":48,"tag":94,"props":1178,"children":1179},{},[1180,1185,1187,1192,1194,1199,1201,1206,1208,1214],{"type":48,"tag":69,"props":1181,"children":1183},{"className":1182},[],[1184],{"type":53,"value":527},{"type":53,"value":1186}," declares what version the ",{"type":48,"tag":954,"props":1188,"children":1189},{},[1190],{"type":53,"value":1191},"project",{"type":53,"value":1193}," uses.\nEdited by the adopter who runs ",{"type":48,"tag":69,"props":1195,"children":1197},{"className":1196},[],[1198],{"type":53,"value":577},{"type":53,"value":1200}," first\n(or who later runs ",{"type":48,"tag":69,"props":1202,"children":1204},{"className":1203},[],[1205],{"type":53,"value":187},{"type":53,"value":1207}," and accepts the\nnew pin). Bumping it is a deliberate project-level action;\nthe bump shows up in the ",{"type":48,"tag":69,"props":1209,"children":1211},{"className":1210},[],[1212],{"type":53,"value":1213},"git diff",{"type":53,"value":1215}," of the PR that proposed\nit.",{"type":48,"tag":94,"props":1217,"children":1218},{},[1219,1224,1226,1231,1233,1238,1240,1245],{"type":48,"tag":69,"props":1220,"children":1222},{"className":1221},[],[1223],{"type":53,"value":596},{"type":53,"value":1225}," records what ",{"type":48,"tag":954,"props":1227,"children":1228},{},[1229],{"type":53,"value":1230},"this machine",{"type":53,"value":1232}," installed. Updated\nsilently by ",{"type":48,"tag":69,"props":1234,"children":1236},{"className":1235},[],[1237],{"type":53,"value":577},{"type":53,"value":1239}," and ",{"type":48,"tag":69,"props":1241,"children":1243},{"className":1242},[],[1244],{"type":53,"value":187},{"type":53,"value":1246},". Per-developer, per-checkout, per-worktree.",{"type":48,"tag":55,"props":1248,"children":1249},{},[1250,1255,1257,1263,1265,1270,1272,1277,1279,1284,1286,1291],{"type":48,"tag":61,"props":1251,"children":1252},{},[1253],{"type":53,"value":1254},"Golden rule 3 — drift surfaces, drift gets remediated.",{"type":53,"value":1256},"\nEvery framework skill (and ",{"type":48,"tag":69,"props":1258,"children":1260},{"className":1259},[],[1261],{"type":53,"value":1262},"\u002Fmagpie-setup verify",{"type":53,"value":1264},") checks\n",{"type":48,"tag":69,"props":1266,"children":1268},{"className":1267},[],[1269],{"type":53,"value":527},{"type":53,"value":1271}," vs ",{"type":48,"tag":69,"props":1273,"children":1275},{"className":1274},[],[1276],{"type":53,"value":596},{"type":53,"value":1278}," at the top of its run.\nOn mismatch the skill surfaces the gap and proposes\n",{"type":48,"tag":69,"props":1280,"children":1282},{"className":1281},[],[1283],{"type":53,"value":187},{"type":53,"value":1285},". The user accepts or defers; if they\naccept, ",{"type":48,"tag":69,"props":1287,"children":1289},{"className":1288},[],[1290],{"type":53,"value":767},{"type":53,"value":1292},":",{"type":48,"tag":1294,"props":1295,"children":1296},"ol",{},[1297,1309,1320,1325,1330],{"type":48,"tag":94,"props":1298,"children":1299},{},[1300,1302,1307],{"type":53,"value":1301},"Deletes ",{"type":48,"tag":69,"props":1303,"children":1305},{"className":1304},[],[1306],{"type":53,"value":74},{"type":53,"value":1308}," outright.",{"type":48,"tag":94,"props":1310,"children":1311},{},[1312,1314,1318],{"type":53,"value":1313},"Re-installs per the ",{"type":48,"tag":954,"props":1315,"children":1316},{},[1317],{"type":53,"value":413},{"type":53,"value":1319}," lock (the new version the\nproject chose).",{"type":48,"tag":94,"props":1321,"children":1322},{},[1323],{"type":53,"value":1324},"Refreshes the gitignored framework-skill symlinks — adds\nany new framework skills the user's family pick covers,\nremoves any framework skills that were renamed away or\nremoved.",{"type":48,"tag":94,"props":1326,"children":1327},{},[1328],{"type":53,"value":1329},"Reconciles agentic overrides against the new framework\nstructure (surfaces conflicts; never auto-rewrites).",{"type":48,"tag":94,"props":1331,"children":1332},{},[1333,1335,1340],{"type":53,"value":1334},"Updates ",{"type":48,"tag":69,"props":1336,"children":1338},{"className":1337},[],[1339],{"type":53,"value":596},{"type":53,"value":1341}," to the new fetch.",{"type":48,"tag":55,"props":1343,"children":1344},{},[1345,1357],{"type":48,"tag":61,"props":1346,"children":1347},{},[1348,1350,1355],{"type":53,"value":1349},"Golden rule 4 — ",{"type":48,"tag":69,"props":1351,"children":1353},{"className":1352},[],[1354],{"type":53,"value":876},{"type":53,"value":1356}," keeps the adopter repo clean.",{"type":53,"value":1358},"\nGitignored in the adopter repo:",{"type":48,"tag":90,"props":1360,"children":1361},{},[1362,1372,1382,1393,1439],{"type":48,"tag":94,"props":1363,"children":1364},{},[1365,1370],{"type":48,"tag":69,"props":1366,"children":1368},{"className":1367},[],[1369],{"type":53,"value":74},{"type":53,"value":1371}," (the entire framework snapshot — gigabytes\npotentially).",{"type":48,"tag":94,"props":1373,"children":1374},{},[1375,1380],{"type":48,"tag":69,"props":1376,"children":1378},{"className":1377},[],[1379],{"type":53,"value":596},{"type":53,"value":1381}," (per-machine state).",{"type":48,"tag":94,"props":1383,"children":1384},{},[1385,1391],{"type":48,"tag":69,"props":1386,"children":1388},{"className":1387},[],[1389],{"type":53,"value":1390},".apache-magpie-local\u002F",{"type":53,"value":1392}," (personal, per-developer override\ndirectory — see Golden rule 7).",{"type":48,"tag":94,"props":1394,"children":1395},{},[1396,1398,1403,1405,1411,1413,1418,1420,1425,1426,1431,1433,1438],{"type":53,"value":1397},"The ",{"type":48,"tag":69,"props":1399,"children":1401},{"className":1400},[],[1402],{"type":53,"value":258},{"type":53,"value":1404}," symlinks ",{"type":48,"tag":69,"props":1406,"children":1408},{"className":1407},[],[1409],{"type":53,"value":1410},"setup adopt",{"type":53,"value":1412}," creates in every active\ntarget dir — the canonical ones in ",{"type":48,"tag":69,"props":1414,"children":1416},{"className":1415},[],[1417],{"type":53,"value":248},{"type":53,"value":1419}," (they\ntarget the gitignored snapshot) and the relays in\n",{"type":48,"tag":69,"props":1421,"children":1423},{"className":1422},[],[1424],{"type":53,"value":274},{"type":53,"value":1049},{"type":48,"tag":69,"props":1427,"children":1429},{"className":1428},[],[1430],{"type":53,"value":282},{"type":53,"value":1432}," \u002F holdouts (they target\nthe canonical entries) — both would dangle in a fresh clone.\nThe one exception un-ignored in each dir is ",{"type":48,"tag":69,"props":1434,"children":1436},{"className":1435},[],[1437],{"type":53,"value":4},{"type":53,"value":189},{"type":48,"tag":94,"props":1440,"children":1441},{},[1442,1448,1450,1455,1457,1465],{"type":48,"tag":69,"props":1443,"children":1445},{"className":1444},[],[1446],{"type":53,"value":1447},".apache-magpie-sources\u002F",{"type":53,"value":1449}," (the gitignored fetch of every\ntrusted external skill source) and\n",{"type":48,"tag":69,"props":1451,"children":1453},{"className":1452},[],[1454],{"type":53,"value":743},{"type":53,"value":1456}," (per-machine source-fetch\nfingerprint), when the adopter trusts any source. See\n",{"type":48,"tag":119,"props":1458,"children":1459},{"href":753},[1460],{"type":48,"tag":69,"props":1461,"children":1463},{"className":1462},[],[1464],{"type":53,"value":753},{"type":53,"value":189},{"type":48,"tag":55,"props":1467,"children":1468},{},[1469,1474,1476,1481,1483,1489,1491,1496,1498,1506,1508,1513,1515,1520,1522,1527],{"type":48,"tag":61,"props":1470,"children":1471},{},[1472],{"type":53,"value":1473},"Committed",{"type":53,"value":1475},": this skill (",{"type":48,"tag":69,"props":1477,"children":1479},{"className":1478},[],[1480],{"type":53,"value":39},{"type":53,"value":1482},", as the canonical\n",{"type":48,"tag":69,"props":1484,"children":1486},{"className":1485},[],[1487],{"type":53,"value":1488},".agents\u002Fskills\u002Fmagpie-setup\u002F",{"type":53,"value":1490}," plus its relays), the\n",{"type":48,"tag":69,"props":1492,"children":1494},{"className":1493},[],[1495],{"type":53,"value":527},{"type":53,"value":1497},", the ",{"type":48,"tag":61,"props":1499,"children":1500},{},[1501],{"type":48,"tag":69,"props":1502,"children":1504},{"className":1503},[],[1505],{"type":53,"value":683},{"type":53,"value":1507},"\nper-source pins (the project's committed vouch for each trusted\nsource), the ",{"type":48,"tag":69,"props":1509,"children":1511},{"className":1510},[],[1512],{"type":53,"value":828},{"type":53,"value":1514}," directory, the\n",{"type":48,"tag":69,"props":1516,"children":1518},{"className":1517},[],[1519],{"type":53,"value":876},{"type":53,"value":1521}," entries themselves, any project-doc updates the\n",{"type":48,"tag":69,"props":1523,"children":1525},{"className":1524},[],[1526],{"type":53,"value":474},{"type":53,"value":1528}," sub-action makes.",{"type":48,"tag":55,"props":1530,"children":1531},{},[1532,1544,1546,1551,1553,1558,1559,1564,1566,1571,1573,1578,1580,1586,1587,1593,1595,1600,1601,1606,1608,1613,1615,1623],{"type":48,"tag":61,"props":1533,"children":1534},{},[1535,1537,1542],{"type":53,"value":1536},"Golden rule 5 — ",{"type":48,"tag":69,"props":1538,"children":1540},{"className":1539},[],[1541],{"type":53,"value":248},{"type":53,"value":1543}," is canonical; everything\nelse just relays into it.",{"type":53,"value":1545}," Regardless of how an adopting\nproject previously organised its ",{"type":48,"tag":69,"props":1547,"children":1549},{"className":1548},[],[1550],{"type":53,"value":274},{"type":53,"value":1552}," or\n",{"type":48,"tag":69,"props":1554,"children":1556},{"className":1555},[],[1557],{"type":53,"value":282},{"type":53,"value":276},{"type":48,"tag":69,"props":1560,"children":1562},{"className":1561},[],[1563],{"type":53,"value":474},{"type":53,"value":1565}," always wires the framework the same\nway: the canonical ",{"type":48,"tag":69,"props":1567,"children":1569},{"className":1568},[],[1570],{"type":53,"value":258},{"type":53,"value":1572}," links live in ",{"type":48,"tag":69,"props":1574,"children":1576},{"className":1575},[],[1577],{"type":53,"value":248},{"type":53,"value":1579},",\nand every other active target (",{"type":48,"tag":69,"props":1581,"children":1583},{"className":1582},[],[1584],{"type":53,"value":1585},".claude",{"type":53,"value":276},{"type":48,"tag":69,"props":1588,"children":1590},{"className":1589},[],[1591],{"type":53,"value":1592},".github",{"type":53,"value":1594},", holdouts)\ngets per-skill relay symlinks pointing back at the canonical\nentries (",{"type":48,"tag":69,"props":1596,"children":1598},{"className":1597},[],[1599],{"type":53,"value":297},{"type":53,"value":299},{"type":48,"tag":69,"props":1602,"children":1604},{"className":1603},[],[1605],{"type":53,"value":305},{"type":53,"value":1607},"). The adopter's own native\n(non-",{"type":48,"tag":69,"props":1609,"children":1611},{"className":1610},[],[1612],{"type":53,"value":213},{"type":53,"value":1614},") skills in those dirs are left untouched. See\n",{"type":48,"tag":119,"props":1616,"children":1617},{"href":310},[1618],{"type":48,"tag":69,"props":1619,"children":1621},{"className":1620},[],[1622],{"type":53,"value":310},{"type":53,"value":189},{"type":48,"tag":55,"props":1625,"children":1626},{},[1627,1639,1641,1647,1649,1654,1656,1661,1663,1668,1670,1676,1677,1683,1685,1690,1692,1697,1699,1705,1706,1712,1714,1719,1721,1726],{"type":48,"tag":61,"props":1628,"children":1629},{},[1630,1632,1637],{"type":53,"value":1631},"Golden rule 6 — copy this skill, symlink the rest; all under\nthe ",{"type":48,"tag":69,"props":1633,"children":1635},{"className":1634},[],[1636],{"type":53,"value":213},{"type":53,"value":1638}," prefix.",{"type":53,"value":1640}," This skill (source ",{"type":48,"tag":69,"props":1642,"children":1644},{"className":1643},[],[1645],{"type":53,"value":1646},"skills\u002Fsetup\u002F",{"type":53,"value":1648},") is\nthe ",{"type":48,"tag":61,"props":1650,"children":1651},{},[1652],{"type":53,"value":1653},"only",{"type":53,"value":1655}," framework skill that gets ",{"type":48,"tag":61,"props":1657,"children":1658},{},[1659],{"type":53,"value":1660},"copied",{"type":53,"value":1662}," into an\nadopter repo — committed as the canonical\n",{"type":48,"tag":69,"props":1664,"children":1666},{"className":1665},[],[1667],{"type":53,"value":1488},{"type":53,"value":1669},", with committed relay symlinks to\nit from ",{"type":48,"tag":69,"props":1671,"children":1673},{"className":1672},[],[1674],{"type":53,"value":1675},".claude\u002Fskills\u002Fmagpie-setup",{"type":53,"value":105},{"type":48,"tag":69,"props":1678,"children":1680},{"className":1679},[],[1681],{"type":53,"value":1682},".github\u002Fskills\u002Fmagpie-setup",{"type":53,"value":1684},". All other framework skills are\n",{"type":48,"tag":61,"props":1686,"children":1687},{},[1688],{"type":53,"value":1689},"symlinked",{"type":53,"value":1691}," (canonical link into the gitignored snapshot, plus\nrelays), each named ",{"type":48,"tag":69,"props":1693,"children":1695},{"className":1694},[],[1696],{"type":53,"value":205},{"type":53,"value":1698},"\n(e.g. ",{"type":48,"tag":69,"props":1700,"children":1702},{"className":1701},[],[1703],{"type":53,"value":1704},"magpie-security-issue-import",{"type":53,"value":460},{"type":48,"tag":69,"props":1707,"children":1709},{"className":1708},[],[1710],{"type":53,"value":1711},"\u003Csnapshot-dir>\u002Fskills\u002Fsecurity-issue-import\u002F",{"type":53,"value":1713},").\nThe ",{"type":48,"tag":69,"props":1715,"children":1717},{"className":1716},[],[1718],{"type":53,"value":213},{"type":53,"value":1720}," prefix namespaces every framework skill so it\nnever collides with an adopter's own skills. Mixing copy and\nsymlink — copying a security skill, for instance — creates a\nmaintenance hazard: copies drift from the framework's source-\nof-truth, and the drift-detection mechanism (which assumes\nthe framework version is the one in ",{"type":48,"tag":69,"props":1722,"children":1724},{"className":1723},[],[1725],{"type":53,"value":74},{"type":53,"value":1727},")\nsilently mis-applies.",{"type":48,"tag":55,"props":1729,"children":1730},{},[1731,1736,1738,1743],{"type":48,"tag":61,"props":1732,"children":1733},{},[1734],{"type":53,"value":1735},"Golden rule 7 — agentic overrides are read at run-time.",{"type":53,"value":1737},"\nEvery framework skill that supports overrides starts its run\nby consulting ",{"type":48,"tag":61,"props":1739,"children":1740},{},[1741],{"type":53,"value":1742},"two",{"type":53,"value":1744}," directories in precedence order (first\nhit wins):",{"type":48,"tag":1294,"props":1746,"children":1747},{},[1748,1759],{"type":48,"tag":94,"props":1749,"children":1750},{},[1751,1757],{"type":48,"tag":69,"props":1752,"children":1754},{"className":1753},[],[1755],{"type":53,"value":1756},".apache-magpie-local\u002F\u003Cthis-skill>.md",{"type":53,"value":1758}," — personal,\ngitignored. Per-developer overrides that are never\ncommitted.",{"type":48,"tag":94,"props":1760,"children":1761},{},[1762,1768],{"type":48,"tag":69,"props":1763,"children":1765},{"className":1764},[],[1766],{"type":53,"value":1767},".apache-magpie-overrides\u002F\u003Cthis-skill>.md",{"type":53,"value":1769}," — committed,\nproject-wide. Overrides shared with every contributor.",{"type":48,"tag":55,"props":1771,"children":1772},{},[1773,1775,1783],{"type":53,"value":1774},"Both files are plain markdown the agent interprets — no\ntemplating engine, no patch tool. The additive-only guardrail\napplies to both: neither may weaken the framework's safety,\nconfidentiality, or privacy baseline. See\n",{"type":48,"tag":119,"props":1776,"children":1777},{"href":359},[1778],{"type":48,"tag":69,"props":1779,"children":1781},{"className":1780},[],[1782],{"type":53,"value":366},{"type":53,"value":1784},"\nfor the full contract including the lookup protocol.",{"type":48,"tag":55,"props":1786,"children":1787},{},[1788,1800,1802,1808,1810,1816,1818,1824,1826,1831,1833,1839,1840,1846,1848,1858,1859,1865,1867,1878],{"type":48,"tag":61,"props":1789,"children":1790},{},[1791,1793,1798],{"type":53,"value":1792},"Golden rule 8 — family membership is declared in\nfrontmatter; two families are ",{"type":48,"tag":954,"props":1794,"children":1795},{},[1796],{"type":53,"value":1797},"always",{"type":53,"value":1799}," installed, the rest\nare opt-in.",{"type":53,"value":1801}," Every framework skill declares its family in a\n",{"type":48,"tag":69,"props":1803,"children":1805},{"className":1804},[],[1806],{"type":53,"value":1807},"family:",{"type":53,"value":1809}," key in its ",{"type":48,"tag":69,"props":1811,"children":1813},{"className":1812},[],[1814],{"type":53,"value":1815},"SKILL.md",{"type":53,"value":1817}," frontmatter (e.g.\n",{"type":48,"tag":69,"props":1819,"children":1821},{"className":1820},[],[1822],{"type":53,"value":1823},"family: repo-health",{"type":53,"value":1825},"). The sub-actions read that key from the\nsnapshot to build the adopt\u002Fupgrade install choice and to wire\neach family's symlinks — ",{"type":48,"tag":61,"props":1827,"children":1828},{},[1829],{"type":53,"value":1830},"family membership is never inferred\nfrom the skill-name prefix",{"type":53,"value":1832},", because families such as\n",{"type":48,"tag":69,"props":1834,"children":1836},{"className":1835},[],[1837],{"type":53,"value":1838},"repo-health",{"type":53,"value":1239},{"type":48,"tag":69,"props":1841,"children":1843},{"className":1842},[],[1844],{"type":53,"value":1845},"contributor-growth",{"type":53,"value":1847}," deliberately span\nseveral prefixes. The canonical family vocabulary is validated\nby ",{"type":48,"tag":119,"props":1849,"children":1851},{"href":1850},"..\u002F..\u002Ftools\u002Fskill-and-tool-validator\u002FREADME.md",[1852],{"type":48,"tag":69,"props":1853,"children":1855},{"className":1854},[],[1856],{"type":53,"value":1857},"skill-and-tool-validator",{"type":53,"value":693},{"type":48,"tag":69,"props":1860,"children":1862},{"className":1861},[],[1863],{"type":53,"value":1864},"ALLOWED_FAMILIES",{"type":53,"value":1866},") and mirrored adopter-facing in\n",{"type":48,"tag":119,"props":1868,"children":1870},{"href":1869},"..\u002F..\u002FREADME.md#skill-families",[1871,1876],{"type":48,"tag":69,"props":1872,"children":1874},{"className":1873},[],[1875],{"type":53,"value":1047},{"type":53,"value":1877}," → Skill families",{"type":53,"value":189},{"type":48,"tag":55,"props":1880,"children":1881},{},[1882,1884,1889,1891,1896],{"type":53,"value":1883},"Two families are wired up ",{"type":48,"tag":61,"props":1885,"children":1886},{},[1887],{"type":53,"value":1888},"unconditionally",{"type":53,"value":1890}," on every adopt \u002F\nupgrade \u002F worktree-init run and the user is ",{"type":48,"tag":61,"props":1892,"children":1893},{},[1894],{"type":53,"value":1895},"never asked",{"type":53,"value":1897},"\nabout them:",{"type":48,"tag":90,"props":1899,"children":1900},{},[1901,2015],{"type":48,"tag":94,"props":1902,"children":1903},{},[1904,1912,1914,1920,1922,1927,1929,1934,1936,1941,1943,1949,1951,1957,1958,1964,1965,1971,1972,1978,1979,1985,1986,1992,1993,1999,2001,2006,2008,2014],{"type":48,"tag":61,"props":1905,"children":1906},{},[1907],{"type":48,"tag":69,"props":1908,"children":1910},{"className":1909},[],[1911],{"type":53,"value":39},{"type":53,"value":1913}," — every skill with ",{"type":48,"tag":69,"props":1915,"children":1917},{"className":1916},[],[1918],{"type":53,"value":1919},"family: setup",{"type":53,"value":1921}," ",{"type":48,"tag":954,"props":1923,"children":1924},{},[1925],{"type":53,"value":1926},"except",{"type":53,"value":1928}," the\nbootstrap ",{"type":48,"tag":69,"props":1930,"children":1932},{"className":1931},[],[1933],{"type":53,"value":39},{"type":53,"value":1935}," itself (which is copied as ",{"type":48,"tag":69,"props":1937,"children":1939},{"className":1938},[],[1940],{"type":53,"value":4},{"type":53,"value":1942},"\nper Rule 6, not symlinked): ",{"type":48,"tag":69,"props":1944,"children":1946},{"className":1945},[],[1947],{"type":53,"value":1948},"setup-isolated-setup-install",{"type":53,"value":1950},",\n",{"type":48,"tag":69,"props":1952,"children":1954},{"className":1953},[],[1955],{"type":53,"value":1956},"setup-isolated-setup-update",{"type":53,"value":276},{"type":48,"tag":69,"props":1959,"children":1961},{"className":1960},[],[1962],{"type":53,"value":1963},"setup-isolated-setup-verify",{"type":53,"value":1950},{"type":48,"tag":69,"props":1966,"children":1968},{"className":1967},[],[1969],{"type":53,"value":1970},"setup-isolated-setup-doctor",{"type":53,"value":276},{"type":48,"tag":69,"props":1973,"children":1975},{"className":1974},[],[1976],{"type":53,"value":1977},"setup-override-upstream",{"type":53,"value":1950},{"type":48,"tag":69,"props":1980,"children":1982},{"className":1981},[],[1983],{"type":53,"value":1984},"setup-shared-config-sync",{"type":53,"value":276},{"type":48,"tag":69,"props":1987,"children":1989},{"className":1988},[],[1990],{"type":53,"value":1991},"setup-status",{"type":53,"value":1950},{"type":48,"tag":69,"props":1994,"children":1996},{"className":1995},[],[1997],{"type":53,"value":1998},"setup-upstream-fix",{"type":53,"value":2000},", plus any new ",{"type":48,"tag":69,"props":2002,"children":2004},{"className":2003},[],[2005],{"type":53,"value":1919},{"type":53,"value":2007}," skill the\nframework grows — each symlinked as ",{"type":48,"tag":69,"props":2009,"children":2011},{"className":2010},[],[2012],{"type":53,"value":2013},"magpie-setup-*",{"type":53,"value":189},{"type":48,"tag":94,"props":2016,"children":2017},{},[2018,2027,2029,2035,2037,2043,2044,2050,2051,2057,2058,2064],{"type":48,"tag":61,"props":2019,"children":2020},{},[2021],{"type":48,"tag":69,"props":2022,"children":2024},{"className":2023},[],[2025],{"type":53,"value":2026},"utilities",{"type":53,"value":2028}," — the meta \u002F discovery family; skills with\n",{"type":48,"tag":69,"props":2030,"children":2032},{"className":2031},[],[2033],{"type":53,"value":2034},"family: utilities",{"type":53,"value":2036},": ",{"type":48,"tag":69,"props":2038,"children":2040},{"className":2039},[],[2041],{"type":53,"value":2042},"list-skills",{"type":53,"value":276},{"type":48,"tag":69,"props":2045,"children":2047},{"className":2046},[],[2048],{"type":53,"value":2049},"write-skill",{"type":53,"value":1950},{"type":48,"tag":69,"props":2052,"children":2054},{"className":2053},[],[2055],{"type":53,"value":2056},"optimize-skill",{"type":53,"value":276},{"type":48,"tag":69,"props":2059,"children":2061},{"className":2060},[],[2062],{"type":53,"value":2063},"skill-reconciler",{"type":53,"value":2065},". These are framework\nself-authoring and discovery tools every adopter gets so the\nframework can grow them without re-prompting.",{"type":48,"tag":55,"props":2067,"children":2068},{},[2069,2071,2077,2079,2085,2087,2092,2094,2099],{"type":53,"value":2070},"These two always-on families (",{"type":48,"tag":69,"props":2072,"children":2074},{"className":2073},[],[2075],{"type":53,"value":2076},"ALWAYS_ON_FAMILIES",{"type":53,"value":2078}," in the\nvalidator) are not exposed in the ",{"type":48,"tag":69,"props":2080,"children":2082},{"className":2081},[],[2083],{"type":53,"value":2084},"skill-families:",{"type":53,"value":2086}," prompt and\nnot stored as user-selectable in the lock files; every\nsub-action that wires symlinks always covers them ",{"type":48,"tag":61,"props":2088,"children":2089},{},[2090],{"type":53,"value":2091},"in addition\nto",{"type":53,"value":2093}," the user's opt-in family picks. Dropping them is ",{"type":48,"tag":954,"props":2095,"children":2096},{},[2097],{"type":53,"value":2098},"not",{"type":53,"value":2100}," a\nsupported configuration — the secure-setup, discovery, and\nskill-authoring flows the framework ships depend on those\nskills being callable.",{"type":48,"tag":55,"props":2102,"children":2103},{},[2104,2106,2111,2113,2118,2120,2125,2126,2132,2133,2139,2140,2146,2147,2152,2153,2159,2160,2166,2167,2172,2174,2179],{"type":53,"value":2105},"Every ",{"type":48,"tag":61,"props":2107,"children":2108},{},[2109],{"type":53,"value":2110},"other",{"type":53,"value":2112}," family is ",{"type":48,"tag":61,"props":2114,"children":2115},{},[2116],{"type":53,"value":2117},"opt-in",{"type":53,"value":2119}," — offered in the Step 5\nprompt and recorded in the lock files. Today those are:\n",{"type":48,"tag":69,"props":2121,"children":2123},{"className":2122},[],[2124],{"type":53,"value":29},{"type":53,"value":276},{"type":48,"tag":69,"props":2127,"children":2129},{"className":2128},[],[2130],{"type":53,"value":2131},"pr-management",{"type":53,"value":276},{"type":48,"tag":69,"props":2134,"children":2136},{"className":2135},[],[2137],{"type":53,"value":2138},"issue",{"type":53,"value":276},{"type":48,"tag":69,"props":2141,"children":2143},{"className":2142},[],[2144],{"type":53,"value":2145},"release-management",{"type":53,"value":1950},{"type":48,"tag":69,"props":2148,"children":2150},{"className":2149},[],[2151],{"type":53,"value":1838},{"type":53,"value":276},{"type":48,"tag":69,"props":2154,"children":2156},{"className":2155},[],[2157],{"type":53,"value":2158},"pairing",{"type":53,"value":276},{"type":48,"tag":69,"props":2161,"children":2163},{"className":2162},[],[2164],{"type":53,"value":2165},"mentoring",{"type":53,"value":276},{"type":48,"tag":69,"props":2168,"children":2170},{"className":2169},[],[2171],{"type":53,"value":1845},{"type":53,"value":2173},".\nThe set is computed from the ",{"type":48,"tag":69,"props":2175,"children":2177},{"className":2176},[],[2178],{"type":53,"value":1807},{"type":53,"value":2180}," keys present in the\nsnapshot minus the always-on families, so a new opt-in family\nappears in the prompt automatically the run after it ships.",{"type":48,"tag":55,"props":2182,"children":2183},{},[2184,2196,2198,2203,2205,2210,2212,2217,2219,2224,2226,2231,2233,2238,2240,2245,2247,2252,2254,2259],{"type":48,"tag":61,"props":2185,"children":2186},{},[2187,2189,2194],{"type":53,"value":2188},"Golden rule 9 — reload ",{"type":48,"tag":69,"props":2190,"children":2192},{"className":2191},[],[2193],{"type":53,"value":39},{"type":53,"value":2195}," in-flight after a\nself-update.",{"type":53,"value":2197}," When a sub-action changes or creates the\ncontent of the committed ",{"type":48,"tag":69,"props":2199,"children":2201},{"className":2200},[],[2202],{"type":53,"value":39},{"type":53,"value":2204}," skill (in practice:\n",{"type":48,"tag":69,"props":2206,"children":2208},{"className":2207},[],[2209],{"type":53,"value":474},{"type":53,"value":2211}," recovering an out-of-date bootstrap, or ",{"type":48,"tag":69,"props":2213,"children":2215},{"className":2214},[],[2216],{"type":53,"value":767},{"type":53,"value":2218},"'s\noverwrite-from-snapshot step), the agent ",{"type":48,"tag":61,"props":2220,"children":2221},{},[2222],{"type":53,"value":2223},"re-reads the\nmodified files of this skill before continuing",{"type":53,"value":2225}," the rest of\nthe current run. Concretely: after the copy lands on disk,\nre-load ",{"type":48,"tag":69,"props":2227,"children":2229},{"className":2228},[],[2230],{"type":53,"value":1815},{"type":53,"value":2232}," and the sub-action file you are\ncurrently executing (and any helper file you have already\nopened, such as ",{"type":48,"tag":69,"props":2234,"children":2236},{"className":2235},[],[2237],{"type":53,"value":310},{"type":53,"value":2239}," or ",{"type":48,"tag":69,"props":2241,"children":2243},{"className":2242},[],[2244],{"type":53,"value":348},{"type":53,"value":2246},"), then\nresume from the step after the overwrite. The reload runs as\nthe ",{"type":48,"tag":61,"props":2248,"children":2249},{},[2250],{"type":53,"value":2251},"first thing",{"type":53,"value":2253}," that happens after the overwrite, before\nany further reconciliation, symlink work, or doc updates.\nThe reason: the snapshot's skill version may have renamed\nsteps, added new sub-actions, or changed the symlink\ncontract; finishing the run against the ",{"type":48,"tag":954,"props":2255,"children":2256},{},[2257],{"type":53,"value":2258},"old",{"type":53,"value":2260}," in-memory\ncopy of the skill would silently mis-apply the new\nframework version the project just pinned to.",{"type":48,"tag":492,"props":2262,"children":2264},{"id":2263},"sub-actions",[2265],{"type":53,"value":2266},"Sub-actions",{"type":48,"tag":55,"props":2268,"children":2269},{},[2270],{"type":53,"value":2271},"The skill dispatches by the first positional argument:",{"type":48,"tag":777,"props":2273,"children":2274},{},[2275,2295],{"type":48,"tag":781,"props":2276,"children":2277},{},[2278],{"type":48,"tag":785,"props":2279,"children":2280},{},[2281,2286,2291],{"type":48,"tag":789,"props":2282,"children":2283},{},[2284],{"type":53,"value":2285},"Invocation",{"type":48,"tag":789,"props":2287,"children":2288},{},[2289],{"type":53,"value":2290},"Loads",{"type":48,"tag":789,"props":2292,"children":2293},{},[2294],{"type":53,"value":798},{"type":48,"tag":800,"props":2296,"children":2297},{},[2298,2341,2368,2416,2457,2484,2541,2569],{"type":48,"tag":785,"props":2299,"children":2300},{},[2301,2311,2322],{"type":48,"tag":807,"props":2302,"children":2303},{},[2304,2309],{"type":48,"tag":69,"props":2305,"children":2307},{"className":2306},[],[2308],{"type":53,"value":330},{"type":53,"value":2310}," (no args)",{"type":48,"tag":807,"props":2312,"children":2313},{},[2314],{"type":48,"tag":119,"props":2315,"children":2316},{"href":486},[2317],{"type":48,"tag":69,"props":2318,"children":2320},{"className":2319},[],[2321],{"type":53,"value":486},{"type":48,"tag":807,"props":2323,"children":2324},{},[2325,2327,2332,2334,2340],{"type":53,"value":2326},"First-time adoption (default; ",{"type":48,"tag":61,"props":2328,"children":2329},{},[2330],{"type":53,"value":2331},"main-checkout only",{"type":53,"value":2333},"). Idempotent — re-running on an already-adopted repo behaves like ",{"type":48,"tag":69,"props":2335,"children":2337},{"className":2336},[],[2338],{"type":53,"value":2339},"verify",{"type":53,"value":189},{"type":48,"tag":785,"props":2342,"children":2343},{},[2344,2352,2363],{"type":48,"tag":807,"props":2345,"children":2346},{},[2347],{"type":48,"tag":69,"props":2348,"children":2350},{"className":2349},[],[2351],{"type":53,"value":577},{"type":48,"tag":807,"props":2353,"children":2354},{},[2355],{"type":48,"tag":119,"props":2356,"children":2357},{"href":486},[2358],{"type":48,"tag":69,"props":2359,"children":2361},{"className":2360},[],[2362],{"type":53,"value":486},{"type":48,"tag":807,"props":2364,"children":2365},{},[2366],{"type":53,"value":2367},"Same as no-arg — explicit form. Main-checkout only.",{"type":48,"tag":785,"props":2369,"children":2370},{},[2371,2379,2390],{"type":48,"tag":807,"props":2372,"children":2373},{},[2374],{"type":48,"tag":69,"props":2375,"children":2377},{"className":2376},[],[2378],{"type":53,"value":187},{"type":48,"tag":807,"props":2380,"children":2381},{},[2382],{"type":48,"tag":119,"props":2383,"children":2384},{"href":839},[2385],{"type":48,"tag":69,"props":2386,"children":2388},{"className":2387},[],[2389],{"type":53,"value":839},{"type":48,"tag":807,"props":2391,"children":2392},{},[2393,2395,2400,2402,2407,2409,2415],{"type":53,"value":2394},"Refresh snapshot per ",{"type":48,"tag":69,"props":2396,"children":2398},{"className":2397},[],[2399],{"type":53,"value":527},{"type":53,"value":2401}," + reconcile overrides + refresh symlinks. ",{"type":48,"tag":61,"props":2403,"children":2404},{},[2405],{"type":53,"value":2406},"Main-checkout only",{"type":53,"value":2408}," — worktrees pick up upgrades automatically via the symlink installed by ",{"type":48,"tag":69,"props":2410,"children":2412},{"className":2411},[],[2413],{"type":53,"value":2414},"worktree-init",{"type":53,"value":189},{"type":48,"tag":785,"props":2417,"children":2418},{},[2419,2428,2440],{"type":48,"tag":807,"props":2420,"children":2421},{},[2422],{"type":48,"tag":69,"props":2423,"children":2425},{"className":2424},[],[2426],{"type":53,"value":2427},"\u002Fmagpie-setup worktree-init",{"type":48,"tag":807,"props":2429,"children":2430},{},[2431],{"type":48,"tag":119,"props":2432,"children":2434},{"href":2433},"worktree-init.md",[2435],{"type":48,"tag":69,"props":2436,"children":2438},{"className":2437},[],[2439],{"type":53,"value":2433},{"type":48,"tag":807,"props":2441,"children":2442},{},[2443,2448,2450,2455],{"type":48,"tag":61,"props":2444,"children":2445},{},[2446],{"type":53,"value":2447},"Worktree-only.",{"type":53,"value":2449}," Symlink the worktree's ",{"type":48,"tag":69,"props":2451,"children":2453},{"className":2452},[],[2454],{"type":53,"value":74},{"type":53,"value":2456}," to the main checkout's so this worktree shares one framework state. No fetch, no lock files written; idempotent.",{"type":48,"tag":785,"props":2458,"children":2459},{},[2460,2468,2479],{"type":48,"tag":807,"props":2461,"children":2462},{},[2463],{"type":48,"tag":69,"props":2464,"children":2466},{"className":2465},[],[2467],{"type":53,"value":1262},{"type":48,"tag":807,"props":2469,"children":2470},{},[2471],{"type":48,"tag":119,"props":2472,"children":2473},{"href":859},[2474],{"type":48,"tag":69,"props":2475,"children":2477},{"className":2476},[],[2478],{"type":53,"value":859},{"type":48,"tag":807,"props":2480,"children":2481},{},[2482],{"type":53,"value":2483},"Read-only health check + drift status report. Works in both main and worktrees.",{"type":48,"tag":785,"props":2485,"children":2486},{},[2487,2506,2517],{"type":48,"tag":807,"props":2488,"children":2489},{},[2490,2496,2498,2504],{"type":48,"tag":69,"props":2491,"children":2493},{"className":2492},[],[2494],{"type":53,"value":2495},"\u002Fmagpie-setup skill-sources",{"type":53,"value":2497}," (aka ",{"type":48,"tag":69,"props":2499,"children":2501},{"className":2500},[],[2502],{"type":53,"value":2503},"skill-sources add \u003Cid>",{"type":53,"value":2505},")",{"type":48,"tag":807,"props":2507,"children":2508},{},[2509],{"type":48,"tag":119,"props":2510,"children":2511},{"href":753},[2512],{"type":48,"tag":69,"props":2513,"children":2515},{"className":2514},[],[2516],{"type":53,"value":753},{"type":48,"tag":807,"props":2518,"children":2519},{},[2520,2522,2527,2529,2533,2535,2540],{"type":53,"value":2521},"Fetch\u002Fverify\u002Fpin\u002Fsymlink skills from the trusted external sources the adopter listed in ",{"type":48,"tag":69,"props":2523,"children":2525},{"className":2524},[],[2526],{"type":53,"value":917},{"type":53,"value":2528},". ",{"type":48,"tag":61,"props":2530,"children":2531},{},[2532],{"type":53,"value":2406},{"type":53,"value":2534}," — worktrees share the source snapshots via ",{"type":48,"tag":69,"props":2536,"children":2538},{"className":2537},[],[2539],{"type":53,"value":2414},{"type":53,"value":189},{"type":48,"tag":785,"props":2542,"children":2543},{},[2544,2553,2564],{"type":48,"tag":807,"props":2545,"children":2546},{},[2547],{"type":48,"tag":69,"props":2548,"children":2550},{"className":2549},[],[2551],{"type":53,"value":2552},"\u002Fmagpie-setup override \u003Cskill>",{"type":48,"tag":807,"props":2554,"children":2555},{},[2556],{"type":48,"tag":119,"props":2557,"children":2558},{"href":348},[2559],{"type":48,"tag":69,"props":2560,"children":2562},{"className":2561},[],[2563],{"type":53,"value":348},{"type":48,"tag":807,"props":2565,"children":2566},{},[2567],{"type":53,"value":2568},"Open \u002F scaffold an override file.",{"type":48,"tag":785,"props":2570,"children":2571},{},[2572,2581,2592],{"type":48,"tag":807,"props":2573,"children":2574},{},[2575],{"type":48,"tag":69,"props":2576,"children":2578},{"className":2577},[],[2579],{"type":53,"value":2580},"\u002Fmagpie-setup unadopt",{"type":48,"tag":807,"props":2582,"children":2583},{},[2584],{"type":48,"tag":119,"props":2585,"children":2586},{"href":1023},[2587],{"type":48,"tag":69,"props":2588,"children":2590},{"className":2589},[],[2591],{"type":53,"value":1023},{"type":48,"tag":807,"props":2593,"children":2594},{},[2595,2597,2602,2604,2609,2611],{"type":53,"value":2596},"Reverse the adoption. Removes snapshot, locks, symlinks, hook, doc sections, and this skill itself. Preserves ",{"type":48,"tag":69,"props":2598,"children":2600},{"className":2599},[],[2601],{"type":53,"value":828},{"type":53,"value":2603}," unless ",{"type":48,"tag":69,"props":2605,"children":2607},{"className":2606},[],[2608],{"type":53,"value":1084},{"type":53,"value":2610}," is passed. ",{"type":48,"tag":61,"props":2612,"children":2613},{},[2614],{"type":53,"value":2615},"Main-checkout only.",{"type":48,"tag":55,"props":2617,"children":2618},{},[2619,2624,2626,2631,2632,2637,2638,2644,2646,2652,2654,2660,2662,2667,2669,2674,2676,2681,2683,2688],{"type":48,"tag":61,"props":2620,"children":2621},{},[2622],{"type":53,"value":2623},"Main-checkout-only sub-actions",{"type":53,"value":2625}," (",{"type":48,"tag":69,"props":2627,"children":2629},{"className":2628},[],[2630],{"type":53,"value":474},{"type":53,"value":276},{"type":48,"tag":69,"props":2633,"children":2635},{"className":2634},[],[2636],{"type":53,"value":767},{"type":53,"value":276},{"type":48,"tag":69,"props":2639,"children":2641},{"className":2640},[],[2642],{"type":53,"value":2643},"unadopt",{"type":53,"value":2645},")\ndetect their context via ",{"type":48,"tag":69,"props":2647,"children":2649},{"className":2648},[],[2650],{"type":53,"value":2651},"git rev-parse --git-dir",{"type":53,"value":2653}," ≠\n",{"type":48,"tag":69,"props":2655,"children":2657},{"className":2656},[],[2658],{"type":53,"value":2659},"git rev-parse --git-common-dir",{"type":53,"value":2661}," and refuse to run in a worktree\nwith a pointer back to the main checkout. The worktree counterpart\nof ",{"type":48,"tag":69,"props":2663,"children":2665},{"className":2664},[],[2666],{"type":53,"value":474},{"type":53,"value":2668}," is ",{"type":48,"tag":69,"props":2670,"children":2672},{"className":2671},[],[2673],{"type":53,"value":2414},{"type":53,"value":2675},"; for ",{"type":48,"tag":69,"props":2677,"children":2679},{"className":2678},[],[2680],{"type":53,"value":767},{"type":53,"value":2682},", every worktree\nautomatically sees the refreshed snapshot once the main runs\nupgrade, because each worktree's ",{"type":48,"tag":69,"props":2684,"children":2686},{"className":2685},[],[2687],{"type":53,"value":74},{"type":53,"value":2689}," is a symlink to\nthe main's.",{"type":48,"tag":55,"props":2691,"children":2692},{},[2693,2716,2718,2723,2725,2731,2733,2744,2746,2757],{"type":48,"tag":61,"props":2694,"children":2695},{},[2696,2701,2702,2707,2709,2714],{"type":48,"tag":69,"props":2697,"children":2699},{"className":2698},[],[2700],{"type":53,"value":474},{"type":53,"value":1239},{"type":48,"tag":69,"props":2703,"children":2705},{"className":2704},[],[2706],{"type":53,"value":767},{"type":53,"value":2708}," always chain into ",{"type":48,"tag":69,"props":2710,"children":2712},{"className":2711},[],[2713],{"type":53,"value":2414},{"type":53,"value":2715}," on every\nlinked worktree as their final pass.",{"type":53,"value":2717}," The chain is unconditional\n— even on a fresh adoption with no linked worktrees yet (the pass\nbecomes a no-op), even on an upgrade where every worktree already\nlooks wired (",{"type":48,"tag":69,"props":2719,"children":2721},{"className":2720},[],[2722],{"type":53,"value":2414},{"type":53,"value":2724}," is idempotent, repairs broken\nsymlinks, and adds new always-on-family entries the upgrade\nintroduced). The user does not need to remember to ",{"type":48,"tag":69,"props":2726,"children":2728},{"className":2727},[],[2729],{"type":53,"value":2730},"cd",{"type":53,"value":2732}," into each\nworktree and re-run anything; the main-checkout sub-action\npropagates state outward to the worktrees by itself. See\n",{"type":48,"tag":119,"props":2734,"children":2736},{"href":2735},"adopt.md#step-12--post-install-sync--worktree-propagation--sandbox-allowlist--sanity-check",[2737,2742],{"type":48,"tag":69,"props":2738,"children":2740},{"className":2739},[],[2741],{"type":53,"value":486},{"type":53,"value":2743}," Step 12.2",{"type":53,"value":2745},"\nand\n",{"type":48,"tag":119,"props":2747,"children":2749},{"href":2748},"upgrade.md#step-6c--propagate-to-every-worktree-run-worktree-init-unconditionally",[2750,2755],{"type":48,"tag":69,"props":2751,"children":2753},{"className":2752},[],[2754],{"type":53,"value":839},{"type":53,"value":2756}," Step 6c",{"type":53,"value":189},{"type":48,"tag":55,"props":2759,"children":2760},{},[2761,2763,2769,2771,2776],{"type":53,"value":2762},"If the snapshot is missing (no ",{"type":48,"tag":69,"props":2764,"children":2766},{"className":2765},[],[2767],{"type":53,"value":2768},"\u003Csnapshot-dir>\u002F",{"type":53,"value":2770},") and\n",{"type":48,"tag":69,"props":2772,"children":2774},{"className":2773},[],[2775],{"type":53,"value":527},{"type":53,"value":2777}," exists, the skill treats any sub-action as\nthe recover-snapshot path: re-install per the committed lock\nfirst, then continue.",{"type":48,"tag":492,"props":2779,"children":2781},{"id":2780},"inputs",[2782],{"type":53,"value":2783},"Inputs",{"type":48,"tag":777,"props":2785,"children":2786},{},[2787,2803],{"type":48,"tag":781,"props":2788,"children":2789},{},[2790],{"type":48,"tag":785,"props":2791,"children":2792},{},[2793,2798],{"type":48,"tag":789,"props":2794,"children":2795},{},[2796],{"type":53,"value":2797},"Flag",{"type":48,"tag":789,"props":2799,"children":2800},{},[2801],{"type":53,"value":2802},"Effect",{"type":48,"tag":800,"props":2804,"children":2805},{},[2806,2851,2910,3030,3181,3216],{"type":48,"tag":785,"props":2807,"children":2808},{},[2809,2825],{"type":48,"tag":807,"props":2810,"children":2811},{},[2812,2818,2819],{"type":48,"tag":69,"props":2813,"children":2815},{"className":2814},[],[2816],{"type":53,"value":2817},"from:\u003Cgit-ref>",{"type":53,"value":1049},{"type":48,"tag":69,"props":2820,"children":2822},{"className":2821},[],[2823],{"type":53,"value":2824},"from:\u003Cversion>",{"type":48,"tag":807,"props":2826,"children":2827},{},[2828,2830,2835,2837,2842,2844,2849],{"type":53,"value":2829},"Adopt or upgrade from a specific framework ref or version. Used during ",{"type":48,"tag":69,"props":2831,"children":2833},{"className":2832},[],[2834],{"type":53,"value":474},{"type":53,"value":2836}," (overrides the user prompt) and ",{"type":48,"tag":69,"props":2838,"children":2840},{"className":2839},[],[2841],{"type":53,"value":767},{"type":53,"value":2843}," (overrides the committed lock for ",{"type":48,"tag":954,"props":2845,"children":2846},{},[2847],{"type":53,"value":2848},"this run only",{"type":53,"value":2850}," — does NOT update the committed lock).",{"type":48,"tag":785,"props":2852,"children":2853},{},[2854,2863],{"type":48,"tag":807,"props":2855,"children":2856},{},[2857],{"type":48,"tag":69,"props":2858,"children":2860},{"className":2859},[],[2861],{"type":53,"value":2862},"method:\u003Cgit-branch|git-tag|svn-zip|local>",{"type":48,"tag":807,"props":2864,"children":2865},{},[2866,2868,2873,2875,2884,2885,2890,2892,2898,2900,2909],{"type":53,"value":2867},"Pick the install method explicitly. Default during ",{"type":48,"tag":69,"props":2869,"children":2871},{"className":2870},[],[2872],{"type":53,"value":474},{"type":53,"value":2874},": prompt the user. ",{"type":48,"tag":61,"props":2876,"children":2877},{},[2878],{"type":48,"tag":69,"props":2879,"children":2881},{"className":2880},[],[2882],{"type":53,"value":2883},"local",{"type":53,"value":2668},{"type":48,"tag":61,"props":2886,"children":2887},{},[2888],{"type":53,"value":2889},"framework-checkout only",{"type":53,"value":2891}," — it self-adopts by linking the in-repo ",{"type":48,"tag":69,"props":2893,"children":2895},{"className":2894},[],[2896],{"type":53,"value":2897},"skills\u002F",{"type":53,"value":2899}," source directly instead of fetching a snapshot (see ",{"type":48,"tag":119,"props":2901,"children":2902},{"href":479},[2903,2908],{"type":48,"tag":69,"props":2904,"children":2906},{"className":2905},[],[2907],{"type":53,"value":486},{"type":53,"value":488},{"type":53,"value":490},{"type":48,"tag":785,"props":2911,"children":2912},{},[2913,2922],{"type":48,"tag":807,"props":2914,"children":2915},{},[2916],{"type":48,"tag":69,"props":2917,"children":2919},{"className":2918},[],[2920],{"type":53,"value":2921},"agents:\u003Clist>",{"type":48,"tag":807,"props":2923,"children":2924},{},[2925,2927,2932,2934,2942,2944,2950,2951,2956,2957,2962,2963,2969,2970,2976,2978,2983,2984,2989,2991,2996,2997,3002,3003,3008,3010,3015,3017,3022,3023,3028],{"type":53,"value":2926},"Comma-separated ",{"type":48,"tag":61,"props":2928,"children":2929},{},[2930],{"type":53,"value":2931},"agent targets",{"type":53,"value":2933}," to wire symlinks into (",{"type":48,"tag":119,"props":2935,"children":2936},{"href":310},[2937],{"type":48,"tag":69,"props":2938,"children":2940},{"className":2939},[],[2941],{"type":53,"value":310},{"type":53,"value":2943}," registry ids: ",{"type":48,"tag":69,"props":2945,"children":2947},{"className":2946},[],[2948],{"type":53,"value":2949},"universal",{"type":53,"value":276},{"type":48,"tag":69,"props":2952,"children":2954},{"className":2953},[],[2955],{"type":53,"value":27},{"type":53,"value":276},{"type":48,"tag":69,"props":2958,"children":2960},{"className":2959},[],[2961],{"type":53,"value":986},{"type":53,"value":276},{"type":48,"tag":69,"props":2964,"children":2966},{"className":2965},[],[2967],{"type":53,"value":2968},"windsurf",{"type":53,"value":276},{"type":48,"tag":69,"props":2971,"children":2973},{"className":2972},[],[2974],{"type":53,"value":2975},"goose",{"type":53,"value":2977},", …). Default on ",{"type":48,"tag":69,"props":2979,"children":2981},{"className":2980},[],[2982],{"type":53,"value":474},{"type":53,"value":701},{"type":48,"tag":69,"props":2985,"children":2987},{"className":2986},[],[2988],{"type":53,"value":767},{"type":53,"value":2990},": auto — the always-on neutral set (",{"type":48,"tag":69,"props":2992,"children":2994},{"className":2993},[],[2995],{"type":53,"value":2949},{"type":53,"value":716},{"type":48,"tag":69,"props":2998,"children":3000},{"className":2999},[],[3001],{"type":53,"value":27},{"type":53,"value":716},{"type":48,"tag":69,"props":3004,"children":3006},{"className":3005},[],[3007],{"type":53,"value":986},{"type":53,"value":3009},") plus any other registry dir already present in the repo. When passed, ",{"type":48,"tag":61,"props":3011,"children":3012},{},[3013],{"type":53,"value":3014},"replaces",{"type":53,"value":3016}," the auto-detected set for that run, except ",{"type":48,"tag":69,"props":3018,"children":3020},{"className":3019},[],[3021],{"type":53,"value":2949},{"type":53,"value":2625},{"type":48,"tag":69,"props":3024,"children":3026},{"className":3025},[],[3027],{"type":53,"value":248},{"type":53,"value":3029},") which is always retained because it is the canonical home every other target relays into — dropping it would leave the relays dangling.",{"type":48,"tag":785,"props":3031,"children":3032},{},[3033,3042],{"type":48,"tag":807,"props":3034,"children":3035},{},[3036],{"type":48,"tag":69,"props":3037,"children":3039},{"className":3038},[],[3040],{"type":53,"value":3041},"skill-families:\u003Clist>",{"type":48,"tag":807,"props":3043,"children":3044},{},[3045,3046,3050,3052,3057,3059,3064,3065,3070,3071,3076,3077,3082,3083,3088,3089,3094,3095,3100,3101,3106,3108,3113,3115,3126,3127,3132,3134,3139,3140,3145,3146,3151,3153,3158,3160,3165,3166,3171,3173,3179],{"type":53,"value":2926},{"type":48,"tag":61,"props":3047,"children":3048},{},[3049],{"type":53,"value":2117},{"type":53,"value":3051}," families to symlink — any of the opt-in families declared by a ",{"type":48,"tag":69,"props":3053,"children":3055},{"className":3054},[],[3056],{"type":53,"value":1807},{"type":53,"value":3058}," frontmatter key in the snapshot (today: ",{"type":48,"tag":69,"props":3060,"children":3062},{"className":3061},[],[3063],{"type":53,"value":29},{"type":53,"value":276},{"type":48,"tag":69,"props":3066,"children":3068},{"className":3067},[],[3069],{"type":53,"value":2131},{"type":53,"value":276},{"type":48,"tag":69,"props":3072,"children":3074},{"className":3073},[],[3075],{"type":53,"value":2138},{"type":53,"value":276},{"type":48,"tag":69,"props":3078,"children":3080},{"className":3079},[],[3081],{"type":53,"value":2145},{"type":53,"value":276},{"type":48,"tag":69,"props":3084,"children":3086},{"className":3085},[],[3087],{"type":53,"value":1838},{"type":53,"value":276},{"type":48,"tag":69,"props":3090,"children":3092},{"className":3091},[],[3093],{"type":53,"value":2158},{"type":53,"value":276},{"type":48,"tag":69,"props":3096,"children":3098},{"className":3097},[],[3099],{"type":53,"value":2165},{"type":53,"value":276},{"type":48,"tag":69,"props":3102,"children":3104},{"className":3103},[],[3105],{"type":53,"value":1845},{"type":53,"value":3107},"). Default on ",{"type":48,"tag":69,"props":3109,"children":3111},{"className":3110},[],[3112],{"type":53,"value":474},{"type":53,"value":3114},": prompt (see ",{"type":48,"tag":119,"props":3116,"children":3118},{"href":3117},"adopt.md#step-5--pick-the-skill-families-and-mcp-servers",[3119,3124],{"type":48,"tag":69,"props":3120,"children":3122},{"className":3121},[],[3123],{"type":53,"value":486},{"type":53,"value":3125}," Step 5",{"type":53,"value":3107},{"type":48,"tag":69,"props":3128,"children":3130},{"className":3129},[],[3131],{"type":53,"value":767},{"type":53,"value":3133},": read the families list from ",{"type":48,"tag":69,"props":3135,"children":3137},{"className":3136},[],[3138],{"type":53,"value":527},{"type":53,"value":1049},{"type":48,"tag":69,"props":3141,"children":3143},{"className":3142},[],[3144],{"type":53,"value":596},{"type":53,"value":276},{"type":48,"tag":61,"props":3147,"children":3148},{},[3149],{"type":53,"value":3150},"auto-include any opt-in family the framework has introduced since the lock was written",{"type":53,"value":3152}," (recorded back into the lock), and ",{"type":48,"tag":61,"props":3154,"children":3155},{},[3156],{"type":53,"value":3157},"ensure every framework skill in the effective family set has a valid symlink",{"type":53,"value":3159}," — create or repair missing \u002F broken symlinks, not just add new ones. The flag never accepts the always-on families (",{"type":48,"tag":69,"props":3161,"children":3163},{"className":3162},[],[3164],{"type":53,"value":39},{"type":53,"value":276},{"type":48,"tag":69,"props":3167,"children":3169},{"className":3168},[],[3170],{"type":53,"value":2026},{"type":53,"value":3172},"); per ",{"type":48,"tag":119,"props":3174,"children":3176},{"href":3175},"#golden-rules",[3177],{"type":53,"value":3178},"Golden rule 8",{"type":53,"value":3180}," those are wired up unconditionally on every run and there is no way to ask for them or opt out.",{"type":48,"tag":785,"props":3182,"children":3183},{},[3184,3192],{"type":48,"tag":807,"props":3185,"children":3186},{},[3187],{"type":48,"tag":69,"props":3188,"children":3190},{"className":3189},[],[3191],{"type":53,"value":1084},{"type":48,"tag":807,"props":3193,"children":3194},{},[3195,3200,3202,3208,3209,3214],{"type":48,"tag":954,"props":3196,"children":3197},{},[3198],{"type":53,"value":3199},"(unadopt only)",{"type":53,"value":3201}," Also ",{"type":48,"tag":69,"props":3203,"children":3205},{"className":3204},[],[3206],{"type":53,"value":3207},"git rm -r",{"type":53,"value":1921},{"type":48,"tag":69,"props":3210,"children":3212},{"className":3211},[],[3213],{"type":53,"value":828},{"type":53,"value":3215},". Default: preserve.",{"type":48,"tag":785,"props":3217,"children":3218},{},[3219,3228],{"type":48,"tag":807,"props":3220,"children":3221},{},[3222],{"type":48,"tag":69,"props":3223,"children":3225},{"className":3224},[],[3226],{"type":53,"value":3227},"dry-run",{"type":48,"tag":807,"props":3229,"children":3230},{},[3231],{"type":53,"value":3232},"Show what the skill would do without writing anything.",{"type":48,"tag":492,"props":3234,"children":3236},{"id":3235},"what-this-skill-is-not-for",[3237],{"type":53,"value":3238},"What this skill is NOT for",{"type":48,"tag":90,"props":3240,"children":3241},{},[3242,3257,3293,3316],{"type":48,"tag":94,"props":3243,"children":3244},{},[3245,3247,3256],{"type":53,"value":3246},"Not for installing the secure agent setup (sandbox, hooks,\npinned tools). That is\n",{"type":48,"tag":119,"props":3248,"children":3250},{"href":3249},"..\u002Fsetup-isolated-setup-install\u002FSKILL.md",[3251],{"type":48,"tag":69,"props":3252,"children":3254},{"className":3253},[],[3255],{"type":53,"value":1948},{"type":53,"value":189},{"type":48,"tag":94,"props":3258,"children":3259},{},[3260,3262,3268,3269,3275,3276,3281,3283,3292],{"type":53,"value":3261},"Not for upgrading framework tools installed on the host\n(",{"type":48,"tag":69,"props":3263,"children":3265},{"className":3264},[],[3266],{"type":53,"value":3267},"bubblewrap",{"type":53,"value":276},{"type":48,"tag":69,"props":3270,"children":3272},{"className":3271},[],[3273],{"type":53,"value":3274},"socat",{"type":53,"value":276},{"type":48,"tag":69,"props":3277,"children":3279},{"className":3278},[],[3280],{"type":53,"value":27},{"type":53,"value":3282}," itself). That is\n",{"type":48,"tag":119,"props":3284,"children":3286},{"href":3285},"..\u002Fsetup-isolated-setup-update\u002FSKILL.md",[3287],{"type":48,"tag":69,"props":3288,"children":3290},{"className":3289},[],[3291],{"type":53,"value":1956},{"type":53,"value":189},{"type":48,"tag":94,"props":3294,"children":3295},{},[3296,3298,3304,3306,3315],{"type":53,"value":3297},"Not for syncing the user's ",{"type":48,"tag":69,"props":3299,"children":3301},{"className":3300},[],[3302],{"type":53,"value":3303},"~\u002F.claude-config",{"type":53,"value":3305}," across\nmachines. That is\n",{"type":48,"tag":119,"props":3307,"children":3309},{"href":3308},"..\u002Fsetup-shared-config-sync\u002FSKILL.md",[3310],{"type":48,"tag":69,"props":3311,"children":3313},{"className":3312},[],[3314],{"type":53,"value":1984},{"type":53,"value":189},{"type":48,"tag":94,"props":3317,"children":3318},{},[3319,3321,3327],{"type":53,"value":3320},"Not for committing framework changes. Framework PRs go\nagainst ",{"type":48,"tag":69,"props":3322,"children":3324},{"className":3323},[],[3325],{"type":53,"value":3326},"apache\u002Fmagpie",{"type":53,"value":3328}," directly — the snapshot is\nread-only.",{"type":48,"tag":492,"props":3330,"children":3332},{"id":3331},"failure-modes",[3333],{"type":53,"value":3334},"Failure modes",{"type":48,"tag":777,"props":3336,"children":3337},{},[3338,3359],{"type":48,"tag":781,"props":3339,"children":3340},{},[3341],{"type":48,"tag":785,"props":3342,"children":3343},{},[3344,3349,3354],{"type":48,"tag":789,"props":3345,"children":3346},{},[3347],{"type":53,"value":3348},"Symptom",{"type":48,"tag":789,"props":3350,"children":3351},{},[3352],{"type":53,"value":3353},"Likely cause",{"type":48,"tag":789,"props":3355,"children":3356},{},[3357],{"type":53,"value":3358},"Remediation",{"type":48,"tag":800,"props":3360,"children":3361},{},[3362,3402,3448,3486,3526],{"type":48,"tag":785,"props":3363,"children":3364},{},[3365,3375,3394],{"type":48,"tag":807,"props":3366,"children":3367},{},[3368,3373],{"type":48,"tag":69,"props":3369,"children":3371},{"className":3370},[],[3372],{"type":53,"value":1262},{"type":53,"value":3374}," reports drift between committed and local locks",{"type":48,"tag":807,"props":3376,"children":3377},{},[3378,3380,3385,3387,3392],{"type":53,"value":3379},"Project lead bumped ",{"type":48,"tag":69,"props":3381,"children":3383},{"className":3382},[],[3384],{"type":53,"value":527},{"type":53,"value":3386}," since this machine last fetched, or local snapshot is stale on a ",{"type":48,"tag":69,"props":3388,"children":3390},{"className":3389},[],[3391],{"type":53,"value":169},{"type":53,"value":3393},"-tracking adopter",{"type":48,"tag":807,"props":3395,"children":3396},{},[3397],{"type":48,"tag":69,"props":3398,"children":3400},{"className":3399},[],[3401],{"type":53,"value":187},{"type":48,"tag":785,"props":3403,"children":3404},{},[3405,3410,3430],{"type":48,"tag":807,"props":3406,"children":3407},{},[3408],{"type":53,"value":3409},"Snapshot present but symlinks dangle",{"type":48,"tag":807,"props":3411,"children":3412},{},[3413,3415,3421,3423,3428],{"type":53,"value":3414},"Adopter ran ",{"type":48,"tag":69,"props":3416,"children":3418},{"className":3417},[],[3419],{"type":53,"value":3420},"git clone",{"type":53,"value":3422}," but not ",{"type":48,"tag":69,"props":3424,"children":3426},{"className":3425},[],[3427],{"type":53,"value":330},{"type":53,"value":3429}," after — symlinks are gitignored but persist in their target's absence on disk",{"type":48,"tag":807,"props":3431,"children":3432},{},[3433,3439,3441,3446],{"type":48,"tag":69,"props":3434,"children":3436},{"className":3435},[],[3437],{"type":53,"value":3438},"\u002Fmagpie-setup verify --auto-fix-symlinks",{"type":53,"value":3440}," (or ",{"type":48,"tag":69,"props":3442,"children":3444},{"className":3443},[],[3445],{"type":53,"value":577},{"type":53,"value":3447},", idempotent)",{"type":48,"tag":785,"props":3449,"children":3450},{},[3451,3456,3461],{"type":48,"tag":807,"props":3452,"children":3453},{},[3454],{"type":53,"value":3455},"Worktree off the adopter repo can't find framework skills",{"type":48,"tag":807,"props":3457,"children":3458},{},[3459],{"type":53,"value":3460},"Worktrees off the adopter don't auto-inherit the gitignored snapshot",{"type":48,"tag":807,"props":3462,"children":3463},{},[3464,3465,3470,3472,3478,3480,3485],{"type":53,"value":1397},{"type":48,"tag":69,"props":3466,"children":3468},{"className":3467},[],[3469],{"type":53,"value":474},{"type":53,"value":3471}," sub-action installs a ",{"type":48,"tag":69,"props":3473,"children":3475},{"className":3474},[],[3476],{"type":53,"value":3477},"post-checkout",{"type":53,"value":3479}," git hook that re-runs the snapshot install on worktree creation; verify the hook is present (",{"type":48,"tag":69,"props":3481,"children":3483},{"className":3482},[],[3484],{"type":53,"value":1262},{"type":53,"value":2505},{"type":48,"tag":785,"props":3487,"children":3488},{},[3489,3499,3518],{"type":48,"tag":807,"props":3490,"children":3491},{},[3492,3497],{"type":48,"tag":69,"props":3493,"children":3495},{"className":3494},[],[3496],{"type":53,"value":3420},{"type":53,"value":3498}," of an upstream PR sees no framework skills",{"type":48,"tag":807,"props":3500,"children":3501},{},[3502,3504,3509,3511,3516],{"type":53,"value":3503},"Expected — the snapshot is gitignored, so a fresh clone has no ",{"type":48,"tag":69,"props":3505,"children":3507},{"className":3506},[],[3508],{"type":53,"value":74},{"type":53,"value":3510},". The clone needs ",{"type":48,"tag":69,"props":3512,"children":3514},{"className":3513},[],[3515],{"type":53,"value":330},{"type":53,"value":3517}," once before any framework skill is invocable",{"type":48,"tag":807,"props":3519,"children":3520},{},[3521],{"type":48,"tag":69,"props":3522,"children":3524},{"className":3523},[],[3525],{"type":53,"value":330},{"type":48,"tag":785,"props":3527,"children":3528},{},[3529,3534,3553],{"type":48,"tag":807,"props":3530,"children":3531},{},[3532],{"type":53,"value":3533},"Project decided to stop using apache-magpie",{"type":48,"tag":807,"props":3535,"children":3536},{},[3537,3539,3544,3546,3551],{"type":53,"value":3538},"The reverse of adoption — remove the snapshot, locks, symlinks, hook, doc sections, and the ",{"type":48,"tag":69,"props":3540,"children":3542},{"className":3541},[],[3543],{"type":53,"value":39},{"type":53,"value":3545}," skill itself. ",{"type":48,"tag":69,"props":3547,"children":3549},{"className":3548},[],[3550],{"type":53,"value":828},{"type":53,"value":3552}," is preserved by default",{"type":48,"tag":807,"props":3554,"children":3555},{},[3556,3561,3563,3568],{"type":48,"tag":69,"props":3557,"children":3559},{"className":3558},[],[3560],{"type":53,"value":2580},{"type":53,"value":3562}," (add ",{"type":48,"tag":69,"props":3564,"children":3566},{"className":3565},[],[3567],{"type":53,"value":1084},{"type":53,"value":3569}," to also drop the overrides directory)",{"items":3571,"total":3723},[3572,3590,3606,3617,3629,3642,3660,3671,3681,3692,3702,3712],{"slug":3573,"name":3573,"fn":3574,"description":3575,"org":3576,"tags":3577,"stars":3587,"repoUrl":3588,"updatedAt":3589},"datafusion-python","write Apache DataFusion Python code","Use when the user is writing datafusion-python (Apache DataFusion Python bindings) DataFrame or SQL code. Covers imports, data loading, DataFrame operations, expression building, SQL-to-DataFrame mappings, idiomatic patterns, and common pitfalls.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3578,3581,3584],{"name":3579,"slug":3580,"type":15},"Data Analysis","data-analysis",{"name":3582,"slug":3583,"type":15},"Python","python",{"name":3585,"slug":3586,"type":15},"SQL","sql",593,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fdatafusion-python","2026-07-12T08:36:04.957626",{"slug":3591,"name":3591,"fn":3592,"description":3593,"org":3594,"tags":3595,"stars":3603,"repoUrl":3604,"updatedAt":3605},"bydbql","generate and execute BanyanDB BydbQL queries","Generate, validate, and optionally execute read-only BanyanDB BydbQL for STREAM, MEASURE, TRACE, and PROPERTY resources. Use when the user asks to query BanyanDB, translate natural language to BydbQL, inspect BanyanDB schema or data, validate BydbQL, or fetch raw BanyanDB records.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3596,3599,3602],{"name":3597,"slug":3598,"type":15},"Analytics","analytics",{"name":3600,"slug":3601,"type":15},"Database","database",{"name":3585,"slug":3586,"type":15},344,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fskywalking-banyandb","2026-07-12T08:31:01.294423",{"slug":3607,"name":3607,"fn":3608,"description":3609,"org":3610,"tags":3611,"stars":3603,"repoUrl":3604,"updatedAt":3616},"compiling","compile and build BanyanDB projects","Compile and build the SkyWalking BanyanDB project. Use when the user asks to compile, build, or generate code for this project.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3612,3615],{"name":3613,"slug":3614,"type":15},"Build","build",{"name":17,"slug":18,"type":15},"2026-07-12T08:31:06.373309",{"slug":3618,"name":3618,"fn":3619,"description":3620,"org":3621,"tags":3622,"stars":3603,"repoUrl":3604,"updatedAt":3628},"gh-pull-request","create GitHub pull requests for BanyanDB","Create a GitHub pull request for SkyWalking BanyanDB. Use when the user asks to create a PR, submit changes, or open a pull request.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3623,3625],{"name":3624,"slug":986,"type":15},"GitHub",{"name":3626,"slug":3627,"type":15},"Pull Requests","pull-requests","2026-07-12T08:31:03.792415",{"slug":3630,"name":3630,"fn":3631,"description":3632,"org":3633,"tags":3634,"stars":3603,"repoUrl":3604,"updatedAt":3641},"vendor-update","update Go and Node.js vendor dependencies","Upgrade Go\u002FNode.js vendor dependencies and sync tool versions. Use whenever the user says \"upgrade dependencies\", \"update vendors\", \"vendor update\", \"run vendor-upgrade\", \"bump dependencies\", \"update packages\", or asks to run the `vendor-update` Make target. This skill also checks `scripts\u002Fbuild\u002Fversion.mk` after upgrading to see if any tracked tool versions need updating too, and removes stale binaries from `bin\u002F` when versions change.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3635,3638],{"name":3636,"slug":3637,"type":15},"Go","go",{"name":3639,"slug":3640,"type":15},"Node.js","node-js","2026-07-12T08:31:02.555555",{"slug":3643,"name":3643,"fn":3644,"description":3645,"org":3646,"tags":3647,"stars":3657,"repoUrl":3658,"updatedAt":3659},"cayenne-cgen","generate Cayenne entity Java classes","Use this skill whenever the user wants to (re)generate Cayenne entity Java classes from a DataMap. Trigger on phrases like 'generate Java classes', 'regenerate entities', 'run cgen', 'create the entity classes', 'why is the Artist class missing fields', 'where did the `_Abstract*` classes come from', 'sync the entity classes with the model', or any request to materialize Java from the DataMap. Also trigger as a follow-up after modeling changes (someone added an entity, attribute, or relationship and now the Java side is stale). This skill exclusively uses the `mcp__cayenne__cgen_run` MCP tool — it does NOT use `mvn cayenne:cgen` or the Gradle cgen task.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3648,3651,3654],{"name":3649,"slug":3650,"type":15},"Data Modeling","data-modeling",{"name":3652,"slug":3653,"type":15},"Java","java",{"name":3655,"slug":3656,"type":15},"ORM","orm",343,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fcayenne","2026-07-12T08:32:33.575211",{"slug":3661,"name":3661,"fn":3662,"description":3663,"org":3664,"tags":3665,"stars":3657,"repoUrl":3658,"updatedAt":3670},"cayenne-db-import","import database schema into Cayenne DataMaps","Use this skill when the user wants to import database schema metadata into a Cayenne DataMap — the *model\u002Fmapping only*, not names or Java classes. Trigger on phrases like 'reverse engineer the database', 'import the schema', 'generate a DataMap from my DB', 'add the new tables from the DB into the model', 'import the customer table', 'create entities from these tables', or any request to read database metadata to populate or update a DataMap's XML. This is for *full schema* or *bulk table* import; one-off a-la-carte entity additions belong in the cayenne-modeling skill. IMPORTANT — scope: this imports the mapping ONLY; it does not clean up the Object-layer names or (re)generate Java classes. When the user wants their whole project brought in line with the DB ('sync my project with the database', 'my schema changed, update everything', 'update my entities\u002Fclasses from the DB'), that is the end-to-end `cayenne-full-db-sync` skill, which runs this import and then name cleanup and class generation. To regenerate classes alone use `cayenne-cgen`. The skill runs reverse engineering directly via the `mcp__cayenne__dbimport_run` MCP tool when a DBConnector is already configured; otherwise it opens the CayenneModeler GUI via `mcp__cayenne__open_project` to configure the connection first.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3666,3667,3668,3669],{"name":3600,"slug":3601,"type":15},{"name":3652,"slug":3653,"type":15},{"name":3655,"slug":3656,"type":15},{"name":3585,"slug":3586,"type":15},"2026-07-19T05:40:33.655062",{"slug":3672,"name":3672,"fn":3673,"description":3674,"org":3675,"tags":3676,"stars":3657,"repoUrl":3658,"updatedAt":3680},"cayenne-full-db-sync","synchronize Cayenne projects with database","Use this skill when the user wants to bring their WHOLE Cayenne project in line with the database in one shot — the mapping, the Object-layer names, and the generated Java classes together. This is the end-to-end 'sync with the DB' workflow, and it orchestrates three skills in order: `cayenne-db-import` (import schema metadata into the DataMap) → `cayenne-model-naming` (polish the just-imported names) → `cayenne-cgen` (regenerate Java classes). Trigger on holistic phrases like 'sync my project with the database', 'sync with the DB', 'my schema changed, update everything', 'update my entities\u002Fclasses from the database', 'reverse engineer and regenerate the classes', 'import the new tables and rebuild the entities', 'full DB sync', 'bring the model and classes up to date with the DB'. The distinguishing signal is scope: the user wants the whole project (mapping + names + Java code), not just one stage. For the *model\u002Fmapping only* (no name cleanup, no class generation) use `cayenne-db-import`; to (re)generate classes alone use `cayenne-cgen`; to clean names alone use `cayenne-model-naming`. Uses the `mcp__cayenne__dbimport_run` and `mcp__cayenne__cgen_run` MCP tools via the sub-skills; does NOT use Maven or Gradle goals.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3677,3678,3679],{"name":3600,"slug":3601,"type":15},{"name":3652,"slug":3653,"type":15},{"name":3655,"slug":3656,"type":15},"2026-07-19T06:03:49.112969",{"slug":3682,"name":3682,"fn":3683,"description":3684,"org":3685,"tags":3686,"stars":3657,"repoUrl":3658,"updatedAt":3691},"cayenne-model-naming","clean up Cayenne object-layer names","Use this skill to clean up Object-layer names in a Cayenne DataMap — ObjEntity, ObjAttribute, and ObjRelationship names, plus DbRelationship names (the first-class unit of relationship cleanup — every FK has one whether or not an ObjRelationship was generated; the ObjRelationship name is synced to it when one exists) — so they read as descriptive, consistent Java. Trigger on phrases like 'clean up the model names', 'fix the entity names', 'these names look ugly', 'make the names descriptive', 'normalize the ObjEntity\u002Fattribute\u002Frelationship names', 'why is this relationship called team1', 'rename entities to be consistent', 'the import produced Gametype instead of GameType'. Invoke it on an explicit user request, or as a manual follow-up after a `cayenne-db-import` to polish the just-imported additions — it is never triggered automatically. IMPORTANT: this is a LIGHT polish pass — CayenneModeler's reverse-engineering already produces good names for the common case; only improve the specific things its deterministic algorithm cannot (run-together names with no separators like `gametype`, meaningless numbered names like `team1` from multiple relationships between two tables, and a common entity prefix that leaks into relationship names like `aaOrders`). Do NOT rewrite names that are already correct. This is Obj-layer naming polish; for structural model edits use `cayenne-modeling`, and for regenerating classes afterward use `cayenne-cgen`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3687,3688,3689,3690],{"name":3649,"slug":3650,"type":15},{"name":3600,"slug":3601,"type":15},{"name":3652,"slug":3653,"type":15},{"name":3655,"slug":3656,"type":15},"2026-07-22T05:35:32.342548",{"slug":3693,"name":3693,"fn":3694,"description":3695,"org":3696,"tags":3697,"stars":3657,"repoUrl":3658,"updatedAt":3701},"cayenne-modeler","manage Cayenne projects with CayenneModeler","Use this skill when the user explicitly wants to open CayenneModeler (the GUI) on a Cayenne project, or when the modeling task is inherently visual — reverse engineering (delegated to cayenne-db-import), bulk relationship layout, multi-entity visual refactoring. Trigger on phrases like 'open the Modeler', 'open in CayenneModeler', 'launch the GUI', 'edit visually', 'show me the project in the Modeler'. Do NOT trigger as a fallback for ordinary a-la-carte XML edits — those belong in the cayenne-modeling skill, which is faster and doesn't require the user to context-switch.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3698,3699,3700],{"name":3649,"slug":3650,"type":15},{"name":3652,"slug":3653,"type":15},{"name":3655,"slug":3656,"type":15},"2026-07-12T08:32:37.199428",{"slug":3703,"name":3703,"fn":3704,"description":3705,"org":3706,"tags":3707,"stars":3657,"repoUrl":3658,"updatedAt":3711},"cayenne-modeling","edit and extend Cayenne ORM models","Use this skill whenever the user wants to edit, inspect, or extend the Cayenne ORM model in a project — adding or modifying entities, attributes, relationships, embeddables, named queries, stored procedures, or DataNodes. Trigger on phrases like 'add an ObjEntity', 'add a DbEntity', 'add a relationship', 'expose this column as an attribute', 'create a new DataMap', 'add a named query', 'create an embeddable', 'add a stored procedure', 'change the attribute type', 'mark this column as nullable', 'rename this entity', or any mention of a Cayenne `*.map.xml` or `cayenne-*.xml` file. Also trigger when the user references modeling concepts (ObjEntity, DbEntity, ObjAttribute, DbAttribute, ObjRelationship, DbRelationship, Embeddable, dbEntityName, deleteRule, db-attribute-path, db-relationship-path, defaultPackage) in the context of a Cayenne-using app. This is the *primary* skill for a-la-carte ORM model manipulation — direct XML edits, not the Modeler GUI.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3708,3709,3710],{"name":3600,"slug":3601,"type":15},{"name":3652,"slug":3653,"type":15},{"name":3655,"slug":3656,"type":15},"2026-07-19T05:40:32.6889",{"slug":3713,"name":3713,"fn":3714,"description":3715,"org":3716,"tags":3717,"stars":3657,"repoUrl":3658,"updatedAt":3722},"cayenne-query","write and modify Cayenne database queries","Use this skill whenever the user wants to write or modify a Cayenne query — fetching entities by criteria, joining, prefetching to avoid N+1, ordering, paginating, aggregating, or running raw SQL through Cayenne. Trigger on phrases like 'query for X', 'fetch all artists where ...', 'write an ObjectSelect', 'use SQLSelect', 'use SelectById', 'add a prefetch', 'get distinct values', 'count rows', 'find by ID', 'load by primary key', 'build a Cayenne expression', 'why am I getting N+1', 'how do I paginate', 'select a single column', 'select columns into a DTO', 'named query in the DataMap'. Do NOT trigger for modeling changes (use cayenne-modeling) or runtime bootstrap (use cayenne-runtime).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3718,3719,3720,3721],{"name":3600,"slug":3601,"type":15},{"name":3652,"slug":3653,"type":15},{"name":3655,"slug":3656,"type":15},{"name":3585,"slug":3586,"type":15},"2026-07-12T08:32:35.072322",108,{"items":3725,"total":3822},[3726,3741,3757,3771,3787,3799,3809],{"slug":3727,"name":3727,"fn":3728,"description":3729,"org":3730,"tags":3731,"stars":19,"repoUrl":20,"updatedAt":3740},"generate-cve-json","generate CVE JSON documents","Generate a CVE 5.x JSON document from an \u003Ctracker> tracking\nissue, ready to paste into the Vulnogram `#source` tab of the ASF CVE tool\nat https:\u002F\u002Fcveprocess.apache.org\u002Fcve5\u002F\u003CCVE-ID>#source. The conversion is\ndeterministic: same issue in, same JSON bytes out. Handles multiple\ncredits (one per line) and multiple references (URLs extracted from the\nissue's \"Public advisory URL\" and \"PR with the fix\" fields; the\n\"Security mailing list thread\" field is treated as internal-only and\nnever exported).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3732,3735,3737],{"name":3733,"slug":3734,"type":15},"Compliance","compliance",{"name":3736,"slug":29,"type":15},"Security",{"name":3738,"slug":3739,"type":15},"Technical Writing","technical-writing","2026-07-12T08:35:41.218722",{"slug":3742,"name":3742,"fn":3743,"description":3744,"org":3745,"tags":3746,"stars":19,"repoUrl":20,"updatedAt":3756},"magpie-audit-finding-fix","fix findings from code audit tools","For a batch of findings from a non-security audit tool\n(`\u003Caudit-tool>` — ruff \u002F flake8 \u002F mypy \u002F pylint \u002F CodeQL \u002F\nApache Verum \u002F Apache Caer \u002F equivalent; full list in the body)\nagainst `\u003Cupstream>`, draft the smallest fix for each finding.\nRe-runs the tool after each batch to confirm the findings are\ncleared. Produces a commit and a hand-back artefact; never opens\na PR on autopilot or merges.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3747,3750,3753],{"name":3748,"slug":3749,"type":15},"Audit","audit",{"name":3751,"slug":3752,"type":15},"Code Analysis","code-analysis",{"name":3754,"slug":3755,"type":15},"Debugging","debugging","2026-07-12T08:35:13.930479",{"slug":3758,"name":3758,"fn":3759,"description":3760,"org":3761,"tags":3762,"stars":19,"repoUrl":20,"updatedAt":3770},"magpie-ci-runner-audit","audit GitHub Actions workflow runner compatibility","Read-only audit of GitHub Actions workflow runner compatibility\nfor one repository, an explicit repository set, one Apache project\nwith multiple repositories, or the full Apache GitHub org. Finds\nobsolete GitHub-hosted runner labels and macOS runner\u002Ftool\narchitecture mismatches. Produces TSV evidence files; never edits\nworkflows, opens PRs, or posts comments.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3763,3764,3767],{"name":3748,"slug":3749,"type":15},{"name":3765,"slug":3766,"type":15},"CI\u002FCD","ci-cd",{"name":3768,"slug":3769,"type":15},"GitHub Actions","github-actions","2026-07-12T08:34:30.320965",{"slug":3772,"name":3772,"fn":3773,"description":3774,"org":3775,"tags":3776,"stars":19,"repoUrl":20,"updatedAt":3786},"magpie-committer-onboarding","onboard Apache project committers","Post-vote committer and PMC onboarding for Apache projects.\nWalks the nominator through every step from ICLA check to\nwelcome announcement for both incubating podlings and\ngraduated top-level projects.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3777,3780,3783],{"name":3778,"slug":3779,"type":15},"Management","management",{"name":3781,"slug":3782,"type":15},"Operations","operations",{"name":3784,"slug":3785,"type":15},"Process Documentation","process-documentation","2026-07-12T08:33:35.628029",{"slug":3788,"name":3788,"fn":3789,"description":3790,"org":3791,"tags":3792,"stars":19,"repoUrl":20,"updatedAt":3798},"magpie-contributor-activity-sweep","generate contributor activity reports","Read-only GitHub activity card for a named contributor on \u003Cupstream>.\nFetches PR authorship, code-review activity, issues, and PR\u002Fissue\ncomments over a configurable window. Limited to GitHub-visible\nactivity — the body documents the off-GitHub tracks the nominator\nmust supply separately. No readiness verdict is produced; use\ncontributor-nomination for a full nomination brief.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3793,3794,3795],{"name":3597,"slug":3598,"type":15},{"name":3624,"slug":986,"type":15},{"name":3796,"slug":3797,"type":15},"Reporting","reporting","2026-07-12T08:33:41.715859",{"slug":3800,"name":3800,"fn":3801,"description":3802,"org":3803,"tags":3804,"stars":19,"repoUrl":20,"updatedAt":3808},"magpie-contributor-nomination","generate contributor nomination briefs","Read-only nomination brief for a named GitHub contributor on\n\u003Cupstream>. Aggregates GitHub activity across all contribution\ntracks plus maintainer-supplied off-GitHub signal, and flags\nvendor-neutrality context — the evidence a PMC needs to open\na committer or PMC nomination thread.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3805,3806,3807],{"name":17,"slug":18,"type":15},{"name":3624,"slug":986,"type":15},{"name":3796,"slug":3797,"type":15},"2026-07-12T08:33:39.211745",{"slug":3810,"name":3810,"fn":3811,"description":3812,"org":3813,"tags":3814,"stars":19,"repoUrl":20,"updatedAt":3821},"magpie-contributor-sentiment","measure contributor sentiment on GitHub repositories","Measures contributor-sentiment signals on \u003Cupstream> over a\nconfigurable window: thread tone (first-response classification),\ntime-to-first-reply (median hours), first-PR retention\n(second-PR rate), and reviewer load (Gini coefficient). Compares\neach signal against a pre-adoption baseline and produces a\nstructured gate report used to decide whether a skill family is\nready to advance from experimental to stable.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3815,3816,3819,3820],{"name":3597,"slug":3598,"type":15},{"name":3817,"slug":3818,"type":15},"Communications","communications",{"name":17,"slug":18,"type":15},{"name":3624,"slug":986,"type":15},"2026-07-12T08:34:09.204167",71]