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,289 @@
1
+ # The 7 Pillars of Art Direction for Conversion
2
+
3
+ > Framework completo para art direction que retam e converte. Todo pixel carrega intencao comportamental.
4
+
5
+ ---
6
+
7
+ ## Pilar 1: Visual Hierarchy & Controlled Attention
8
+
9
+ A hierarquia visual controla a sequencia em que o olho processa informacao. Sem hierarquia intencional, o usuario escaneia randomicamente e perde o argumento de conversao.
10
+
11
+ ### Leis Fundamentais
12
+
13
+ #### Hick's Law
14
+ - **Principio:** Tempo de decisao aumenta logaritmicamente com o numero de opcoes
15
+ - **Aplicacao:** Limitar opcoes visiveis por viewport (max 3 CTAs, max 5 nav items, max 3 pricing tiers)
16
+ - **Quando usar:** Sempre que ha mais de 3 opcoes para o usuario
17
+
18
+ #### Fitts's Law
19
+ - **Principio:** Tempo para alcancar um alvo e funcao da distancia e do tamanho
20
+ - **Aplicacao:** CTAs grandes (min 44x44px), proximos ao conteudo que convenceu, longe de opcoes concorrentes
21
+ - **Quando usar:** Posicionamento de todo elemento interativo
22
+
23
+ #### Von Restorff Effect (Isolation Effect)
24
+ - **Principio:** O item que destoa de um grupo homogeneo e o mais lembrado
25
+ - **Aplicacao:** Um unico accent color em toda a pagina. Esse accent APENAS em elementos de conversao
26
+ - **Quando usar:** Highlighting de CTA primario, pricing recommended, notification badges
27
+
28
+ #### Gestalt Principles
29
+ | Principio | Aplicacao | Exemplo |
30
+ |-----------|----------|---------|
31
+ | Proximity | Elementos proximos sao percebidos como grupo | Icon + label juntos = feature |
32
+ | Similarity | Elementos parecidos sao percebidos como categoria | Cards com mesmo estilo = comparaveis |
33
+ | Closure | Mente completa formas incompletas | Progress bars, loading states |
34
+ | Continuity | Olho segue linhas e curvas | Scroll direction, flow lines |
35
+ | Figure/Ground | Separacao entre conteudo e fundo | Cards elevados, overlay modals |
36
+ | Common Region | Elementos em mesma area = grupo | Sections com background distinto |
37
+ | Focal Point | Elemento com maior contraste atrai primeiro | Hero headline, accent CTA |
38
+
39
+ #### Reading Patterns
40
+ | Padrao | Quando | Layout |
41
+ |--------|--------|--------|
42
+ | F-pattern | Conteudo text-heavy (blog, docs) | Important info on left + top |
43
+ | Z-pattern | Landing pages (pouco texto) | Logo top-left → Nav top-right → Visual mid-left → CTA bottom-right |
44
+ | Gutenberg | Print-like, homogeneous | Strong fallow area bottom-left is dead zone |
45
+ | Layer Cake | Headlines + scannable | Bold headlines, short paragraphs, bullet points |
46
+
47
+ ---
48
+
49
+ ## Pilar 2: Psychologically Intentional Color System
50
+
51
+ Cor nao e estetica — e neurociencia aplicada. Cada hue dispara respostas neurologicas especificas que podem ser direcionadas para conversao.
52
+
53
+ ### Regras do Sistema
54
+
55
+ 1. **Max 1 accent + 1 neutral** — restricao forca intencionalidade
56
+ 2. **Von Restorff via cor** — accent APENAS em elementos de conversao
57
+ 3. **WCAG AAA (7:1) em CTAs** — se o usuario nao le, nao converte
58
+ 4. **Semantica funcional** — success/warning/error sao funcoes, nao decoracao
59
+ 5. **Dark mode e redesign** — nao inverta, reprojete toda a luminancia
60
+
61
+ ### Neuropsicologia Cromática
62
+
63
+ | Hue | Resposta Neural | Uso Estrategico |
64
+ |-----|----------------|-----------------|
65
+ | Red (620-750nm) | Amigdala activation, arousal, urgency | CTAs urgentes, alertas, limited offers |
66
+ | Orange | Approach behavior, enthusiasm | Engagement CTAs, upgrades |
67
+ | Yellow | Cortex visual primario alert, caution | Warnings, highlights, attention |
68
+ | Green | Parasympathetic response, safety | Success, money, growth, "go" |
69
+ | Blue | Pre-frontal cortex calm, trust | Corporate, fintech, trust signals |
70
+ | Purple | Creativity, premium perception | AI/tech, premium tiers |
71
+ | Black | Authority, sophistication | Luxury, tech, dark mode |
72
+ | White | Clarity, cognitive relief | Whitespace, medical, editorial |
73
+
74
+ ### Emotion-to-Color Mapping
75
+
76
+ | Emocao Alvo | Accent | Surface | Resultado |
77
+ |-------------|--------|---------|-----------|
78
+ | Urgencia/FOMO | Red-orange | Dark | High-conversion, aggressive |
79
+ | Confianca | Deep blue | Light | Corporate, trustworthy |
80
+ | Inovacao | Purple | Dark | Tech-forward, premium |
81
+ | Calma/Wellness | Soft green | Warm white | Organic, safe |
82
+ | Energia | Bright orange | Dark warm | Dynamic, actionable |
83
+ | Premium | Gold/black | True black | Exclusive, luxury |
84
+
85
+ ---
86
+
87
+ ## Pilar 3: Typography as Identity Signal
88
+
89
+ A fonte fala pela marca antes do leitor ler. Tipografia e identidade visual comprimida em curvas e espessuras.
90
+
91
+ ### Pairings por Posicionamento
92
+
93
+ | Posicionamento | Heading | Body | Sinal |
94
+ |---------------|---------|------|-------|
95
+ | Tech/Builder | Mono | Sans | "Somos tecnicos, precisos" |
96
+ | Editorial/Authority | Serif | Sans | "Somos profundidade" |
97
+ | Consumer/Friendly | Display | Sans | "Somos acessiveis" |
98
+ | Luxury/Premium | Serif Display | Sans Light | "Somos refinados" |
99
+ | Agency/Bold | Display Heavy | Sans | "Somos ousados" |
100
+
101
+ ### Scale System (Major Third 1.25)
102
+
103
+ ```
104
+ 5xl: 76px → Hero display
105
+ 4xl: 61px → Section hero
106
+ 3xl: 49px → Major heading
107
+ 2xl: 39px → Section heading
108
+ xl: 31px → Sub-section
109
+ lg: 25px → Feature title
110
+ base: 20px → Body text
111
+ sm: 16px → Small text
112
+ xs: 12px → Caption, label
113
+ ```
114
+
115
+ ### Tracking como Personalidade
116
+
117
+ | Nivel | Letter-spacing | Percepcao |
118
+ |-------|---------------|-----------|
119
+ | Tight (-0.04em) | Display headings | Impacto, coesao, tech |
120
+ | Normal (0) | Body text | Neutro, legivel |
121
+ | Wide (+0.08em) | Overlines, labels, caps | Destaque, categoria, luxo |
122
+
123
+ ### Fluid Typography
124
+
125
+ ```css
126
+ font-size: clamp(min, preferred, max);
127
+ /* Exemplo: heading 32px mobile → 64px desktop */
128
+ font-size: clamp(2rem, 1rem + 3vw, 4rem);
129
+ ```
130
+
131
+ ---
132
+
133
+ ## Pilar 4: Motion as Kinesthetic Narrative
134
+
135
+ Motion nao decora — conduz. Cada animacao e um argumento visual: revela informacao, direciona atencao, confirma acao ou cria atmosfera.
136
+
137
+ ### Catalogo por Funcao
138
+
139
+ | Funcao | Tecnica | Duracao | Easing | Lib |
140
+ |--------|---------|---------|--------|-----|
141
+ | Revelar (scroll enter) | Fade + slide up | 600-800ms | power3.out | GSAP ScrollTrigger |
142
+ | Confirmar (click) | Scale down + up | 100+200ms | power1.in → power2.out | CSS |
143
+ | Guiar (atencao) | Pulse, glow | 1500ms loop | sine.inOut | CSS |
144
+ | Narrar (scroll story) | Pinned + scrub | Viewport-based | scrub: true | GSAP ScrollTrigger |
145
+ | Atmosfera (ambient) | Gradient shift, particles | 8-15s loop | linear | CSS/Canvas |
146
+ | Transicionar (page) | Clip-path + fade | 500-800ms | power2.inOut | GSAP/Barba |
147
+ | Impressionar (hero) | Frame sequence | Scrub | scrub: true | GSAP ScrollTrigger |
148
+ | Comunicar (data) | Counter, chart animate | 800-1200ms | power2.out | GSAP |
149
+
150
+ ### Regras de Performance
151
+
152
+ | Regra | Detalhe |
153
+ |-------|---------|
154
+ | GPU-only | Apenas `transform` e `opacity` |
155
+ | 60fps desktop, 30fps+ mobile | Threshold inegociavel |
156
+ | Max 30 elementos animados simultaneamente | Budget mobile |
157
+ | will-change com parcimonia | Usar e remover |
158
+ | Intersection Observer para trigger | Nunca scroll event listener |
159
+ | prefers-reduced-motion obrigatorio | Fallback sem motion |
160
+
161
+ ### Easing Guide
162
+
163
+ ```
164
+ NUNCA linear para UI (exceto marquee e ambient)
165
+ Entradas: power2.out ou power3.out (desacelera ao chegar)
166
+ Saidas: power2.in (acelera ao sair)
167
+ Transicoes: power2.inOut (suave em ambas pontas)
168
+ Dramaticas: back.out (overshoot), elastic (bounce)
169
+ ```
170
+
171
+ ### Smooth Scroll: Lenis + GSAP
172
+
173
+ Lenis para smooth scrolling nativo, integrado com GSAP ScrollTrigger para animacoes scroll-driven.
174
+
175
+ ---
176
+
177
+ ## Pilar 5: Information Architecture for Retention
178
+
179
+ A ordem da informacao muda a decisao. IA nao e organizacao — e jornada psicologica.
180
+
181
+ ### Blueprint de Landing Page (Ordem Otima)
182
+
183
+ ```
184
+ 1. HOOK — Curiosity gap que forca scroll
185
+ 2. PROMISE — Beneficio + metric anchor
186
+ 3. PROOF — Social proof visual
187
+ 4. EDUCATE — Como funciona (progressive disclosure)
188
+ 5. QUALIFY — Self-qualification
189
+ 6. DEMONSTRATE — Showcase interativo
190
+ 7. COMPARE — Comparison table
191
+ 8. OVERCOME — FAQ + risk reversal
192
+ 9. CONVERT — CTA final com multiplas opcoes
193
+ 10. REINFORCE — Footer com trust signals
194
+ ```
195
+
196
+ ### Principios de Retencao
197
+
198
+ | Principio | Mecanismo | Aplicacao |
199
+ |-----------|----------|-----------|
200
+ | Zeigarnik Effect | Tarefas incompletas geram tensao | Headlines com lacuna, progress bars, reveals parciais |
201
+ | Goal Gradient | Esforco aumenta proximo do fim | Progress indicators, "quase la" signals |
202
+ | Peak-End Rule | Pico emocional + final determinam memoria | Momento memoravel mid-page, footer com valor |
203
+ | Curiosity Gap | Informacao parcial forca busca | Numeros sem contexto, promessas veladas |
204
+ | Progressive Disclosure | Revelar na cadencia certa | L1 scan → L2 skim → L3 read → L4 deep dive |
205
+ | Self-Qualification | Usuario se identifica | Persona match, size filter, use case tabs |
206
+
207
+ ---
208
+
209
+ ## Pilar 6: Visual Persuasion via CRO Patterns
210
+
211
+ Padroes visuais de conversao fundamentados em ciencia comportamental.
212
+
213
+ ### Catalogo de Padroes
214
+
215
+ | Padrao | Principio | Impacto Esperado |
216
+ |--------|----------|-----------------|
217
+ | Comparison table | Anchoring + framing | +15-25% conversion |
218
+ | Logo wall | Social proof (authority) | +10-15% trust |
219
+ | Testimonial carousel | Social proof (specificity) | +10-20% trust |
220
+ | Live counter | FOMO + social proof | +5-10% urgency |
221
+ | Sticky CTA bar | Availability + persistence | +15-25% CTA visibility |
222
+ | Progress form | Goal gradient + commitment | +20-30% form completion |
223
+ | Risk reversal | Loss aversion reversal | +10-20% conversion |
224
+ | Price anchoring | Anchoring bias | +5-15% premium selection |
225
+ | Scarcity indicator | Scarcity principle | +10-20% urgency (se real) |
226
+ | Multiple CTAs | Capture different intent levels | +10-15% total conversion |
227
+
228
+ ### CTA Hierarchy
229
+
230
+ ```
231
+ Primary CTA: Accent color, max 1 por viewport, acao principal
232
+ Secondary CTA: Ghost/outline, alternativa de menor compromisso
233
+ Tertiary CTA: Text link, informacao adicional
234
+ ```
235
+
236
+ ---
237
+
238
+ ## Pilar 7: Layout and Spacing as Cognitive Breathing
239
+
240
+ Espaco nao e vazio — e respiracao cognitiva. Grid nao e restricao — e direcionalidade.
241
+
242
+ ### Spacing System
243
+
244
+ ```
245
+ Base unit: 4px
246
+ Significant spacing: multiplos de 8px
247
+ Component internal: 12-24px
248
+ Between components: 24-32px
249
+ Between sections: 96-192px
250
+ ```
251
+
252
+ ### Full-bleed vs Contained
253
+
254
+ | Conteudo | Layout | Razao |
255
+ |----------|--------|-------|
256
+ | Hero | Full-bleed | Impacto maximo |
257
+ | Body text | Contained (max 65ch) | Conforto de leitura |
258
+ | Feature showcase | Full-bleed + inner contain | Espaco visual + texto contido |
259
+ | CTA band | Full-bleed com cor | Separacao + urgencia |
260
+ | Footer | Full-bleed | Peso visual, fechamento |
261
+
262
+ ### Responsive Breakpoints
263
+
264
+ ```
265
+ Mobile: < 640px (4 col, 16px gutter)
266
+ Tablet: 640-1024px (8 col, 24px gutter)
267
+ Desktop: 1024-1440px (12 col, 32px gutter)
268
+ Wide: > 1440px (12 col, centered max-width)
269
+ ```
270
+
271
+ ---
272
+
273
+ ## Como os 7 Pilares Trabalham Juntos
274
+
275
+ ```
276
+ Prism define mood visual (P1) →
277
+ Spectrum traduz em cor (P2) +
278
+ Kern traduz em tipo (P3) +
279
+ Grid traduz em espacamento (P7)
280
+
281
+ Flow projeta jornada cognitiva (P5) →
282
+ Convert aplica padroes CRO (P6) +
283
+ Tempo adiciona narrativa motion (P4) +
284
+ Pulse refina micro-interactions (P4)
285
+
286
+ Shield valida acessibilidade (transversal)
287
+
288
+ Canvas consolida nos 8 deliverables
289
+ ```
@@ -0,0 +1,221 @@
1
+ # The 10 Pillars of Art Direction — LP + Platform Unified Framework
2
+
3
+ > v2.0 extension of the original 7 Pillars. The first 7 pillars are preserved verbatim from `seven-pillars-framework.md` (backward compatible). Pillars 8, 9, 10 are NEW and were added to cover SaaS / platform / dashboard / premium packaging contexts that v1.0 did not address.
4
+ >
5
+ > **Every pillar now carries TWO applicability ratings:** LP (landing page context) and Platform (logged-in product context). This is how Canvas routes work intelligently based on briefing type.
6
+
7
+ ---
8
+
9
+ ## Applicability Matrix — All 10 Pillars
10
+
11
+ | # | Pillar | LP | Platform | Primary Agent | Secondary Agent |
12
+ |---|--------|----|---------:|---------------|-----------------|
13
+ | 1 | Visual Hierarchy & Controlled Attention | YES | YES | Prism (visual-strategist) | Grid (layout-engineer) |
14
+ | 2 | Psychologically Intentional Color | YES | YES | Spectrum (color-psychologist) | Shield (accessibility-guardian) |
15
+ | 3 | Typography as Identity Signal | YES | YES | Kern (type-systemist) | Prism (visual-strategist) |
16
+ | 4 | Motion as Kinesthetic Narrative | YES | PARTIAL | Tempo (motion-architect) | Pulse (interaction-designer) |
17
+ | 5 | Information Architecture for Retention | YES | YES | Flow (ia-architect) | Convert (cro-persuasion) |
18
+ | 6 | Visual Persuasion via CRO Patterns | YES | PARTIAL | Convert (cro-persuasion) | Flow (ia-architect) |
19
+ | 7 | Layout & Spacing as Cognitive Breathing | YES | YES | Grid (layout-engineer) | Prism (visual-strategist) |
20
+ | **8** | **Product Surface Ergonomics (NEW)** | NO | YES | **Axiom (product-surface-director)** | Flow (ia-architect), Grid (layout-engineer) |
21
+ | **9** | **Multi-Surface Design System Architecture (NEW)** | PARTIAL | YES | **Atlas (design-system-architect)** | Spectrum, Kern, Tempo |
22
+ | **10** | **Premium Packaging & Perceived Value (NEW)** | YES | YES | **Aura (premium-packaging-strategist)** | Canvas (artdir-orqx), Vertex (platform-aesthetic-director) |
23
+
24
+ **Note:** Vertex (platform-aesthetic-director) is the KB custodian for the SaaS canon and is invoked on Pillars 8, 9, 10 for reference intelligence but does not own any single pillar exclusively — Vertex is the lens, not a pillar owner.
25
+
26
+ ---
27
+
28
+ ## Pillars 1-7 (v1.0 — preserved verbatim, see `seven-pillars-framework.md`)
29
+
30
+ 1. **Visual Hierarchy & Controlled Attention** — Hick, Fitts, Von Restorff, Gestalt, reading patterns
31
+ 2. **Psychologically Intentional Color System** — neuropsychology, WCAG AAA, emotion mapping
32
+ 3. **Typography as Identity Signal** — pairings by positioning, fluid type, tracking
33
+ 4. **Motion as Kinesthetic Narrative** — Disney 12, easing, lib selection, perf budget
34
+ 5. **Information Architecture for Retention** — Zeigarnik, progressive disclosure, curiosity gaps
35
+ 6. **Visual Persuasion via CRO Patterns** — comparison tables, social proof, scarcity, risk reversal
36
+ 7. **Layout & Spacing as Cognitive Breathing** — grid systems, spacing tokens, container queries
37
+
38
+ These are unchanged. Canvas still owns the 7-pillar validation for LP briefings.
39
+
40
+ ---
41
+
42
+ ## Pillar 8 — Product Surface Ergonomics (NEW, v2.0)
43
+
44
+ **Owner:** Axiom (product-surface-director)
45
+ **Applicability:** Platform YES, LP NO
46
+
47
+ ### Principle
48
+
49
+ Logged-in product surfaces are not landing pages. They are inhabited — users see them 100 times, not once. The aesthetic goals shift from first-impression conversion to long-term cognitive ergonomics. The product's job is to disappear into the user's workflow, not to impress.
50
+
51
+ ### Core Laws
52
+
53
+ #### The Inhabitation Law
54
+ - **Principle:** Users will see this surface 100+ times. Every decoration becomes visual noise on the 2nd impression.
55
+ - **Application:** Strip ornamentation. Prefer information density over marketing flash.
56
+
57
+ #### The Daily-Use Fitts's Law
58
+ - **Principle:** Fitts applies, but in a product surface the action targets are hit THOUSANDS of times. Micro-optimization matters.
59
+ - **Application:** Primary actions (save, send, create) are large, consistent positions, keyboard-accessible.
60
+
61
+ #### The Empty-State Promise
62
+ - **Principle:** Empty states are the second impression (after the LP). If the first real interaction after signup is an empty dashboard with no guidance, the user churns.
63
+ - **Application:** Every surface has an intentional empty state. It teaches, it motivates, it previews value.
64
+
65
+ #### The Data Density Balance
66
+ - **Principle:** Too sparse = "this product is not useful" signal. Too dense = cognitive overload. Find the Goldilocks per surface.
67
+ - **Application:** Dashboards lean dense. Settings lean sparse. Onboarding leans sparse. Data tables lean ultra-dense.
68
+
69
+ #### The Dark-Mode Mandate
70
+ - **Principle:** For product surfaces, dark mode is a requirement, not an option. Users spend 6+ hours/day in the app — eye strain is real.
71
+ - **Application:** Design dark-first OR design both in parallel. Never retrofit.
72
+
73
+ ### Cognitive Zones in a Product Surface
74
+
75
+ | Zone | Role | Density | Motion |
76
+ |------|------|---------|--------|
77
+ | Top bar / nav | Orientation | Low | Minimal |
78
+ | Primary content | Focus | Medium-High | Purposeful only |
79
+ | Side panels / inspectors | Context | Medium | Subtle reveal |
80
+ | Toasts / notifications | Interruption | Low | Von Restorff motion |
81
+ | Modals | Decision | Medium | Entry/exit only |
82
+ | Empty states | Onboarding | Low | Tempo-guided |
83
+
84
+ ### Checkpoints Axiom enforces
85
+
86
+ 1. Every dashboard has a clear KPI hero zone
87
+ 2. Every empty state is intentionally designed (not the framework default)
88
+ 3. Dark mode is at parity with light mode (not a 80% retrofit)
89
+ 4. Notifications use Von Restorff motion sparingly
90
+ 5. Keyboard shortcuts are visible in the UI (learnable velocity)
91
+ 6. No vanity animations on surfaces users see daily
92
+
93
+ ---
94
+
95
+ ## Pillar 9 — Multi-Surface Design System Architecture (NEW, v2.0)
96
+
97
+ **Owner:** Atlas (design-system-architect)
98
+ **Applicability:** Platform YES, LP PARTIAL (LP benefits from the token system but rarely needs full versioning)
99
+
100
+ ### Principle
101
+
102
+ A product company does not have one surface — it has many: brand identity, marketing site, product UI, transactional emails, documentation, support center, billing/invoice PDFs, mobile apps, embeds, social media assets. If these surfaces drift apart, premium perception collapses. A design system is the only enforcement mechanism that scales.
103
+
104
+ ### Core Laws
105
+
106
+ #### The Single Source of Truth Law
107
+ - **Principle:** Brand tokens are the root. Every downstream surface inherits from the same canonical source.
108
+ - **Application:** Tokens are defined once (brand layer), translated into surface-specific dialects (marketing tokens, product tokens, email-safe tokens, print tokens).
109
+
110
+ #### The Surface Dialect Law
111
+ - **Principle:** Surfaces have constraints. Email cannot use CSS grid. Print cannot use interactive color. Tokens must translate, not break.
112
+ - **Application:** Each surface gets a dialect layer that maps canonical tokens to surface-supported equivalents.
113
+
114
+ #### The Versioning Law
115
+ - **Principle:** A design system without versioning is a bug farm. Breaking changes must ship with migration guides.
116
+ - **Application:** Semver for design tokens. Changelog. Deprecation notices. Automated migration scripts when possible.
117
+
118
+ #### The Ownership Law
119
+ - **Principle:** Every token has an owner. If no one owns it, it drifts.
120
+ - **Application:** Token registry with owner, justification, and last-reviewed date.
121
+
122
+ #### The Consistency Audit Law
123
+ - **Principle:** Every quarter, audit all surfaces for drift. Drift is inevitable; detection is mandatory.
124
+ - **Application:** Automated diff of deployed surfaces vs token system. Manual audit of hard-to-automate surfaces (emails, PDFs).
125
+
126
+ ### The 7 Canonical Surfaces
127
+
128
+ | Surface | Token Dialect | Enforcement Difficulty |
129
+ |---------|--------------|----------------------|
130
+ | Brand identity | Canonical | (source of truth) |
131
+ | Marketing site | Web tokens | Easy (code-enforced) |
132
+ | Product UI | Web tokens + component contracts | Medium |
133
+ | Transactional email | Email-safe tokens (inline CSS) | Hard |
134
+ | Documentation | Web tokens, often 3rd-party themed | Hard |
135
+ | Billing / invoice PDF | Print tokens | Very hard (often forgotten) |
136
+ | Mobile apps | Platform-native token maps | Hard |
137
+
138
+ ### Checkpoints Atlas enforces
139
+
140
+ 1. There is ONE canonical brand token layer
141
+ 2. Each surface has a documented dialect mapping
142
+ 3. Tokens are versioned (semver)
143
+ 4. Every token has an owner + justification
144
+ 5. A quarterly consistency audit is scheduled
145
+ 6. Breaking changes have migration guides
146
+ 7. Email and invoice surfaces are NOT forgotten
147
+
148
+ ---
149
+
150
+ ## Pillar 10 — Premium Packaging & Perceived Value (NEW, v2.0)
151
+
152
+ **Owner:** Aura (premium-packaging-strategist)
153
+ **Applicability:** LP YES, Platform YES (both surfaces need to justify the price tag)
154
+
155
+ ### Principle
156
+
157
+ Price is a signal. Design is the proof. Every surface must signal premium; every interaction must earn the price tag. Premium is not decoration — it is a consistent choreography of restraint, custom craft, strategic friction, first-run theater, and multi-surface consistency.
158
+
159
+ ### The 5 Non-Negotiables
160
+
161
+ See `premium-packaging-principles.md` for the full pressurization output.
162
+
163
+ 1. **Restraint reads as confidence** (Signaling theory)
164
+ 2. **Custom craft = unfakeable signal** (Veblen + Bourdieu)
165
+ 3. **Friction at the right moment creates value** (Ariely, IKEA effect)
166
+ 4. **Presentation > intrinsic quality** (Framing effect)
167
+ 5. **Consistency across surfaces defends the price** (Cognitive consistency)
168
+
169
+ ### Diagnostic Questions (Aura's briefing intake)
170
+
171
+ 1. What is the ONE custom craft element this product will own?
172
+ 2. Where is the strategic friction in the funnel?
173
+ 3. What is the choreography of the first 5 minutes after signup?
174
+ 4. Is there a documented multi-surface token system?
175
+ 5. Do the invoice PDF and transactional emails match the marketing site quality?
176
+
177
+ **Any "no" = the product is pricing itself as commodity.**
178
+
179
+ ### Checkpoints Aura enforces
180
+
181
+ 1. Briefing has a named custom craft element
182
+ 2. Funnel has at least one strategic friction point
183
+ 3. First 5 Minutes Choreography is documented
184
+ 4. Multi-surface token system exists (delegates to Atlas)
185
+ 5. Full surface audit covers: marketing, product, email, docs, support, billing, mobile
186
+
187
+ ---
188
+
189
+ ## How Canvas (artdir-orqx) Routes with 10 Pillars
190
+
191
+ ### LP / Marketing site briefing
192
+ - Activate Pillars 1-7 (primary) + Pillar 10 (premium check)
193
+ - Agents: Prism, Spectrum, Kern, Tempo, Flow, Convert, Grid, Pulse, Shield, Aura
194
+ - Optional: Vertex (if premium SaaS category)
195
+
196
+ ### Platform / SaaS / Dashboard briefing
197
+ - Activate Pillars 1-5, 7 (LP pillars that apply) + Pillars 8, 9, 10 (NEW)
198
+ - Pillar 4 (Motion) becomes PARTIAL — only purposeful motion, no marketing flash
199
+ - Pillar 6 (CRO) becomes PARTIAL — CRO applies to upgrade/upsell paths, not to daily surfaces
200
+ - Agents: Axiom (primary), Atlas, Aura, Vertex, Prism, Spectrum, Kern, Flow, Grid, Pulse, Shield
201
+
202
+ ### Multi-surface / design-system work
203
+ - Activate Pillars 9, 10 (primary) + Pillars 2, 3, 4, 7 (tokens)
204
+ - Agents: Atlas (primary), Aura, Spectrum, Kern, Tempo, Grid, Vertex
205
+
206
+ ### Premium packaging audit
207
+ - Activate Pillars 8, 9, 10 (primary) + Pillar 2 (color), Pillar 3 (type), Pillar 4 (motion)
208
+ - Agents: Aura (primary), Vertex, Atlas, Axiom, Spectrum, Kern, Tempo
209
+
210
+ ---
211
+
212
+ ## Backward Compatibility
213
+
214
+ - `seven-pillars-framework.md` is preserved verbatim as the canonical LP framework.
215
+ - All existing v1.0 tasks and workflows continue to work (they reference Pillars 1-7).
216
+ - `ten-pillars-framework.md` (this file) is the v2.0 extension, referenced by the new platform workflow and new agents.
217
+ - Canvas's routing logic (in `artdir-orqx.md`) is updated to check the briefing type and select the right pillar set.
218
+
219
+ ---
220
+
221
+ *@design-orqx (Nexus) + @brand-orqx (Meridian) collaborative output | squad-artdir v2.0 | KB v1.0*
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "squad-artdir",
3
+ "version": "1.0.0",
4
+ "description": "Art direction focused on retention and conversion. Every pixel carries behavioral intent.",
5
+ "author": "Caio Imori",
6
+ "license": "MIT",
7
+ "keywords": [
8
+ "sinapse",
9
+ "squad",
10
+ "art-direction",
11
+ "conversion",
12
+ "cro",
13
+ "visual-strategy",
14
+ "motion-design"
15
+ ],
16
+ "sinapse": {
17
+ "type": "squad",
18
+ "minVersion": "2.1.0"
19
+ }
20
+ }