mvschwarz

mvschwarz/openrig

Plugin Claude Code

OpenRig canonical skills and hooks for cross-runtime agent topology coordination, continuity, and operating discipline.

mvschwarz/openrig

Skill Claude CodeCodex

Use when a permission policy is attached to a rig/seat (rig.yaml permissionpolicy:), or a user asks you to apply one, and you must translate that harness-neutral policy into the target harness's LIVE permission config — Claude settings.json / Codex config.toml / Pi run flags. Agent-driven and interactive: you read the…

mvschwarz/openrig

Skill Claude CodeCodex

Use when a Claude Code session has just compacted, is about to compact, reached context limit, resumed after /compact, or needs to rebuild its working mental model from Claude JSONL transcripts and touched files.

mvschwarz/openrig

Skill Claude CodeCodex

Use when you have a task and must decide WHO does it — yourself, a spawned subagent, or another agent in the topology that already holds the context. The rule: how much would a blank slate have to read in to do this correctly? A lot → route to a context-holding agent; a little → subagent; unsure → a real agent or…

mvschwarz/openrig

Skill Claude CodeCodex

Use when the system around you does not make sense yet: you just booted into a seat and do not know how the pieces fit; someone said rig, pod, seat, fleet, topology, or slice and you are not certain what they mean here; you are unsure what kind of rig you are in or what it is for; you do not know how skills reach you…

mvschwarz/openrig

Skill Claude CodeCodex

Use when a human decision, access grant, external action, or escalation must survive the operator's absence, or when an orchestrator or PM has a judgment-worthy update for the operator.

mvschwarz/openrig

Skill Claude CodeCodex

Use when starting, building, handing off, restoring, or closing a mission or slice under the default lightweight SDLC.

mvschwarz/openrig

Skill Claude CodeCodex

Use when you do not know WHERE something belongs: you learned a lesson and are unsure which file takes it; you are about to create a new doc, folder, or convention; you are asking "should this be a skill, a note, or a chain file?"; you inherited a seat and want to know what SHOULD exist; or you are about to duplicate…

mvschwarz/openrig

Skill Claude CodeCodex

Use when you're operating OpenRig and need the right skill or context for fleet recovery, seat handover, new-seat orientation, a watchdog wake, cross-host reach to an agent on another machine, rig packaging, an OpenRig upgrade, systematic debugging, queue triage, or implementation planning; also use when you don't…

mvschwarz/openrig

Skill Claude CodeCodex

Use when a specific rig command, subcommand, or flag is already known and you need its exact syntax, JSON shape, defaults, or error meaning. NOT for natural capability discovery, open-ended how-do-I questions, or choosing which OpenRig move applies.

mvschwarz/openrig

Skill Claude CodeCodex

Use when you have just been primed into an EXISTING seat through a planned handover — a different agent retired and handed you the seat plus its earned context — and you need a world model of what just happened to you. Covers how a handover differs from compaction and from a fresh launch, the…

mvschwarz/openrig

Skill Claude CodeCodex

Use when ending a turn, finishing a slice, blocked on another agent's work, or escalating to a human — durable work handoff via queue items so the system keeps moving across compactions, missed messages, and interruptions. Covers the hot-potato terminal-turn-rule (active work ends by passing the ball, not by going…

mvschwarz/openrig

Skill Claude CodeCodex

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.

mvschwarz/openrig

Skill Claude CodeCodex

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)…

mvschwarz/openrig

Skill Claude CodeCodex

Use when replacing a seat's occupant (rebuild/handover/swap), reasoning about stable-seat-identity vs fluid-occupant-identity, choosing an old-occupant disposition (retire/advise/shadow), or recording provenance for an occupant change. Two independent outcomes (continuityOutcome + seatBindingOutcome) and the 5 failure…

mvschwarz/openrig

Skill Claude CodeCodex

Use when reasoning about what survives compaction/context-loss/restart/seat-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…

mvschwarz/openrig

Skill Claude CodeCodex

Load this FIRST, before you assume how anything here works — especially before building, modifying, or "fixing a bug" in an OpenRig or studio-box system, or when something behaves unexpectedly and you're about to treat it as a code bug. You are almost certainly NOT operating in traditional software. This is a…

mvschwarz/openrig

Skill Claude CodeCodex

You have access to a HashiCorp Vault instance managed by this rig's environment.

mvschwarz/openrig

Skill Claude CodeCodex

Use when creating, refreshing, packaging, inspecting, promoting, or deprecating a named per-seat starting point — Agent Starter manifest authoring, the 6-state lifecycle (captured → named → inspectable → used → promoted → deprecated), provenance honesty, and refusal rules. NOT a VM image; a managed starting point…

mvschwarz/openrig

Skill Claude CodeCodex

Use when designing or auditing how an agent becomes useful after launch — AGENTS.md overlays, role files, skills, rig specs, workflow specs, startup checklists, refocus messages, "rig context" surface. Covers the 4 failure modes that make startup context fail (old rig spec misses current operating mode; current agents…

mvschwarz/openrig

Skill Claude CodeCodex

Use when issuing rig commands against a remote host via --host flag (single-hop SSH to a host declared in /.openrig/hosts.yaml). Covers the 4 structured failure modes (ssh-unreachable / permission-gate / remote-daemon-unreachable / remote-command-failed), the --verify honest pass-through (SSH success is NOT verify…

mvschwarz/openrig

Skill Claude CodeCodex

Use when classifying a slice closeout (auto-continue / human gate / park), routing a real decision to a human, or designing a human queue/dashboard surface. Treats humans as durable network participants with attention surfaces, queues, and decision records — escalation lands as a durable attention item, not a chat…

mvschwarz/openrig

Skill Claude CodeCodex

Use when designing multi-agent topologies that run ON OpenRig — authoring RigSpec and AgentSpec files for new rigs, creating agent startup content (guidance / skills / culture), or diagnosing why a launched rig's agents aren't behaving as intended. NOT for changing OpenRig itself (use openrig-builder); NOT for…

mvschwarz/openrig

Skill Claude CodeCodex

Use when opening OpenRig fleet terminals into cmux — turning a rig, pod, mission, slice, or saved view into live agent tiles via rig terminal --provider cmux, or driving cmux on an agent's request. Same OpenRig view semantics as openrig-herdr (the verbs, honest-partial/degrade, read-only cross-rig, scroll/copy…