[Subject name]
Version: 0.1.0
Layer 1: Vision
Scope: the whole [subject], its [audiences], and what lies beyond it.
1. Need
[Who] has [the problem]. Today [what they do about it, if anything]. [What it costs them.]
2. Target audience
- [Audience] (actor): [who they are, how many, what they want].
- [Other party] (outsider): [who they are and why they matter].
3. Value
- V1. Given [an audience in a situation], when [they act], then [what they get].
- V2. Given […], when […], then […].
4. Focus
The [subject] covers [what is in]. It does not cover [what is out].
5. Success measures (optional)
- [A number or an observable result] (V1).
- [A number or an observable result] (V2).
6. Qualities and constraints (optional)
- [Quality]: [what must hold, in the audience’s terms].
- [Constraint]: [the limit], set by [its source].
7. Vocabulary (optional)
- [Term]: [the owner’s definition].
8. Costs (optional)
- C1.1. Given [the condition or volume], when [the subject is built, run or changed], then it costs [the amount, or Not supplied: the figure]. Paid by [who].
9. Risks (optional)
- R1.1. Given [a situation], when [it goes wrong], then [the harm]. Severity: [High, Medium, Low or Not rated]. Answered by [the id of a decision, assumption or rule, or Not supplied: the answer].
10. Open Concerns (optional)
- O1.1. Given [the unsettled situation], when [what would settle it happens], then [what follows, and what it feeds]. Raised by [who].
11. Assumptions
- A1.1. [What is taken as true]. Basis: [why we think so]. If wrong: [what changes].
12. Decisions
- D1.1. [What was chosen]. Reason: [why].
Layer 2: Structure
Scope: the whole [subject], divided into parts, with the seams between them and with the outside.
1. Parts
- Part A (part): [its one responsibility].
- Part B (part): [its one responsibility].
- Part C (part): [its one responsibility].
2. Standing (optional)
3. Seams between parts
4. Seams with the outside (optional)
- Part A to [actor or outsider]: [what crosses and why]. Part A initiates when [what starts it].
- [Outsider] to Part C: [what crosses and why]. [Outsider] initiates when [what starts it].
5. Shared things (optional)
6. Scenario paths (optional)
- V1. Given […], when […], then [Part A] [does what], and [Part B] [does what].
- V2. Given […], when […], then [Part B] [does what].
7. Costs (optional)
- C2.1. Given [the condition or volume], when [the subject is built, run or changed], then it costs [the amount, or Not supplied: the figure]. Paid by [who].
8. Risks (optional)
- R2.1. Given [a situation], when [it goes wrong], then [the harm]. Severity: [High, Medium, Low or Not rated]. Answered by [the id of a decision, assumption or rule, or Not supplied: the answer].
9. Open Concerns (optional)
- O2.1. Given [the unsettled situation], when [what would settle it happens], then [what follows, and what it feeds]. Raised by [who].
10. Assumptions
- A2.1. [What the division takes as true]. Basis: [why we think so]. If wrong: [what changes].
11. Decisions
- D2.1. [Why a part is a part of its own, or why two parts were kept apart]. Reason: [why].
Layer 3: Detail
Scope: one part at a time. Each entry below describes one part from Layer 2: what it does, what it offers and needs at its seams, and what it is made with.
1. Responsibility
[One or two sentences: what this part answers for, starting from its one-line responsibility in Layer 2.]
2. Concepts and states (optional)
- [A thing the part works with], with [its fields].
- [Thing]’s state: [state one], [state two] or [state three].
3. Seams (optional)
- Part A to Part B, offers: [what this part offers, in what form].
- Part C to Part A, needs: [what this part needs, in what condition].
4. Rules
- V1. Given […], when […], then [Part A] [does what].
- Given [an edge or failure the owner gave], when […], then [Part A] [does what].
5. Inside (optional)
- [A piece] (piece), which [does what].
- [Another piece] (piece), which [does what].
6. Limits
- [A number, a testable condition or an observable result] (Layer 1, [quality or topic]).
- [A second limit] (Layer 1, Not supplied: [the quality]).
7. Construction (optional)
- [The means chosen: tool, material or method, and the value it is set to]. Reason: [the Limit it meets].
- Not supplied: [a value nobody has chosen].
8. Costs (optional)
- C3.1. Given [the condition or volume], when [the subject is built, run or changed], then it costs [the amount, or Not supplied: the figure]. Paid by [who].
9. Risks (optional)
- R3.1. Given [a situation], when [it goes wrong], then [the harm]. Severity: [High, Medium, Low or Not rated]. Answered by [the id of a decision, assumption or rule, or Not supplied: the answer].
10. Open Concerns (optional)
- O3.1. Given [the unsettled situation], when [what would settle it happens], then [what follows, and what it feeds]. Raised by [who].
11. Assumptions
- A3.1. [What the part’s rules rest on]. Basis: [why we think so]. If wrong: [what changes].
12. Decisions
- D3.1. [What was chosen about the part’s shape]. Reason: [why].
1. Responsibility
[…]
2. Rules
- V2. Given […], when […], then [Part B] [does what].
3. Limits
- […] (Layer 1, [quality or topic]).
4. Assumptions
None.
5. Decisions
None.