RCH — remote compilation specialist
RCH can offload one explicit compilation command or inspect the remote compiler
path. This skill reports what happened; it does not govern retries or repair.
Staged diagnosis works because the offload pipeline fails in order —
availability, configuration, hook, classification, sync, remote compile,
worker pressure — so the first failing stage localizes the fault and every
later stage is noise until it passes. Remediate in irreversibility order:
read-only probes and config inspection before daemon restarts, restarts before
cleanup, and destructive cleanup or worker mutation only with explicit caller
authority.
Named failure mode — green-local blindness: a passing [RCH] local (...)
build read as offload success; the local fallback hid that the remote claim
was never proved.
Anti-pattern: re-running the build hoping the fallback reason disappears.
Corrective: read the recorded fallback reason and fix that stage; the pipeline
fails deterministically, not moodily.
Procedure
- Capture
rch check, rch doctor --json, worker status, and the relevant
[RCH] summary before mutation.
- For diagnosis, identify the first failing stage: availability, configuration,
hook, classification, sync, remote compile, or worker pressure.
- Run only the caller-authorized command or documented safe diagnostic once.
- Capture the exact command, worker when known, exit code, local-fallback reason,
and post-action status.
- Stop and return the evidence.
[RCH] local (...) means the requested remote-offload claim was not proved even
when the local build succeeds. Destructive cleanup, worker deployment, daemon
configuration, and remote mutation require explicit caller authority.
rch check exit status adjudicates readiness (0 = ready, nonzero = not
offload-ready). Do not read rch doctor --json success: true as readiness — a
successful diagnostic report can coexist with a down daemon or unreachable
workers. Adjudicate on rch check; use doctor for the reasons behind it.
Output
Return a factual packet with status (remote, local_fallback, failed, or
not_proven), commands and exit codes, worker, summary line, and checked/not
checked surfaces. Do not include a next action. not_proven here is a runtime
diagnosis status, not an AgentOps verdict; it carries no verdict weight and never
substitutes for a verdict.v2.
References
The SKILL.md authority boundary above governs every reference below. Where a
reference lists a remediation, its read-only diagnostics run autonomously but its
remote, privileged, or irreversible steps (remote/sudo mutation, daemon
start/restart/reconfigure, worker or fleet deployment, toolchain sync,
destructive cleanup) still require explicit caller authorization first. A
reference never widens the autonomy the kernel grants.
