mvschwarz/openrig-world

Letzte erfasste Quellaktivität: 8. November 2026 um 12:51

SkillsMP-Katalog aktualisiert: 9. November 2026 um 14:22

gesammelte Skills: 30

GitHub-Stars: 15
GitHub-Forks: 4

Mit einem KI-Assistenten installieren

Diesen Prompt kopieren und in den verwendeten KI-Assistenten einfügen.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/mvschwarz/openrig-world.

README des Repositorys

README-Quelldatei: README.md

README-Quelldatei lesen

Vollständige README anzeigen

# OpenRig project world A context pack that helps a coding agent work on [OpenRig](https://github.com/mvschwarz/openrig) itself. It covers what the project is for, how a contribution gets from an idea to a merged pull request, and how to prove that a change works. Install it once. After that, any agent working in an OpenRig checkout can load it with one command. > **This map is not the territory.** It is short on purpose, it is incomplete, and it will drift. > The OpenRig source, the `rig` binary you are running, and the maps inside the product repository > are the authorities. Where this pack disagrees with them, they are right. Please open an issue > or a pull request here when you find a disagreement. ## Who it is for - People who want to contribute to OpenRig, and the coding agents they work with. - Claude Code and Codex are supported directly: `rig context profile` composes a walk for either. Agents on other runtimes can still read every file with `rig context get`, or straight from this repository, because the files are plain Markdown. You do not need a multi-agent rig to use this pack. One agent in one terminal is enough. ## How it fits with the rest of OpenRig's context OpenRig gives agents context in layers. This pack is one of them. | Layer | What it answers | Where it comes from | |---|---|---| | System World | How to be an agent inside OpenRig: identity, peers, the queue, the command surface | Ships with OpenRig. On a default install it selects the `world-public` and `onboarding-width` packs; `rig context list` shows what your install has. | | **Project world (this pack)** | How to build OpenRig: its purpose, how contributions move, how to prove a change | This repository | | Code maps and the `developing-openrig` skill | Where code lives, what is risky, what to run | The product repository: `ARCHITECTURE.md`, `docs/as-built/arteries.md`, `docs/as-built/test-layers.md`, `.claude/skills/` and `.agents/skills/` | | Your work | The issue or pull request in front of you | GitHub | This pack points at the product repository's maps instead of copying them. A copy would drift, and the maps in your checkout describe the code you are actually changing. ## Install You need OpenRig installed, with its daemon running. The [product README](https://github.com/mvschwarz/openrig#install-and-first-run) covers requirements and [what OpenRig changes on your machine](https://github.com/mvschwarz/openrig#what-openrig-changes-on-your-machine). ```bash rig context add --git https://github.com/mvschwarz/openrig-world.git rig context list ``` `--git` clones this repository using your existing Git setup, finds `manifest.yaml` at its root, and installs the pack under the manifest's name, `openrig-world`. Only the files the manifest declares are served to agents; this README is for you. To check for and take later changes: ```bash rig context source inspect openrig-world rig context source update openrig-world ``` ## Load it Run one of these yourself, or ask your agent to run it. Each prints the composed text for the agent to read. | When | Command | |---|---| | Starting work on OpenRig | `rig context profile openrig-world --situation fresh` | | Reviewing a pull request | `rig context profile openrig-world --situation fresh --profile reviewer` | | After a compaction, `/clear` or restart | `rig context profile openrig-world --situation post-compaction` | | One file | `rig context get openrig-world/craft/proving-a-change.md` | | One section | `rig context get 'openrig-world/workflow/contributing-with-agents.md#after-a-context-reset'` | | Everything, in one bundle | `rig context get openrig-world` | `rig context profile` composes for Claude Code by default. Add `--runtime codex` for Codex, or set `OPENRIG_RUNTIME`. Add `--json` to see token estimates and content hashes for each piece. ## What is inside | File | What it covers | |---|---| | `identity/what-openrig-is-for.md` | What OpenRig is for, and how proposed changes are judged | | `workflow/contributing-with-agents.md` | The loop from install to merged pull request, done with agents | | `craft/proving-a-change.md` | How to show a change works: seams, checks that can fail, proof by effect | | `craft/tells-of-a-wrong-claim.md` | Moments when you are about to be wrong, and the cheapest check for each | | `manifest.yaml` | The pack manifest: files, atoms, and the `reviewer` profile | ## Rig catalog Reviewed listings, submissions, team diagrams and public status live in [openrig-registry](https://github.com/mvschwarz/openrig-registry). The workshop and factory-rsi bundle sources remain here under `rigs/`; their installation links do not change. `registry/workshop.yaml` is the only catalog file retained here, for OpenRig 0.6.6 operators. The copy in openrig-registry is canonical. Update this compatibility mirror with the exact same bytes in a paired, reviewed pull request when that pin changes, and merge both before announcing the new pin. See the [registry's compatibility instructions](https://github.com/mvschwarz/openrig-registry#workshop-compatibility-with-openrig-066). ## Naming a team Use the [topology naming reference](https://github.com/mvschwarz/openrig/blob/95412717f319c6557c970d870cc22fa976565837/docs/reference/topology-naming.md) when authoring rigs: a rig names the purpose, a pod names a domain, and a seat names its role. Starter grows from `dev.build` and `dev.review` to Workshop's lead and development pod, then Factory's independent review pair. Runtime presets keep those identities. The `factory-rsi` bundle remains an original workflow reference with its original addresses. It is distinct from the current built-in Factory and is not the naming template for a new team. Its bundle, workflow targets and pinned registry view remain together; old fixtures and run records keep the identities they describe. ## Contributing to this pack Pull requests are welcome, especially when you find something here that is stale or wrong. Keep pages short, point at sources instead of copying them, and describe commands only after you have run them. If you change `manifest.yaml` or a section heading that an atom addresses, commit, then check that your clone still loads under a scratch name: ```bash rig context add --git /path/to/your/clone --name openrig-world-test rig context profile openrig-world-test --situation fresh --json rig context profile openrig-world-test --situation post-compaction --json rig context profile openrig-world-test --situation fresh --profile reviewer --json rig context rm openrig-world-test ``` Each `profile` command should list its pieces with no error. ## License Apache-2.0, the same as the OpenRig product repository. See [LICENSE](LICENSE).

