manual page/ ADRs
ADR-0174 - Fixed native instruction targets
Context
ADR-0173 allowed setup to follow an existing Codex override. That makes installation depend on incidental user scaffolding and lets setup occupy a file whose purpose is exceptional precedence. The ordinary global instruction files are the stable integration surface [CODEXGLOBAL] [CLAUDEDIR] [OPENCODERULES].
Decision
- Use the ordinary native file. Each explicit harness identifier maps to its documented normal global instruction file. Existing content is preserved around the neutral owned block.
- Never chase precedence. Setup does not redirect installation into overrides, alternate instruction files, or discovered scaffolding.
- Report shadowing. When another configuration would prevent the normal file from loading, setup stops. The user resolves that harness configuration outside Suspec.
Narrowed decisions
Consequences
- Setup behaves the same on clean and customized machines.
- Exceptional harness configuration remains owned by the user.
Status
Accepted (2026-08-09). Narrows ADR-0172 and ADR-0173.
Need a starting point? Install the skills