sinapse-ai 9.3.0 → 9.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/CLAUDE.md +56 -343
- package/.claude/rules/agent-authority.md +6 -0
- package/.claude/rules/agent-handoff.md +5 -0
- package/.claude/rules/cross-squad-routing.md +5 -0
- package/.claude/rules/hook-governance.md +6 -0
- package/.claude/rules/mcp-usage.md +3 -1
- package/.claude/rules/safe-collaboration.md +10 -0
- package/.claude/rules/security-data-protection.md +9 -0
- package/.claude/rules/squad-awareness.md +3 -1
- package/.claude/rules/tool-examples.md +6 -0
- package/.claude/rules/workflow-execution.md +7 -0
- package/.codex/agents/analyst.md +253 -72
- package/.codex/agents/architect.md +455 -68
- package/.codex/agents/data-engineer.md +492 -106
- package/.codex/agents/developer.md +560 -0
- package/.codex/agents/devops.md +518 -69
- package/.codex/agents/product-lead.md +335 -0
- package/.codex/agents/project-lead.md +377 -0
- package/.codex/agents/quality-gate.md +449 -0
- package/.codex/agents/sinapse-orqx.md +9 -7
- package/.codex/agents/sprint-lead.md +287 -0
- package/.codex/agents/squad-creator.md +344 -0
- package/.codex/agents/ux-design-expert.md +495 -0
- package/.codex/delegation-matrix.json +756 -44
- package/.codex/handoff-packet.schema.json +30 -6
- package/.sinapse-ai/data/entity-registry.yaml +175 -363
- package/.sinapse-ai/data/registry-update-log.jsonl +16 -0
- package/.sinapse-ai/development/agents/analyst.md +90 -0
- package/.sinapse-ai/development/agents/architect.md +73 -0
- package/.sinapse-ai/development/agents/developer.md +69 -0
- package/.sinapse-ai/development/agents/devops.md +117 -0
- package/.sinapse-ai/development/agents/quality-gate.md +85 -0
- package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
- package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
- package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
- package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
- package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
- package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
- package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
- package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
- package/.sinapse-ai/development/skills/debug.md +57 -0
- package/.sinapse-ai/development/skills/fast-review.md +69 -0
- package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
- package/.sinapse-ai/development/skills/security-scan.md +73 -0
- package/.sinapse-ai/development/skills/verify.md +53 -0
- package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
- package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
- package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
- package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
- package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
- package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
- package/.sinapse-ai/install-manifest.yaml +71 -35
- package/docs/codex-integration-process.md +22 -0
- package/docs/codex-parity-program.md +27 -0
- package/docs/ide-integration.md +36 -0
- package/package.json +1 -1
- package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
- package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
- package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
- package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
- package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
- package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
- package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
- package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
- package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
- package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
- package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
- package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
- package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
- package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
- package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
- package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
- package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
- package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
- package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
- package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
- package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
- package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
- package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
- package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
- package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
- package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
- package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
- package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
- package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
- package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
- package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
- package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
- package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
- package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
- package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
- package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
- package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
- package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
- package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
- package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
- package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
- package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
- package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
- package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
- package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
- package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
- package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
- package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
- package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
- package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
- package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
- package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
- package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
- package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
- package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
- package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
- package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
- package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
- package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
- package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
- package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
- package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
- package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
- package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
- package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
- package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
- package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
- package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
- package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
- package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
- package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
- package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
- package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
- package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
- package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
- package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
- package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
- package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
- package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
- package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
- package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
- package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
- package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
- package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
- package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
- package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
- package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
- package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
- package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
- package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
- package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
- package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
- package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
- package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
- package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
- package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
- package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
- package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
- package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
- package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
- package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
- package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
- package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
- package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
- package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
- package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
- package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
- package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
- package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
- package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
- package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
- package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
- package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
- package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
- package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
- package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
- package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
- package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
- package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
- package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
- package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
- package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
- package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
- package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
- package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
- package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
- package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
- package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
- package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
- package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
- package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
- package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
- package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
- package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
- package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
- package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
# Data Storytelling
|
|
2
|
+
|
|
3
|
+
> Version: 1.0.0 | Agent: nancy-duarte | Domain: presentations, data-narrative
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
Data storytelling is the practice of using narrative structure, visual design, and selective data presentation to communicate insights in ways that drive understanding and action. Raw data informs; data stories move people.
|
|
8
|
+
|
|
9
|
+
The paradox of data: the more data you have, the harder it is to communicate. Data storytelling resolves this by applying narrative logic to analytical content.
|
|
10
|
+
|
|
11
|
+
**Primary specialist:** Nancy Duarte (DataStory, Resonate)
|
|
12
|
+
**Supporting context:** Hans Rosling (Factfulness), Heath Brothers (Made to Stick)
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## The Core Problem: Data Without Narrative
|
|
17
|
+
|
|
18
|
+
Most data presentations fail not because the data is wrong, but because:
|
|
19
|
+
- Too much data — the audience is overwhelmed and remembers nothing
|
|
20
|
+
- No tension — data is presented as information, not as story
|
|
21
|
+
- No protagonist — there's no "character" (person, organization, situation) whose fate the data measures
|
|
22
|
+
- No urgency — data without consequence doesn't motivate action
|
|
23
|
+
- Wrong audience — technical data delivered to decision-makers
|
|
24
|
+
|
|
25
|
+
**The fix:** Data storytelling imposes narrative structure on analytical content. The data becomes evidence for a story, not a replacement for it.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Nancy Duarte — DataStory Framework
|
|
30
|
+
|
|
31
|
+
**Source:** "DataStory: Explain Data and Inspire Action Through Story" (2019)
|
|
32
|
+
|
|
33
|
+
### The DataStory Framework
|
|
34
|
+
|
|
35
|
+
1. **Form your data** — Explore and understand what the data actually shows before deciding what to say
|
|
36
|
+
2. **Focus your insight** — What is the one most important thing the data reveals?
|
|
37
|
+
3. **Configure a story** — Structure the insight as a narrative with tension and resolution
|
|
38
|
+
4. **Create data displays** — Design visuals that support the narrative
|
|
39
|
+
5. **Influence your audience** — Deliver the story to drive the specific action needed
|
|
40
|
+
|
|
41
|
+
### Step 1: Form — Four Types of Data Insight
|
|
42
|
+
|
|
43
|
+
Before storytelling, identify what TYPE of insight you have:
|
|
44
|
+
|
|
45
|
+
| Insight Type | What It Shows | Visual Type |
|
|
46
|
+
|-------------|--------------|-------------|
|
|
47
|
+
| **Comparison** | How items relate to each other | Bar chart, column chart, dot plot |
|
|
48
|
+
| **Trend** | How things change over time | Line chart, area chart |
|
|
49
|
+
| **Relationship** | How variables correlate | Scatter plot, bubble chart |
|
|
50
|
+
| **Part-to-whole** | How components make up a total | Pie chart (use sparingly), treemap, stacked bar |
|
|
51
|
+
|
|
52
|
+
**Common error:** Using the wrong chart type for the insight type. Using a pie chart to show trend. Using a line chart for categories. The wrong visual obscures the insight.
|
|
53
|
+
|
|
54
|
+
### Step 2: Focus — The One Insight
|
|
55
|
+
|
|
56
|
+
Data presentations fail when they try to show everything. DataStory forces a single, answerable question:
|
|
57
|
+
|
|
58
|
+
**The big idea sentence:** "[Person/group] should [take action] because [data insight + consequence]"
|
|
59
|
+
|
|
60
|
+
Example: "The marketing team should shift 30% of budget to email because email generates 4x more qualified leads per dollar than paid social."
|
|
61
|
+
|
|
62
|
+
Everything in the presentation either supports this sentence or should be cut.
|
|
63
|
+
|
|
64
|
+
### Step 3: Configure — Story Structure for Data
|
|
65
|
+
|
|
66
|
+
Apply the Sparkline to data:
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
WHAT IS (the current data state — the uncomfortable truth)
|
|
70
|
+
WHAT COULD BE (the data trend that's possible, the benchmark we could reach)
|
|
71
|
+
WHAT IS (the obstacles, the barriers, the data that shows the gap)
|
|
72
|
+
WHAT COULD BE (the vision if we act on the insight)
|
|
73
|
+
[THE STAR MOMENT: the single most surprising/important data point]
|
|
74
|
+
CALL TO ACTION (specific decision or behavior change)
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### The Tension Pair in Data
|
|
78
|
+
|
|
79
|
+
The most effective data stories show a tension between two data points:
|
|
80
|
+
- Where we are vs. where we could be
|
|
81
|
+
- Our performance vs. the benchmark
|
|
82
|
+
- The trend if we act vs. the trend if we don't
|
|
83
|
+
- The cost of the problem vs. the cost of the solution
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## Chart Selection Guide
|
|
88
|
+
|
|
89
|
+
The most common chart types and when to use each:
|
|
90
|
+
|
|
91
|
+
| Chart Type | Best For | Avoid When |
|
|
92
|
+
|-----------|---------|-----------|
|
|
93
|
+
| **Bar chart** | Comparing discrete categories | Too many categories (>12) |
|
|
94
|
+
| **Column chart** | Comparing over few time periods | Many time periods (use line instead) |
|
|
95
|
+
| **Line chart** | Trends over time | Few time periods (use column) |
|
|
96
|
+
| **Area chart** | Cumulative trends, part-to-whole over time | Comparing separate series |
|
|
97
|
+
| **Scatter plot** | Correlation between two variables | Audience unfamiliar with scatter plots |
|
|
98
|
+
| **Bubble chart** | Three-variable relationships | Small differences between bubbles |
|
|
99
|
+
| **Pie chart** | Part-to-whole (use only with 2-3 slices) | More than 4 slices; comparisons over time |
|
|
100
|
+
| **Treemap** | Hierarchical part-to-whole | Fine-grained comparison needed |
|
|
101
|
+
| **Heatmap** | Patterns in matrices | Small datasets |
|
|
102
|
+
| **Table** | Precise values matter | Finding trends or comparisons |
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Slide Design Principles for Data
|
|
107
|
+
|
|
108
|
+
### One Insight Per Slide
|
|
109
|
+
Each slide communicates exactly one idea. If a slide needs a title to explain itself, the visual isn't working. The title states the insight (declarative sentence), not the data type.
|
|
110
|
+
|
|
111
|
+
**Wrong title:** "Q3 Revenue by Region" (just a label)
|
|
112
|
+
**Right title:** "Northeast Revenue Grew 40% While All Other Regions Declined" (the insight)
|
|
113
|
+
|
|
114
|
+
### Slide Titles as Story
|
|
115
|
+
A sequence of slide titles should tell the story on their own. Executive audiences often only read titles. If the titles tell the story, the slides are working.
|
|
116
|
+
|
|
117
|
+
**Test:** Print only the slide titles. Does the narrative make sense? Does the story build?
|
|
118
|
+
|
|
119
|
+
### Data Decoration vs. Data Communication
|
|
120
|
+
|
|
121
|
+
**Decoration** (avoid):
|
|
122
|
+
- 3D charts (distort proportions)
|
|
123
|
+
- Gradient fills (add noise)
|
|
124
|
+
- Unnecessary borders and gridlines
|
|
125
|
+
- Decorative images unrelated to data
|
|
126
|
+
- "Chart junk" (Tufte's term for unnecessary visual elements)
|
|
127
|
+
|
|
128
|
+
**Communication** (use):
|
|
129
|
+
- Clear labeling of axes
|
|
130
|
+
- Data labels on key points
|
|
131
|
+
- Annotation of significant moments
|
|
132
|
+
- Highlighting the specific data point the story is about
|
|
133
|
+
- White space (negative space directs attention)
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## The Annotation Technique
|
|
138
|
+
|
|
139
|
+
One of the most powerful data storytelling tools: annotating the chart with the narrative context.
|
|
140
|
+
|
|
141
|
+
Instead of a bare chart, add:
|
|
142
|
+
- **Event annotations:** "Product launch," "Competitor enters market," "Policy changed"
|
|
143
|
+
- **Consequence annotations:** "This gap represents 2,000 customers lost monthly"
|
|
144
|
+
- **Comparison annotations:** "Industry average" line on your performance chart
|
|
145
|
+
- **Highlight annotations:** Circle or highlight the specific data point the story is about
|
|
146
|
+
|
|
147
|
+
The annotation bridges data and narrative. It says: "Here's what the number means in the world."
|
|
148
|
+
|
|
149
|
+
---
|
|
150
|
+
|
|
151
|
+
## Hans Rosling's Approach
|
|
152
|
+
|
|
153
|
+
Hans Rosling (1948-2017) was a statistician who became famous for making global development data accessible and compelling. His approach synthesizes data with storytelling in ways that changed how people perceive the world.
|
|
154
|
+
|
|
155
|
+
### Rosling's Core Techniques
|
|
156
|
+
|
|
157
|
+
**1. The Bubble Chart Animation**
|
|
158
|
+
Rosling used animated bubble charts (Gapminder) to show how global health and wealth changed over decades. The animation was narrative — it showed the story of progress over time.
|
|
159
|
+
|
|
160
|
+
**Key insight:** Static data is a snapshot. Animated data shows movement — and movement is story.
|
|
161
|
+
|
|
162
|
+
**2. Concrete Scale**
|
|
163
|
+
Rather than large numbers, Rosling always brought them to human scale.
|
|
164
|
+
- Not "1 billion people" — "Every person in China plus every person in India and half of Africa"
|
|
165
|
+
- Not "child mortality fell 50%" — "In 1950, 1 in 5 children died before age 5. Today, it's 1 in 25."
|
|
166
|
+
|
|
167
|
+
**Scale** creates emotional recognition. Abstract numbers create cognitive distance.
|
|
168
|
+
|
|
169
|
+
**3. Factfulness — Fighting Overdramatic Instincts**
|
|
170
|
+
Rosling identified 10 instincts that cause people to misread data:
|
|
171
|
+
- The Gap Instinct (seeing distinct groups when continuums exist)
|
|
172
|
+
- The Negativity Instinct (bad news registers more than good)
|
|
173
|
+
- The Straight Line Instinct (assuming trends continue linearly)
|
|
174
|
+
- The Fear Instinct (overweighting dramatic, scary data)
|
|
175
|
+
- The Size Instinct (big numbers seem more important without proportion)
|
|
176
|
+
|
|
177
|
+
**Storytelling application:** Great data stories actively counter these instincts by providing context, proportion, and counterintuitive framing.
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## The Narrative Arc for Data Presentations
|
|
182
|
+
|
|
183
|
+
### Structure for Executive Audiences (< 15 minutes)
|
|
184
|
+
|
|
185
|
+
```
|
|
186
|
+
1. THE SITUATION (2 min)
|
|
187
|
+
- What question are we answering?
|
|
188
|
+
- Why does it matter now?
|
|
189
|
+
- One chart that shows the key context
|
|
190
|
+
|
|
191
|
+
2. THE INSIGHT (5 min)
|
|
192
|
+
- The specific finding — the "but" in the data
|
|
193
|
+
- 2-3 supporting evidence slides
|
|
194
|
+
- The star data moment (most surprising finding)
|
|
195
|
+
|
|
196
|
+
3. THE IMPLICATION (3 min)
|
|
197
|
+
- What this means for the business
|
|
198
|
+
- The cost of acting vs. not acting
|
|
199
|
+
- One slide with the consequence
|
|
200
|
+
|
|
201
|
+
4. THE RECOMMENDATION (5 min)
|
|
202
|
+
- Specific proposed action
|
|
203
|
+
- What it requires
|
|
204
|
+
- Expected outcome
|
|
205
|
+
- The ask
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
### Structure for Technical Audiences (30-60 minutes)
|
|
209
|
+
|
|
210
|
+
Same structure but with expanded supporting data, methodology disclosure, and uncertainty quantification.
|
|
211
|
+
|
|
212
|
+
---
|
|
213
|
+
|
|
214
|
+
## Data Storytelling Anti-Patterns
|
|
215
|
+
|
|
216
|
+
| Anti-Pattern | Problem | Fix |
|
|
217
|
+
|-------------|---------|-----|
|
|
218
|
+
| "Data dump" deck | 40 slides of raw data, no narrative | Find the single most important insight first |
|
|
219
|
+
| Misleading axes | Y-axis doesn't start at zero on bar charts | Start bar charts at zero; label explicitly |
|
|
220
|
+
| 3D charts | Visual distortion makes comparison inaccurate | Use 2D only |
|
|
221
|
+
| Too many colors | No hierarchy, no emphasis | 3 colors maximum; highlight color for key data |
|
|
222
|
+
| Title as label | "Q3 Results" tells nothing | "Q3 Results Beat Target by 23%" tells a story |
|
|
223
|
+
| Missing context | Raw numbers without benchmarks | Always show context: target, trend, comparison |
|
|
224
|
+
| Precision theater | 6 decimal places imply false accuracy | Round appropriately; acknowledge uncertainty |
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
228
|
+
## Cross-Reference
|
|
229
|
+
|
|
230
|
+
- **Nancy Duarte's Sparkline** is the presentation framework that surrounds the data story
|
|
231
|
+
- **Park Howell's ABT** provides the "But" that makes data narratively interesting
|
|
232
|
+
- **Made to Stick (Heath Brothers)** provides the SUCCESs model for making data memorable
|
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
# Improv & Spontaneous Storytelling
|
|
2
|
+
|
|
3
|
+
> Version: 1.0.0 | Agent: keith-johnstone | Domain: improvisation, creative-unblocking
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
Keith Johnstone is the inventor of Theatresports (competitive improv) and author of "Impro" (1979) and "Impro for Storytellers" (1999). His work is not just about performance — it's a complete philosophy of spontaneity, status, and creative unblocking that applies to anyone who tells stories.
|
|
8
|
+
|
|
9
|
+
Johnstone's core insight: **the blocks to storytelling are social and psychological, not technical.** Most people can't tell good stories not because they lack skill, but because they're trying to be good, avoid judgment, and maintain control. These survival mechanisms kill spontaneity.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## The Core Paradox
|
|
14
|
+
|
|
15
|
+
Johnstone discovered that the more people try to be creative, the less creative they become. The path to genuine creativity is **to stop trying and start accepting.**
|
|
16
|
+
|
|
17
|
+
**Trying to be creative** → self-monitoring → censorship → blocked, generic output
|
|
18
|
+
**Accepting what comes** → flow state → surprise → authentic, vivid output
|
|
19
|
+
|
|
20
|
+
This is counterintuitive for trained professionals who believe craft = conscious control. Improv reveals that the most powerful stories emerge when the conscious mind gets out of the way.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Status — The Master System
|
|
25
|
+
|
|
26
|
+
The most influential concept in Johnstone's work: **every interaction involves a status transaction.**
|
|
27
|
+
|
|
28
|
+
Status is not social rank or job title. Status is behavioral — it's communicated moment to moment through body language, eye contact, vocal patterns, and word choices.
|
|
29
|
+
|
|
30
|
+
### High Status Behaviors
|
|
31
|
+
|
|
32
|
+
- Still head and body (no fidgeting)
|
|
33
|
+
- Held eye contact (looks away to think, not to avoid)
|
|
34
|
+
- Slow, deliberate speech with pauses
|
|
35
|
+
- Low vocal pitch, no rising inflection on statements
|
|
36
|
+
- Uses space fully — doesn't compress body
|
|
37
|
+
- Responds rather than reacts
|
|
38
|
+
- Comfortable with silence
|
|
39
|
+
|
|
40
|
+
### Low Status Behaviors
|
|
41
|
+
|
|
42
|
+
- Excessive movement, displacement activity (touching face, hair)
|
|
43
|
+
- Breaking eye contact first
|
|
44
|
+
- Fast speech, filling silence
|
|
45
|
+
- Rising inflection on statements (makes everything sound like a question)
|
|
46
|
+
- Compressed posture
|
|
47
|
+
- Excessive hedging language ("I kind of think maybe...")
|
|
48
|
+
- Laughing at own jokes nervously
|
|
49
|
+
|
|
50
|
+
### Why Status Matters for Storytelling
|
|
51
|
+
|
|
52
|
+
Every character in a story has status relative to every other character. Status shifts drive drama. A story where status never changes is static and boring.
|
|
53
|
+
|
|
54
|
+
Great stories are **status games**:
|
|
55
|
+
- Characters fight for status (drama)
|
|
56
|
+
- Characters lose status (tragedy)
|
|
57
|
+
- Characters gain status unexpectedly (triumph)
|
|
58
|
+
- Low-status characters achieve high-status ends (comedy)
|
|
59
|
+
|
|
60
|
+
**Application for presenters and speakers:**
|
|
61
|
+
- Entering a room with high-status body language changes how the audience receives the story
|
|
62
|
+
- Fake high status (overcompensation) reads as insecurity
|
|
63
|
+
- Genuine high status comes from accepting the situation, not fighting it
|
|
64
|
+
|
|
65
|
+
### Status Transactions in Business
|
|
66
|
+
|
|
67
|
+
| Situation | Low Status Move | High Status Move |
|
|
68
|
+
|-----------|----------------|-----------------|
|
|
69
|
+
| Entering negotiation | "We're really excited to work with you" | "Tell me about your situation" |
|
|
70
|
+
| Receiving criticism | Defending immediately | "Interesting perspective. Tell me more." |
|
|
71
|
+
| Presenting to executives | "I hope this makes sense" | "Here's what we've found" |
|
|
72
|
+
| Handling objections | "I understand, but..." | "You're right that [X]. And [Y]." |
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## Yes, And — The Foundation of Collaborative Story
|
|
77
|
+
|
|
78
|
+
The first rule of improv: **accept what your partner offers and build on it.**
|
|
79
|
+
|
|
80
|
+
"Yes" = accept the reality your partner has created
|
|
81
|
+
"And" = add to it, build forward, make it more real
|
|
82
|
+
|
|
83
|
+
### Yes, And vs. Blocking
|
|
84
|
+
|
|
85
|
+
| Move | Effect on Story |
|
|
86
|
+
|------|----------------|
|
|
87
|
+
| **Yes, And** | Story advances, both players engage, reality deepens |
|
|
88
|
+
| **Block** ("No, that's not right") | Story dies, partner feels rejected, tension shifts from story to players |
|
|
89
|
+
| **Hedge** ("Kind of, but maybe...") | Story weakens, commitment disappears |
|
|
90
|
+
| **Accept but negate** ("Yes, AND that's totally fine") | Kills the tension the partner was building |
|
|
91
|
+
|
|
92
|
+
**In storytelling workshops:** Yes-And is taught as a communication skill. Partners who practice it stop competing to control the narrative and start co-creating it.
|
|
93
|
+
|
|
94
|
+
**In business contexts:** Blocking is the default in meetings ("Actually, I think..."). Yes-And moves transform meetings into generative spaces.
|
|
95
|
+
|
|
96
|
+
### Yes, And at the Story Level
|
|
97
|
+
|
|
98
|
+
When telling a story, "Yes, And" means:
|
|
99
|
+
- Accept the premise you've set up — don't back away from it
|
|
100
|
+
- Follow the logic wherever it leads — don't redirect when it gets uncomfortable
|
|
101
|
+
- Each new story element builds on (not replaces) what came before
|
|
102
|
+
- Trust the escalation — where you think the story is "too much" is usually exactly right
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Offers and Blocks
|
|
107
|
+
|
|
108
|
+
An "offer" is anything a performer gives the scene — an action, a word, a sound, a gesture. Every offer carries narrative potential.
|
|
109
|
+
|
|
110
|
+
A "block" is refusing, ignoring, or undermining an offer.
|
|
111
|
+
|
|
112
|
+
**Johnstone's observation:** Beginners block constantly. They refuse offers because:
|
|
113
|
+
- The offer wasn't what they planned
|
|
114
|
+
- The offer seems "wrong" or "bad"
|
|
115
|
+
- The offer would require vulnerability or risk
|
|
116
|
+
- The offer would expose them to judgment
|
|
117
|
+
|
|
118
|
+
**The training:** Learn to accept EVERY offer and build on it. This builds trust (between partners), spontaneity (in the self), and richness (in the story).
|
|
119
|
+
|
|
120
|
+
### Tilting, Advancing, Reincorporation
|
|
121
|
+
|
|
122
|
+
Three techniques for developing scenes:
|
|
123
|
+
|
|
124
|
+
**Tilting** — Changing the direction of the scene gradually (not blocking, but steering)
|
|
125
|
+
**Advancing** — Escalating the reality of the scene forward
|
|
126
|
+
**Reincorporation** — Bringing back elements from earlier in the scene in a new context (creates surprise and coherence simultaneously)
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## Platform-Tilt-Resolution (PTR)
|
|
131
|
+
|
|
132
|
+
The basic structural unit of improv scenes:
|
|
133
|
+
|
|
134
|
+
```
|
|
135
|
+
PLATFORM: Establish the normal — who, where, what, what's the relationship
|
|
136
|
+
TILT: Something disrupts the normal — tension enters
|
|
137
|
+
RESOLUTION: How the disruption is resolved — usually surprising
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
This maps to: Setup → Conflict → Payoff
|
|
141
|
+
|
|
142
|
+
**Why it matters for storytelling:** If you skip the Platform (start too quickly), the Tilt has no impact. The audience needs to understand what "normal" is before they can feel the disruption.
|
|
143
|
+
|
|
144
|
+
**In business contexts:** Before presenting a problem (Tilt), establish the context (Platform). Before presenting a solution (Resolution), make the problem feel real.
|
|
145
|
+
|
|
146
|
+
---
|
|
147
|
+
|
|
148
|
+
## Spontaneity vs Preparation
|
|
149
|
+
|
|
150
|
+
Johnstone's paradox of spontaneity:
|
|
151
|
+
|
|
152
|
+
**The trap:** Most people practice to eliminate spontaneity — they script, rehearse, and control everything.
|
|
153
|
+
|
|
154
|
+
**The insight:** Spontaneity is not the absence of preparation. It's the result of preparation so deep that conscious monitoring is no longer required.
|
|
155
|
+
|
|
156
|
+
**The levels:**
|
|
157
|
+
1. **Unconscious incompetence** — Don't know you're blocking; stories are flat
|
|
158
|
+
2. **Conscious incompetence** — See the blocks; stories improve but feel effortful
|
|
159
|
+
3. **Conscious competence** — Can apply techniques deliberately; stories work but feel calculated
|
|
160
|
+
4. **Unconscious competence** — Techniques are internalized; spontaneous stories have structure without effort
|
|
161
|
+
|
|
162
|
+
Most professional storytellers operate at level 3 when stressed and level 4 when at ease.
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## Johnstone's Rules for Finding Stories
|
|
167
|
+
|
|
168
|
+
**1. Don't be original — be obvious.**
|
|
169
|
+
The first thing that comes to mind is usually the most truthful and universally relatable. The second and third thoughts are the self-censored, "improved" versions that lose authenticity.
|
|
170
|
+
|
|
171
|
+
**2. Say the scary thing first.**
|
|
172
|
+
The moment where you think "I can't say that" is usually the most interesting moment to say. Self-censorship is the enemy of genuine story.
|
|
173
|
+
|
|
174
|
+
**3. Make the other person look good.**
|
|
175
|
+
In collaborative story, your job is to make your partner look brilliant. This counter-intuitively makes you look brilliant. Same principle in business communication: make the customer look good, not yourself.
|
|
176
|
+
|
|
177
|
+
**4. The story goes where the fear is.**
|
|
178
|
+
Wherever in the story you feel resistance, that's where the story needs to go. The blocks you feel tell you exactly where the truth is.
|
|
179
|
+
|
|
180
|
+
**5. Mistakes are gifts.**
|
|
181
|
+
When something goes "wrong" in a story, it's an offer. Accept it. Build on it. The audience doesn't know your plan — they only see what you do.
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## Practical Improv Exercises for Storytellers
|
|
186
|
+
|
|
187
|
+
### Exercise 1: One Word at a Time
|
|
188
|
+
Two people tell a story one word at a time, alternating. No one controls the story. Result: The story goes places neither person would have gone alone.
|
|
189
|
+
|
|
190
|
+
**Lesson:** Stories don't need to be controlled to be good. Surrender to the story.
|
|
191
|
+
|
|
192
|
+
### Exercise 2: Yes-And in Pairs
|
|
193
|
+
Person A makes a statement. Person B must say "Yes, and..." and build on it. No blocks, no "yes, buts."
|
|
194
|
+
|
|
195
|
+
**Lesson:** Acceptance is generative. The instinct to block weakens with practice.
|
|
196
|
+
|
|
197
|
+
### Exercise 3: Gibberish Status
|
|
198
|
+
Have two people interact using only gibberish — no real words. Audience can identify the high-status and low-status character immediately.
|
|
199
|
+
|
|
200
|
+
**Lesson:** Status is communicated through body and tone, not content.
|
|
201
|
+
|
|
202
|
+
### Exercise 4: Reincorporation
|
|
203
|
+
Tell a 2-minute story. Halfway through, the instructor calls out an element from the first minute ("bring back the red coat"). The teller must weave it back in.
|
|
204
|
+
|
|
205
|
+
**Lesson:** Reincorporation creates the feeling of inevitability — great endings feel like they were foreshadowed.
|
|
206
|
+
|
|
207
|
+
---
|
|
208
|
+
|
|
209
|
+
## Improv Principles in Non-Performance Contexts
|
|
210
|
+
|
|
211
|
+
| Context | Application |
|
|
212
|
+
|---------|-------------|
|
|
213
|
+
| **Sales call** | Yes-And with prospect's objections instead of blocking them |
|
|
214
|
+
| **Keynote presentation** | Let the room's energy guide pacing — don't fight the audience's state |
|
|
215
|
+
| **Brainstorming meeting** | No blocking ideas before they're fully expressed |
|
|
216
|
+
| **Podcast/interview** | Accept the host's framing; build on it rather than redirecting |
|
|
217
|
+
| **Writer's block** | Write the obvious, scary, or "bad" first — get out of level 3 |
|
|
218
|
+
| **Client workshop** | Bring PTR to every exercise — Platform, then Tilt, then Resolution |
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
## Cross-Reference
|
|
223
|
+
|
|
224
|
+
- **Kindra Hall** uses Johnstone's authenticity principles in finding and telling personal stories
|
|
225
|
+
- **Dan Harmon's Story Circle** provides structure for the scenes that improv generates
|
|
226
|
+
- **Marshall Ganz** requires genuine spontaneity in delivering the Story of Self
|