Problem
Two CI scripts reference an ADR file path that does not exist in this repo:
scripts/check-stub-debt.mjs:13 — comment: Reference: ADR 0005 H5 (engineering/decisions/0005-fork-sync-hardening.md)
scripts/check-obsolescence-audit.mjs:34 — comment: Reference: ADR 0005 H6 (engineering/decisions/0005-fork-sync-hardening.md)
scripts/check-obsolescence-audit.mjs:357 — error message references engineering/notes/provider-model-obsolescence-audit.md
Neither engineering/decisions/ nor engineering/notes/ exists in the remoteclaw repo. Contributors hitting these gates cannot resolve the referenced documents.
Decision (2026-04-20)
ADRs stay in the private HQ repo. remoteclaw CI scripts drop the path references and keep the rule names only.
Rationale:
- The ADR's audience is fork maintainers (us), not external contributors
- All 5 existing ADRs (0001-0005) live in HQ and there is no established ADR convention in remoteclaw
- CI error messages already carry the enforceable rule (
ADR 0005 H5, ADR 0005 H6) by name — that is sufficient for enforcement
- Creating a public ADR convention in remoteclaw just to satisfy stale path comments is overbuilding
This supersedes the original AC of authoring an ADR at the cited path.
Acceptance criteria
Out of scope
Cascade impact
References
Problem
Two CI scripts reference an ADR file path that does not exist in this repo:
scripts/check-stub-debt.mjs:13— comment:Reference: ADR 0005 H5 (engineering/decisions/0005-fork-sync-hardening.md)scripts/check-obsolescence-audit.mjs:34— comment:Reference: ADR 0005 H6 (engineering/decisions/0005-fork-sync-hardening.md)scripts/check-obsolescence-audit.mjs:357— error message referencesengineering/notes/provider-model-obsolescence-audit.mdNeither
engineering/decisions/norengineering/notes/exists in the remoteclaw repo. Contributors hitting these gates cannot resolve the referenced documents.Decision (2026-04-20)
ADRs stay in the private HQ repo. remoteclaw CI scripts drop the path references and keep the rule names only.
Rationale:
ADR 0005 H5,ADR 0005 H6) by name — that is sufficient for enforcementThis supersedes the original AC of authoring an ADR at the cited path.
Acceptance criteria
scripts/check-stub-debt.mjs:13— strip(engineering/decisions/0005-fork-sync-hardening.md)from the comment; keepADR 0005 H5rule namescripts/check-obsolescence-audit.mjs:34— strip(engineering/decisions/0005-fork-sync-hardening.md)from the comment; keepADR 0005 H6rule namescripts/check-obsolescence-audit.mjs:357— strip, engineering/notes/provider-model-obsolescence-audit.mdfrom the error message outputscripts/check-stub-debt.mjs:108— already correct (rule name only, no path); no changeengineering/decisions/orengineering/notes/remain in the repoOut of scope
Cascade impact
: nevercalibration signal (H7) #2435, ci(fork-sync): fork-boundary mock baseline in check-stub-debt.mjs (H8) #2436, ci(fork-sync): MODULE_ATTESTATIONS manifest for src/agents/* (Option 6) #2437 immediately — none depend on an ADR file being present in this repoReferences
check-stub-debt.mjs)