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,234 @@
1
+ # Knowledge Base: AI Visual Generation Canon
2
+
3
+ > **Status:** Canon — canonical source of truth for how `squad-brand` (Meridian) produces brand-consistent visual output at scale using AI image/video models.
4
+ > **Version:** 1.0 (shipped with squad-brand v2.0.0 framework-upgrade / fw-v2.3)
5
+ > **Depends on:** `ai-api-capabilities.md` (capability catalog), `prompt-engineering-visual.md` (prompt mechanics)
6
+ > **Supersedes:** ad-hoc generation workflows
7
+
8
+ ## Why this doc exists
9
+
10
+ `ai-api-capabilities.md` is a **catalog** — "which API does what". `prompt-engineering-visual.md` is a **mechanics reference** — "how to write a prompt". Neither is a **canon** — "the rules that must hold for every brand asset we ship". In 2026, ~80% of brand visual production runs through AI models, and the gap between "I generated something that looks cool" and "I generated something that is on-brand and legally safe to ship" is the single biggest risk factor for brand drift.
11
+
12
+ This KB is the canonical playbook. Every agent in `squad-brand` that produces visual assets (brand-collateral-designer, brand-identity-designer, brand-motion-vfx, brand-creative-engineer) MUST comply with this canon for any asset that will leave the studio.
13
+
14
+ ---
15
+
16
+ ## 1. The 5 brand-consistency dimensions (lock these, always)
17
+
18
+ Every batch of AI-generated visual output is judged on 5 dimensions. Each dimension has a **lock protocol** — the concrete steps that enforce consistency across a batch, across sessions, across months.
19
+
20
+ ### 1.1 Style lock
21
+
22
+ **What it means:** The "visual vocabulary" — illustration style, render style, graphic sensibility. A batch must NOT mix photorealistic shots with flat illustrations unless the brand canon explicitly allows both.
23
+
24
+ **Lock protocol:**
25
+ 1. Declare the style in the brand canon (e.g. "editorial photography, natural light, medium grain").
26
+ 2. For each generation session, prepend the exact canon style phrase to every prompt.
27
+ 3. Pin 1-3 reference images in the model session (every modern model accepts reference input — Midjourney `--cref`, Stable Diffusion IP-Adapter, DALL-E upload, Flux img2img).
28
+ 4. If the model drifts mid-batch, STOP and re-seed with the reference — never "work around" drift in post.
29
+
30
+ ### 1.2 Lighting lock
31
+
32
+ **What it means:** Direction, hardness, color temperature, time-of-day. Lighting is the highest-signal brand marker after color and is often the first thing that drifts.
33
+
34
+ **Lock protocol:**
35
+ 1. Codify lighting in the canon: direction (N-SW 45°), hardness (soft/medium/hard), color temp (K), intensity (flat/dimensional/dramatic).
36
+ 2. Use precise vocabulary in prompts — "soft north-light 5500K, subtle rim" beats "nice lighting".
37
+ 3. Reference-image lock handles lighting implicitly when the reference is on-brand.
38
+ 4. For video: lock AFTER first frame — subsequent frames must inherit the anchor frame's lighting.
39
+
40
+ ### 1.3 Palette lock
41
+
42
+ **What it means:** Every color in the output must either be in the brand palette OR be a naturalistic color that the brand palette allows in context (e.g. skin tones, sky).
43
+
44
+ **Lock protocol:**
45
+ 1. Brand canon declares: primary palette (3-5 colors), secondary palette (5-10), neutrals (3-5), allowed environmental colors (context-dependent).
46
+ 2. Prompts reference specific named colors ("cerulean #1E40AF, warm ivory #FAF8F1").
47
+ 3. Post-generation palette extraction — run a script (or visual check) on the output against the declared palette. Any color > 5% area that is NOT in the allowed set is a FAIL.
48
+ 4. For illustrations/vectors: use a color-palette LUT or Figma variable binding to hard-lock at the design-tool layer.
49
+
50
+ ### 1.4 Subject lock
51
+
52
+ **What it means:** The specific entity (person, product, space) must be recognizably the same across all shots in a batch. This is the most technically demanding dimension and the one where naive prompting fails hardest.
53
+
54
+ **Lock protocol:**
55
+ 1. For **real people/products** the brand owns: use a trained LoRA / DreamBooth / textual inversion model of the subject (or Midjourney `--cref` / Flux reference).
56
+ 2. For **synthetic characters** that recur: lock via seed + prompt signature + reference image pinning. Treat the first accepted generation as the canonical reference and build the LoRA from the batch.
57
+ 3. For **products**: the reference image is the source of truth — every shot is inpainting/compositing, not free generation. Never trust a pure text-to-image generation of a real product.
58
+ 4. When the subject is **generic** (a crowd, a landscape): no subject lock required but the other 4 dimensions still apply.
59
+
60
+ ### 1.5 Composition lock
61
+
62
+ **What it means:** Framing, aspect, focal points, negative space behavior. Composition is the dimension most often "drifted" by AI models because they default to centered hero compositions.
63
+
64
+ **Lock protocol:**
65
+ 1. Specify aspect explicitly in every prompt (aspect params, `--ar`, output resolution).
66
+ 2. Specify framing vocabulary: close-up / medium / wide / establishing, eye-level / low / high angle.
67
+ 3. For batches that need composition variety: define the variety upfront (3 framings × 2 angles = 6-cell grid) and generate per cell, not free.
68
+ 4. For templates (social media slots, email headers): use ControlNet/reference with the canonical layout wireframe.
69
+
70
+ ---
71
+
72
+ ## 2. Model selection matrix (when to use which)
73
+
74
+ | Output type | First choice | Second choice | When to use which |
75
+ |-------------|-------------|---------------|-------------------|
76
+ | Hero editorial photography | Flux / Midjourney v6+ | Stable Diffusion + SDXL refiner | Flux for realism + control, MJ for aesthetic polish |
77
+ | Product shots on white | Stable Diffusion + ControlNet | DALL-E 3 edit | SD for compositing precision, DALL-E when product reference isn't available |
78
+ | Illustration series | Midjourney + style LoRA | Flux + reference image | MJ has the best style coherence for non-photo |
79
+ | Text-in-image (posters, quote cards) | Ideogram | DALL-E 3 | Ideogram is the only model with reliable text rendering in 2026 |
80
+ | Character consistency across batch | LoRA-trained Flux / SD | Midjourney `--cref` | Train once, reuse everywhere |
81
+ | Product in lifestyle scene | SD img2img with product reference | Photoroom API → AI background | SD if you need the product to exist; Photoroom if you have the product photo and need the context |
82
+ | Video (short, 2-5 sec) | Runway Gen-3 / Kling 2.0 | Pika Labs | Runway for cinematography, Kling for physical realism |
83
+ | Motion graphics | Figma → Rive → Lottie | After Effects + plugin generation | Stay vector whenever possible — AI video is still expensive per second and drift-prone |
84
+ | Brand animation (logo, intro) | Manual (After Effects / Rive) | — | Brand logo motion is canon — NEVER free-generate, always hand-authored |
85
+
86
+ **Rule:** If the output will carry the **wordmark**, the **logomark**, or a **recognizable brand character**, the AI model is assisting a human motion designer, not driving the work. Free-generation is banned for identity-critical assets.
87
+
88
+ ---
89
+
90
+ ## 3. Style-lock techniques (detailed reference)
91
+
92
+ ### 3.1 Reference images
93
+ - Always the first line of defense. Modern models all support it.
94
+ - Pin 1-3 references — more than 3 causes the model to average and lose specificity.
95
+ - References should be EXACT matches for the dimensions you're locking (style reference for style, subject reference for subject, composition reference for composition).
96
+
97
+ ### 3.2 LoRA / DreamBooth / textual inversion
98
+ - For recurring subjects or recurring style, train a LoRA (recommended: 15-50 images, 1500-3000 steps on SDXL or Flux).
99
+ - LoRA is the most reliable lock for subject + style. It's an hour of setup that saves weeks of re-prompting.
100
+ - Maintain a LoRA registry per brand: `brands/{brand}/loras/{subject}/v{n}.safetensors` with changelog.
101
+
102
+ ### 3.3 Seed control
103
+ - Locking a seed pins one axis of randomness. Useful for A/B style tests (same seed, different prompts).
104
+ - NOT sufficient alone — same seed + different prompt still drifts.
105
+
106
+ ### 3.4 ControlNet / Canny / depth / pose
107
+ - Pin composition and structure via a control map derived from a wireframe/sketch.
108
+ - Essential for templated outputs (social media slot layouts, email header banners).
109
+ - Control + LoRA + seed = maximum lock.
110
+
111
+ ### 3.5 Negative prompts
112
+ - Every brand canon should include a banned vocabulary list. Hard-code the list into every prompt as negatives.
113
+ - Example bans: "watermark", "logo overlay", "low quality", "deformed", "stock photo look", plus brand-specific bans.
114
+
115
+ ---
116
+
117
+ ## 4. Batch consistency QA checklist (mandatory per batch)
118
+
119
+ Before any batch ships out of the studio, it MUST pass this checklist:
120
+
121
+ | # | Check | Threshold | Action if FAIL |
122
+ |---|-------|-----------|---------------|
123
+ | 1 | Style dimension matches canon reference | Visual inspection | Regenerate with style reference |
124
+ | 2 | Lighting dimension matches canon | Visual inspection | Regenerate with lighting reference |
125
+ | 3 | Palette extraction — all > 5% colors in allowed set | Script / visual | Color-correct or regenerate |
126
+ | 4 | Subject dimension — same entity across all shots where required | Visual + reference comparison | Regenerate with stronger LoRA/reference |
127
+ | 5 | Composition dimension — matches declared framing grid | Visual | Regenerate per cell |
128
+ | 6 | Text accuracy (if text-in-image) — spelling, hierarchy | Proofread | Regenerate with Ideogram or DALL-E |
129
+ | 7 | Face/hand anatomy sanity check | Visual | Inpaint fixes or regenerate |
130
+ | 8 | Watermark / model artifact absence | Visual | Remove via inpaint |
131
+ | 9 | Resolution meets delivery spec | Metadata check | Upscale via Topaz / Flux refiner |
132
+ | 10 | No unintended text/logos visible (hallucinated signage, off-brand logos) | Visual | Inpaint away |
133
+
134
+ **A batch that fails any check does not ship. Period.** The batch goes back to regeneration. Partial passes are not acceptable — AI generation is cheap enough that "re-run the batch" is always the right call.
135
+
136
+ ---
137
+
138
+ ## 5. Legal / IP guardrails (non-negotiable)
139
+
140
+ ### 5.1 Training data provenance
141
+ - Prefer models with documented training data (Adobe Firefly, Getty Generative, Flux-with-license).
142
+ - For SD/MJ/DALL-E: check the brand's legal policy on generative use. Some brands forbid models trained on scraped web data.
143
+ - If the model is used for backgrounds or textures where likeness doesn't matter, provenance is lower-risk.
144
+ - If the model is used for faces, characters, or recognizable art styles, provenance is high-risk — prefer trained-LoRA approach with brand-owned training data.
145
+
146
+ ### 5.2 Commercial-use flags
147
+ - Every delivered asset must have a logged "commercial use cleared" status.
148
+ - Required metadata per asset: model used, model license, prompt, seed, reference images used, LoRA(s) used, date.
149
+ - Store metadata in sidecar JSON or EXIF — never "in memory".
150
+
151
+ ### 5.3 Right of publicity (people's likenesses)
152
+ - NEVER generate outputs depicting a recognizable real person without signed release.
153
+ - Synthetic people generated by AI are OK if the output does not resemble any real celebrity (run a reverse-image check against known-persons databases before ship).
154
+ - Stock-model LoRAs (models who have signed releases for AI training) are the safest source when you need real-looking faces.
155
+
156
+ ### 5.4 Trademark avoidance
157
+ - Hallucinated logos, branded signage, branded products in scenes → inpaint away before ship.
158
+ - Crowd scenes and urban scenes are the #1 source of accidental trademark content.
159
+
160
+ ### 5.5 Copyright on style
161
+ - "In the style of [living artist]" → legally risky in many jurisdictions.
162
+ - "In the style of [public-domain / historical movement]" → safe.
163
+ - When in doubt, describe the style by its attributes (palette, brushwork, composition) rather than by attribution.
164
+
165
+ ---
166
+
167
+ ## 6. Generation session hygiene (operational discipline)
168
+
169
+ Every session of AI generation MUST produce:
170
+
171
+ 1. **Session log** — `brands/{brand}/generations/{yyyy-mm-dd}-{session-slug}/`
172
+ 2. **Per-asset metadata sidecar** — prompt, seed, model, LoRA(s), references, negative prompts.
173
+ 3. **The canonical brand references used** — copied into the session folder (no "floating" references).
174
+ 4. **The pass/fail log** per QA check (the 10 items in §4).
175
+ 5. **The final selects** — separated from rejects.
176
+ 6. **Commercial-use status** — signed off by the brand owner before ship.
177
+
178
+ Rejects are kept for ≥ 30 days (often useful as training data for the next LoRA) then archived or deleted per the brand's retention policy.
179
+
180
+ ---
181
+
182
+ ## 7. Batch orchestration patterns
183
+
184
+ | Pattern | When to use | Squad agents involved |
185
+ |---------|------------|----------------------|
186
+ | **Editorial set** (single concept, 5-15 variants) | Campaign hero + secondary shots | brand-creative-engineer drives, brand-identity-designer reviews |
187
+ | **Template grid** (N slots × M variants) | Social media calendar, email series | brand-collateral-designer owns grid definition, brand-creative-engineer generates |
188
+ | **Character series** (same subject, multiple scenes) | Recurring mascot, executive portraits | LoRA-first workflow, brand-identity-designer trains, brand-creative-engineer generates |
189
+ | **Mockup set** (product on N surfaces) | Brand presentation, pitch deck | Photoroom API / SD compositing, brand-collateral-designer owns |
190
+ | **Motion sequence** (logo intro, 3-6 sec) | Brand identity handoff to motion | Hand-authored by brand-motion-vfx, AI used only for assist (upscaling, cleanup) |
191
+
192
+ ---
193
+
194
+ ## 8. Anti-patterns (forbidden)
195
+
196
+ - **Generating a product shot from pure text-to-image** when a product reference photo exists. Always img2img / compositing when the product is real.
197
+ - **Mixing styles mid-batch without a canon rule allowing it.** If the brand canon says "editorial photography", a single flat illustration mid-batch is a FAIL.
198
+ - **Generating faces resembling real celebrities "for inspiration".** This is a legal landmine, not a creative shortcut.
199
+ - **"Fixing" drift in post.** If a batch drifted, regenerate. Don't color-correct your way out of a style mismatch.
200
+ - **Shipping without session metadata.** If you can't reproduce the asset later, you don't own it.
201
+ - **Using "in the style of [living artist]" prompts for brand-owned deliverables.** Legally and ethically risky.
202
+ - **Treating AI generation as "done" after the first acceptable output.** Every brand asset benefits from N:1 generate-to-ship ratio ≥ 5. Cheap to generate means pick the best, not pick the first.
203
+ - **Free-generating brand identity elements (logomark, wordmark, brand character).** Brand identity is a human craft, AI assists but doesn't drive.
204
+
205
+ ---
206
+
207
+ ## 9. Owner matrix (which squad-brand agent owns what)
208
+
209
+ | Canon element | Owner agent | Rationale |
210
+ |--------------|------------|-----------|
211
+ | Style lock + reference curation | brand-identity-designer | Owns the visual vocabulary |
212
+ | Lighting + palette lock | brand-creative-engineer | Owns the generation craft |
213
+ | Subject lock + LoRA training | brand-creative-engineer + brand-identity-designer | Joint: one trains, one approves |
214
+ | Composition lock + batch templates | brand-collateral-designer | Owns templated output |
215
+ | Batch QA (§4 checklist) | brand-auditor | Independent review, not the generator |
216
+ | Legal / IP guardrails | brand-legal-ip reference KB + brand-strategist sign-off | Strategic, not creative |
217
+ | Session hygiene + metadata | brand-creative-engineer | Operational discipline |
218
+ | Motion / video canon | brand-motion-vfx | Owns motion craft |
219
+ | Sonic (if multimodal) | brand-sonic-designer | Owns sonic craft — see `sonic-branding-principles.md` |
220
+
221
+ ---
222
+
223
+ ## 10. Reference index
224
+
225
+ - `squads/squad-brand/knowledge-base/ai-api-capabilities.md` — capability catalog (this squad)
226
+ - `squads/squad-brand/knowledge-base/prompt-engineering-visual.md` — prompt mechanics (this squad)
227
+ - `squads/squad-brand/knowledge-base/brand-legal-ip.md` — legal reference (this squad)
228
+ - `squads/squad-brand/knowledge-base/color-psychology.md` — palette theory (this squad)
229
+ - `squads/squad-brand/knowledge-base/brandbook-structure.md` — where the generated assets land
230
+ - `squads/squad-design/knowledge-base/cross-surface-token-canon.md` — how brand tokens propagate to product surfaces (design squad canon)
231
+
232
+ ## Change log
233
+
234
+ - **2026-04-12 (v1.0)** — Created as part of squad-brand v3.3 / fw-v2.3. Raises `ai-api-capabilities.md` and `prompt-engineering-visual.md` from "capability notes" to a canonical playbook covering the 5 brand-consistency dimensions with lock protocols, model selection matrix, batch QA checklist, legal/IP guardrails, and agent ownership matrix.
@@ -4,6 +4,16 @@
4
4
 
