Stop blind retries
Consult once when a distinctive operational failure appears, then act on evidence.
Portable recovery governance
Agents remember the right path.
Broken paths get repaired.
LoopCompass gives every agent in a project a small, reviewable memory of how the repository actually works, plus a rule that broken mechanisms get fixed instead of becoming folklore.
- No daemon
- No database
- Provider neutral
- Markdown native
The boundary matters
A small protocol with a sharp opinion.
Remember correct operating knowledge. Repair defects. Reject clever bypasses.
Keep only verified paths
A recovery survives only when it represents correct, repeatable operating behavior.
Escalate broken mechanisms
Repairable defects become visible incidents with a normal-path success gate.
Bring it to your repository
One instruction. No new runtime.
Give this to Codex, Claude, Cursor, or another agent host:
Install the latest LoopCompass release at project scope from
https://github.com/adammmmmm/LoopCompass.
Follow docs/update-strategy-v1.md and report validation evidence.