sinapse-ai 9.3.0 → 9.5.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.
Files changed (432) hide show
  1. package/.claude/CLAUDE.md +60 -341
  2. package/.claude/hooks/enforce-architecture-first.py +197 -197
  3. package/.claude/hooks/enforce-git-push-authority.sh +25 -4
  4. package/.claude/hooks/mind-clone-governance.py +193 -193
  5. package/.claude/hooks/read-protection.py +152 -152
  6. package/.claude/hooks/sql-governance.py +183 -183
  7. package/.claude/hooks/verify-packages.cjs +83 -0
  8. package/.claude/hooks/write-path-validation.py +195 -195
  9. package/.claude/rules/agent-authority.md +6 -0
  10. package/.claude/rules/agent-handoff.md +5 -0
  11. package/.claude/rules/cross-squad-routing.md +5 -0
  12. package/.claude/rules/hook-governance.md +7 -0
  13. package/.claude/rules/mandatory-delegation.md +24 -0
  14. package/.claude/rules/mcp-usage.md +3 -1
  15. package/.claude/rules/project-intelligence.md +63 -0
  16. package/.claude/rules/response-format.md +4 -0
  17. package/.claude/rules/safe-collaboration.md +14 -2
  18. package/.claude/rules/security-data-protection.md +27 -0
  19. package/.claude/rules/squad-awareness.md +96 -68
  20. package/.claude/rules/token-economy.md +148 -0
  21. package/.claude/rules/tool-examples.md +6 -0
  22. package/.claude/rules/workflow-execution.md +7 -0
  23. package/.codex/agents/analyst.md +342 -71
  24. package/.codex/agents/architect.md +533 -68
  25. package/.codex/agents/data-engineer.md +530 -106
  26. package/.codex/agents/developer.md +657 -0
  27. package/.codex/agents/devops.md +639 -69
  28. package/.codex/agents/product-lead.md +362 -0
  29. package/.codex/agents/project-lead.md +405 -0
  30. package/.codex/agents/quality-gate.md +538 -0
  31. package/.codex/agents/sinapse-orqx.md +9 -7
  32. package/.codex/agents/sprint-lead.md +315 -0
  33. package/.codex/agents/squad-creator.md +402 -0
  34. package/.codex/agents/ux-design-expert.md +523 -0
  35. package/.codex/delegation-matrix.json +756 -44
  36. package/.codex/handoff-packet.schema.json +30 -6
  37. package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
  38. package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
  39. package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
  40. package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
  41. package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
  42. package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
  43. package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
  44. package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
  45. package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
  46. package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
  47. package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
  48. package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
  49. package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
  50. package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
  51. package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
  52. package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
  53. package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
  54. package/.sinapse-ai/core/doctor/index.js +157 -50
  55. package/.sinapse-ai/core/ids/registry-updater.js +6 -1
  56. package/.sinapse-ai/core/logger/index.js +319 -0
  57. package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
  58. package/.sinapse-ai/core/telemetry/index.js +247 -0
  59. package/.sinapse-ai/data/entity-registry.yaml +1060 -808
  60. package/.sinapse-ai/development/agents/analyst.md +90 -0
  61. package/.sinapse-ai/development/agents/architect.md +78 -0
  62. package/.sinapse-ai/development/agents/data-engineer.md +38 -0
  63. package/.sinapse-ai/development/agents/developer.md +97 -0
  64. package/.sinapse-ai/development/agents/devops.md +121 -0
  65. package/.sinapse-ai/development/agents/product-lead.md +27 -0
  66. package/.sinapse-ai/development/agents/project-lead.md +28 -0
  67. package/.sinapse-ai/development/agents/quality-gate.md +89 -0
  68. package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
  69. package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
  70. package/.sinapse-ai/development/agents/squad-creator.md +58 -0
  71. package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
  72. package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
  73. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
  74. package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
  75. package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
  76. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
  77. package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
  78. package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
  79. package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
  80. package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
  81. package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
  82. package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
  83. package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
  84. package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
  85. package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
  86. package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
  87. package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
  88. package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
  89. package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
  90. package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
  91. package/.sinapse-ai/development/skills/debug.md +57 -0
  92. package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
  93. package/.sinapse-ai/development/skills/fast-review.md +69 -0
  94. package/.sinapse-ai/development/skills/model-router.md +92 -0
  95. package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
  96. package/.sinapse-ai/development/skills/security-scan.md +73 -0
  97. package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
  98. package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
  99. package/.sinapse-ai/development/skills/verify.md +53 -0
  100. package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
  101. package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
  102. package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
  103. package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
  104. package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
  105. package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
  106. package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
  107. package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
  108. package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
  109. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
  110. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
  111. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
  112. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
  113. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
  114. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
  115. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
  116. package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
  117. package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
  118. package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
  119. package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
  120. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
  121. package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
  122. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
  123. package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
  124. package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
  125. package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
  126. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
  127. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
  128. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
  129. package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
  130. package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
  131. package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
  132. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
  133. package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
  134. package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
  135. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
  136. package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
  137. package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
  138. package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
  139. package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
  140. package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
  141. package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
  142. package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
  143. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
  144. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
  145. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
  146. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
  147. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
  148. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
  149. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
  150. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
  151. package/.sinapse-ai/install-manifest.yaml +333 -162
  152. package/.sinapse-ai/local-config.yaml.template +65 -65
  153. package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
  154. package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
  155. package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
  156. package/.sinapse-ai/monitor/hooks/notification.py +30 -30
  157. package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
  158. package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
  159. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
  160. package/.sinapse-ai/monitor/hooks/stop.py +30 -30
  161. package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
  162. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
  163. package/.sinapse-ai/product/templates/adr.hbs +126 -126
  164. package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
  165. package/.sinapse-ai/product/templates/epic.hbs +213 -213
  166. package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
  167. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
  168. package/.sinapse-ai/product/templates/prd.hbs +202 -202
  169. package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
  170. package/.sinapse-ai/product/templates/story.hbs +264 -264
  171. package/.sinapse-ai/product/templates/task.hbs +171 -171
  172. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
  173. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
  174. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
  175. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
  176. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
  177. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
  178. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
  179. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
  180. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
  181. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
  182. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
  183. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
  184. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
  185. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
  186. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
  187. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
  188. package/LICENSE +34 -34
  189. package/README.en.md +167 -20
  190. package/README.md +190 -22
  191. package/bin/cli.js +510 -196
  192. package/bin/postinstall.js +564 -0
  193. package/bin/sinapse-cli +283 -283
  194. package/bin/sinapse-graph.js +9 -0
  195. package/bin/sinapse-init.js +36 -4
  196. package/bin/sinapse-minimal.js +20 -9
  197. package/bin/sinapse.js +202 -122
  198. package/bin/utils/deprecation-warning.js +46 -0
  199. package/bin/utils/pre-push-safety.js +14 -0
  200. package/docs/TELEMETRY.md +131 -0
  201. package/docs/chrome-brain-upgrade-plan.md +624 -0
  202. package/docs/codex-integration-process.md +22 -0
  203. package/docs/codex-parity-program.md +27 -0
  204. package/docs/framework/orqx-plan.md +1 -1
  205. package/docs/ide-integration.md +36 -0
  206. package/docs/installation/chrome-brain.md +17 -7
  207. package/docs/mega-upgrade-orchestration-plan.md +71 -0
  208. package/docs/pt/contributing.md +20 -0
  209. package/docs/research-synthesis-for-upgrade.md +511 -0
  210. package/docs/security-audit-report.md +306 -0
  211. package/package.json +20 -8
  212. package/packages/installer/src/config/configure-environment.js +19 -44
  213. package/packages/installer/src/detection/detect-project-type.js +181 -63
  214. package/packages/installer/src/installer/manifest-signature.js +32 -17
  215. package/packages/installer/src/wizard/i18n.js +12 -0
  216. package/packages/installer/src/wizard/ide-config-generator.js +8 -39
  217. package/packages/installer/src/wizard/index.js +119 -14
  218. package/packages/installer/src/wizard/questions.js +2 -3
  219. package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
  220. package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
  221. package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
  222. package/packages/sinapse-install/bin/edmcp.js +0 -0
  223. package/packages/sinapse-install/bin/sinapse-install.js +0 -0
  224. package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
  225. package/scripts/check-markdown-links.py +353 -353
  226. package/scripts/coverage-report-summary.js +169 -0
  227. package/scripts/generate-install-manifest.js +6 -2
  228. package/scripts/release-readiness.js +169 -0
  229. package/scripts/test-install-matrix-local.sh +153 -0
  230. package/scripts/validate-install-docs.js +394 -0
  231. package/scripts/validate-no-external-refs.js +376 -0
  232. package/scripts/validate-squad-orqx.js +302 -0
  233. package/scripts/validate-story-meta.js +263 -0
  234. package/squads/claude-code-mastery/CHANGELOG.md +1 -1
  235. package/squads/claude-code-mastery/README.md +2 -2
  236. package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
  237. package/squads/claude-code-mastery/squad.yaml +1 -1
  238. package/squads/squad-artdir/README.md +90 -0
  239. package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
  240. package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
  241. package/squads/squad-artdir/agents/color-psychologist.md +166 -0
  242. package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
  243. package/squads/squad-artdir/agents/design-system-architect.md +100 -0
  244. package/squads/squad-artdir/agents/ia-architect.md +169 -0
  245. package/squads/squad-artdir/agents/interaction-designer.md +162 -0
  246. package/squads/squad-artdir/agents/layout-engineer.md +163 -0
  247. package/squads/squad-artdir/agents/motion-architect.md +185 -0
  248. package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
  249. package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
  250. package/squads/squad-artdir/agents/product-surface-director.md +86 -0
  251. package/squads/squad-artdir/agents/type-systemist.md +138 -0
  252. package/squads/squad-artdir/agents/visual-strategist.md +127 -0
  253. package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
  254. package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
  255. package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
  256. package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
  257. package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
  258. package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
  259. package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
  260. package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
  261. package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
  262. package/squads/squad-artdir/package.json +20 -0
  263. package/squads/squad-artdir/squad.yaml +271 -0
  264. package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
  265. package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
  266. package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
  267. package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
  268. package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
  269. package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
  270. package/squads/squad-artdir/tasks/design-color-system.md +81 -0
  271. package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
  272. package/squads/squad-artdir/tasks/design-token-system.md +58 -0
  273. package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
  274. package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
  275. package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
  276. package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
  277. package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
  278. package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
  279. package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
  280. package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
  281. package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
  282. package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
  283. package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
  284. package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
  285. package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
  286. package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
  287. package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
  288. package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
  289. package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
  290. package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
  291. package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
  292. package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
  293. package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
  294. package/squads/squad-brand/squad.yaml +20 -6
  295. package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
  296. package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
  297. package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
  298. package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
  299. package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
  300. package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
  301. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
  302. package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
  303. package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
  304. package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
  305. package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
  306. package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
  307. package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
  308. package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
  309. package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
  310. package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
  311. package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
  312. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
  313. package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
  314. package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
  315. package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
  316. package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
  317. package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
  318. package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
  319. package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
  320. package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
  321. package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
  322. package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
  323. package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
  324. package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
  325. package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
  326. package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
  327. package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
  328. package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
  329. package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
  330. package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
  331. package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
  332. package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
  333. package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
  334. package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
  335. package/squads/squad-content/squad.yaml +187 -27
  336. package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
  337. package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
  338. package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
  339. package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
  340. package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
  341. package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
  342. package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
  343. package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
  344. package/squads/squad-copy/squad.yaml +19 -4
  345. package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
  346. package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
  347. package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
  348. package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
  349. package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
  350. package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
  351. package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
  352. package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
  353. package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
  354. package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
  355. package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
  356. package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
  357. package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
  358. package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
  359. package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
  360. package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
  361. package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
  362. package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
  363. package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
  364. package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
  365. package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
  366. package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
  367. package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
  368. package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
  369. package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
  370. package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
  371. package/squads/squad-design/squad.yaml +19 -4
  372. package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
  373. package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
  374. package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
  375. package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
  376. package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
  377. package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
  378. package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
  379. package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
  380. package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
  381. package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
  382. package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
  383. package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
  384. package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
  385. package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
  386. package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
  387. package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
  388. package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
  389. package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
  390. package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
  391. package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
  392. package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
  393. package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
  394. package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
  395. package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
  396. package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
  397. package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
  398. package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
  399. package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
  400. package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
  401. package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
  402. package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
  403. package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
  404. package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
  405. package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
  406. package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
  407. package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
  408. package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
  409. package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
  410. package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
  411. package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
  412. package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
  413. package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
  414. package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
  415. package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
  416. package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
  417. package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
  418. package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
  419. package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
  420. package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
  421. package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
  422. package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
  423. package/.sinapse-ai/core/registry/service-registry.json +0 -6346
  424. package/.sinapse-ai/data/registry-update-log.jsonl +0 -1307
  425. package/.sinapse-ai/manifests/agents.csv +0 -29
  426. package/.sinapse-ai/manifests/tasks.csv +0 -204
  427. package/.sinapse-ai/manifests/workers.csv +0 -196
  428. package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
  429. package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
  430. package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
  431. package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
  432. package/squads/squad-paidmedia/tasks/calculate-sample-size.md +0 -57
@@ -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