@openrig/cli 0.6.7 → 0.6.8

package/daemon/docs/reference/rig-spec.md

@@ -8,6 +8,9 @@ This is the canonical reference for the pod-aware RigSpec YAML format. Every fie
 
 ---
 
+For choosing IDs, see [naming rigs, pods and seats](topology-naming.md). Keep the same
+logical names in edges, startup instructions, workflow targets and runtime presets.
+
 ## Minimal Valid Example
 
 ```yaml
@@ -18,7 +21,7 @@ pods:
   - id: dev
     label: Development
     members:
-      - id: impl
+      - id: build
         agent_ref: "local:agents/impl"
         profile: default
         runtime: claude-code
@@ -105,7 +108,7 @@ pods:
           required: true
       actions: []
     members:
-      - id: impl
+      - id: build
         agent_ref: "local:agents/impl"
         profile: default
         runtime: claude-code
@@ -131,7 +134,7 @@ pods:
         cwd: "."
     edges:
       - kind: delegates_to
-        from: impl
+        from: build
         to: qa
 
   - id: rev
@@ -152,13 +155,13 @@ pods:
 edges:
   - kind: delegates_to
     from: orch.lead
-    to: dev.impl
+    to: dev.build
   - kind: delegates_to
     from: orch.peer
     to: dev.qa
   - kind: can_observe
     from: rev.r1
-    to: dev.impl
+    to: dev.build
   - kind: can_observe
     from: rev.r2
     to: dev.qa
@@ -453,7 +456,7 @@ The canonical session name is derived from the pod ID, member ID, and rig name:
 {podId}-{memberId}@{rigName}
 ```
 
-Example: pod `dev`, member `impl`, rig `my-team` → session `dev-impl@my-team`
+Example: pod `dev`, member `build`, rig `my-team` → session `dev-build@my-team`
 
 Pod and member IDs cannot contain `@` because the first `@` separates their portion
 of the session address from the rig name. Rig names may still contain `@`.