README des Repositorys wird geladen…

Skills in diesem Repository

Klassifizierung ausstehend

Skill

Beruf

Beschreibung

Aktualisiert

refocusing

nicht klassifiziert

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…

Quellsprache: Englisch

2026-11-08

queue-handoff

nicht klassifiziert

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…

Quellsprache: Englisch

2026-10-27

openrig-user

nicht klassifiziert

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.

Quellsprache: Englisch

2026-10-26

openrig-skills

nicht klassifiziert

Use when an agent running inside OpenRig needs 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…

Quellsprache: Englisch

2026-10-23

openrig-architect

nicht klassifiziert

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…

Quellsprache: Englisch

2026-10-08

openrig-software-factory

nicht klassifiziert

Use when a user wants a continuing software team for a real repository, or has a first OpenRig team and needs a repeatable path for reviewed work and later tasks.

Quellsprache: Englisch

2026-10-08

using-the-tui-together

nicht klassifiziert

Use when you notice something the person would want to see (a seat waiting on them, a seat that has stalled or keeps failing, work that needs their decision), when they ask what the team is doing or where some work stands, or in their first session with this…

Quellsprache: Englisch

2026-10-07

cross-host-rig-commands

nicht klassifiziert

Use when addressing a registered remote OpenRig host, choosing its transport, or interpreting a cross-host result.

Quellsprache: Englisch

2026-10-06

messaging-the-human

nicht klassifiziert

Use when project policy calls for a human decision or update, a human delivery is pending or failed, or a reply must resume the right work.

Quellsprache: Englisch

2026-10-06

openrig-herdr

nicht klassifiziert

Use when opening OpenRig fleet terminals as a herdr wall — turning a rig, pod, mission, slice, or saved view into live interactive agent tiles via `rig terminal`, watching another rig read-only, or driving herdr on an agent's request ("open all my rigs + a…

