sinapse-ai 9.4.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 (266) hide show
  1. package/.claude/CLAUDE.md +10 -4
  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/hook-governance.md +1 -0
  10. package/.claude/rules/mandatory-delegation.md +24 -0
  11. package/.claude/rules/project-intelligence.md +63 -0
  12. package/.claude/rules/response-format.md +4 -0
  13. package/.claude/rules/safe-collaboration.md +4 -2
  14. package/.claude/rules/security-data-protection.md +18 -0
  15. package/.claude/rules/squad-awareness.md +93 -67
  16. package/.claude/rules/token-economy.md +148 -0
  17. package/.codex/agents/analyst.md +90 -0
  18. package/.codex/agents/architect.md +78 -0
  19. package/.codex/agents/data-engineer.md +38 -0
  20. package/.codex/agents/developer.md +97 -0
  21. package/.codex/agents/devops.md +121 -0
  22. package/.codex/agents/product-lead.md +27 -0
  23. package/.codex/agents/project-lead.md +28 -0
  24. package/.codex/agents/quality-gate.md +89 -0
  25. package/.codex/agents/sprint-lead.md +28 -0
  26. package/.codex/agents/squad-creator.md +58 -0
  27. package/.codex/agents/ux-design-expert.md +28 -0
  28. package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
  29. package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
  30. package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
  31. package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
  32. package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
  33. package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
  34. package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
  35. package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
  36. package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
  37. package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
  38. package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
  39. package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
  40. package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
  41. package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
  42. package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
  43. package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
  44. package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
  45. package/.sinapse-ai/core/doctor/index.js +157 -50
  46. package/.sinapse-ai/core/ids/registry-updater.js +6 -1
  47. package/.sinapse-ai/core/logger/index.js +319 -0
  48. package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
  49. package/.sinapse-ai/core/telemetry/index.js +247 -0
  50. package/.sinapse-ai/data/entity-registry.yaml +1384 -944
  51. package/.sinapse-ai/development/agents/architect.md +5 -0
  52. package/.sinapse-ai/development/agents/data-engineer.md +38 -0
  53. package/.sinapse-ai/development/agents/developer.md +28 -0
  54. package/.sinapse-ai/development/agents/devops.md +4 -0
  55. package/.sinapse-ai/development/agents/product-lead.md +27 -0
  56. package/.sinapse-ai/development/agents/project-lead.md +28 -0
  57. package/.sinapse-ai/development/agents/quality-gate.md +4 -0
  58. package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
  59. package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
  60. package/.sinapse-ai/development/agents/squad-creator.md +58 -0
  61. package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
  62. package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
  63. package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
  64. package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
  65. package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
  66. package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
  67. package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
  68. package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
  69. package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
  70. package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
  71. package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
  72. package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
  73. package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
  74. package/.sinapse-ai/development/skills/model-router.md +92 -0
  75. package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
  76. package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
  77. package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
  78. package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
  79. package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
  80. package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
  81. package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
  82. package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
  83. package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
  84. package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
  85. package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
  86. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
  87. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
  88. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
  89. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
  90. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
  91. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
  92. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
  93. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
  94. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
  95. package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
  96. package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
  97. package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
  98. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
  99. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
  100. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
  101. package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
  102. package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
  103. package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
  104. package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
  105. package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
  106. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
  107. package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
  108. package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
  109. package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
  110. package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
  111. package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
  112. package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
  113. package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
  114. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
  115. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
  116. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
  117. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
  118. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
  119. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
  120. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
  121. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
  122. package/.sinapse-ai/install-manifest.yaml +275 -140
  123. package/.sinapse-ai/local-config.yaml.template +65 -65
  124. package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
  125. package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
  126. package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
  127. package/.sinapse-ai/monitor/hooks/notification.py +30 -30
  128. package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
  129. package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
  130. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
  131. package/.sinapse-ai/monitor/hooks/stop.py +30 -30
  132. package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
  133. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
  134. package/.sinapse-ai/product/templates/adr.hbs +126 -126
  135. package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
  136. package/.sinapse-ai/product/templates/epic.hbs +213 -213
  137. package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
  138. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
  139. package/.sinapse-ai/product/templates/prd.hbs +202 -202
  140. package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
  141. package/.sinapse-ai/product/templates/story.hbs +264 -264
  142. package/.sinapse-ai/product/templates/task.hbs +171 -171
  143. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
  144. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
  145. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
  146. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
  147. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
  148. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
  149. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
  150. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
  151. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
  152. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
  153. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
  154. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
  155. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
  156. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
  157. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
  158. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
  159. package/LICENSE +34 -34
  160. package/README.en.md +167 -20
  161. package/README.md +190 -22
  162. package/bin/cli.js +510 -196
  163. package/bin/postinstall.js +564 -0
  164. package/bin/sinapse-cli +283 -283
  165. package/bin/sinapse-graph.js +9 -0
  166. package/bin/sinapse-init.js +36 -4
  167. package/bin/sinapse-minimal.js +20 -9
  168. package/bin/sinapse.js +202 -122
  169. package/bin/utils/deprecation-warning.js +46 -0
  170. package/bin/utils/pre-push-safety.js +14 -0
  171. package/docs/TELEMETRY.md +131 -0
  172. package/docs/chrome-brain-upgrade-plan.md +624 -0
  173. package/docs/framework/orqx-plan.md +1 -1
  174. package/docs/installation/chrome-brain.md +17 -7
  175. package/docs/mega-upgrade-orchestration-plan.md +71 -0
  176. package/docs/pt/contributing.md +20 -0
  177. package/docs/research-synthesis-for-upgrade.md +511 -0
  178. package/docs/security-audit-report.md +306 -0
  179. package/package.json +20 -8
  180. package/packages/installer/src/config/configure-environment.js +19 -44
  181. package/packages/installer/src/detection/detect-project-type.js +181 -63
  182. package/packages/installer/src/installer/manifest-signature.js +32 -17
  183. package/packages/installer/src/wizard/i18n.js +12 -0
  184. package/packages/installer/src/wizard/ide-config-generator.js +8 -39
  185. package/packages/installer/src/wizard/index.js +119 -14
  186. package/packages/installer/src/wizard/questions.js +2 -3
  187. package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
  188. package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
  189. package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
  190. package/packages/sinapse-install/bin/edmcp.js +0 -0
  191. package/packages/sinapse-install/bin/sinapse-install.js +0 -0
  192. package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
  193. package/scripts/check-markdown-links.py +353 -353
  194. package/scripts/coverage-report-summary.js +169 -0
  195. package/scripts/generate-install-manifest.js +6 -2
  196. package/scripts/release-readiness.js +169 -0
  197. package/scripts/test-install-matrix-local.sh +153 -0
  198. package/scripts/validate-install-docs.js +394 -0
  199. package/scripts/validate-no-external-refs.js +376 -0
  200. package/scripts/validate-squad-orqx.js +302 -0
  201. package/scripts/validate-story-meta.js +263 -0
  202. package/squads/claude-code-mastery/CHANGELOG.md +1 -1
  203. package/squads/claude-code-mastery/README.md +2 -2
  204. package/squads/claude-code-mastery/squad.yaml +1 -1
  205. package/squads/squad-artdir/README.md +90 -0
  206. package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
  207. package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
  208. package/squads/squad-artdir/agents/color-psychologist.md +166 -0
  209. package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
  210. package/squads/squad-artdir/agents/design-system-architect.md +100 -0
  211. package/squads/squad-artdir/agents/ia-architect.md +169 -0
  212. package/squads/squad-artdir/agents/interaction-designer.md +162 -0
  213. package/squads/squad-artdir/agents/layout-engineer.md +163 -0
  214. package/squads/squad-artdir/agents/motion-architect.md +185 -0
  215. package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
  216. package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
  217. package/squads/squad-artdir/agents/product-surface-director.md +86 -0
  218. package/squads/squad-artdir/agents/type-systemist.md +138 -0
  219. package/squads/squad-artdir/agents/visual-strategist.md +127 -0
  220. package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
  221. package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
  222. package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
  223. package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
  224. package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
  225. package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
  226. package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
  227. package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
  228. package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
  229. package/squads/squad-artdir/package.json +20 -0
  230. package/squads/squad-artdir/squad.yaml +271 -0
  231. package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
  232. package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
  233. package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
  234. package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
  235. package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
  236. package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
  237. package/squads/squad-artdir/tasks/design-color-system.md +81 -0
  238. package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
  239. package/squads/squad-artdir/tasks/design-token-system.md +58 -0
  240. package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
  241. package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
  242. package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
  243. package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
  244. package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
  245. package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
  246. package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
  247. package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
  248. package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
  249. package/squads/squad-brand/squad.yaml +20 -6
  250. package/squads/squad-claude/knowledge-base/context-window-optimization.md +1 -1
  251. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +2 -2
  252. package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
  253. package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
  254. package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
  255. package/squads/squad-content/squad.yaml +187 -27
  256. package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
  257. package/squads/squad-copy/squad.yaml +19 -4
  258. package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
  259. package/squads/squad-design/squad.yaml +19 -4
  260. package/.sinapse-ai/core/registry/service-registry.json +0 -6346
  261. package/.sinapse-ai/data/registry-update-log.jsonl +0 -1323
  262. package/.sinapse-ai/manifests/agents.csv +0 -29
  263. package/.sinapse-ai/manifests/tasks.csv +0 -204
  264. package/.sinapse-ai/manifests/workers.csv +0 -196
  265. package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
  266. package/squads/squad-paidmedia/tasks/calculate-sample-size.md +0 -57