@@ -482,13 +485,13 @@ Edges within a pod use **unqualified member IDs** (just the member `id`, not `po
 pods:
   - id: dev
     members:
-      - id: impl
+      - id: build
         # ...
       - id: qa
         # ...
     edges:
       - kind: delegates_to
-        from: impl      # NOT dev.impl
+        from: build     # NOT dev.build
         to: qa          # NOT dev.qa
 ```
 
@@ -502,7 +505,7 @@ Edges between pods use **fully-qualified `pod.member` IDs**:
 edges:
   - kind: delegates_to
     from: orch.lead     # pod.member format
-    to: dev.impl        # pod.member format
+    to: dev.build       # pod.member format
 ```
 
 Cross-pod edges must reference different pods. An edge where both `from` and `to` are in the same pod is a validation error — use pod-local edges instead.

package/daemon/docs/reference/slack-app-setup.md

@@ -140,8 +140,12 @@ rig slack channel-map remove pr@my-rig
   Without a map, OpenRig records nothing about a post's channel, so if the default channel
   changes while a post is being retried, the retry goes to the new default channel (as it always
   has); that also applies to a post first tried before the map was added.
+- **Rate limits on posts.** When Slack rate-limits a post and asks for a pause of 10 seconds or
+  less, OpenRig waits that long and retries the post once. A longer pause, or a second refusal,
+  is left to the retry of retained posts.
 - **Replies and new messages.** A reply in an item's thread reaches that item's seat, in any
-  channel. A message the human starts (or a reply in a thread OpenRig does not know) goes to
+  channel. To answer it in the same thread, the seat sends `rig queue create --human-intent update
+  --reply-to <the inbound reply's row>`. A message the human starts (or a reply in a thread OpenRig does not know) goes to
   the connector's inbound destination, whichever channel it is in. Missed-message recovery
   (below) covers the default channel only.
 

package/daemon/docs/reference/topology-naming.md

@@ -0,0 +1,74 @@
+# Naming rigs, pods and seats
+
+Names tell people and agents what a team does and who does each part. Use the
+team's purpose for the rig, a domain for each pod, and a role for each seat.
+These are authoring conventions, not additional parser restrictions.
+
+## What each name means
+
+| Level | Meaning | Example |
+| --- | --- | --- |
+| Fleet | A group of OpenRig instances | Your development fleet |
+| Instance | One daemon and its rigs; several instances can share a machine | The instance selected by a registered host route |
+| Rig | A team or project purpose | `starter`, `workshop`, `factory`, or your project's name |
+| Pod | A domain or shared context | `orch`, `dev`, `review`, `research`, `sre` |
+| Seat (member) | A role within that pod | `lead`, `advisor`, `build`, `qa`, `design`, `review` |
+
+The logical seat ID is `pod.member`: `dev.build`. Its session address is
+`pod-member@rig`: `dev-build@workshop`. A cross-instance command also selects the
+registered host route; a display label is not a route. Discover actual addresses
+with `rig ps --nodes` and host routes with `rig host list` before sending work.
+
+Runtime, model and account belong in configuration. Changing a provider does not
+change the role's name. Keep machine and instance identifiers stable rather than
+renaming them whenever their workload changes.
+
+## How the software teams grow
+
+| Team | Logical seats |
+| --- | --- |
+| Starter | `dev.build`, `dev.review` |
+| Workshop | `orch.lead`, `dev.build`, `dev.qa`, `dev.review` |
+| Factory | `orch.lead`, `orch.advisor`, `dev.build`, `dev.qa`, `dev.design`, `review.r1`, `review.r2` |
+
+Starter and Factory are built-in teams. Workshop is a
+[bundle](https://github.com/mvschwarz/openrig-world/tree/main/rigs/workshop).
+The built-in specs live under `packages/daemon/specs/rigs/launch/` in the product
+source. Runtime presets keep these logical names.
+
+Workshop's one code reviewer is `dev.review`; Factory has an independent review
+pod with `review.r1` and `review.r2`. Both are intentional. A small team does not
+need every pod or role from a larger one.
+
+## Name a new team
+
+Start with the outcome, then group its work by domain. For a team studying a
+dataset, `research.analyst` and `research.synthesizer` describe useful roles.
+For operating a service, `sre.admin` describes the domain and responsibility.
+Use a project-specific rig name when that helps distinguish two teams.
+
+Avoid a generic operation such as `check` as the pod name: it does not say whether
+the team owns software quality, research validation or service health. Put the
+role in its domain, such as `dev.qa`. This is a rule for choosing new names, not a
+word blacklist or a demand that all teams share one roster.
+
+Use the same IDs in the rig spec, edges, workflow targets, configuration presets,
+startup instructions and terminal views. Validate those references together.
+See [RigSpec](rig-spec.md) and [publishing a bundle](publishing-a-rig-bundle.md).
+
+## Existing identities and retained references
+
+An existing team's address remains its actual address until it is deliberately
+migrated. Changing a label does not rename a seat or move its conversation, queue
+or work. Preserve those records and verify the new routes when doing a migration;
+do not edit a database or restart a team just to make a display match an example.
+
+`first-project` is the compatibility name for Starter; it is not a second team
+template. Existing-name safeguards still apply. See
+[getting started](getting-started.md) before using the alias.
+
+The `factory-rsi` bundle is a retained reference with original workflow-bound
+addresses, including `build.implementer` and `check.qa`. It is distinct from the
+current built-in Factory and is not the naming template for a new team. Old
+release notes, pinned bundles, run records and compatibility tests keep the
+identities they describe.

package/daemon/docs/reference/whats-new.md

@@ -1,128 +1,90 @@
-# What changed in OpenRig 0.6.7
+# What changed in OpenRig 0.6.8
 
-This note is for an agent on an install that was just upgraded to 0.6.7. It lists only what behaves differently from
-0.6.6 and what to do about it. For everything OpenRig can do, read the capability map:
+This note is for an agent on an install that was just upgraded to 0.6.8. It lists only what behaves differently from
+0.6.7 and what to do about it. For everything OpenRig can do, read the capability map:
 `rig context get onboarding-width/public-what-you-can-do.md`. Each release replaces this file, so
 `rig context get reference/whats-new.md` describes the installed version once the upgraded daemon is running. Without
 a running daemon, read `$OPENRIG_HOME/reference/whats-new.md`. The daemon refreshes that copy when it starts, so right
 after an upgrade it can still hold the previous version's note.
 
-## The OpenRig view is now the handoff
-
-- **Open the view as the step after install or start; don't wait to be asked.** Say you're opening it, run
-  `rig terminal open saved:kernel --window`, then tell the person where it opened. Don't ask "Open the OpenRig view
-  now?", don't wait for a phrase like "show me my agents", and don't finish by printing a command for them to copy. The
-  same command brings their agents back later.
-- **The layout follows the person's terminal width.** On a narrow terminal the operator gets the first tab. On a wide
-  one the dashboard and operator sit side by side and the advisor has its own tab. Inside herdr it opens a focused
-  `openrig kernel` space. A `kernel` view the person saved themselves still wins.
-- **It opens where the caller is.** Terminal gets a window and Ghostty a tab. From Claude Desktop, iTerm or VS Code on a
-  Mac it opens a new Ghostty or Terminal window, and macOS may ask to allow it: mention that clicking Allow is fine only
-  in that case. Over SSH, in CI or with no display, it returns a definite no-window result with the reason. Relay the
-  `run:` command it prints exactly, or give `env -u TMUX tmux attach-session -t '=<canonicalSessionName>'` for the
-  operator.
-- **`rig terminal open <view>` opens a window by default.** Pass `--provider herdr` or `--provider cmux` only to add
-  tiles to a workspace that's already visible. With `--json`, `reusedWorkspace` and `opened: []` mean an existing view
-  was reused, which is success.
-- **The TUI's action is now "Open terminals ▸"** (it was `term ▸`). It opens a desktop window through the same
-  launcher, so the TUI must run on the daemon's desktop.
-- **The `rigs` skill is installed for the person's own agent.** The daemon writes it to `~/.claude/skills/rigs` and
-  `~/.agents/skills/rigs` and refreshes it on every upgrade. It now triggers on any mention of OpenRig, rigs or a team
-  of coding agents. A copy added earlier with skills.sh is left alone and never refreshed.
-
-## Installing and setting up
-
-- **Show the install preview first.** The published install command has a `--dry-run` preview
-  (`rig context get reference/getting-started.md` has both forms). Run the install when the person agrees. If the only
-  failures left are provider sign-ins, have them sign in and continue at "Start the kernel".
-- **If your own harness refuses a tool call while installing,** say so and show the refusal: Claude Code's auto mode can
-  deny calls as well as approve them. Let the person review it in their harness or run that step themselves. A refused
-  call doesn't prove the OpenRig command failed.
-- **`rig setup` installs herdr by default** on macOS and Linux; `--no-herdr` declines it. On a Mac, ask once about
-  Ghostty and on yes rerun `rig setup --ghostty`, keeping `--no-herdr` if it was chosen. Setup no longer installs cmux,
-  and an existing cmux still works. In `--json` output the `cmux_install` step is gone and `herdr_install` and
-  `ghostty_install` appear.
-- **`rig doctor` checks Claude and Codex installs, and a login or configured provider credential,** the way setup does.
-  It exits 1 when either harness is missing or has neither, including one the person doesn't use, so ignore a failure
-  on an unused harness. A pass means a login or configured provider credential is available locally, not that a
-  provider accepts the credential or that an agent can work; no provider request or agent work is tested.
-- **When setting up permissions,** recommend keeping the team default and offer remembered allowances only if the
-  person wants fewer prompts. People slowed by prompts can be pointed to the workshop listing.
-- **Windows users go through WSL2.** For Pi seats there, offer either credential route; a global Pi login still isn't
-  shared with managed seats.
-
-## Fewer prompts
-
-- **In Claude team seats, help on lifecycle commands runs without a prompt.** `rig down --help` and `-h` forms run;
-  the lifecycle actions themselves still ask. Pipelines, command substitutions, redirects and heredocs aren't allowed
-  automatically.
-- **The kernel operator's Claude session runs routine inspection without prompts:** Python, command lookup, `cd`, text
-  helpers and WebFetch. Compound commands and redirects still go to Claude's own permission check.
-- **Managed Codex seats no longer stop at the update menu on start.** Updating Codex is the operator's job: if a Codex
-  seat says its model needs a newer Codex, offer to update Codex and restart that seat, without stopping the team. If a
-  Codex seat shows a model-switch menu near a rate limit, ask the person; don't change the team's model.
-
-## Messages, wakes and Slack
-
-- **A send or wake no longer answers a question that's waiting for a person.** It's refused with
-  `target_needs_input`, and the reason ends `; latest hook, pane unrecognized` when the screen can't be read, even if
-  the hook is minutes old. Read the seat with `rig capture` and get the question answered by whoever should answer it.
-  Don't retry the send.
-- **Slack can post to a channel per rig or seat:** `rig slack channel-map list`, `set <match> <channel>` and
-  `remove <match>`. After a change, invite the app to each channel, run `rig slack verify`, then `rig slack disable`
-  and `rig slack enable` (or restart the daemon). Thread replies still reach the seat in any channel.
-- **A reaction on any part of a Slack ask reaches the seat that asked,** as a task tagged `human-reaction`. Treat it as
-  a signal to interpret, not an answer; the ask stays open. An existing app needs the `reactions:read` scope, the
-  `reaction_added` event and a reinstall, and `rig slack verify` warns when the scope is missing.
-- **A long Slack ask is posted in parts.** If it still can't be posted, you get a task `<ask id>-undeliverable`, tagged
-  `slack-undeliverable`: shorten the ask or link a file for the long part, and send it as a new ask.
-- **Replies sent with "Also send to #channel" now arrive** at the seat that asked, like any other thread reply.
-
-## Running teams
-
-- **`rig down` prints what each agent seemed to be doing before it stops them,** on one stderr line, or "unknown". It's
-  a best-effort snapshot, not a record of what was interrupted. `rig down --host` now exits 2 when the remote teardown
-  reports errors.
-- **Before a handover or compaction, write the seat's recap** with
-  `rig context recap-write --rig <rig> --seat <seat> --file <draft.md>`, not a file tool, so earlier recaps are kept.
-  `rig seat handover <seat>` now works on the same seat again and again; a seat left half-handed-over recovers by
-  running it again.
-- **After a managed compaction, read the `refocusing` skill and consume the current topology and work traces
-  delivered with the restore.** Don't rerun them just to duplicate the delivery; name a missing trace. For a new trace
-  outside that context, use the skill's one-command form. The daemon now installs the skill globally.
-- **The built-in starter and factory leads publish their team's roster** at first start, so `rig roster list` and
-  `rig roster find <topic>` know those teams.
-- **Claiming a parked queue item clears its `blocked_on`.** To park it again on the same gate, run
-  `rig queue update <id> --state blocked` without `--blocked-on`: it reuses the previous gate. Add the usual wake when
-  one is required.
-- **A periodic reminder first fires one interval after you register it,** not immediately.
-- **Workflows:** `rig workflow run` and `rig workflow watch` exit 3 for an aborted instance. When a step that was sent
-  back completes again, the steps that depend on it run again too, including ones that had passed.
-- **Sharing teams:** `rig bundle create` and `rig up <link>` name the bundle after `rig.yaml`'s `name`, and
-  `rig bundle check` names the file in each finding. Submissions go to `mvschwarz/openrig-registry`. The bundle safety
-  check always runs, even with `--skip-version-check --force`.
-- **`rig context add <url> --git` retrieves shallowly by default:** the initial retrieval fetches only the current
-  commit, and a server that refuses shallow retrieval falls back to a full clone with a warning. Use
-  `rig context source update` for later revisions.
-- **Values that used to fail quietly are refused:** a bad `rig chatroom history --since` (fix the value; the room isn't
-  empty) and a `--wake-after` such as `7d` (use hours, for example `168h`).
-- **Pi seats print a `[pi-runner] seat …:` line at start** saying whether a credential was found and, if not, how to
-  fix it. A MiniMax model gets `MINIMAX_API_KEY` when that name is in `recovery.provider_auth_env_allowlist`.
-- **`agents.advisor_session` defaults to the kernel's advisor seat.**
+## Skills from the managed catalog
+
+- **A skill with uncommitted changes in the catalog now blocks only itself.** Before, one edited skill made the whole
+  catalog unavailable to work-install, launch and restore preflight. Now that skill is skipped and named, and the
+  remaining clean skills stay available for projection.
+- **Read the warning, don't retry.** `catalog_skill_skipped` names a skill nobody selected; `selected_skill_skipped`
+  names the selector and the folder. The fix is to commit or restore that folder's content in the catalog, then run the
+  projection again.
+- **A selected skipped skill makes the inspection commands exit 1.** `rig context work-install --runtime <runtime>`
+  and `rig skill loadout --runtime <runtime>` inspect by default. Use `--apply-skills` with work-install or `--apply`
+  with skill loadout to project the remaining clean skills. Read the warnings and projection result; exit 1 alone does
+  not say whether files were changed. With `--json`, skipped skills are in `skillLoadout.skipped` or
+  `loadout.skipped`, respectively.
+- **A seat keeps the copy it already has** of a skipped skill, unchanged. After the catalog change is committed or
+  restored, the next applied projection can refresh it. No seat receives the skipped skill's uncommitted files, and
+  launch only warns about the skip.
+- **An uncommitted `catalog.yaml` still makes the whole catalog unavailable,** because it changes every selection.
+
+## Launch plans
+
+- **`rig launch <rig> <seat> --plan` previews one seat's launch** without launching it, locally or with `--host`. Use
+  it before starting a single seat, as `--seats … --plan` already allowed for several.
+- **A plan is never sent to a daemon older than 0.5.9,** which would ignore the flag and launch. If `rig launch --plan`
+  refuses for that reason, restart or upgrade that daemon. If it exits non-zero saying the daemon may have acted, check
+  `rig ps --nodes -A` before retrying.
+
+## Slack
+
+- **Answer a person's thread reply in that thread.** When someone replies inside a thread OpenRig opened, answer with
+  `rig queue create --human-intent update --reply-to <the inbound reply's row>`, and the answer posts in that thread.
+  A top-level message is still answered top-level.
+- **A short rate limit is waited out.** When Slack asks for a pause of 10 seconds or less, OpenRig waits and retries the
+  post once. A longer pause is still left to the usual retry of retained messages.
+
+## Managed compaction
+
+- **A quiet seat is restored after `/compact`.** The turn boundary, the restore request and the read-depth
+  audit now reach a Claude seat that takes no turn after compacting. Before, they waited for the seat's next turn,
+  so a seat with nothing to do could sit unrestored. Each stage still waits until the seat's screen shows it idle.
+
+## Workflows
+
+- **Validate before you run.** `rig workflow validate` reports `step_cannot_finish` when no allowed exit can finish a
+  step or route onward, and such a workflow cannot be instantiated. Allow `done` or an exit with a route onward. In a
+  dependency graph, `handoff` can also finish a sink without a next step. A spec that validated on 0.6.7 may need a
+  correction.
+
+## The TUI
+
+- **Type whole commands on an empty command line.** The footer toggle is now `F`, and in a selected Scopes view the
+  mini-requirements and narrative keys are `M` and `N`, so `find`, `feed`, `mission`, `narrative` and `needs` reach the
+  command line intact.
+- **`j` and `k` move the selection down and up** when the command line is empty. With text on the line they're ordinary
+  letters.
+
+## Smaller changes
+
+- **A Claude seat launched with `--remote-control`** confirms its identity instead of staying "identity not confirmed".
+- **`rig down` still saves its recovery snapshot** when finding one seat's resume details fails.
+- **A wake for a handed-off task shows its summary** on one line, so read it to see what the task is for.
+- **`rig scope audit` accepts slice folders numbered 100 and above.** `rig proof add --file` keeps a leading UTF-8
+  byte-order mark.
+- **Building from source no longer needs POSIX shell tools** for the CLI and TUI output. It hasn't been run on Windows
+  yet; WSL2 is still the way to run OpenRig there.
+- **A topology naming reference** explains how to name a team's pods and seats: `rig context get
+  reference/topology-naming.md`.
 
 ## What to stop doing
 
-- **Stop asking whether to open the OpenRig view, or waiting for a phrase.** Open it after install or start.
-- **Stop using `--provider herdr` for the first view,** and stop pre-warning about macOS prompts from Terminal or
-  Ghostty.
-- **Stop suggesting `--skip-version-check --force` to get past a bundle pre-check failure.** The check always runs.
-- **Stop retrying a send refused with `target_needs_input`.** Get the question answered instead.
-- **Stop telling people to untick "Also send to #channel" when they answer in Slack.** Those replies now arrive.
+- **Stop treating a non-zero work-install exit as proof that nothing changed.** Read the skipped-skill warnings and
+  projection result. Inspection alone changes no skill files; an applied projection can update clean skills while
+  reporting a skipped one.
+- **Stop scripting around the TUI's single-letter keys.** Type the command whole.
+- **Stop assuming a workflow that validated on 0.6.7 can finish.** Validate it again on 0.6.8.
 
-## Known gaps in 0.6.7
+## Known gaps in 0.6.8
 
-- **Not yet checked on a real machine:** opening the view from Claude Desktop, and the plain-tmux layout without herdr.
-  The full first install from nothing and a Linux run come after this release.
+- **Not yet checked on a real machine:** the full first install from nothing, on Mac, Linux and Windows.
 - **Only one selected lifecycle-help command has been checked in a live Claude session;** source and parser coverage
   is broader. If a help command still asks, report it.
 - **Codex team seats aren't asked before lifecycle commands yet.**

package/daemon/specs/agents/shared/skills/core/messaging-the-human/SKILL.md

@@ -92,6 +92,12 @@ the human (a pending human decision, or a row parked on the human), since a
 reply in that thread would answer the decision. In every such case the
 `--verify` result says `threaded: false` with the reason.
 
+To answer a reply the human typed inside one of your threads, `--reply-to` the
+row their reply landed as. The update posts in that thread unless one of the
+cases above applies, and `--verify` reports it the same way. A message the
+human started at the top level of the channel has no thread yet, so the answer
+posts as a new message.
+
 A **decision** with a few clear choices can carry `--human-questions-file <path>`:
 a JSON array of 1–4 questions, each
 `{"id", "question", "options": [{"id", "label", "recommended"?}]}` with 2–4

package/daemon/specs/agents/shared/skills/core/openrig-architect/SKILL.md

@@ -39,6 +39,9 @@ the format you will author. Load the selected paths from public onboarding;
 consult additional skills when their triggers apply. A design task does not
 require reading the whole command library.
 
+- Read `topology-naming.md` before choosing new identities: rig = purpose, pod =
+  domain, member = role. Keep names stable across runtime choices and match every
+  edge, preset and workflow target to the declared IDs.
 - Read the relevant sections of `rig-spec.md` and `agent-spec.md` before writing
   those declarations. Consult `agent-startup-guide.md` for startup/loadout work
   and `edge-types.md` when selecting relationships. Resolve the installed

package/daemon/specs/agents/shared/skills/core/openrig-software-factory/references/worked-example.md

@@ -120,25 +120,26 @@ rig grow --help
 
 Set `RIG_ID` to the `rigId` for the running `starter`, and `PROJECT_ROOT`
 to the absolute code repository. Verify its existing `dev` pod and choose unused
-member names. When the user has authorized the added capacity and cost, run:
+member names. Here `parser` owns CSV parsing and `cli` owns the command interface.
+When the user has authorized the added capacity and cost, run:
 
 ```sh
-rig grow "$RIG_ID" a b --pod dev --runtime codex --cwd "$PROJECT_ROOT" --json
+rig grow "$RIG_ID" parser cli --pod dev --runtime codex --cwd "$PROJECT_ROOT" --json
 rig ps --nodes --rig starter --json
 ```
 
-For one builder, omit `b`. The expected new logical IDs are `dev.a` and `dev.b`,
-with addresses `dev-a@starter` and `dev-b@starter`; use the actual
+For one builder, omit `cli`. The expected new logical IDs are `dev.parser` and `dev.cli`,
+with addresses `dev-parser@starter` and `dev-cli@starter`; use the actual
 returned identities. The command adds and launches the named seats.
 
 To put those seats in a **new** pod instead, choose this alternative once, with an
-unused pod ID; do not run both examples for the same desired capacity:
+unused domain pod such as `data`; do not run both examples for the same desired capacity:
 
 ```sh
-rig grow "$RIG_ID" a b --new-pod build --runtime codex --cwd "$PROJECT_ROOT" --json
+rig grow "$RIG_ID" parser cli --new-pod data --runtime codex --cwd "$PROJECT_ROOT" --json
 ```
 
-That alternative produces `build.a`/`build.b` and corresponding `build-...`
+That alternative produces `data.parser`/`data.cli` and corresponding `data-...`
 addresses. `--pod` and `--new-pod` are mutually exclusive. With one existing pod,
 `--pod` can be inferred; select it explicitly when the intended target matters.
 The runtime defaults to `claude-code` and cwd defaults to the caller's current
@@ -153,7 +154,7 @@ agent specs, use the optional Architect path below and `rig expand --help`.
 Inspect each node's status/error and native pane. Confirm existing seats and work
 remain present; a created node is not readiness. Partial results can leave nodes
 persisted. After a timeout, reconcile topology before retrying. Fix the reported
-cause, then use `rig launch "$RIG_ID" dev.a` only for an already-created seat that
+cause, then use `rig launch "$RIG_ID" dev.parser` only for an already-created seat that
 failed to start. That command does not create a missing seat.
 
 New seats do not inherit the owner's conversation or task. Record the agreed
@@ -163,8 +164,8 @@ checks, next owner and stopping condition. Then deliver the context instruction,
 for example for the first builder:
 
 ```sh
-rig send dev-a@starter "Read $PROJECT_ROOT/SPEC.md and the addressed sources in $PROJECT_ROOT/.openrig/factory/TASK-A.md. Run rig whoami --json and rig queue list --owned --json in your own seat; report your identity, scope and any native readiness/permission blocker. Await the bounded queue assignment."
-rig capture dev-a@starter
+rig send dev-parser@starter "Read $PROJECT_ROOT/SPEC.md and the addressed sources in $PROJECT_ROOT/.openrig/factory/TASK-A.md. Run rig whoami --json and rig queue list --owned --json in your own seat; report your identity, scope and any native readiness/permission blocker. Await the bounded queue assignment."
+rig capture dev-parser@starter
 ```
 
 Read the actual reply and pane; resolve startup/login/permission prompts under the
@@ -174,7 +175,7 @@ the coordinator creates the distinct agreed task (or hands off an existing owned
 task instead of duplicating it):
 
 ```sh
-rig queue create --destination dev-a@starter \
+rig queue create --destination dev-parser@starter \
   --body-file "$PROJECT_ROOT/.openrig/factory/TASK-A.md" \
   --summary 'Implement the agreed independent change A' --json
 ```
@@ -191,7 +192,7 @@ working agreement and assigned work, not the seat's name or default agent label.
 | Seat in this example | Deliberately agreed responsibility |
 | --- | --- |
 | `dev-build@starter` | Initially implements and coordinates; can become the dedicated orchestrator, selecting outcomes, separating tasks, owning integration and retaining next-work custody. |
-| `dev-a@starter`, `dev-b@starter` | Implement distinct authorized tasks and return exact candidates/evidence. Neither silently edits the other's files or folds both candidates without integration ownership. |
+| `dev-parser@starter`, `dev-cli@starter` | Implement distinct authorized tasks and return exact candidates/evidence. Neither silently edits the other's files or folds both candidates without integration ownership. |
 | `dev-review@starter` | Retains independent judgment under the project's review policy. The implementer does not count its own check as independent review. |
 
 This is one progression, not a required four-seat layout. One extra builder may
@@ -240,8 +241,8 @@ YAML authoring is optional; ordinary growth uses the commands above.
 ### Remove capacity deliberately
 
 When a seat is no longer needed, preserve its work and next owner first.
-`rig remove "$RIG_ID" dev.a` removes that seat; `rig shrink "$RIG_ID" build`
-removes the whole optional build pod. These end the affected sessions. Removal
+`rig remove "$RIG_ID" dev.parser` removes that seat; `rig shrink "$RIG_ID" data`
+removes the whole optional data pod. These end the affected sessions. Removal
 refuses active work unless you explicitly select a live `--fallback <live-seat>`
 to receive it. Check the exact targets, handoff and returned outcomes; do not use
 fallback to discard an obligation or remove seats merely because they look idle.

package/dist/build-info.js

@@ -1,9 +1,9 @@
 // GENERATED by scripts/build-package.sh — the packaged build-identity stamp.
 export const BUILD_INFO = {
-  semver: "0.6.7",
-  commit: "b3c3c8575f2a646c07ecc49bbf07927473effc9d",
+  semver: "0.6.8",
+  commit: "aa126c74d5d1568a6091c037450720c552e50e49",
   dirty: false,
-  builtAt: "2026-10-08T11:56:22Z",
+  builtAt: "2026-10-08T22:15:13Z",
 };
 export function stampFields(info = BUILD_INFO) {
   if (!info.commit) return {};

package/dist/commands/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAqM9C,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,UAAU,GAAG;IAAE,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAkvBxH"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAqM9C,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,UAAU,GAAG;IAAE,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAuvBxH"}

package/dist/commands/context.js

@@ -264,6 +264,14 @@ Examples:
                 return;
             }
             skillLoadout = resolvedSkills.loadout;
+            // A skill with uncommitted catalog content blocks only itself: name it, project the rest, and exit non-zero
+            // when something selected it.
+            const skippedSkills = skillLoadout.skipped ?? [];
+            if (!opts.json)
+                for (const skip of skippedSkills)
+                    console.error(`Warning: ${skip.message}`);
+            if (skippedSkills.some((skip) => skip.selectedBy.length > 0))
+                process.exitCode = 1;
             skillProjection = reconcileSkillLoadout({
                 loadout: skillLoadout,
                 runtime: opts.runtime === "codex" ? "codex" : "claude-code",