0005: Agent roster is global, not per-repo
- Status: Accepted β shipped
- Date: 2026-08-28 (recorded); shipped OR-132
Contextβ
The agent roster β name, model and effort per actor (implementer, QA,
devops engineer, PR describer, ...) β originally lived as an agents
block inside each repository's own orion.json, meaning it had to be
re-declared every time Orion was adopted into a new repo, and could drift
between repos for no reason tied to the repo itself.
Decisionβ
The roster moved to a single global file, ~/.orion/agents.json, shared
by every project. orion config agents writes this file directly;
per-project agents blocks in orion.json are no longer read.
Consequencesβ
- Who the implementer is and what model/effort it runs on is an operator preference, not a per-checkout one β adopting Orion into a new repo does not require restating the roster.
- Existing per-project
agentsblocks inorion.jsoncan be deleted; they are inert. - Any future actor-level setting (model, effort, or similar) defaults to living in this global file unless there is a specific reason the setting must vary per repository.