> The fixed colour grammar a knowledge workshop's shared canvas runs on - [[Event Storming]] re-read for *knowledge flow*: the move on the board is knowledge being needed, held, and supplied, not events in time. Learn it once, use it in every act.
^definition
The cards - each one an [[Event Storming]] element, re-read for knowledge:
### need
🟦 A consumer's [[Event Storming#Command|command]] - a request for knowledge ("recruiting needed the comp policy").
### pain
🔴 The failure [[Event Storming#Event|event]] a need produces when its request comes back empty. On the board it is a **red dot on the need**, not a separate sticky - but it is the event worth mapping, since a satisfied request leaves no trace. *Pains are the worklist* - the catalogued ones live in [[Collective knowledge problems]].
### knowledge
🟩 The data or read model the need reaches for - usually living in *another* (outer) context.
### actor
🟨 A person, role, or domain. *Owner and consumer share this colour*; the arrow says which: `owner → maintains → knowledge`, `knowledge → read by → consumer`.
### domain
⬜ A boundary (frame) around related knowledge - a bounded context; the costly needs reach *across* it.
Method and edge pattern are **not** core grammar - they are the *answers* (Event Storming's policy), added in Act 3 (a 🟪 method inside a domain, an integration pattern on an edge). The whole grammar in one sentence:
> OWNER → maintains → KNOWLEDGE → read by → CONSUMER → raises → NEED → (unmet) → PAIN.
Per act:
- **Act 1** lays the flow - needs, knowledge, actors with arrows - and red-dots every uncovered need.
- **Act 2** draws the domain frames, classifies each Core / Supporting / Generic, and labels the edge between domains.
- **Act 3** adds the method inside each domain and the integration pattern on each edge, and names the owning actor.
**For a non-technical room, run a reduced palette** - need / knowledge / actor, plus the red dot - and let the facilitator handle the domain frames and edge labels. The colours are scaffolding for *you*; participants mostly add cards and say what they are.