An agent does the work,a person holds every gate.
An AI agent holds the seats that specify, plan, control, implement, review, write and translate. Every gate is approved by a seat a person holds.
Generated from the model, so the words below are its own — and in the one language it is written in. The rest of this site is bilingual; a translated copy would be a second thing to keep true, which is what this page argues against.
Delivery
How anything we publish is shaped, specified, planned, made and merged, in code and in prose.
Owner
Specifier
Planner
Controller
Implementer
Reviewer
Writer
Translator
- 01Shape
- Decide what kind of change this is, how far it reaches, and how much of it gets written down.
- 02Spec
- Write what the change must do, completely enough that nobody downstream has to guess.
- 03Plan
- Cut the approved specification into pieces that can be worked one at a time.
- 04Implement
- Make the thing, and let nothing go forward unread.
- 05Integrate
- Put the change where it binds, release what other repositories take from it, and move everything that names it.
Contribution
How a change offered from outside as a pull request is reviewed and taken, under the same rules a change from inside is held to.
Owner
Contributor
Reviewer
- 01Propose
- Offer the change, under the address the Contributor means to be known by.
- 02Consider
- Establish what the change is for, before anyone spends time on how it is written.
- 03Review
- Find what is wrong with the change, and hand it to whoever merges as findings rather than as a verdict.
- 04Integrate
- Take the change into the default branch, and carry it to whoever vendors what it touched.
Feature request
How somebody outside asks for vocabulary or tooling that is not there, as a GitHub issue, and gets an answer they can act on.
Owner
Requestor
- 01Raise
- Say where it can be answered that the vocabulary would not carry something.
- 02Understand
- Turn what somebody asked for into the page they could not write.
- 03Triage
- Decide what kind of thing the gap is, and whether it is ours to fill.
- 04Answer
- Give the asker something they can act on, whether or not anything will be built.
Each process draws its own board: delivery; feature requests, raised as GitHub issues; contributions, proposed as pull requests. Read a row for what a seat does across the work, and a column for who touches a phase. The gate marks are the argument: every gate is approved by a seat a person holds, and no agent row carries one. A name beside a seat is the profile that holds it; a seat with no name is held by a person the model does not name. A seat opens onto its card from the model.
How to read it
A seat is a role, not a person. A profile holds some seats, and its name stands beside them. A seat with no name is held by a person; the model says that much and not who.
A gate is what a phase cannot be left without. The Owner approves most of them. The Requestor approves the first phase of a feature request, and the Contributor the first phase of a contribution.
No mark is typed. Every cell is read off the phase's own file, so the board cannot disagree with the process it draws.
Generated from companygraph/mental-model@HEAD