5
5
  ---
6
6
 
7
+ ## Fonte e Origem do Framework
8
+
9
+ **Carl Jung** identificou 12 arquetipos universais do inconsciente coletivo em sua obra de psicologia analitica.
10
+
11
+ **Margaret Mark e Carol S. Pearson** aplicaram esses arquetipos a branding em **"The Hero and the Outlaw: Building Extraordinary Brands Through the Power of Archetypes"** (McGraw-Hill, 2001). Este e o livro de referencia do framework para uso em estrategia de marca.
12
+
13
+ **Aplicacao pratica:** O arquetipo guia tom de voz, narrativa, design e comportamento da marca. Uma marca Outlaw nunca usaria linguagem corporativa. Uma marca Sage nunca seria frivola. O arquetipo cria coerencia instintiva — quando todas as decisoes de comunicacao sao filtradas pelo arquetipo, a marca soa autenticamente consistente.
14
+
15
+ ---
16
+
7
17
  ## 1. Os 12 Arquétipos de Marca
8
18
 
9
19
  Baseado no framework de Carl Jung, adaptado para branding por Margaret Mark e Carol S. Pearson.
@@ -202,11 +212,12 @@ Baseado no framework de Carl Jung, adaptado para branding por Margaret Mark e Ca
202
212
  | Primário | Secundário | Resultado | Exemplo |
