[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DMCEY4EGKN0KC1GJNEZ1G2":3,"skill-same:01M7DMCEY4EGKN0KC1GJNEZ1G2":73},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":6,"ownerHtmlUrl":55,"ownerBlogUrl":56,"ownerDescription":57,"updatedAt":58,"install":59,"resources":72},"01M7DMCEY4EGKN0KC1GJNEZ1G2","topology-mutation-and-seat-management",null,"Use when changing a rig while it is alive — `rig grow` \u002F `rig expand` \u002F `rig shrink` \u002F `rig launch` \u002F `rig remove` \u002F `rig discover` \u002F `rig bind` \u002F `rig adopt` \u002F `rig attach`. Covers the 4 failure modes (newly created seat lacks queue\u002Fstartup\u002Frole; edges and permissions not updated; adopt\u002Fbind succeeds at tmux but not OpenRig identity; shrink\u002Fremove leaves stale topology references) and the rule that mutation must work while the rig is active, not just in clean fixtures.","mvschwarz\u002Fopenrig-world","mvschwarz","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F171890339?v=4","01M7DM95A4N5936P8G2FTSPMY7","Mike Schwarz","01M7DM95AX80NY8HZA7XXDYAZR",16,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world\u002Fblob\u002Fmain\u002Fagents\u002Fshared\u002Fskills\u002Fcore\u002Ftopology-mutation-and-seat-management\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: topology-mutation-and-seat-management\ndescription: Use when changing a rig while it is alive — `rig grow` \u002F `rig expand` \u002F `rig shrink` \u002F `rig launch` \u002F `rig remove` \u002F `rig discover` \u002F `rig bind` \u002F `rig adopt` \u002F `rig attach`. Covers the 4 failure modes (newly created seat lacks queue\u002Fstartup\u002Frole; edges and permissions not updated; adopt\u002Fbind succeeds at tmux but not OpenRig identity; shrink\u002Fremove leaves stale topology references) and the rule that mutation must work while the rig is active, not just in clean fixtures.\nmetadata:\n  cli_surfaces_referenced:\n    - adopt\n    - attach\n    - bind\n    - discover\n    - expand\n    - grow\n    - launch\n    - ps\n    - release\n    - remove\n    - shrink\n    - unclaim\n    - up\n    - whoami\n  openrig:\n    stage: factory-approved\n    sibling_skills:\n      - rig-lifecycle\n      - seat-scaling-and-specialization\n      - cross-host-rig-commands\n      - sidecar-operator\n      - rig-bundles-and-shareable-artifacts\n      - specification-system\n      - extension-and-user-workspace\n---\n\n# Topology Mutation and Seat Management\n\nThe ability to change a rig **while it is alive**: expand, shrink,\nlaunch, remove, discover, bind, adopt, and attach seats or sessions.\nSeat management includes the **stable identifiers, edges, roles, and\nstartup context** that make those mutations coherent.\n\n**OpenRig should be easy to reach for.** A user should be able to add\ncapacity, retire capacity, adopt an existing session, or attach a\nterminal **without rebuilding the whole topology.** If mutation is\nrarely tested, users avoid it and the product collapses back into\nstatic launch scripts.\n\n## Use this when\n\n- Adding seats to a running rig (`rig grow \u003Crig-id> \u003Cmember...>` for the simple case, a fragment with `rig expand` or `rig add` otherwise; see below)\n- Removing capacity (`rig shrink` \u002F `rig remove`)\n- Launching\u002Frelaunching a node in a running rig (`rig launch`)\n- Binding a discovered session into an existing logical node (`rig bind`)\n- Adopting a topology + binding live sessions (`rig adopt`)\n- Attaching a shell or agent into a rig node (`rig attach --self`)\n\n## Adding seats: `rig grow` first, a fragment when you need more\n\n`rig grow \u003Crig-id> \u003Cmember...>` adds one or more seats to a running rig without\nwriting YAML. Each seat gets the default agent spec and its `default` profile.\nCheck `rig grow --help` on your installed version; at the time of writing:\n\n- `--pod \u003Cpod>`: the target pod; inferred when the rig has one pod\n- `--new-pod \u003Cpod>`: create a new pod for the seats (not together with `--pod`)\n- `--runtime \u003Cruntime>`: one runtime for every named seat (default `claude-code`)\n- `--cwd \u003Cpath>`: one working directory for every named seat (default: the current directory)\n- `--json`: output for agents\n\nWrite a fragment instead when a seat needs something `rig grow` does not set: an\nexplicit model, a permission policy, a different agent spec or role profile, a\nper-seat runtime or working directory, or startup files. Use\n`rig expand \u003Crig-id> \u003Cpod-fragment-path>` to add a pod, or\n`rig add \u003Crig-id> \u003Cpod-namespace> \u003Cmember-fragment-path>` to add one member to an\nexisting pod.\n\n## Don't use this when\n\n- The rig is being created fresh from scratch — use `rig up` (lifecycle, not mutation)\n- The intent is to scale specifically (add specialized capacity) — use `seat-scaling-and-specialization` skill\n- The intent is occupant replacement on a stable seat — use `seat-continuity-and-handover` skill\n\n## Failure modes (4)\n\n1. **A newly created seat lacks the queue, startup context, or role files it needs to operate.** Topology mutation creates the seat, but the seat needs more than a tmux session to be useful.\n2. **Edges and permissions are not updated when a seat is added or removed.** Topology references go stale; later workflows route to nonexistent seats.\n3. **Adopt\u002Fbind succeeds at the tmux\u002Fsession layer but not at the OpenRig identity layer.** The session is attached but `rig whoami` doesn't know about it; downstream consumers see partial state.\n4. **Shrink\u002Fremove leaves stale topology references that later workflows route into.** Cleanup is part of the operation, not an afterthought.\n\n## Proof standard\n\nProof must cover **mutation while a rig is active**, not just in a\nclean test fixture. The useful matrix:\n\n| Operation | What to verify |\n|---|---|\n| Add seat | New seat has queue, startup context, role; `rig whoami` resolves it |\n| Remove seat | Stale references cleaned; edges\u002Fpermissions updated |\n| Adopt existing session | tmux session bound at OpenRig identity layer; `rig whoami` reports correctly |\n| Attach observer terminal | External CLI attachment recorded |\n| Verify topology projections after each move | `rig ps --nodes` reflects current truth, not pre-mutation cache |\n\nA clean-fixture proof is necessary but not sufficient. Live-rig proof\ncatches the failure modes that fixture-mode misses.\n\n## Stable roles during topology changes\n\nCapacity changes must preserve useful roles, routing and durable work. Distinguish\nadding or removing a seat from replacing its occupant; use\n`seat-continuity-and-handover` for the latter.\n\n## Currently shipped surfaces\n\nPer `cli-reference.md` v0.2.0:\n\n- `rig grow \u003Crig-id> \u003Cmember...> [--pod \u003Cpod> | --new-pod \u003Cpod>] [--runtime \u003Cruntime>] [--cwd \u003Cpath>]` (added after v0.2.0; check `rig grow --help`)\n- `rig expand \u003Crig-id> \u003Cpod-fragment-path>` (with optional `session_source`)\n- `rig shrink \u003CrigId> \u003CpodRef>`\n- `rig launch \u003CrigId> \u003CnodeRef>`\n- `rig remove \u003CrigId> \u003CnodeRef>`\n- `rig discover [--draft]`\n- `rig bind \u003CdiscoveredId> --rig \u003CrigId> (--node \u003Cid> | --pod \u003Cns> --member \u003Cname>)`\n- `rig adopt \u003Cpath> --bind \u003ClogicalId=tmuxSessionOrDiscoveryId>`\n- `rig attach --self --rig \u003CrigId> --node \u003ClogicalId>`\n- `rig unclaim \u003CsessionRef>` \u002F `rig release \u003CrigId>`\n\n## Choose the proving environment and authority\n\nSelect an isolated active rig or an explicitly authorized live target for the\nrelevant operation. Record its running build, before\u002Fafter topology, continuity\nand outstanding work. A passing schema check or isolated fixture does not prove\nan existing live rig was changed correctly. A runtime timeout is indeterminate\nuntil its durable and process effects are reconciled; do not retry blindly.\n\nThe matrix above is verification guidance, not permission to modify another\nrig. Name the operation's owner and scope, preserve the state needed for recovery,\nand retain missing or failed checks in the result. No local experiment or\nunfinished proof obligation is implied by loading this skill.\n\n## See also\n\n- `openrig-user` skill — CLI surface for `rig grow \u002F expand \u002F shrink \u002F launch \u002F remove \u002F bind \u002F adopt \u002F attach`\n- `seat-scaling-and-specialization` skill — when to add specialized capacity vs generic\n- `seat-continuity-and-handover` skill — replacing an occupant on a stable seat (different shape than topology mutation)\n- `cross-host-rig-commands` skill — cross-host topology mutation (deferred)\n","# Topology Mutation and Seat Management\n\nThe ability to change a rig **while it is alive**: expand, shrink,\nlaunch, remove, discover, bind, adopt, and attach seats or sessions.\nSeat management includes the **stable identifiers, edges, roles, and\nstartup context** that make those mutations coherent.\n\n**OpenRig should be easy to reach for.** A user should be able to add\ncapacity, retire capacity, adopt an existing session, or attach a\nterminal **without rebuilding the whole topology.** If mutation is\nrarely tested, users avoid it and the product collapses back into\nstatic launch scripts.\n\n## Use this when\n\n- Adding seats to a running rig (`rig grow \u003Crig-id> \u003Cmember...>` for the simple case, a fragment with `rig expand` or `rig add` otherwise; see below)\n- Removing capacity (`rig shrink` \u002F `rig remove`)\n- Launching\u002Frelaunching a node in a running rig (`rig launch`)\n- Binding a discovered session into an existing logical node (`rig bind`)\n- Adopting a topology + binding live sessions (`rig adopt`)\n- Attaching a shell or agent into a rig node (`rig attach --self`)\n\n## Adding seats: `rig grow` first, a fragment when you need more\n\n`rig grow \u003Crig-id> \u003Cmember...>` adds one or more seats to a running rig without\nwriting YAML. Each seat gets the default agent spec and its `default` profile.\nCheck `rig grow --help` on your installed version; at the time of writing:\n\n- `--pod \u003Cpod>`: the target pod; inferred when the rig has one pod\n- `--new-pod \u003Cpod>`: create a new pod for the seats (not together with `--pod`)\n- `--runtime \u003Cruntime>`: one runtime for every named seat (default `claude-code`)\n- `--cwd \u003Cpath>`: one working directory for every named seat (default: the current directory)\n- `--json`: output for agents\n\nWrite a fragment instead when a seat needs something `rig grow` does not set: an\nexplicit model, a permission policy, a different agent spec or role profile, a\nper-seat runtime or working directory, or startup files. Use\n`rig expand \u003Crig-id> \u003Cpod-fragment-path>` to add a pod, or\n`rig add \u003Crig-id> \u003Cpod-namespace> \u003Cmember-fragment-path>` to add one member to an\nexisting pod.\n\n## Don't use this when\n\n- The rig is being created fresh from scratch — use `rig up` (lifecycle, not mutation)\n- The intent is to scale specifically (add specialized capacity) — use `seat-scaling-and-specialization` skill\n- The intent is occupant replacement on a stable seat — use `seat-continuity-and-handover` skill\n\n## Failure modes (4)\n\n1. **A newly created seat lacks the queue, startup context, or role files it needs to operate.** Topology mutation creates the seat, but the seat needs more than a tmux session to be useful.\n2. **Edges and permissions are not updated when a seat is added or removed.** Topology references go stale; later workflows route to nonexistent seats.\n3. **Adopt\u002Fbind succeeds at the tmux\u002Fsession layer but not at the OpenRig identity layer.** The session is attached but `rig whoami` doesn't know about it; downstream consumers see partial state.\n4. **Shrink\u002Fremove leaves stale topology references that later workflows route into.** Cleanup is part of the operation, not an afterthought.\n\n## Proof standard\n\nProof must cover **mutation while a rig is active**, not just in a\nclean test fixture. The useful matrix:\n\n| Operation | What to verify |\n|---|---|\n| Add seat | New seat has queue, startup context, role; `rig whoami` resolves it |\n| Remove seat | Stale references cleaned; edges\u002Fpermissions updated |\n| Adopt existing session | tmux session bound at OpenRig identity layer; `rig whoami` reports correctly |\n| Attach observer terminal | External CLI attachment recorded |\n| Verify topology projections after each move | `rig ps --nodes` reflects current truth, not pre-mutation cache |\n\nA clean-fixture proof is necessary but not sufficient. Live-rig proof\ncatches the failure modes that fixture-mode misses.\n\n## Stable roles during topology changes\n\nCapacity changes must preserve useful roles, routing and durable work. Distinguish\nadding or removing a seat from replacing its occupant; use\n`seat-continuity-and-handover` for the latter.\n\n## Currently shipped surfaces\n\nPer `cli-reference.md` v0.2.0:\n\n- `rig grow \u003Crig-id> \u003Cmember...> [--pod \u003Cpod> | --new-pod \u003Cpod>] [--runtime \u003Cruntime>] [--cwd \u003Cpath>]` (added after v0.2.0; check `rig grow --help`)\n- `rig expand \u003Crig-id> \u003Cpod-fragment-path>` (with optional `session_source`)\n- `rig shrink \u003CrigId> \u003CpodRef>`\n- `rig launch \u003CrigId> \u003CnodeRef>`\n- `rig remove \u003CrigId> \u003CnodeRef>`\n- `rig discover [--draft]`\n- `rig bind \u003CdiscoveredId> --rig \u003CrigId> (--node \u003Cid> | --pod \u003Cns> --member \u003Cname>)`\n- `rig adopt \u003Cpath> --bind \u003ClogicalId=tmuxSessionOrDiscoveryId>`\n- `rig attach --self --rig \u003CrigId> --node \u003ClogicalId>`\n- `rig unclaim \u003CsessionRef>` \u002F `rig release \u003CrigId>`\n\n## Choose the proving environment and authority\n\nSelect an isolated active rig or an explicitly authorized live target for the\nrelevant operation. Record its running build, before\u002Fafter topology, continuity\nand outstanding work. A passing schema check or isolated fixture does not prove\nan existing live rig was changed correctly. A runtime timeout is indeterminate\nuntil its durable and process effects are reconciled; do not retry blindly.\n\nThe matrix above is verification guidance, not permission to modify another\nrig. Name the operation's owner and scope, preserve the state needed for recovery,\nand retain missing or failed checks in the result. No local experiment or\nunfinished proof obligation is implied by loading this skill.\n\n## See also\n\n- `openrig-user` skill — CLI surface for `rig grow \u002F expand \u002F shrink \u002F launch \u002F remove \u002F bind \u002F adopt \u002F attach`\n- `seat-scaling-and-specialization` skill — when to add specialized capacity vs generic\n- `seat-continuity-and-handover` skill — replacing an occupant on a stable seat (different shape than topology mutation)\n- `cross-host-rig-commands` skill — cross-host topology mutation (deferred)\n",{"name":5,"metadata":24,"description":7},{"openrig":25,"cli_surfaces_referenced":35},{"stage":26,"sibling_skills":27},"factory-approved",[28,29,30,31,32,33,34],"rig-lifecycle","seat-scaling-and-specialization","cross-host-rig-commands","sidecar-operator","rig-bundles-and-shareable-artifacts","specification-system","extension-and-user-workspace",[36,37,38,39,40,41,42,43,44,45,46,47,48,49],"adopt","attach","bind","discover","expand","grow","launch","ps","release","remove","shrink","unclaim","up","whoami","main","60438a272b68d091eddb01aad6e399af4996d536","agents\u002Fshared\u002Fskills\u002Fcore\u002Ftopology-mutation-and-seat-management",4,"https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world","https:\u002F\u002Fgithub.com\u002Fmvschwarz","https:\u002F\u002Fopenrig.dev","Building OpenRig. Running rogue AI civilizations. Debugging their coordination problems.","2026-11-12 13:31:38",{"source":8,"skillName":5,"commands":60,"prompt":70,"zipAvailable":71},[61,64,67],{"tool":62,"command":63},"npx","npx skills add mvschwarz\u002Fopenrig-world --skill topology-mutation-and-seat-management",{"tool":65,"command":66},"bunx","bunx skills add mvschwarz\u002Fopenrig-world --skill topology-mutation-and-seat-management",{"tool":68,"command":69},"pnpm","pnpm dlx skills add mvschwarz\u002Fopenrig-world --skill topology-mutation-and-seat-management","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world\u002Fblob\u002Fmain\u002Fagents\u002Fshared\u002Fskills\u002Fcore\u002Ftopology-mutation-and-seat-management\u002FSKILL.md",true,[],[74,81,88,95,102,109],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7DMSEDCRREMBJF57RQB59HC","notes","Use when taking notes.","https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world\u002Fblob\u002Fmain\u002Ftools\u002Ftest\u002Ffixtures\u002Finstall-verify\u002Fbundle\u002Fagents\u002Fteam\u002Fskills\u002Fnotes\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7DMSBZP9WE8MC09JDXFCR2F","software-for-agents","Use when older OpenRig instructions name software-for-agents or describe agent-in-the-middle or studio software under the former skill name.","https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world\u002Fblob\u002Fmain\u002Frigs\u002Fworkshop\u002Fagents\u002Fworkshop\u002Fskills\u002Fsoftware-for-agents\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7DMS55VHEAGPXMHZJ7FX94R","session-compaction-and-restore","Use when reasoning about what survives compaction\u002Fcontext-loss\u002Frestart\u002Fseat-refresh, designing a high-fidelity restore packet, or distinguishing native runtime resume vs fork vs artifact-backed mental-model rebuild. Covers the 4 failure modes that prevent honest restore (compacted seat drops hot potato; restore packet preserves details but loses product intent; runtime resume mistaken for handover or fork; rebuilt seat starts with stale instructions).","https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world\u002Fblob\u002Fmain\u002Frigs\u002Fworkshop\u002Fagents\u002Fworkshop\u002Fskills\u002Fsession-compaction-and-restore\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7DMRYQK0JTV7MMVHFWZ0BW0","seat-continuity-and-handover","Use when replacing a seat's occupant (rebuild\u002Fhandover\u002Fswap), reasoning about stable-seat-identity vs fluid-occupant-identity, choosing an old-occupant disposition (retire\u002Fadvise\u002Fshadow), or recording provenance for an occupant change. Two independent outcomes (continuityOutcome + seatBindingOutcome) and the 5 failure modes that prevent silent dishonesty.","https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world\u002Fblob\u002Fmain\u002Frigs\u002Fworkshop\u002Fagents\u002Fworkshop\u002Fskills\u002Fseat-continuity-and-handover\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7DMRP6RRGCJZSH9CE3PC1MY","retiring-and-inheriting-a-seat","Use when you are a sitting agent near your context threshold (~85%) and a PLANNED seat transition is due — retire deliberately and hand your seat to a fresh successor primed from a packet, rather than let compaction degrade you. Covers the handover packet, the append-only lineage ledger (one row per tenure), physical-seat continuity, the do-not-over-inherit framing, the optional warm-handoff window, and wake-v0 (consulting a retired predecessor). NOT for unplanned compaction\u002Fcrash recovery (session-compaction-and-restore \u002F claude-compaction-restore) and NOT the seat-binding primitive mechanics (seat-continuity-and-handover).","https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world\u002Fblob\u002Fmain\u002Frigs\u002Fworkshop\u002Fagents\u002Fworkshop\u002Fskills\u002Fretiring-and-inheriting-a-seat\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M7DMRJGN6Z8TZDR7JNHXH6KX","refocusing","Use when a long-running agent may have lost the product outcome, when context was compacted, when work has crossed a major boundary, or when a fresh path-based trace is needed before the next consequential action. Not for fresh-session orientation, waking an idle seat, or checkpoints.","https:\u002F\u002Fgithub.com\u002Fmvschwarz\u002Fopenrig-world\u002Fblob\u002Fmain\u002Frigs\u002Fworkshop\u002Fagents\u002Fworkshop\u002Fskills\u002Frefocusing\u002FSKILL.md",[],[]]