tvproductions/gzkit / .agents/skills/gz-mx
gz-mx
UnverifiedUse to open or exit the MX hangar or safe mode, or to check which mode is open.
SKILL.md
View on GitHub---
name: gz-mx
persona: main-session
description: Use to open or exit the MX hangar or safe mode, or to check which mode is open.
category: agent-operations
lifecycle_state: active
owner: gzkit-governance
last_reviewed: 2026-11-21
model: haiku
gz_command: mx
metadata:
skill-version: "1.12.0"
---
# gz mx
## Overview
The MX Maintenance Hangar lets the operator repair governance surfaces that
the guards themselves protect. While the hangar is open, most governance
guards drop to advisory so repair work can proceed without the checked-in
surfaces blocking the repair itself. Two guards NEVER drop: `gate5_invariants`
and the PRIME DIRECTIVE (ownership — "fix what you know AND what you find").
The same marker carries a second mode. **Safe mode** is the toggle
(GHI #1244): OBPI initiation and brief ceremony are suspended under a written
contract, every guard outside the floor drops to advisory as in the hangar, and the banner names the contract each
turn. Gate 5, the ledger through `gz` verbs, operator PII and the PRIME DIRECTIVE bind
in both modes.
**Out of service is one state** (ruled 2026-11-03,
`docs/governance/safe-mode-doctrine.md` § Out of service and the four levels): hangar and
drydock are synonyms, and the alarm test decides whether work needs the flag at all. Work done
with every alarm on stays on the line. Every opening has a **return to service package**: the
contract for an incident, the generated package for a scheduled C or D check. Return to service
is the operator's act at that package's close, apart from each order's Gate 5.
The operator operates this skill; the skill invokes `gz mx`; nobody shells
out to `gz mx enter` or `gz mx exit` directly. The operator never types the verb:
entry and exit are the skill's steps below, and an instruction that hands the
operator a raw `gz mx` command is a defect in the surface that gave it.
## When to Use
- **Entering the hangar** — governance repair session needs to begin; guards
need to go advisory so you can fix the surfaces they protect
- **Checking hangar status** — confirming whether the hangar is currently
open mid-session
- **Renewing the lease** — resuming a session whose lease ran out, with the work
not done; the session stays open and no guard runs
- **Clean exit** — repair is complete; re-enforce all guards at full strength
- **Entering safe mode** — the operator has written a contract that says what the
mode suspends, what still binds, what each act records and how the mode exits
- **Exiting safe mode** — the contract's exit legs are met; the skill reads them
before the hard gate runs
## Workflow
1. **Open the hangar**
```bash
uv run gz mx enter --reason "<why>" --attestor g0 [--scope ADR-X.Y.Z ...]
```
Creates `.gzkit/mx.json` marker. Most governance guards drop to advisory. `--reason`
and `--attestor` are required; the attestor is the operator, never an agent. Before
entry, confirm with the operator which return to service package this opening serves;
until GHI #1303 makes the verb require it, the skill asks and `--reason` names it.
2. **Perform the repair**
Work on the governance surfaces that needed fixing. Gate 5 invariants and
the PRIME DIRECTIVE still bind — guards drop to advisory so you can repair
governance itself, not so defects can be deferred.
3. **Close the hangar**
```bash
uv run gz mx exit --attestor g0
```
Removes `.gzkit/mx.json` marker. Every guard re-runs at full strength;
exit is a hard gate (all guards must pass before exit succeeds). Return to service is
the operator's word on the package's close; the exit records it, it does not make it.
## Workflow — safe mode (GHI #1244)
1. **Confirm the contract before anything is written.** The operator names the contract
document, written from `.gzkit/templates/safe_mode_contract.md` under
`docs/governance/safe-mode-doctrine.md` (first instance:
`docs/governance/harbor-pilotage-candidate-2026-10-15.md`). The skill
reads it and confirms it carries § Authority (whose word opened the mode), § Purpose,
§ The general arrangement (the target structure, drawn), § What is suspended and what
is not, § Mandate, § Records (one commit per act with its trailer and its
`gz arb red --commit` witness), § Repair orders (the register, each naming the band it
serves) and § Exit (structural conditions, each with a witness). A contract missing any
of these is reported and the mode is not entered.
2. **Enter safe mode**
```bash
uv run gz mx enter --level drydock --contract <contract path> --reason "<why>" --attestor g0
```
Same marker, `level: drydock`, bound to its `mx_session_opened` event. The verb refuses a
missing or outside contract and refuses a contract under `--level hangar`. From this turn
the banner names the contract; guards outside the floor are advisory until the exit.
The entry event pins the contract: its SHA-256 and the bodies of § What is suspended
and § Exit. Each commit that edits the contract while the session is open books
`mx_contract_amended`, so the ledger always says which version is in force.
3. **Work the repair orders under the contract.** Each act is one commit with its
`Task:` trailer naming its repair order, its commit-grain witness, and a passage-log
row with the measurement before and after. The ledger is written only through `gz`
verbs; no control is removed.
**Renew the lease when a session resumes past it** (GHI #1261). The orientation
announces an expired lease; renewal is the operator's call and one command:
```bash
uv run gz mx renew --attestor g0
```
Lease-only: no guard runs, the marker stays, debt keeps aging; a lease that ran out is
booked expired first and announced, and the MX session id holds the renewed lock
(RP-12 rulings 3 and 149). Never exit and re-enter to renew; the exit is for the
drydock's end.
4. **Read the exit before leaving.** The skill reads the contract's § Exit conditions
and § Repair orders (the orientation's drydock block once GHI #1245 lands; until
then each witness re-run) and names any condition not met or order still open. One
unmet condition stops here: the exit is not attempted, and the operator decides
whether it is waived by a recorded ruling or worked.
5. **Exit through the hard gate**
```bash
uv run gz mx exit --attestor g0
```
Every guard re-runs at full strength with the marker held (marked `exiting`), the
enter-to-exit log is rendered for the operator, `mx_session_closed` is written, and
the marker is removed. The log is the maintenance record's view: the session's entries
by order with their landing commits, then every commit no entry accounts for as
unrecorded work; review it before signing (`docs/user/manpages/mx-exit.md`). A red guard,
or a record that cannot be read, puts the marker back and refuses. A session past
its lease is announced, booked as `mx_session_lease_expired`, and never blocks exit.
6. **Hand back.** The contract's handback amendment (every pilot commit listed, kept or
reverted, the passage log carried, the suspended rules restored) is drafted by the
session and ratified by the operator. Civil rule resumes on that ratification, not on
the exit.
The handback takes the form of a **transfer of custody**. It enumerates three
categories: every open discrepancy on the list of discrepancies, every departure from
specification the session accepted, and each deferred action with its new holder. State
an empty category as *none*. Silence is not *none*: a category left out is a defect in
the handback. Draw the enumeration from the list of discrepancies and the work package
log, its sources; the handback is not a third copy of them (`docs/rnd/contractor-kit.md`,
decision C12 and its correction, which replaces *punch list* with *list of
discrepancies*; operator: *"A"*). No verb checks the enumeration against its sources
yet. RP-12 ruling 33 specifies it and it is not built: the drafting verb will compose the
three categories from their sources, and refuse an enumeration that does not match them.
Until it lands the check is the operator's ratification.
## Example
```bash
# Enter the hangar to repair a drifted OBPI brief
uv run gz mx enter --reason "repair a drifted OBPI brief" --attestor g0
# Perform repair work (briefs, rules, docs)
# ...
# Exit — guards re-enforce; exit fails if any guard is still red
uv run gz mx exit --attestor g0
```
Safe mode, as the skill runs it for the operator:
```bash
# Step 2 — enter under the pilotage contract
uv run gz mx enter --level drydock --contract docs/governance/harbor-pilotage-candidate-2026-10-15.md --reason "harbor pilotage" --attestor g0
# Steps 3 and 4 — repair orders under § Records; § Exit read before leaving
# Step 5 — exit through the hard gate
uv run gz mx exit --attestor g0
```
## Repairing the marker
The banner may read `MX MARKER UNREADABLE` or `MX MARKER UNBOUND`. Nothing is lowered then: every
guard is at full strength. When a session should be open, the operator authorizes the repair:
```bash
uv run gz mx repair --attestor g0
```
It rewrites the marker from the one session the ledger keeps open, or removes a marker no session
backs, and books `mx_marker_repaired`. A healthy marker is left alone, and two open sessions refuse.
Commit the repaired marker, since the condition belongs to the repository.
## Repairing a ledger row
The ledger is the one governance surface hangar mode can never make writable:
`AGENTS.md` § Behavior Rules forbids hand-writing it, and that prohibition is what makes
it trustworthy. A row recorded in error is therefore repaired *forward*, and
the repair is available inside or outside the hangar.
`gz ledger correct` appends one corrective action naming the prior row by its
`(event, id, ts)` triple — the ledger has no per-row id, because `id` carries
the artifact rather than the event. `gz ledger corrections` is the census of
what is currently in force.
```bash
# Review the exact target first; nothing is written
uv run gz ledger correct \
--subject-event pipeline_launched \
--subject-id OBPI-0.35.0-08-remember-post-append-advisory \
--subject-ts 2026-08-23T13:12:21.832251+00:00 \
--disposition void --cause agent-error \
--reason "pipeline launched without operator initiation" \
--attestor g0 --dry-run
# What is corrected right now
uv run gz ledger corrections
```
Three dispositions: `void` (the row records something that was not true — no
reader may count it), `discharged` (the row was true and its condition has
since been resolved — it leaves the liveness reading but stays evidence), and
`reinstated` (undo a prior correction). Operator-gated: `--attestor` and
`--reason` fail closed when empty, on the same terms as `gz obpi repudiate`.
## Constraints
- Operator operates the skill; the skill invokes `gz mx`; nobody shells out, and no
surface hands the operator a raw `gz mx` command
- Safe mode is entered only under a contract that carries § Authority, § Purpose, § The
general arrangement, § What is suspended, § Mandate, § Records, § Repair orders and
§ Exit; exit is attempted only after § Exit and the register are read
- `gate5_invariants` and the PRIME DIRECTIVE bind throughout the session
- Exit is a hard gate — do not attempt exit while any line graded *blocks return to service* stays open; the handback transfers every other open discrepancy, departure and deferred action to its holder (`.gzkit/rules/mx-mode.md`)
- See `.gzkit/rules/mx-mode.md` for the binding agent rule for hangar sessions
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |