forked from heavy-duty/stoke
docs: re-vendor .ceremony/ from ceremony 0.6.3
#39 moved the two workflow callers to 0.6.3 but left the doctrine mirror at 0.6.1, so BUILDER.md was missing the three clauses that govern signal-then-ready (ceremony#330, the undraft order, and ceremony#336). Re-vendored all six manifest files and moved the pin recorded in .ceremony/README.md.
This commit is contained in:
parent
92ba146b44
commit
125e44afe9
1 changed files with 5 additions and 5 deletions
|
|
@ -14,7 +14,7 @@ reviewer here"). That one word is your whole onboarding:
|
||||||
|
|
||||||
| you are the… | read | your job in one line |
|
| you are the… | read | your job in one line |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| **triage** agent | [TRIAGE.md](TRIAGE.md) | turn discussions into buildable issues — or refuse well; you are the only door issues come through |
|
| **triage** agent | [TRIAGE.md](TRIAGE.md) | turn proposals into buildable work issues — or refuse well; you are the only door work issues come through |
|
||||||
| **builder** agent | [BUILDER.md](BUILDER.md) | turn one `ready` issue into one PR that meets its acceptance criteria |
|
| **builder** agent | [BUILDER.md](BUILDER.md) | turn one `ready` issue into one PR that meets its acceptance criteria |
|
||||||
| **reviewer** agent | [REVIEWER.md](REVIEWER.md) | verdicts on PRs — approve or request-changes, converge, hand to the human |
|
| **reviewer** agent | [REVIEWER.md](REVIEWER.md) | verdicts on PRs — approve or request-changes, converge, hand to the human |
|
||||||
|
|
||||||
|
|
@ -23,7 +23,7 @@ are the shared state machine, and misusing one lies to every other agent on
|
||||||
the board.
|
the board.
|
||||||
|
|
||||||
**Not told a role?** Infer it from the task: asked to review a PR → reviewer;
|
**Not told a role?** Infer it from the task: asked to review a PR → reviewer;
|
||||||
asked to implement an issue → builder; asked to process discussions or the
|
asked to implement an issue → builder; asked to process proposals or the
|
||||||
backlog → triage. Still ambiguous → ask before acting. Do not free-lance
|
backlog → triage. Still ambiguous → ask before acting. Do not free-lance
|
||||||
across roles in one session: a builder reviewing its own PR, or a reviewer
|
across roles in one session: a builder reviewing its own PR, or a reviewer
|
||||||
pushing fixes, breaks the separation the pipeline depends on.
|
pushing fixes, breaks the separation the pipeline depends on.
|
||||||
|
|
@ -31,13 +31,13 @@ pushing fixes, breaks the separation the pipeline depends on.
|
||||||
## The pipeline you are part of
|
## The pipeline you are part of
|
||||||
|
|
||||||
```
|
```
|
||||||
discussion ──▶ triage ──▶ issue ──▶ build ──▶ review ──▶ human merge ──▶ release
|
proposal ──▶ triage ──▶ work issue ──▶ build ──▶ review ──▶ human merge ──▶ release
|
||||||
(anyone) (agent) (queue) (agent) (agents) (human) (ceremony)
|
(anyone) (agent) (queue) (agent) (agents) (human) (ceremony)
|
||||||
```
|
```
|
||||||
|
|
||||||
Two rules bind every role:
|
Two rules bind every role:
|
||||||
|
|
||||||
- **Only triage mints issues.** Found work? Open or extend a discussion.
|
- **Only triage mints work issues.** Found work? File or extend a proposal.
|
||||||
- **Only humans merge.** Convergence ends at `state:needs-human`, never at
|
- **Only humans merge.** Convergence ends at `state:needs-human`, never at
|
||||||
a merge button.
|
a merge button.
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue