rch

name	rch
user-invocable	false
skill_api_version	1
hexagonal_role	supporting
consumes	[]
produces	[]
context_rel	[]
metadata	{"dependencies":[],"capabilities":["rch"],"effects":["remote_compilation_offload","authorized_remote_daemon_worker_mutation"],"canonical_status":"canonical","disposition":"keep_specialist","tier":"execution"}
description	Use RCH once to offload a build or collect remote-compilation diagnostics. Triggers: "use RCH", "offload this build".
practices	["pragmatic-programmer"]
output_contract	remote compilation status and diagnostic evidence

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

1. Capture rch check, rch doctor --json, worker status, and the relevant [RCH] summary before mutation.
2. For diagnosis, identify the first failing stage: availability, configuration, hook, classification, sync, remote compile, or worker pressure.
3. Run only the caller-authorized command or documented safe diagnostic once.
4. Capture the exact command, worker when known, exit code, local-fallback reason, and post-action status.
5. 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.