203
213
  |----------|-----------|-----------|---------|
204
214
  | Herói | Sábio | Competência + expertise | Nike Academy |
205
- | Mago | Criador | Inovação + artesanato | Apple |
215
+ | Mago | Criador | Inovação + artesanato | Apple (Magician + Creator) |
206
216
  | Explorador | Fora-da-lei | Liberdade + rebeldia | Harley-Davidson |
207
217
  | Amante | Governante | Desejo + exclusividade | Chanel |
208
218
  | Cuidador | Sábio | Proteção + conhecimento | Mayo Clinic |
209
219
  | Bobo | Inocente | Diversão + pureza | Ben & Jerry's |
220
+ | Fora-da-lei | Cara Comum | Disrupção + acessibilidade | Nubank (Outlaw + Regular Guy — desafia bancos com linguagem acessivel) |
210
221
 
211
222
  ### Combinações a Evitar
212
223
  | Combinação | Por que Evitar |
@@ -0,0 +1,216 @@
1
+ # Brand Activism & Cultural Branding — Knowledge Base
2
+
3
+ > Frameworks para marcas que querem se tornar iconicas culturalmente e/ou tomar posicoes relevantes.
4
+
5
+ ---
6
+
7
+ ## 1. Cultural Branding — Douglas Holt
8
+
9
+ ### 1.1 A Teoria
10
+
11
+ **Douglas Holt** (Professor de Oxford, "How Brands Become Icons", 2004; "Cultural Strategy", 2010) propoe uma teoria radical sobre como marcas se tornam iconicas:
12
+
13
+ > Marcas iconicas nao sao construidas por publicidade convencional — sao construidas por **performar "identity myths"** — narrativas que resolvem tensoes culturais da sociedade.
14
+
15
+ Quando a sociedade americana enfrentava a tensao entre a liberdade do "velho oeste" e a rigidez corporativa pos-guerra → Marlboro ofereceu o cowboy.
16
+ Quando a sociedade enfrentava a massificacao tecnologica → Apple ofereceu "Think Different" (individualismo criativo).
17
+ Quando o consumismo predatorio virou tensao cultural → Patagonia ofereceu o ambientalismo radical.
18
+
19
+ ### 1.2 Cultural Branding Model (4 Etapas)
20
+
21
+ | Etapa | Pergunta | Acao |
22
+ |-------|----------|------|
23
+ | **1. Identifique a tensao cultural** | O que angustia seu publico a nivel social/cultural? Que contradictions existem? | Pesquisa cultural, etnografia, social listening |
24
+ | **2. Crie um mito de identidade** | Que narrativa resolve essa tensao? Que "mundo melhor" a marca oferece? | Brand storytelling, manifesto |
25
+ | **3. Encontre o populist world** | Que "mundo" autentico valida esse mito? (nao pode ser fabricado) | Parcerias autenticam, subculturas validam |
26
+ | **4. Performe o mito consistentemente** | Cada comunicacao reforca a mesma narrativa cultural | Todos os touchpoints falam o mesmo mito |
27
+
28
+ ### 1.3 Exemplos Completos
29
+
30
+ **Marlboro (anos 50-60):**
31
+ - Tensao cultural: liberdade do velho oeste vs rigidez corporativa moderna
32
+ - Mito: o cowboy independente, masculino, livre
33
+ - Mundo: o Far West americano (autentico, icônico)
34
+ - Resultado: De cigarro feminino para a marca de cigarro mais vendida do mundo
35
+
36
+ **Nike (1988-presente):**
37
+ - Tensao cultural: corpo medio vs aspiracao atletica
38
+ - Mito: "Just Do It" — qualquer um pode ser heroi de sua propria historia atletica
39
+ - Mundo: esporte de alto desempenho + cultura de rua + empoderamento
40
+ - Resultado: Marca esportiva mais valiosa do mundo
41
+
42
+ **Patagonia (2000s-presente):**
43
+ - Tensao cultural: consumismo inevitavel vs consciencia ambiental
44
+ - Mito: e possivel ser uma empresa capitalista E salvar o planeta
45
+ - Mundo: wilderness, alpinismo, ativismo ambiental (populist world autentico)
46
+ - Resultado: Em 2022, Yvon Chouinard doou a empresa inteira para combater mudancas climaticas
47
+
48
+ ---
49
+
50
+ ## 2. Brand Storytelling
51
+
52
+ ### 2.1 Por Que Narrativa Funciona
53
+
54
+ Storytelling e a ferramenta primaria de construcao de marca emocional. Narrativas ativam areas cerebrais que dados nao ativam:
55
+ - Cortex pre-frontal (decisao)
56
+ - Insula (empatia)
57
+ - Cortex sensorial (imaginacao)
58
+
59
+ Dados convencem o cerebro racional. Narrativas mudam comportamento.
60
+
61
+ ### 2.2 Estrutura de Brand Story (Hero's Journey Adaptada)
62
+
63
+ | Etapa | Descricao | Exemplo (Airbnb) |
64
+ |-------|-----------|-----------------|
65
+ | **O mundo ordinario** | Como era antes da marca existir — o problema | Dois designers falidos em San Francisco nao conseguiam pagar aluguel |
66
+ | **O chamado** | O fundador percebe que precisa agir | Alugaram colchoes inflaveis na sala para pagar as contas |
67
+ | **A jornada** | Desafios, aprendizados, pivotos | Construiram uma plataforma — rejeitados por todos os investidores |
68
+ | **A transformacao** | O que a marca conquistou e aprendeu | Mudaram como o mundo viaja |
69
+ | **O retorno** | Como a marca agora transforma a vida dos clientes | "Agora qualquer pessoa pode pertencer a qualquer lugar" |
70
+
71
+ ### 2.3 StoryBrand vs Brand Story
72
+
73
+ | Aspecto | StoryBrand (Donald Miller) | Brand Story (origem) |
74
+ |---------|--------------------------|---------------------|
75
+ | Foco | Comunicacao de marketing (o cliente como heroi) | Historia da fundacao da marca |
76
+ | Quando usar | Landing pages, ads, pitch | About page, manifesto, brandbook |
77
+ | Heroi da narrativa | O CLIENTE | O fundador/empresa |
78
+ | Objetivo | Conversao | Conexao emocional e cultura |
79
+
80
+ ---
81
+
82
+ ## 3. Brand Mythology
83
+
84
+ Brand mythology vai alem do storytelling individual — e o universo narrativo completo que a marca cria.
85
+
86
+ ### 3.1 Elementos da Mitologia de Marca
87
+
88
+ | Elemento | Descricao | Exemplo |
89
+ |----------|-----------|---------|
90
+ | **Origin story** | Como a marca nasceu | Apple na garagem, Amazon no carro de Bezos, Airbnb com colchoes |
91
+ | **Heroes** | Fundadores, funcionarios, clientes que personificam valores | Steve Jobs, Tony Hsieh (Zappos), Yvon Chouinard (Patagonia) |
92
+ | **Rituals** | Momentos repetidos que criam expectativa e pertencimento | Lancamentos Apple, corrida Nike, Black Friday Amazon |
93
+ | **Symbols** | Objetos que carregam significado especifico da marca | Copo Starbucks, caixa Tiffany, sacola Apple |
94
+ | **Lexicon** | Vocabulario proprio que identifica a tribo | Starbucks: "tall, grande, venti"; Apple: "Genius Bar", "Think Different" |
95
+ | **Sacred beliefs** | Crencas inegociaveis que definem a tribo | Google: "Don't be evil"; Patagonia: "We're in business to save our home planet" |
96
+
97
+ ### 3.2 Construindo a Mitologia
98
+
99
+ 1. Documente a origin story com detalhes autenticados
100
+ 2. Identifique os "heroes" internos e externos da marca
101
+ 3. Crie e codifique rituais (lancamentos, eventos, marcos)
102
+ 4. Designe simbolos visuais e objetos com significado
103
+ 5. Crie um lexicon proprio (mas nao forcado)
104
+ 6. Declare as crencas sagradas publicamente
105
+
106
+ ---
107
+
108
+ ## 4. Brand Activism
109
+
110
+ ### 4.1 O Espectro do Ativismo
111
+
112
+ ```
113
+ Genuino ←————————————————→ Performativo
114
+
115
+ Patagonia (doou | Logo arco-iris
116
+ a empresa para | no Pride Month
117
+ salvar o planeta) | sem politica
118
+ | interna
119
+ Ben & Jerry's |
120
+ (posicoes em | "Sustainable
121
+ Israel-Palestina, | collection" = 2%
122
+ BLM, mesmo com | do portfolio
123
+ controversia) |
124
+ ```
125
+
126
+ ### 4.2 Ativismo Genuino — Casos de Referencia
127
+
128
+ **Patagonia:**
129
+ - Fundado por Yvon Chouinard com sustentabilidade no core desde 1973
130
+ - 1% for the Planet desde 1986
131
+ - Campanha "Don't Buy This Jacket" (Black Friday 2011) — pediu consumidores a NAO comprar
132
+ - 2022: Chouinard transferiu a propriedade para a Holdfast Collective (luta contra mudancas climaticas)
133
+ - Coerencia de decadas = credibilidade maxima
134
+
135
+ **Ben & Jerry's:**
136
+ - Usa plataforma para justica social, mesmo quando causa controversia
137
+ - Posicoes sobre Israel-Palestina, Black Lives Matter, direitos de refugiados
138
+ - Aceita custo (perder clientes conservadores) para manter posicao
139
+ - Funcionarios confirmam o alinhamento interno-externo
140
+
141
+ **Natura (Brasil):**
142
+ - Integrou sustentabilidade no modelo de negocio desde a fundacao (1969) — antes de ser tendencia
143
+ - Bioeconomia da Amazonia como diferencial estrategico
144
+ - Cadeia de valor com comunidades ribeirinhas e indigenas
145
+ - Nao e campanha de marketing — e o modelo de negocio
146
+
147
+ ### 4.3 Performative Activism (Wokewashing) — O Que Evitar
148
+
149
+ | Sinal | Exemplo |
150
+ |-------|---------|
151
+ | Logo arco-iris apenas em junho | Nenhuma politica interna de diversidade |
152
+ | "Black Lives Matter" no perfil | Nenhum negro na lideranca |
153
+ | "Sustainable collection" | 2% do portfolio; 98% fast fashion |
154
+ | Doacao pontual sem historico | "Apoiamos [causa]" sem coerencia historica |
155
+ | Ativismo sem custo | Posicao que nao afasta nenhum cliente nao e ativismo |
156
+
157
+ ### 4.4 Teste de Autenticidade (Philip Kotler)
158
+
159
+ Uma marca passa no teste se responde SIM a todas as perguntas:
160
+
161
+ 1. A marca tem **HISTORICO** nessa causa? (nao comecou ontem)
162
+ 2. A marca **INVESTE recursos reais**? (nao so posts e likes)
163
+ 3. A marca aceita **CUSTO** por essa posicao? (perder clientes que discordam)
164
+ 4. **Funcionarios CONFIRMAM**? (alinhamento interno-externo e verificavel)
165
+ 5. A marca e **TRANSPARENTE** sobre seus proprios gaps? (nao finige perfeicao)
166
+
167
+ ---
168
+
169
+ ## 5. Purpose-Driven Branding — Nuances
170
+
171
+ ### 5.1 O Valor do Purpose Genuino
172
+
173
+ Simon Sinek ("Start with Why", 2009) popularizou o conceito de que pessoas compram o POR QUE, nao o O QUE.
174
+
175
+ Marcas com purpose genuino demonstram:
176
+ - Maior retencao de clientes (preferem marcas com valores alinhados)
177
+ - Maior atracao de talentos (colaboradores querem trabalho com significado)
178
+ - Maior resiliencia em crises (reputacao de longo prazo protege)
179
+ - Maior coerencia de comunicacao (tudo deriva do mesmo norte)
180
+
181
+ ### 5.2 A Critica Ao Excesso de Purpose
182
+
183
+ Byron Sharp ("How Brands Grow") e Mark Ritson ("purpose-bollocks") argumentam:
184
+ - A maioria dos consumidores nao conhece nem se importa com o purpose das marcas que compra
185
+ - Propositos inventados desconectados do produto sao transparentemente vazios
186
+ - Um produto excelente + marketing competente supera qualquer purpose no impacto de vendas
187
+ - Consumidores ficaram ceticos com performative activism pos-2020
188
+
189
+ **Posicao equilibrada:** Purpose e valioso quando genuino e operacionalizado — nao como substituto de produto excelente.
190
+
191
+ ### 5.3 Como Operacionalizar Purpose
192
+
193
+ Purpose que fica apenas no manifesto = inutil.
194
+ Purpose operacionalizado = em cada decisao:
195
+
196
+ | Decisao | Sem Purpose | Com Purpose (Patagonia) |
197
+ |---------|------------|------------------------|
198
+ | Produto | Maximizar margem | Durabilidade maxima (menos consumo) |
199
+ | Pricing | Precos competitivos | Precos refletem custo real + qualidade |
200
+ | Supply chain | Custo mais baixo | Algodao organico, fornecedores eticos |
201
+ | Marketing | Mais vendas | "Nao compre o que voce nao precisa" |
202
+ | RH | Habilidades tecnicas | Missao primeiro, habilidades depois |
203
+ | Decisoes financeiras | Retorno aos acionistas | Retorno ao planeta |
204
+
205
+ ---
206
+
207
+ ## 6. Referencia de Pensadores
208
+
209
+ | Pensador | Contribuicao Principal | Obra Chave |
210
+ |----------|----------------------|------------|
211
+ | **Douglas Holt** | Cultural branding, identity myths | "How Brands Become Icons" (2004) |
212
+ | **Philip Kotler** | Marketing moderno, purpose-driven brands | "Marketing 4.0" (2016), "Marketing 5.0" (2021) |
213
+ | **Simon Sinek** | Golden Circle, brand purpose | "Start with Why" (2009) |
214
+ | **Byron Sharp** | Empirical branding, contra-purpose | "How Brands Grow" (2010) |
215
+ | **Mark Ritson** | Pragmatismo de marketing, critica ao purpose | Colunas Marketing Week, Mini MBA |
216
+ | **Marty Neumeier** | Cultural resonance em Zag | "Zag" (2007) |
@@ -199,3 +199,61 @@ BCS% = (BCS / 5) × 100
199
199
  | Post-launch | Após cada campanha | Materiais da campanha vs guidelines |