@@ -0,0 +1,172 @@
1
+ # 7 Pillars Validation Checklist
2
+
3
+ > Use este checklist para validar qualquer entrega de art direction contra os 7 pilares.
4
+ > Cada item e binario (pass/fail). Score minimo por pilar: 6/10 para PASS.
5
+
6
+ ---
7
+
8
+ ## Pilar 1: Visual Hierarchy & Controlled Attention
9
+
10
+ - [ ] Focal point claro por viewport (Von Restorff applied)
11
+ - [ ] Heading hierarchy consistente (h1 > h2 > h3, sem pulos)
12
+ - [ ] Accent color APENAS em elementos de conversao
13
+ - [ ] Reading pattern adequado ao tipo de conteudo (F, Z, layer cake)
14
+ - [ ] Hick's Law: max 3 opcoes de CTA por viewport
15
+ - [ ] Fitts's Law: CTAs min 44x44px, proximos ao conteudo convincente
16
+ - [ ] Gestalt proximity: elementos relacionados agrupados
17
+ - [ ] Gestalt figure/ground: separacao clara conteudo vs fundo
18
+ - [ ] Nenhum viewport sem hierarquia clara
19
+ - [ ] Atencao direcionada para conversao, nao para decoracao
20
+
21
+ **Score: __ /10**
22
+
23
+ ---
24
+
25
+ ## Pilar 2: Color System
26
+
27
+ - [ ] Max 1 accent + 1 neutral (restricao respeitada)
28
+ - [ ] Accent color tem justificativa neuropsicologica documentada
29
+ - [ ] WCAG AAA (7:1) em TODOS os CTAs
30
+ - [ ] WCAG AA (4.5:1) em TODO o body text
31
+ - [ ] WCAG AA (3:1) em texto grande e UI components
32
+ - [ ] Cores semanticas funcionais (success, warning, error, info)
33
+ - [ ] Color-blindness safe (cor nunca e unico indicador)
34
+ - [ ] Dark/light mode e redesenhado (nao invertido)
35
+ - [ ] Von Restorff maximizado (accent destoa do neutral)
36
+ - [ ] Emotion target alinhado com hue selecionado
37
+
38
+ **Score: __ /10**
39
+
40
+ ---
41
+
42
+ ## Pilar 3: Typography
43
+
44
+ - [ ] Font pairing justificado por posicionamento de marca
45
+ - [ ] Type scale consistente e modular (ratio documentado)
46
+ - [ ] Fluid typography com clamp() (nao breakpoint-based)
47
+ - [ ] Tracking tight em headings, normal em body, wide em labels
48
+ - [ ] Line-height tight em display, relaxado em body longo
49
+ - [ ] Font loading otimizado (swap, preload heading, subset)
50
+ - [ ] Tratamentos especiais documentados (gradient text, mono inline, etc.)
51
+ - [ ] All-caps tem tracking adicional (+0.05em min)
52
+ - [ ] Max line length 65ch para body text
53
+ - [ ] Fontes carregam < 200KB total
54
+
55
+ **Score: __ /10**
56
+
57
+ ---
58
+
59
+ ## Pilar 4: Motion System
60
+
61
+ - [ ] Toda animacao cita principio Disney ou psicologico
62
+ - [ ] Apenas GPU properties animadas (transform, opacity)
63
+ - [ ] 60fps target desktop verificado
64
+ - [ ] 30fps minimo mobile verificado
65
+ - [ ] prefers-reduced-motion cobre 100% das animacoes
66
+ - [ ] Easing NUNCA e linear para UI motion
67
+ - [ ] Duration micro: 150-400ms, macro: 400-1200ms
68
+ - [ ] Stagger cria ritmo (30-120ms entre elementos)
69
+ - [ ] will-change usado com parcimonia e removido apos uso
70
+ - [ ] Nenhuma animacao > 5s sem controle de pausa
71
+
72
+ **Score: __ /10**
73
+
74
+ ---
75
+
76
+ ## Pilar 5: Information Architecture
77
+
78
+ - [ ] Toda secao tem papel cognitivo documentado
79
+ - [ ] Sequencia justificada por principio psicologico
80
+ - [ ] Progressive disclosure implementado (L1 scan > L2 skim > L3 read > L4 deep)
81
+ - [ ] Min 2 Zeigarnik loops identificados e posicionados
82
+ - [ ] Peak moment posicionado mid-page (nao primeiro ou ultimo)
83
+ - [ ] End moment (footer) e significativo (nao generico)
84
+ - [ ] Self-qualification presente antes do hard sell
85
+ - [ ] Curiosity gaps entre secoes mantem scroll
86
+ - [ ] Goal gradient aplicado (progress aumenta perto do CTA)
87
+ - [ ] Pode converter em qualquer ponto da pagina
88
+
89
+ **Score: __ /10**
90
+
91
+ ---
92
+
93
+ ## Pilar 6: CRO Patterns
94
+
95
+ - [ ] Social proof presente e verificavel (nomes, fotos, handles reais)
96
+ - [ ] Multiple CTAs em diferentes niveis de intencao
97
+ - [ ] Risk reversal enderecea top 3 objecoes
98
+ - [ ] Comparison table enquadrada favoravelmente (se aplicavel)
99
+ - [ ] Impact hypotheses documentadas para cada padrao (metrica + direcao + %)
100
+ - [ ] Sticky CTA aparece apos hero scroll
101
+ - [ ] CTA copy usa verbo de acao + beneficio (nao "Submit")
102
+ - [ ] Scarcity/urgency e REAL (nao fabricada)
103
+ - [ ] Form otimizado (multi-step, inline validation, single column)
104
+ - [ ] Trust signals no footer (seguranca, compliance, suporte)
105
+
106
+ **Score: __ /10**
107
+
108
+ ---
109
+
110
+ ## Pilar 7: Layout & Spacing
111
+
112
+ - [ ] 4px/8px baseline grid enforced
113
+ - [ ] Spacing entre secoes: 96-192px (respiracao cognitiva)
114
+ - [ ] Full-bleed vs contained justificado por secao
115
+ - [ ] Responsive breakpoints testados (320, 640, 1024, 1440px)
116
+ - [ ] Max content width enforced (65ch body, 1280-1440px container)
117
+ - [ ] Mobile-first layout explicito
118
+ - [ ] Container queries para componentes (quando aplicavel)
119
+ - [ ] Asymmetric balance usado para direcionalidade
120
+ - [ ] Section pacing cria ritmo vertical
121
+ - [ ] Nenhum layout orphan (elemento sozinho sem contexto)
122
+
123
+ **Score: __ /10**
124
+
125
+ ---
126
+
127
+ ## WCAG Compliance (Transversal)
128
+
129
+ - [ ] Contrast ratios verificados com ferramenta
130
+ - [ ] Keyboard navigation completa (Tab + Enter + Escape)
131
+ - [ ] Focus states visiveis em TODOS os elementos interativos
132
+ - [ ] Skip link presente e funcional
133
+ - [ ] Alt text em todas as imagens significativas
134
+ - [ ] Form labels presentes e associados
135
+ - [ ] aria-live para conteudo dinamico
136
+ - [ ] lang attribute no html
137
+ - [ ] Touch targets min 44x44px (mobile)
138
+ - [ ] Nenhum keyboard trap (exceto modal)
139
+
140
+ **Score: __ /10**
141
+
142
+ ---
143
+
144
+ ## Performance (Transversal)
145
+
146
+ - [ ] Lighthouse target > 90
147
+ - [ ] FCP < 1.5s
148
+ - [ ] LCP < 2.5s
149
+ - [ ] CLS < 0.1
150
+ - [ ] Animation JS < 100KB gzipped
151
+ - [ ] Font files < 200KB total
152
+ - [ ] Images otimizadas (WebP/AVIF, lazy loading)
153
+ - [ ] Critical CSS inlined
154
+ - [ ] Nao-blocking JS (defer/async)
155
+ - [ ] Service worker para cache (se aplicavel)
156
+
157
+ **Score: __ /10**
158
+
159
+ ---
160
+
161
+ ## Verdict
162
+
163
+ | Resultado | Criterio |
164
+ |-----------|---------|
165
+ | **PASS** | Todos os pilares >= 7/10, nenhuma violacao WCAG critica |
166
+ | **CONCERNS** | Todos os pilares >= 6/10, violacoes WCAG menores |
167
+ | **FAIL** | Qualquer pilar < 6/10 OU violacao WCAG critica |
168
+
169
+ **Overall Score:** __ /90 (soma dos 9 scores)
170
+ **Verdict:** ___________
171
+ **Reviewer:** ___________
172
+ **Date:** ___________
@@ -0,0 +1,289 @@
1
+ # Case Study: nyo.ia.br — Canonical Art Direction Reference
2
+
3
+ > Analise completa do site nyo.ia.br como referencia canonica de art direction para conversao.
4
+ > Cada decisao estetica e desconstruida pelo principio psicologico que a sustenta.
5
+
6
+ ---
7
+
8
+ ## Overview
9
+
10
+ **URL:** https://nyo.ia.br
11
+ **Categoria:** AI Agents SaaS (B2B)
12
+ **Audiencia:** Founders, CTOs, VPs de Vendas (Brasil)
13
+ **Posicionamento:** "Seus agentes de IA nunca dormem" — automacao agressiva com resultado concreto
14
+
15
+ ---
16
+
17
+ ## 1. Visual Language Analysis
18
+
19
+ ### Dark Mode Decision
20
+
21
+ | Decisao | Justificativa Psicologica |
22
+ |---------|--------------------------|
23
+ | Background: neutral-950 (#0a0a0a aprox.) | Sofisticacao tech, reducao de fadiga, imersao |
24
+ | Nao e true black (#000) | Evita "void" feeling, mantém profundidade |
25
+ | Text: neutral-100 (off-white) | Contraste alto sem glare de pure white |
26
+ | Accent: red-orange (#E8402D) | Von Restorff — unico elemento quente em campo frio |
27
+
28
+ **Principios em acao:** Von Restorff (accent destoa), Authority (dark = sofisticacao), Contrast (legibilidade)
29
+
30
+ ### Accent Color Strategy
31
+
32
+ ```
33
+ Toda a pagina: neutral dark + neutral light
34
+ UNICO elemento com cor quente: CTAs e highlights em red-orange
35
+
36
+ → Von Restorff effect maximizado
37
+ → Quando TUDO e frio, o QUENTE converte
38
+ → Accent usado em: botoes CTA, badges, hover states, progress indicators
39
+ ```
40
+
41
+ **Principio:** Max 1 accent rule — restricao forca atencao para os pontos de conversao
42
+
43
+ ### Density Level
44
+
45
+ - **Alta densidade de informacao** — cada viewport tem conteudo substancial
46
+ - Nao ha secoes "vazias" — ate o espaco e intencional
47
+ - Dados, metricas, agentes — informacao densa para audiencia tecnica
48
+ - **Principio:** Audiencia tech/founder espera densidade — low-density pareceria "empty"
49
+
50
+ ### Visual Identity Signals
51
+
52
+ | Sinal | O que Comunica | Como Comunica |
53
+ |-------|---------------|---------------|
54
+ | "//" prefix em textos | "Somos builders, somos codigo" | Estetica terminal/code |
55
+ | Monospace accent | Precisao tecnica | JetBrains Mono / Space Mono |
56
+ | Dark mode | Sofisticacao, tech-native | Ambiente dev-like |
57
+ | Metrics visuals | Data-driven, transparencia | Numeros grandes, counters |
58
+ | Live clock | Presenca real-time | Relogio local no header |
59
+
60
+ ---
61
+
62
+ ## 2. Motion Philosophy
63
+
64
+ ### Core Motion Decisions
65
+
66
+ | Tecnica | Implementacao | Principio |
67
+ |---------|--------------|-----------|
68
+ | Lenis smooth scroll | Smooth scrolling nativo, nao browser default | Controle da experiencia, premium feel |
69
+ | GSAP ScrollTrigger | Scroll-driven animations para reveals | Progressive disclosure via scroll |
70
+ | Frame sequence | 60+ frames como image sequence pinned | Cinema-level hero, impressao de premium |
71
+ | Text scramble | Caracteres randomicos → texto final | Tech aesthetic, anticipation principle |
72
+ | Marquee scroll-direction | Inverte direcao baseado no scroll | Engagement, surpresa, interatividade |
73
+ | Clip-path reveal | Sections revelam via clip-path morph | Staging, storytelling, drama |
74
+
75
+ ### Frame Sequence Hero
76
+
77
+ ```
78
+ 60+ imagens renderizadas
79
+ Pinned section com ScrollTrigger
80
+ Scroll position → frame index mapping
81
+ Efeito: usuario "controla" a animacao com scroll
82
+
83
+ Principios:
84
+ - Anticipation: scroll como trigger cria expectativa
85
+ - Control: usuario sente agency sobre a experiencia
86
+ - Zeigarnik: scroll incompleto = narrativa incompleta → scroll mais
87
+ ```
88
+
89
+ ### Text Scramble Effect
90
+
91
+ ```
92
+ "■▓▒░█▓▒" → "AGENTES" → "AGENTES DE IA"
93
+
94
+ Sequence:
95
+ 1. Random chars aparecem (noise)
96
+ 2. Chars gradualmente resolvem para texto correto
97
+ 3. Left-to-right ou simultaneous reveal
98
+
99
+ Principios:
100
+ - Anticipation (Disney): buildup antes do reveal
101
+ - Curiosity gap: o que esse texto vai dizer?
102
+ - Tech aesthetic: "decodificando" — reforça posicionamento AI
103
+ ```
104
+
105
+ ### Marquee com Scroll Direction
106
+
107
+ ```
108
+ Scroll para baixo → marquee move para direita
109
+ Scroll para cima → marquee inverte para esquerda
110
+
111
+ Principios:
112
+ - Secondary action (Disney): movimento secundário ao scroll
113
+ - Engagement: conteudo responde ao usuario
114
+ - Continuity (Gestalt): direcao consistente com scroll
115
+ ```
116
+
117
+ ### Body Lock em Modals
118
+
119
+ ```
120
+ Modal abre → body scroll trava
121
+ Focus trap dentro do modal
122
+ Escape ou click outside fecha
123
+
124
+ Principios:
125
+ - Staging (Disney): modal e o unico palco ativo
126
+ - Focus: elimina distracao do background
127
+ - Commitment: usuario engajou, agora complete a acao
128
+ ```
129
+
130
+ ### Progress Bars e Indicators
131
+
132
+ ```
133
+ Barra fixa no topo que avanca com scroll
134
+ Indica progresso na pagina
135
+
136
+ Principios:
137
+ - Zeigarnik: barra incompleta = tarefa incompleta → scroll mais
138
+ - Goal gradient: "80% — quase la" → esforco aumenta
139
+ - Cognitive fluency: usuario sabe onde esta
140
+ ```
141
+
142
+ ---
143
+
144
+ ## 3. IA as Psychological Tool
145
+
146
+ ### Information Architecture Breakdown
147
+
148
+ | Secao | Papel Cognitivo | Principio |
149
+ |-------|----------------|-----------|
150
+ | 1. Hero com frame sequence | HOOK — impacto visual + curiosity gap | Von Restorff, Zeigarnik |
151
+ | 2. "AI Agents never sleep" | PROMISE — beneficio central | Framing (always-on) |
152
+ | 3. Agent showcase carousel | DEMONSTRATE — o que cada agente faz | Progressive disclosure |
153
+ | 4. Agent modals | DEEP DIVE — expandir detalhes por agente | Zeigarnik (abrir = completar) |
154
+ | 5. Metrics section | PROOF — numeros concretos | Anchoring, authority |
155
+ | 6. Comparison table | COMPARE — nos vs alternativas | Framing, anchoring |
156
+ | 7. Testimonials | PROOF (social) — clientes reais | Social proof |
157
+ | 8. FAQ | OVERCOME — resolver objecoes | Risk reversal |
158
+ | 9. CTA final | CONVERT — multiplas opcoes | Hick's (limitado), commitment |
159
+ | 10. Footer com trust | REINFORCE — ultima impressao | Peak-end rule |
160
+
161
+ ### Progressive Disclosure via Agent Modals
162
+
163
+ ```
164
+ Carousel → mostra 10 agentes como cards
165
+ Cada card: nome + icone + one-liner
166
+ Click → modal expande com:
167
+ - Descricao detalhada
168
+ - Features especificas
169
+ - Metricas de resultado
170
+ - CTA contextual
171
+
172
+ Principios:
173
+ - Progressive disclosure: L1 (card) → L2 (modal)
174
+ - Zeigarnik: card mostra parcial → click para completar
175
+ - Hick's Law: 10 opcoes MAS so uma por vez no modal
176
+ ```
177
+
178
+ ### Comparison Table Strategy
179
+
180
+ ```
181
+ | Feature | Eles | NYO |
182
+ |-------------|--------|----------|
183
+ | Agentes AI | 3 | 10 |
184
+ | Uptime | 99.5% | 99.97% |
185
+ | Resposta | 2h | 2min |
186
+ | Preco | $$$ | $$ |
187
+
188
+ Coluna NYO: highlighted com accent color
189
+
190
+ Principios:
191
+ - Anchoring: numeros concorrentes sao a ancora
192
+ - Framing: features escolhidas favorecem NYO
193
+ - Von Restorff: coluna highlight = focal point
194
+ ```
195
+
196
+ ### FAQ como Objecao Handling
197
+
198
+ ```
199
+ Cada pergunta = uma objecao comum
200
+ Respostas curtas, diretas, com link para proof
201
+
202
+ "E se eu quiser cancelar?" → "Cancele quando quiser, sem multa"
203
+ "Funciona com meu CRM?" → "Integramos com +50 CRMs. Lista completa"
204
+
205
+ Principios:
206
+ - Risk reversal: remove medo
207
+ - Cognitive fluency: resposta simples = mais crivel
208
+ - Commitment: ler FAQ = micro-compromisso com a decisao
209
+ ```
210
+
211
+ ### Multiple CTAs Strategy
212
+
213
+ ```
214
+ CTA #1 (hero): "Agendar demonstracao" — alto compromisso
215
+ CTA #2 (mid-page): "Comece gratis" — baixo compromisso
216
+ CTA #3 (modal): "Fale com vendas" — personalizado
217
+ CTA #4 (sticky bar): "Agende uma demo" — persistente
218
+ CTA #5 (footer): "Comece agora" — ultima chance
219
+
220
+ Principios:
221
+ - Diferentes niveis de intencao: explore → learn → try → buy
222
+ - Hick's Law respeitada: max 2 opcoes por viewport
223
+ - Availability: CTA sempre visivel, sempre acessivel
224
+ ```
225
+
226
+ ### Real Social Handles
227
+
228
+ ```
229
+ Testimonials incluem @username do Twitter/LinkedIn
230
+ Verificavel — usuario pode checar se e real
231
+
232
+ Principio:
233
+ - Verifiability: proof que pode ser validado = mais confiavel
234
+ - Authority: handles reais > "Joao, CEO"
235
+ - Social proof: publico, nao anonimo
236
+ ```
237
+
238
+ ---
239
+
240
+ ## 4. CRO Patterns Applied
241
+
242
+ ### Pattern Map
243
+
244
+ | Padrao | Localizacao | Principio | Impacto Estimado |
245
+ |--------|-----------|-----------|-----------------|
246
+ | Frame sequence hero | Topo | Engagement, premium perception | +20-30% time on page |
247
+ | Live clock | Header | Real-time presence, tech signal | +5% credibility |
248
+ | Agent carousel | Mid-page | Progressive disclosure | +15% engagement |
249
+ | Comparison table | Pre-CTA | Anchoring, framing | +15-25% conversion |
250
+ | Sticky CTA | After hero | Availability | +15-25% CTA visibility |
251
+ | Testimonials + handles | Post-compare | Social proof (verifiable) | +10-20% trust |
252
+ | FAQ accordion | Pre-footer | Objection handling | +10% reduction in bounce |
253
+ | Multiple CTAs | Throughout | Intent capture | +10-15% total conversion |
254
+ | Progress bar | Fixed top | Zeigarnik, goal gradient | +5-10% scroll depth |
255
+ | Text scramble | Hero + sections | Tech aesthetic, curiosity | +10% time on page |
256
+
257
+ ---
258
+
259
+ ## 5. Lessons for Art Direction
260
+
261
+ ### O que Copiar (princípios)
262
+
263
+ 1. **Single accent color** — restricao maximiza Von Restorff
264
+ 2. **Dark mode + density** — match com audiencia tech
265
+ 3. **Scroll as narrative** — usuario controla o ritmo
266
+ 4. **Progressive disclosure via modals** — L1 overview → L2 detail on demand
267
+ 5. **Real social proof** — handles verificaveis, numeros concretos
268
+ 6. **Multiple intent CTAs** — capture diferentes niveis de compromisso
269
+ 7. **FAQ as objection handling** — cada pergunta e uma venda
270
+
271
+ ### O que NAO Copiar (execucao especifica)
272
+
273
+ 1. **Frame sequence exato** — necessita 60+ renders custom, high cost
274
+ 2. **Text scramble em tudo** — use com parcimonia, senao perde efeito
275
+ 3. **Custom cursor** — nao presente neste site, adicionar apenas se fizer sentido
276
+ 4. **Exata paleta de cor** — extract o principio (high contrast accent on dark), nao os hex codes
277
+
278
+ ### O que Entender (gatilhos)
279
+
280
+ > "Nunca clone sem entender qual gatilho cada elemento ativa."
281
+
282
+ | Elemento | Gatilho que Ativa | Se Remover, Perde |
283
+ |---------|-------------------|-------------------|
284
+ | Frame sequence | Agency do usuario + premium perception | Engagement hero, time on page |
285
+ | Text scramble | Curiosity + tech positioning | Brand differentiation |
286
+ | Live clock | Real-time trust | Subtle authority signal |
287
+ | Marquee reversal | Engagement via interactivity | Secondary motion richness |
288
+ | Progress bar | Zeigarnik + goal gradient | Scroll completion |
289
+ | Agent modals | Progressive disclosure depth | Detail without overwhelm |