Development record
A fresh install's facilitator is a person until the repository says auto
Context
adr-2609151528057260
settled that the technical facilitator is a mode: "AI by default and human on
activation". Since then the security standard rule
(.abcd/development/principles/abcd-fixes-what-it-adds.md) has said that abcd
adds no vulnerability and never changes how a repository works. These two
records collide the first time the mode governs an outward act. Under an AI
default, installing abcd in someone's repository and changing nothing would
let abcd merge their pull requests with no person involved.
The collision became concrete on 2026-10-15. iss-2610150524246898 asks abcd to queue every ready pull request at once, and the product thinker ruled that the queueing follows the facilitator's mode: with abcd as facilitator it happens at once, and with a person the merge waits for them. itd-2610150602547271 builds that declaration as the first slice of itd-97. It needs a default.
Decision
We will start every repository with a person as its facilitator. The
declaration facilitator.mode (human or auto, in .abcd/config.json) is
human when no layer sets it, and human from any layer wins over auto. A
repository becomes auto only by a deliberate setting. abcd's own repository
sets it in its committed config.
This amends the default clause of adr-2609151528057260, and only that clause. The three roles, the facilitator being a mode, and every gate declaring its behaviour in both modes all stand.
Ruled by the product thinker, 2026-10-15.
Alternatives Considered
- A person by default (chosen): installing abcd changes nothing about who merges, so the security rule holds with no install-time question. Cost: a repository that wants abcd to facilitate must say so.
- abcd by default, as the roles decision said: the solo-by-default promise with no setup. Rejected: a silent default that hands merging to abcd is the change to how a repository works that the security rule forbids.
- Ask at install: an explicit choice with no silent default. Not chosen
now: it still needs a default for repositories installed before it, and that
default is this decision. It may be added later as an
ahoyquestion that writes the key.
Consequences
- itd-2610150602547271's merge gate reads
humanin every repository that has not opted in. Thereabcd landand the build loop arm no merge, and the guard refuses the merge commands. - abcd's own repository must carry
facilitator.mode: autoin the change that ships the gate, or its own sessions stop queueing. - The README's "automated facilitator" ambition becomes opt-in. Docs that describe the facilitator as AI by default must say a fresh install starts with a person.
Frontmatter
| id | adr-2610150603484802 |
|---|---|
| type | adr |
| status | accepted |
| date | 2026-10-15 |
.abcd/development/decisions/adrs/2610150603484802-a-fresh-install-s-facilitator-is-a.md
open on GitHub ↗ · commit history ↗
References3
- adr-2609151528057260Three roles, who each artefact addresses, and when the loop stopsrelated
- itd-97The Facilitator Is a Mode, Not a Personrelated
- itd-2610150602547271The facilitator's mode gates the mergerelated
Referenced by1
- adr-2610240850193281A human-set autonomy grant permits, separately from the agent-written waiting-on badgerelated
mentions4
- iss-2610150524246898Ready pull requests reach the merge queue one at a time, so a queue that can build four entries at once tests one. On 2026-10-15 abcd's own queue was configured to build up to four entries (max_entries_to_build 4), but the coordinator queued each pull request only after the previous one merged, through hand-run watchers. With each queue run taking 25 to 40 minutes, three ready pull requests cost about two hours instead of about forty minutes. abcd's land step arms auto-merge for a build lane, which lets the queue batch, but landings outside the loop have no such step, and iss-2610090642376032 already records that even a lane's arming can leave a pull request unqueued. The product thinker asked (2026-10-15) for queueing ready work together to be the default for every abcd-managed repository, toggled in config. Bound by the security standard rule: abcd adds the queueing, never changes how the repository's queue is configured.
- iss-2610252215090992glossary/core/technical-facilitator.md:4 and :25 attribute 'the facilitator is a mode, not a person' to draft itd-97; adr-2609151528057260:52 accepted it, and adr-2610150603484802:34-42 set a fresh repository's facilitator to a person. docs/explanation/roles.md:3 and :23 still say the facilitator 'is an AI by default', against that amendment.
- itd-2610240850336695The person grants their sessions what they may do alone, until a time
- itd-2610241015120503The person and the repository agree when abcd may merge, and what a cloud session may do