200
200
  | Trigger-based | Quando necessário | Após rebranding, crise, fusão |
201
201
  | Continuous | Automatizado | Monitoramento digital (cores, fontes, logos em uso) |
202
+
203
+ ---
204
+
205
+ ## 8. Brand Health via BAV PowerGrid
206
+
207
+ O **BAV PowerGrid** (Young & Rubicam / VML, pesquisa longitudinal desde 1993) oferece uma visao de saude estrategica da marca em 4 pilares:
208
+
209
+ | Pilar | O que mede |
210
+ |-------|-----------|
211
+ | **Differentiation** | A marca e percebida como diferente? |
212
+ | **Relevance** | A marca e relevante para o publico? |
213
+ | **Esteem** | A marca e respeitada e admirada? |
214
+ | **Knowledge** | O publico conhece e entende a marca? |
215
+
216
+ **Diagnostico de posicao no PowerGrid:**
217
+
218
+ | Posicao | Brand Strength | Brand Stature | Acao |
219
+ |---------|---------------|--------------|------|
220
+ | **Leadership** | Alto | Alto | Manter investimento. Proteger diferenciacao. |
221
+ | **New/Niche** | Alto | Baixo | Aumentar awareness. Escalar investimento. |
222
+ | **Eroding** | Baixo | Alto | URGENTE: Reinventar diferenciacao antes que seja tarde. Kodak, BlackBerry. |
223
+ | **Unfocused** | Baixo | Baixo | Reposicionamento fundamental necessario. |
224
+
225
+ **Sinais de erosao (marca na zona "Eroding"):**
226
+ - Awareness alto mas vendas caindo
227
+ - Clientes usam mas nao recomendam
228
+ - Marca percebida como "velha" ou "desatualizada"
229
+ - Concorrentes com diferenciacoes que voce nao tem
230
+
231
+ ---
232
+
233
+ ## 9. Brand Tracking Studies — Estrutura
234
+
235
+ Para auditorias periodicas mais rigorosas:
236
+
237
+ ### Metricas a Monitorar
238
+ - **Awareness:** Spontaneous (unaided) + Prompted (aided recall) por segmento
239
+ - **Consideration:** "Consideraria comprar?"
240
+ - **Preference:** "Qual marca prefere na categoria?"
241
+ - **Usage:** "Comprou/usou nos ultimos 30/90 dias?"
242
+ - **Recommendation:** NPS (Net Promoter Score)
243
+ - **Associations:** Atributos livres + direcionados
244
+ - **Ad awareness:** "Viu publicidade recentemente?"
245
+
246
+ ### Benchmarks de NPS por Tipo de Marca
247
+ | NPS | Status |
248
+ |-----|--------|
249
+ | 70+ | Excepcional (Apple, Tesla, Costco) |
250
+ | 50-69 | Excelente |
251
+ | 30-49 | Bom |
252
+ | 0-29 | Precisa melhorar |
253
+ | Negativo | Crise de marca — acao urgente |
254
+
255
+ ### Metodologias de Tracking
256
+ - **Panel continuo:** Mesmo grupo respondendo periodicamente (longitudinal, mais preciso)
257
+ - **Cross-sectional:** Amostras diferentes a cada onda (mais acessivel)
258
+ - **Social listening:** Monitoramento de mencoes (Brandwatch, Sprinklr, Meltwater)
259
+ - **Search data:** Google Trends como proxy de brand interest