본문으로 건너뛰기
cccskills
무료GitHub에 공개

rig-lifecycle

Plan and verify OpenRig startup, shutdown, and recovery. Compare reported status with actual running sessions, distinguish recovery outcomes, and define reboot tests that expose partial failures instead of hiding them behind a fresh launch.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

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. Covers the 4 failure modes (auto-restore creates partial rig; projections report healthier than reality; provider auth treated as impl work; resume succeeds for one runtime fails another) plus the restore-honesty rule (failed resume is FAILED loudly — no auto fresh fallback).

설치 방법 보기

이럴 때 유용합니다

  • Checking rig status after a host reboot
  • Designing recovery tests across runtimes
  • Investigating partially restored agent sessions
  • Reviewing how failed resumes are reported

포함된 파일(1)

  • SKILL.md6.0 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Rig Lifecycle

The family of operations that create, start, stop, resume, restore, snapshot, release, unclaim, and destroy OpenRig-managed topologies. Includes the user story after reboot: "bring my work back without turning a clean recovery into a cleanup project."

If lifecycle is brittle, every higher-level primitive inherits that brittleness. Queue, workflow, seat continuity, cross-host operation, and RSI all assume that rigs and seats can be restored into known states.

Use this when

  • Operating rig up / down / restore / resume / snapshot / release / unclaim / destroy
  • Reading rig ps after a reboot or recovery and deciding what to trust
  • Designing proof for a lifecycle scenario (clean start / warm resume / host reboot / provider auth loss / partial boot / operator recovery)
  • Reasoning about restore-outcome semantics (resumed / rebuilt / fresh / failed / attention_required)
  • Auditing whether a lifecycle proof is in-process bedrock vs requires real reboot evidence

Don't use this when

  • The operation is single-command and deterministic — use openrig-user skill for CLI surface
  • The work is operator-level configuration of OpenRig itself — use openrig-operator
  • The work is rig spec authoring — use openrig-architect

Failure modes (4)

  1. Auto-restore creates a partially restored rig that must be cleaned up before real recovery. Partial restore looks like recovery but isn't; cleanup-before-recovery becomes the actual workload.
  2. rig ps or lifecycle projections report a healthier state than the runtime actually has. Projections are summaries; the runtime is truth. Don't trust projections silently.
  3. Provider auth is unavailable after reboot and the system treats that as implementation work instead of a human/environment decision. Auth issues are environmental; route to human.
  4. Resume succeeds for one runtime/provider but fails for another scenario that was never tested. Per-runtime parity assumptions break silently; matrix proof catches them.

Restore-honesty rule (load-bearing)

Failed resume is FAILED loudly. No automatic fresh fallback. Fresh launch is explicit follow-up only. This is enforced architecturally at the daemon level (per architecture.md §7 rule 15).

The locked restore-outcome vocabulary:

OutcomeMeaning
resumedNative runtime resumed the same conversation
rebuiltNew process assembled from artifacts (session_source: mode: rebuild)
freshNew process with no prior continuity
failedRestore attempted and failed; no automatic fallback
attention_requiredRecoverable blocker (provider auth refused, etc.); needs operator action
n-aNot applicable (terminal nodes, etc.)

Codex auth-refusal returns attention_required (recoverable); Claude looksLikeClaudeLoginPrompt returns failed/login_required (terminal). Cross-runtime alignment is an open follow-up question.

Proof standard

Lifecycle proof should include real reboot or VM-reboot evidence, not only daemon-unit evidence. The minimum useful matrix covers:

ScenarioWhat it proves
Clean startBoot from spec into known state
Warm resumerig down → rig up <name> resumes seats
Host reboot / tmux socket absenceRecovery from lost tmux connection
Provider auth lossCodex/Claude auth refusal handled honestly
Partial boot / partial failureSome seats up, some failed; honest reporting
Intentional operator recoveryOperator-initiated restore from snapshot

Tier 1: in-process bedrock (daemon-unit evidence). Tier 2: real reboot or disposable Tart VM. Tier 1 alone is not lifecycle proof; it's bedrock.

Default policy is part of the primitive

Treat default policy as part of the primitive, not an afterthought. Lifecycle defaults that are too optimistic for the reliability level actually proven create silent harm:

  • auto-restore defaults that mask failure modes
  • Implicit fresh-fallback that hides resume failure
  • Permissive verification that doesn't distinguish honest success from "appeared to work"

Total-Host Restore Product Rail v2

The rail sequences restore truth into four rungs:

  • fully_restored is a Rung 3 execution rollup
  • "fully back" is reserved for Rung 4 only

Naming discipline matters. "Fully restored" and "fully back" are different claims; don't conflate.

See also

  • openrig-user skill — CLI surface for rig up / down / restore / etc.
  • openrig-operator skill — operator-level discipline for OpenRig itself
  • seat-continuity-and-handover skill — sub-primitive: occupant-creation modes for restore (resume / rebuild / fresh / failed)
  • session-source-fork skill — forked continuity outcome for fork-based restore
  • permission-and-capability-preflight skill — provider-auth blocker → escalation path
  • openrig/docs/as-built/architecture/lifecycle-snapshot-restore.md (product reference doc) — daemon enforcement of restore-honesty rule

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Automate website interactions through a command-line browser tool. Navigate pages, fill forms, extract text, save screenshots or PDFs, reuse login sessions, and compare page states to check the effects of actions or website changes.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Automating form entry and submission
  • Extracting page text and saving screenshots
  • Comparing page appearance before and after changes
mvschwarz/openrig7.8천2026년 10월 19일 업데이트

Design and maintain applications where OpenRig agents help run the system. Organize instructions, shared state, and artifact checks, then trace unexpected behavior to the code, skill, or schema that needs repair.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Designing an application operated by OpenRig agents
  • Organizing instructions and shared application state
  • Tracing unexpected behavior to its source
mvschwarz/openrig7.8천2026년 10월 19일 업데이트

Design and run bounded procedures in environments where current conditions are uncertain. The skill separates agent judgment from precise tool actions, verifies each effect, and records checkpoints so interrupted work can resume from observed evidence.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Designing procedures for environments with varying conditions
  • Resuming interrupted operations from verified evidence
  • Deciding whether an agent or ordinary code should control a procedure
mvschwarz/openrig7.8천2026년 10월 19일 업데이트

Create reusable starting configurations that combine an agent’s role, startup context, and source history. The skill guides registry entries, checks whether their sources are current, and manages their progression from initial capture to recommendation or retirement.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Create reusable startup context for an agent role
  • Refresh an agent workspace from an existing starter
  • Check a starter’s source history and freshness
mvschwarz/openrig7.8천2026년 10월 19일 업데이트

Guides the design and review of agent startup context, including role files and links to authoritative records. It helps identify stale guidance, missing updates, overloaded startup files, and instructions that lose the purpose of the work.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Designing startup files for a new agent
  • Reviewing stale guidance used by running agents
  • Separating role information from reusable procedures
mvschwarz/openrig7.8천2026년 10월 19일 업데이트

Configure selected OpenRig command permissions in Claude Code or Codex at the agreed project or user scope. Preserve existing restrictions, verify that settings load and behave as intended, and record additions so they can be removed later.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Configuring command permissions before launching an agent team
  • Reducing repeated approvals for selected rig commands
  • Adding permission rules within a chosen project scope
mvschwarz/openrig7.8천2026년 10월 19일 업데이트

mvschwarz의 스킬 모두 보기

이 스킬의 문제 신고