Quellsprache: Englisch

2026-10-06

openrig-skills

nicht klassifiziert

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…

Quellsprache: Englisch

2026-10-06

openrig-upgrade

nicht klassifiziert

Use when an agent is preparing or performing an OpenRig CLI/daemon upgrade and must preserve live seats, verify each mutation, or reconcile managed plugin and skill files without overwriting local work.

Quellsprache: Englisch

2026-10-06

rig-bundles-and-shareable-artifacts

nicht klassifiziert

Use when authoring or installing a rig bundle (packaged, shareable artifact that instantiates an opinionated OpenRig topology + workflow), reasoning about the bundle vs extension boundary, or auditing a bundle for portability. Covers the 4 failure modes that…

Quellsprache: Englisch

2026-10-06

rig-lifecycle

nicht klassifiziert

Use when reasoning about the rig lifecycle operations family (create / start / stop / resume / restore / snapshot / release / unclaim / destroy), reading or trusting `rig ps` / lifecycle projections after recovery, or designing proof for a lifecycle scenario.…

Quellsprache: Englisch

2026-10-06

topology-mutation-and-seat-management

nicht klassifiziert

Use when changing a rig while it is alive — `rig grow` / `rig expand` / `rig shrink` / `rig launch` / `rig remove` / `rig discover` / `rig bind` / `rig adopt` / `rig attach`. Covers the 4 failure modes (newly created seat lacks queue/startup/role; edges and…

Quellsprache: Englisch

2026-10-06

development-team

nicht klassifiziert

Use when a development pod begins or hands off implementation, QA, or design work.

Quellsprache: Englisch

2026-10-06

orchestration-team

nicht klassifiziert

Use when coordinating assignments, selected review boundaries, or blocked work across a rig.

Quellsprache: Englisch

2026-10-06

review-team

nicht klassifiziert

Use when assigned a review or when an authored review boundary is reached.

Quellsprache: Englisch

2026-10-06

agent-browser

nicht klassifiziert

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include…

Quellsprache: Englisch

2026-10-06

dogfood

nicht klassifiziert

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application.…

Quellsprache: Englisch

2026-10-06

systematic-debugging

nicht klassifiziert

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Quellsprache: Englisch

2026-10-06

test-driven-development

nicht klassifiziert

Use when implementing any feature or bugfix, before writing implementation code

Quellsprache: Englisch

2026-10-06

verification-before-completion

nicht klassifiziert

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

Quellsprache: Englisch

2026-10-06

ponytail

nicht klassifiziert

Forces the laziest solution that actually works, simplest, shortest, most minimal. Channels a senior dev who has seen everything: question whether the task needs to exist at all (YAGNI), reach for the standard library before custom code, native platform…

Quellsprache: Englisch

2026-10-05

agent-operated-software

nicht klassifiziert

Use when designing, building, operating, or diagnosing an ongoing application whose live backend or control loop includes OpenRig agents, including applications with a Markdown, YAML, or JSON agent control plane or a thin surface over specialist agent roles.

Quellsprache: Englisch

2026-10-05

notes

nicht klassifiziert

Use when taking notes.

Quellsprache: Nicht bestimmbar

2026-10-05

applying-a-permission-policy

nicht klassifiziert

Use before launching a team during agent-guided setup, or when a user asks to configure OpenRig command permissions, reduce repeated native approval prompts, or apply a selected rig/seat permission policy.

Quellsprache: Englisch

2026-10-05

claude-compaction-restore

nicht klassifiziert

Use when a Claude Code session is about to compact, has just compacted, reached its context limit, resumed after /compact, or must rebuild its working picture of a long-running seat from its own restore map, its JSONL transcript and the files it touched.

Quellsprache: Englisch

2026-10-05

forming-an-openrig-mental-model

nicht klassifiziert

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…

Quellsprache: Englisch

2026-10-05

session-compaction-and-restore

nicht klassifiziert

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…

Quellsprache: Englisch

2026-10-05

Es werden 30 von 30 gesammelten Skills angezeigt.