Playbooks 01 and 02: one record per question an effort answers; design choices live in the design
Research 085 graduated into eleven records where it answered two questions: the rule 'one record per choice that could be reversed on its own' made every design choice a record of its own. Claude-Session: https://claude.ai/code/session_01NcbgfFSnn24M3GcqttoU7i
This commit is contained in:
@@ -83,8 +83,9 @@ An idea arrives in one of two forms, and the first step differs:
|
||||
decisions in those words. Asked when the idea is set up, too: an option that lands a concept in the wrong
|
||||
domain is offered with that cost named, like one that breaks a rule.
|
||||
7. **Settle the direction with the operator.** When the questions are answered, write the section **Direction**:
|
||||
the proposed decisions in a few lines each, the options rejected and why, and the build's acceptance
|
||||
tests: what the build must prove before it is done, carried by its milestones (playbook
|
||||
the question the effort answers, the options weighed and the one proposed (a second only for a second
|
||||
question of its own; playbook [02](02-graduation.md), step 2), the design choices that follow from it in a
|
||||
line each, and the build's acceptance tests: what the build must prove before it is done, carried by its milestones (playbook
|
||||
[04](04-build-handoff.md)). Nothing else is left open: each question closes by a test, by a decision the
|
||||
effort records with its reason (a small design limit is the lead's), or by the operator. Ask the
|
||||
operator to confirm or change the direction, one point at a time. Then review it by architectural domain (below) and
|
||||
|
||||
@@ -21,8 +21,17 @@ about an hour, and said to the operator if it runs past.
|
||||
[`mission.md`](../mission.md), [`context.md`](../context.md) and
|
||||
[`effect.md`](../effect.md). If it conflicts, either the effort is wrong or GENESIS is —
|
||||
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.
|
||||
2. **Record the decisions** (below, *Writing a decision record*): one record per question the effort
|
||||
answers, holding that question, the options weighed and the one chosen. Most efforts answer one question
|
||||
and graduate into one record; a second record is written only for a second question of its own, such as
|
||||
how the change can be checked or delivered at all (the operator, 2026-11-06: research 085 graduated into
|
||||
eleven records where it answered two questions). The choices made while working out the design that
|
||||
follows (a field, a tool, an event, a bound, the order of steps) are the design's: written in the design
|
||||
with their reasons, under the record they follow from, never as records of their own. A clause of an
|
||||
earlier record the decision changes is a `changes` link from the record, with one line saying in what.
|
||||
How it is checked: the lead names, in the graduation's report to the operator, the question each record
|
||||
answers; an effort graduating into more than two records is said to the operator with why, before the
|
||||
records are proposed.
|
||||
- **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. A record that
|
||||
@@ -139,7 +148,8 @@ by a progressive insight.
|
||||
|
||||
## Amending an existing design
|
||||
|
||||
A design changes only through a decision.
|
||||
A design changes only through a decision. A choice within what a decision decides (a field, a tool, an event,
|
||||
a bound) is the design's own, written in it with its reason; it needs no record of its own.
|
||||
|
||||
1. Write the decision record (above). If it reverses an earlier one, it `supersedes` it.
|
||||
2. Edit the to-be design document, add the record to its `decisions:` as `"ADR NNNN"`, and set `updated:`
|
||||
|
||||
@@ -424,7 +424,7 @@ const P = [
|
||||
{n:"02",name:"Graduation & design change",kind:"idea",c:"--dec",
|
||||
trig:"A research effort concludes, or an existing design must change.",
|
||||
who:"The lead, on the larger model; the decision is recorded before the design moves.",
|
||||
steps:["Check the conclusion against mission, context and effect.","Reserve a number per decision.","Propose one record per choice that can be reversed on its own.","Pre-check, then propose siblings together.","On changes: revise whole; after three rounds fix findings yourself.","A finding that would change what was decided: ask the operator.","needs-operator: wait for the operator's Approve.","Amend the design, or create a to-be design with status designed.","Add the decisions, updated:, and the effort's glossary words.","Review the design by architectural domain before it is merged.","Hand the design to the breakdown (04).","Close the effort: graduated with became links, or abandoned.","When it ships: write the as-is, set the to-be implemented."],
|
||||
steps:["Check the conclusion against mission, context and effect.","Reserve a number per question the effort answers.","Propose one record per question: its options and the one chosen; design choices go in the design.","Pre-check, then propose siblings together.","On changes: revise whole; after three rounds fix findings yourself.","A finding that would change what was decided: ask the operator.","needs-operator: wait for the operator's Approve.","Amend the design, or create a to-be design with status designed.","Add the decisions, updated:, and the effort's glossary words.","Review the design by architectural domain before it is merged.","Hand the design to the breakdown (04).","Close the effort: graduated with became links, or abandoned.","When it ships: write the as-is, set the to-be implemented."],
|
||||
prod:"Decision records; a to-be design with frontmatter; glossary entries; later the as-is.",
|
||||
next:"04",bounds:"One sitting of about an hour",
|
||||
prev:["A decision rewritten silently","A deferral nothing tracks","A design amended without a decision"],
|
||||
|
||||
Reference in New Issue
Block a user