Writing Beats
Beats
- Each beat is a complete sentence. No noun phrases, no bullet fragments, no hiding in abstraction.
- One job per beat. If a beat is trying to do two things, split it.
- Each beat must earn the next. It forms a bridge from the previous beat to the next one. That is its only job.
- The position test: could you move this beat elsewhere in the changes without breaking the logic? If yes, the bridge is not built yet.
- If two beats are doing the same thing, merge them.
- Every beat must have at least one signal. If you cannot say how you would know the beat has landed, the beat is not concrete enough.
Changes
- A set of changes has a name, a scope, and an owner.
- Start by writing the first beat and the last beat. These form the container. The first beat grabs attention and establishes the current problem or opportunity. The last beat describes the state the changes are trying to reach.
- Fill in the middle. Each intermediate beat bridges from the one before to the one after.
- Read the changes straight through. Does the argument hold? Does each beat earn the next? Does it land?
- A set of changes should be legible to the people living through it. If they cannot read it end-to-end and see themselves in it, it is too abstract.
Connections
- Gates are explicit and named. If changes A depends on changes B at this point, write it down: the gate name, the source beat, the target beat, and the reason.
- Gates are directional. Changes A waiting on changes B does not imply changes B is waiting on changes A.
- Every set of changes must be dissolvable without breaking surviving changes, unless the dependency is a named gate. If dissolving changes C would silently break changes D, there is an unnamed gate.
- Minimise gates. Each gate is a coordination cost. If two sets of changes have more than three gates between them, consider whether they are really one set of changes.
Licensed under CC BY-SA 4.0.