// adapters
Adapters
Adapters enrich SAGE for a project (globs, labels, handoff blobs). They never become a hard dependency for core judging.
Rules of the road
- Discovery order is documented in
ADAPTERS.md. - Fail-closed-to-core — a broken adapter must not take down board/war/doctor.
- Optional — zero adapters is a valid fleet.
Contract (summary)
Adapters export a small surface (project blob, globs dialect, optional hooks). Full contract + worked acme example:
→ ADAPTERS.md
→ Code: adapters/acme.mjs, adapters/template.mjs
When to write one
- You have a custom monorepo layout and want cleaner territory globs
- You want board labels that match your internal product names
- You integrate with a sibling tool and need a stable handoff shape
When not to: everyday Claude/Grok fleets on normal repos — core is enough.