rch · diff
git:20260715.baaa9e2 to git:20260716.2ff3bc2
16 added, 0 removed. Audit A to A.
---
name: rch
user-invocable: false
skill_api_version: 1
hexagonal_role: supporting
consumes: []
produces: []
context_rel: []
metadata:
dependencies: []
capabilities: [rch]
effects: []
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.
## 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.
## References
- [Fail-open reasons](references/FAIL_OPEN.md)
- [Error catalog](references/ERROR_CODES.md)
- [Troubleshooting](references/TROUBLESHOOTING.md)
- [Recovery playbooks](references/RECOVERY_PLAYBOOKS.md)
- [Worker operations](references/WORKERS.md)
- [Configuration](references/CONFIGURATION.md)
- [Machine-readable surfaces](references/MACHINE_INTROSPECTION.md)