Write a graduation's records side by side, from the confirmed direction (playbook 02)

Proposing records one after another serialises their reviews and the
operator's asks; retyping the effort's findings into each record makes them
long and gives the review more to send back.
This commit is contained in:
2026-10-16 02:09:57 +02:00
parent 2a61c57258
commit ada703e790
+9
View File
@@ -23,6 +23,15 @@ about an hour, and said to the operator if it runs past.
say which, in writing, before proceeding.
2. **Record the decisions** (below, *Writing a decision record*): one record per choice that could be
reversed on its own, not one record for the whole effort.
- **Write them together, not one after another.** Reserve every number first, then propose each record
as soon as it is written, without waiting for the review of the one before; the reviews run side by
side, and the operator's asks for the records that need them arrive together.
- **Take the clauses from the confirmed direction** and cite the effort (`cites`, `"research NNN"`) for
the evidence instead of retyping its findings: a record's Context holds the few facts its decision
rests on, with the effort named for the rest.
- **Pre-check each record before proposing it**, as for research (playbook [01](01-research.md), step
5): every record, issue or design it names is in `links`; each deferral names its issue; figures as
measured; no retired word.
3. **Write the design.** Create the document under `03-DESIGN/01-to-be/` with frontmatter:
```yaml