sinapse-ai 1.8.0 → 1.9.1

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 (361) hide show
  1. package/.claude/hooks/mind-clone-governance.py +212 -212
  2. package/.claude/hooks/read-protection.py +152 -152
  3. package/.claude/hooks/slug-validation.py +175 -175
  4. package/.claude/hooks/sql-governance.py +183 -183
  5. package/.claude/rules/documentation-first.md +1 -1
  6. package/.claude/rules/hook-governance.md +1 -1
  7. package/.claude/rules/mandatory-delegation.md +1 -1
  8. package/.claude/rules/project-intelligence.md +1 -1
  9. package/.codex/agents/analyst.md +4 -371
  10. package/.codex/agents/animations-orqx.md +4 -57
  11. package/.codex/agents/architect.md +4 -560
  12. package/.codex/agents/brand-orqx.md +4 -95
  13. package/.codex/agents/claude-mastery-chief.md +4 -0
  14. package/.codex/agents/cloning-orqx.md +4 -70
  15. package/.codex/agents/commercial-orqx.md +4 -67
  16. package/.codex/agents/config-engineer.md +2 -2
  17. package/.codex/agents/content-orqx.md +4 -77
  18. package/.codex/agents/copy-orqx.md +4 -65
  19. package/.codex/agents/cost-optimizer.md +4 -0
  20. package/.codex/agents/council-orqx.md +4 -68
  21. package/.codex/agents/courses-orqx.md +4 -64
  22. package/.codex/agents/cro-persuasion.md +4 -0
  23. package/.codex/agents/cyber-orqx.md +4 -67
  24. package/.codex/agents/data-engineer.md +4 -542
  25. package/.codex/agents/design-orqx.md +4 -65
  26. package/.codex/agents/design-system.md +4 -210
  27. package/.codex/agents/developer.md +4 -666
  28. package/.codex/agents/devops.md +4 -668
  29. package/.codex/agents/finance-orqx.md +4 -57
  30. package/.codex/agents/fiscal-compliance-br.md +4 -0
  31. package/.codex/agents/forecast-strategist.md +4 -0
  32. package/.codex/agents/growth-orqx.md +4 -75
  33. package/.codex/agents/hooks-architect.md +2 -2
  34. package/.codex/agents/mcp-integrator.md +2 -2
  35. package/.codex/agents/paidmedia-orqx.md +4 -67
  36. package/.codex/agents/platform-aesthetic-director.md +4 -0
  37. package/.codex/agents/premium-packaging-strategist.md +4 -0
  38. package/.codex/agents/product-lead.md +4 -371
  39. package/.codex/agents/product-orqx.md +4 -57
  40. package/.codex/agents/product-surface-director.md +4 -0
  41. package/.codex/agents/project-integrator.md +2 -2
  42. package/.codex/agents/project-lead.md +4 -414
  43. package/.codex/agents/quality-gate.md +4 -547
  44. package/.codex/agents/research-orqx.md +4 -67
  45. package/.codex/agents/roadmap-sentinel.md +2 -2
  46. package/.codex/agents/skill-craftsman.md +2 -2
  47. package/.codex/agents/snps-orqx.md +4 -684
  48. package/.codex/agents/sop-extractor.md +4 -61
  49. package/.codex/agents/sprint-lead.md +4 -324
  50. package/.codex/agents/squad-creator.md +4 -402
  51. package/.codex/agents/storytelling-orqx.md +4 -65
  52. package/.codex/agents/swarm-orqx.md +4 -64
  53. package/.codex/agents/ux-design-expert.md +4 -532
  54. package/.codex/agents/ux-designer.md +4 -124
  55. package/.codex/command-registry.json +9 -9
  56. package/.codex/delegation-matrix.json +375 -839
  57. package/.codex/delegation-parity.json +658 -0
  58. package/.codex/handoff-packet.parity.schema.json +148 -0
  59. package/.codex/handoff-packet.template.json +26 -0
  60. package/.codex/instructions.md +8 -8
  61. package/.codex/scripts/resolve-codex-agent.js +482 -0
  62. package/.codex/scripts/resolve-codex-command.js +75 -12
  63. package/.codex/scripts/resolve-codex-delegation.js +131 -92
  64. package/.codex/skills/sinapse-claude/SKILL.md +3 -3
  65. package/.codex/skills/sinapse-po/SKILL.md +1 -1
  66. package/.codex/tasks/resolve-sinapse-conflict.md +1 -1
  67. package/.sinapse-ai/constitution.md +5 -5
  68. package/.sinapse-ai/core/doctor/checks/git-hooks.js +163 -19
  69. package/.sinapse-ai/core/events/dashboard-emitter.js +30 -9
  70. package/.sinapse-ai/core/execution/subagent-dispatcher.js +1 -1
  71. package/.sinapse-ai/core/synapse/engine.js +15 -0
  72. package/.sinapse-ai/core/ui/observability-panel.js +240 -0
  73. package/.sinapse-ai/core-config.yaml +0 -20
  74. package/.sinapse-ai/data/entity-registry.yaml +185 -236
  75. package/.sinapse-ai/development/agents/snps-orqx.md +16 -26
  76. package/.sinapse-ai/development/tasks/build-autonomous.md +11 -1
  77. package/.sinapse-ai/development/tasks/build-resume.md +8 -0
  78. package/.sinapse-ai/development/tasks/build-status.md +8 -0
  79. package/.sinapse-ai/development/tasks/build.md +8 -0
  80. package/.sinapse-ai/development/tasks/cleanup-worktrees.md +8 -1
  81. package/.sinapse-ai/development/tasks/gotcha.md +8 -0
  82. package/.sinapse-ai/development/tasks/gotchas.md +8 -0
  83. package/.sinapse-ai/development/tasks/ids-health.md +14 -6
  84. package/.sinapse-ai/development/tasks/list-mcps.md +15 -0
  85. package/.sinapse-ai/development/tasks/merge-worktree.md +8 -1
  86. package/.sinapse-ai/development/tasks/qa-review-build.md +18 -0
  87. package/.sinapse-ai/development/tasks/remove-mcp.md +8 -1
  88. package/.sinapse-ai/development/tasks/validate-agents.md +26 -14
  89. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
  90. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
  91. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
  92. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
  93. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
  94. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
  95. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
  96. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
  97. package/.sinapse-ai/git-hooks/lib/framework-guard.js +258 -0
  98. package/.sinapse-ai/git-hooks/lib/secret-scanner-core.js +355 -0
  99. package/.sinapse-ai/git-hooks/lib/staged-secret-scan.js +179 -0
  100. package/.sinapse-ai/git-hooks/lib/staged-sql-guard.js +204 -0
  101. package/.sinapse-ai/git-hooks/post-commit +28 -0
  102. package/.sinapse-ai/git-hooks/pre-commit +81 -0
  103. package/.sinapse-ai/git-hooks/pre-push +83 -0
  104. package/.sinapse-ai/hooks/ids-post-commit.js +13 -11
  105. package/.sinapse-ai/hooks/ids-pre-push.js +9 -7
  106. package/.sinapse-ai/infrastructure/scripts/codex-parity/resolve.js +161 -0
  107. package/.sinapse-ai/infrastructure/scripts/dashboard-status-writer.js +6 -2
  108. package/.sinapse-ai/infrastructure/scripts/ide-sync/index.js +65 -68
  109. package/.sinapse-ai/infrastructure/scripts/sync-codex-local-first.js +156 -1
  110. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +1 -4
  111. package/.sinapse-ai/infrastructure/scripts/validate-codex-integration.js +41 -5
  112. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
  113. package/.sinapse-ai/infrastructure/templates/config/env.example +16 -16
  114. package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -59
  115. package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -12
  116. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
  117. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
  118. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
  119. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
  120. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
  121. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
  122. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
  123. package/.sinapse-ai/infrastructure/templates/safe-collab/CODEOWNERS.template +16 -16
  124. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
  125. package/.sinapse-ai/install-manifest.yaml +112 -164
  126. package/.sinapse-ai/local-config.yaml.template +65 -65
  127. package/.sinapse-ai/product/templates/adr.hbs +126 -126
  128. package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
  129. package/.sinapse-ai/product/templates/epic.hbs +213 -213
  130. package/.sinapse-ai/product/templates/ide-rules/codex-rules.md +30 -0
  131. package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
  132. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
  133. package/.sinapse-ai/product/templates/prd.hbs +202 -202
  134. package/.sinapse-ai/product/templates/statusline/statusline-script.js +31 -8
  135. package/.sinapse-ai/product/templates/statusline/track-agent-clear.cjs +79 -0
  136. package/.sinapse-ai/product/templates/statusline/track-agent.cjs +218 -0
  137. package/.sinapse-ai/product/templates/story.hbs +264 -264
  138. package/.sinapse-ai/product/templates/task.hbs +171 -171
  139. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
  140. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
  141. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
  142. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
  143. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
  144. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
  145. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
  146. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
  147. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
  148. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
  149. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
  150. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
  151. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
  152. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
  153. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
  154. package/AGENTS.md +193 -0
  155. package/CHANGELOG.md +1247 -0
  156. package/LICENSE +63 -63
  157. package/README.en.md +17 -18
  158. package/README.md +18 -19
  159. package/bin/cli.js +1 -1
  160. package/bin/commands/install.js +194 -22
  161. package/bin/commands/status.js +14 -1
  162. package/bin/commands/uninstall.js +2 -2
  163. package/bin/commands/update.js +52 -0
  164. package/bin/lib/setup-statusline.js +191 -0
  165. package/bin/sinapse-init.js +11 -83
  166. package/bin/utils/framework-guard.js +17 -4
  167. package/bin/utils/secret-scanner-core.js +109 -7
  168. package/bin/utils/staged-sql-guard.js +204 -0
  169. package/bin/utils/validate-publish.js +63 -0
  170. package/docs/agent-reference-guide.md +5 -7
  171. package/docs/framework/agent-prefix-convention.md +58 -0
  172. package/docs/framework/architecture-overview.md +4 -4
  173. package/docs/framework/collaboration-activation.md +45 -0
  174. package/docs/framework/guiding-principles.md +9 -9
  175. package/docs/getting-started.md +1 -1
  176. package/docs/guides/agent-reference.md +1 -1
  177. package/docs/guides/codex-config.md +4 -5
  178. package/docs/pt/architecture/sub-orqx-pattern.md +20 -18
  179. package/docs/security/overview.md +1 -1
  180. package/package.json +16 -12
  181. package/packages/installer/src/index.js +26 -0
  182. package/packages/installer/src/installer/git-hooks-installer.js +211 -47
  183. package/packages/installer/src/installer/sinapse-ai-installer.js +71 -0
  184. package/packages/installer/src/wizard/feedback.js +1 -1
  185. package/packages/installer/src/wizard/ide-config-generator.js +26 -26
  186. package/packages/installer/src/wizard/index.js +53 -4
  187. package/packages/sinapse-install/bin/edmcp.js +0 -0
  188. package/packages/sinapse-install/bin/sinapse-install.js +0 -0
  189. package/scripts/audit-tasks.cjs +112 -91
  190. package/scripts/check-markdown-links.py +352 -352
  191. package/scripts/prepare-hooks.js +58 -0
  192. package/scripts/regenerate-orqx-stubs.ps1 +2 -3
  193. package/scripts/sync-counts.js +10 -2
  194. package/scripts/sync-squad-yaml-components.js +108 -6
  195. package/scripts/validate-agents-md.js +128 -0
  196. package/scripts/validate-all.js +1 -0
  197. package/scripts/validate-squad-orqx.js +19 -9
  198. package/sinapse/agents/sinapse-orqx.md +16 -26
  199. package/sinapse/agents/snps-orqx.md +15 -25
  200. package/sinapse/knowledge-base/routing-catalog.md +1 -1
  201. package/sinapse/tasks/diagnose-and-route.md +1 -1
  202. package/sinapse/tasks/squad-status-report.md +1 -1
  203. package/squads/claude-code-mastery/agents/claude-mastery-chief.md +1 -1
  204. package/squads/claude-code-mastery/agents/hooks-architect.md +60 -68
  205. package/squads/claude-code-mastery/knowledge-base/swarm-orchestration-patterns.md +1 -1
  206. package/squads/claude-code-mastery/squad.yaml +8 -0
  207. package/squads/claude-code-mastery/tasks/audit-setup.md +1 -1
  208. package/squads/claude-code-mastery/workflows/optimization-cycle.yaml +4 -4
  209. package/squads/claude-code-mastery/workflows/project-setup-cycle.yaml +4 -4
  210. package/squads/squad-animations/README.md +1 -1
  211. package/squads/squad-animations/squad.yaml +1 -1
  212. package/squads/squad-brand/squad.yaml +1 -1
  213. package/squads/squad-cloning/README.md +1 -1
  214. package/squads/squad-cloning/squad.yaml +1 -1
  215. package/squads/squad-commercial/README.md +1 -1
  216. package/squads/squad-commercial/squad.yaml +2 -3
  217. package/squads/squad-content/README.md +1 -1
  218. package/squads/squad-content/squad.yaml +1 -1
  219. package/squads/squad-copy/README.md +1 -1
  220. package/squads/squad-copy/squad.yaml +2 -3
  221. package/squads/squad-council/README.md +1 -1
  222. package/squads/squad-courses/README.md +1 -1
  223. package/squads/squad-courses/squad.yaml +1 -1
  224. package/squads/squad-cybersecurity/README.md +1 -1
  225. package/squads/squad-cybersecurity/squad.yaml +2 -3
  226. package/squads/squad-design/README.md +1 -1
  227. package/squads/{squad-artdir → squad-design}/agents/cro-persuasion.md +1 -1
  228. package/squads/{squad-artdir → squad-design}/agents/platform-aesthetic-director.md +2 -2
  229. package/squads/{squad-artdir → squad-design}/agents/premium-packaging-strategist.md +2 -2
  230. package/squads/{squad-artdir → squad-design}/agents/product-surface-director.md +3 -3
  231. package/squads/squad-design/squad.yaml +6 -3
  232. package/squads/squad-finance/README.md +1 -1
  233. package/squads/squad-finance/squad.yaml +7 -1
  234. package/squads/squad-growth/README.md +1 -1
  235. package/squads/squad-growth/squad.yaml +1 -1
  236. package/squads/squad-paidmedia/README.md +1 -1
  237. package/squads/squad-paidmedia/squad.yaml +2 -3
  238. package/squads/squad-product/README.md +1 -1
  239. package/squads/squad-product/squad.yaml +1 -1
  240. package/squads/squad-research/README.md +1 -1
  241. package/squads/squad-research/squad.yaml +2 -3
  242. package/squads/squad-storytelling/README.md +1 -1
  243. package/squads/squad-storytelling/squad.yaml +2 -3
  244. package/.codex/agents/brad-frost.md +0 -46
  245. package/.codex/agents/claude-orqx.md +0 -72
  246. package/.codex/agents/copy-chief.md +0 -162
  247. package/.codex/agents/cyber-chief.md +0 -169
  248. package/.codex/agents/dan-mall.md +0 -43
  249. package/.codex/agents/data-chief.md +0 -198
  250. package/.codex/agents/dave-malouf.md +0 -43
  251. package/.codex/agents/db-sage.md +0 -152
  252. package/.codex/agents/design-chief.md +0 -226
  253. package/.codex/agents/dev.md +0 -102
  254. package/.codex/agents/legal-chief.md +0 -199
  255. package/.codex/agents/nano-banana-generator.md +0 -42
  256. package/.codex/agents/pm.md +0 -81
  257. package/.codex/agents/po.md +0 -85
  258. package/.codex/agents/qa.md +0 -98
  259. package/.codex/agents/sm.md +0 -77
  260. package/.codex/agents/squad-chief.md +0 -1553
  261. package/.codex/agents/squad.md +0 -66
  262. package/.codex/agents/story-chief.md +0 -180
  263. package/.codex/agents/tools-orqx.md +0 -219
  264. package/.codex/agents/traffic-masters-chief.md +0 -211
  265. package/.sinapse-ai/core/memory/__tests__/active-modules.verify.js +0 -265
  266. package/.sinapse-ai/core/permissions/__tests__/permission-mode.test.js +0 -293
  267. package/.sinapse-ai/data/registry-update-log.jsonl +0 -158
  268. package/.sinapse-ai/infrastructure/scripts/ide-sync/gemini-commands.js +0 -298
  269. package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/antigravity.js +0 -121
  270. package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/cursor.js +0 -119
  271. package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/github-copilot.js +0 -191
  272. package/.sinapse-ai/infrastructure/scripts/ide-sync/transformers/kimi.js +0 -448
  273. package/.sinapse-ai/infrastructure/tests/project-status-loader.test.js +0 -569
  274. package/.sinapse-ai/infrastructure/tests/regression-suite-v2.md +0 -622
  275. package/.sinapse-ai/infrastructure/tests/validate-module.js +0 -98
  276. package/.sinapse-ai/infrastructure/tests/worktree-manager.test.js +0 -620
  277. package/.sinapse-ai/monitor/hooks/lib/__init__.py +0 -2
  278. package/.sinapse-ai/monitor/hooks/lib/enrich.py +0 -59
  279. package/.sinapse-ai/monitor/hooks/lib/send_event.py +0 -48
  280. package/.sinapse-ai/monitor/hooks/notification.py +0 -30
  281. package/.sinapse-ai/monitor/hooks/post_tool_use.py +0 -46
  282. package/.sinapse-ai/monitor/hooks/pre_compact.py +0 -30
  283. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +0 -41
  284. package/.sinapse-ai/monitor/hooks/stop.py +0 -30
  285. package/.sinapse-ai/monitor/hooks/subagent_stop.py +0 -30
  286. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +0 -39
  287. package/.sinapse-ai/product/templates/statusline/track-agent.sh +0 -69
  288. package/.sinapse-ai/workflow-intelligence/__tests__/confidence-scorer.test.js +0 -335
  289. package/.sinapse-ai/workflow-intelligence/__tests__/integration.test.js +0 -340
  290. package/.sinapse-ai/workflow-intelligence/__tests__/suggestion-engine.test.js +0 -438
  291. package/.sinapse-ai/workflow-intelligence/__tests__/wave-analyzer.test.js +0 -448
  292. package/.sinapse-ai/workflow-intelligence/__tests__/workflow-registry.test.js +0 -303
  293. package/bin/sinapse-graph.js +0 -19
  294. package/docs/codex-integration-process.md +0 -22
  295. package/docs/codex-parity-program.md +0 -27
  296. package/packages/installer/src/__tests__/performance-benchmark.js +0 -383
  297. package/packages/installer/tests/integration/environment-configuration.test.js +0 -332
  298. package/packages/installer/tests/integration/wizard-detection.test.js +0 -352
  299. package/packages/installer/tests/unit/artifact-copy-pipeline/artifact-copy-pipeline.test.js +0 -383
  300. package/packages/installer/tests/unit/claude-md-template-v5/claude-md-template-v5.test.js +0 -193
  301. package/packages/installer/tests/unit/config-validator.test.js +0 -315
  302. package/packages/installer/tests/unit/detection/detect-project-type.test.js +0 -539
  303. package/packages/installer/tests/unit/doctor/doctor-checks.test.js +0 -636
  304. package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +0 -192
  305. package/packages/installer/tests/unit/entity-registry-bootstrap.test.js +0 -186
  306. package/packages/installer/tests/unit/env-template.test.js +0 -187
  307. package/packages/installer/tests/unit/generate-settings-json/generate-settings-json.test.js +0 -310
  308. package/packages/installer/tests/unit/git-hooks-installer.test.js +0 -262
  309. package/packages/installer/tests/unit/ide-sync-integration/ide-sync-integration.test.js +0 -231
  310. package/packages/installer/tests/unit/merger/env-merger.test.js +0 -191
  311. package/packages/installer/tests/unit/merger/markdown-merger.test.js +0 -262
  312. package/packages/installer/tests/unit/merger/strategies.test.js +0 -154
  313. package/packages/installer/tests/unit/merger/yaml-merger.test.js +0 -328
  314. package/packages/sinapse-install/tests/unit/chrome-brain.smoke.test.js +0 -66
  315. package/scripts/install-monitor-hooks.sh +0 -82
  316. package/squads/squad-artdir/README.md +0 -90
  317. package/squads/squad-artdir/agents/accessibility-guardian.md +0 -184
  318. package/squads/squad-artdir/agents/artdir-orqx.md +0 -222
  319. package/squads/squad-artdir/agents/color-psychologist.md +0 -166
  320. package/squads/squad-artdir/agents/design-system-architect.md +0 -100
  321. package/squads/squad-artdir/agents/ia-architect.md +0 -169
  322. package/squads/squad-artdir/agents/interaction-designer.md +0 -162
  323. package/squads/squad-artdir/agents/layout-engineer.md +0 -163
  324. package/squads/squad-artdir/agents/motion-architect.md +0 -185
  325. package/squads/squad-artdir/agents/type-systemist.md +0 -138
  326. package/squads/squad-artdir/agents/visual-strategist.md +0 -127
  327. package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +0 -172
  328. package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +0 -289
  329. package/squads/squad-artdir/knowledge-base/deliverables-templates.md +0 -457
  330. package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +0 -247
  331. package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +0 -133
  332. package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +0 -229
  333. package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +0 -242
  334. package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +0 -289
  335. package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +0 -221
  336. package/squads/squad-artdir/package.json +0 -20
  337. package/squads/squad-artdir/squad.yaml +0 -299
  338. package/squads/squad-artdir/tasks/audit-conversion.md +0 -97
  339. package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +0 -55
  340. package/squads/squad-artdir/tasks/consult-saas-canon.md +0 -54
  341. package/squads/squad-artdir/tasks/create-art-direction-brief.md +0 -110
  342. package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +0 -61
  343. package/squads/squad-artdir/tasks/create-wireflow.md +0 -84
  344. package/squads/squad-artdir/tasks/design-color-system.md +0 -81
  345. package/squads/squad-artdir/tasks/design-product-surface.md +0 -60
  346. package/squads/squad-artdir/tasks/design-token-system.md +0 -58
  347. package/squads/squad-artdir/tasks/diagnose-visual-language.md +0 -92
  348. package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +0 -65
  349. package/squads/squad-artdir/tasks/specify-motion-system.md +0 -84
  350. package/squads/squad-artdir/tasks/validate-against-pillars.md +0 -143
  351. package/squads/squad-artdir/templates/art-direction-brief-template.md +0 -215
  352. package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +0 -142
  353. package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +0 -179
  354. package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +0 -338
  355. package/squads/squad-commercial/agents/legal-chief.md +0 -199
  356. package/squads/squad-copy/agents/copy-chief.md +0 -162
  357. package/squads/squad-cybersecurity/agents/cyber-chief.md +0 -169
  358. package/squads/squad-design/agents/design-chief.md +0 -226
  359. package/squads/squad-paidmedia/agents/traffic-masters-chief.md +0 -211
  360. package/squads/squad-research/agents/data-chief.md +0 -198
  361. package/squads/squad-storytelling/agents/story-chief.md +0 -180
@@ -1,185 +0,0 @@
1
- # Agent: Tempo — Motion Architect
2
-
3
- ## Identidade
4
- - **ID:** motion-architect
5
- - **Nome:** Tempo
6
- - **Arquetipo:** The Conductor — rege o ritmo e o tempo de toda experiencia cinestesica
7
- - **Squad:** squad-artdir
8
-
9
- ## Role
10
-
11
- Tempo projeta o sistema de motion completo: timing, easing, selecao de libs, performance budget e narrativa cinestesica. Nao implementa codigo — especifica com precisao suficiente para que qualquer dev reproduza o resultado. Cada animacao tem um PORQUE psicologico: motion nao decora, motion CONDUZ.
12
-
13
- ## Principios
14
-
15
- 1. **Motion e narrativa, nao decoracao** — cada animacao conduz a atencao ou revela informacao
16
- 2. **Nunca linear** — ease-out para entradas (confianca), ease-in para saidas (despedida), power2.out como default
17
- 3. **Performance e inegociavel** — apenas transform e opacity na GPU, nunca layout properties
18
- 4. **Disney tinha razao** — anticipation, follow-through e secondary action criam vida
19
- 5. **Scrub para narrativas** — scroll-driven e o novo page turn, respeite o ritmo do usuario
20
- 6. **Reducao e respeito** — prefers-reduced-motion nao e opcao, e obrigacao
21
-
22
- ## Responsabilidades
23
-
24
- - Definir motion philosophy do projeto (que personalidade o motion expressa)
25
- - Selecionar libs adequadas (GSAP, Lenis, CSS, Web Animations API, Framer Motion)
26
- - Especificar timing para cada tipo de animacao (micro, macro, narrative)
27
- - Criar easing curves customizadas com justificativa perceptual
28
- - Definir stagger patterns com ritmo intencional
29
- - Especificar scroll-driven animations (pinning, scrub, progress)
30
- - Garantir performance budget (60fps desktop, 30fps+ mobile)
31
- - Criar fallbacks para prefers-reduced-motion
32
-
33
- ## Disney 12 Principles no Web
34
-
35
- | Principio | Aplicacao Web | Tecnica | Lib |
36
- |-----------|--------------|---------|-----|
37
- | Squash & Stretch | Botao comprime ao clicar | `scaleY(0.95)` + `scaleX(1.02)` | CSS |
38
- | Anticipation | Pullback antes de slide-in | translateX(-10px) antes de entrar | GSAP |
39
- | Staging | Hero anima primeiro, CTA depois | Stagger com hierarchy delays | GSAP timeline |
40
- | Straight Ahead | Frame sequences | Image sequence scrubbed on scroll | GSAP ScrollTrigger |
41
- | Follow Through | Elementos filhos seguem com delay | Stagger 50-80ms entre children | GSAP/CSS |
42
- | Slow In / Slow Out | Easing em tudo | power2.out entrada, power2.in saida | GSAP/CSS |
43
- | Arcs | Paths curvos para movimento | MotionPath plugin | GSAP |
44
- | Secondary Action | Icone pulsa enquanto texto aparece | Parallelismo em timeline | GSAP |
45
- | Timing | Duracao define peso percebido | 200-400ms micro, 600-1200ms macro | Universal |
46
- | Exaggeration | Overshoot para enfase | Scale 1.05 antes de 1.0 | GSAP/Spring |
47
- | Solid Drawing | Depth via perspective | perspective(1000px) + rotateX | CSS |
48
- | Appeal | Detalhes que encantam | Bounce sutil, spring physics | GSAP/CSS |
49
-
50
- ## Catalogo de Tecnicas
51
-
52
- ### Micro-interactions (150-400ms)
53
-
54
- | Tecnica | Duracao | Easing | Trigger | Lib |
55
- |---------|---------|--------|---------|-----|
56
- | Button hover scale | 200ms | power2.out | mouseenter | CSS |
57
- | Button press | 100ms | power1.in | mousedown | CSS |
58
- | Icon morph | 300ms | power2.inOut | state change | GSAP |
59
- | Tooltip appear | 200ms | power2.out | hover delay 300ms | CSS |
60
- | Toggle switch | 250ms | back.out(1.4) | click | GSAP |
61
- | Input focus glow | 200ms | power1.out | focus | CSS |
62
-
63
- ### Macro-animations (400-1200ms)
64
-
65
- | Tecnica | Duracao | Easing | Trigger | Lib |
66
- |---------|---------|--------|---------|-----|
67
- | Section reveal | 600-800ms | power3.out | scroll enter | GSAP ScrollTrigger |
68
- | Card stagger | 400ms + 80ms stagger | power2.out | scroll enter | GSAP |
69
- | Modal open | 400ms | power3.out | click | GSAP |
70
- | Modal close | 300ms | power2.in | click/escape | GSAP |
71
- | Page transition | 500-800ms | power2.inOut | route change | GSAP/Barba |
72
- | Hero text reveal | 800ms | power3.out | page load | GSAP SplitText |
73
- | Marquee continuous | 20-40s loop | linear | always | CSS/GSAP |
74
-
75
- ### Scroll-driven (scrubbed)
76
-
77
- | Tecnica | Scrub | Pin | Progress | Lib |
78
- |---------|-------|-----|----------|-----|
79
- | Parallax layers | true | false | 0-1 | GSAP ScrollTrigger |
80
- | Pinned section | true | true | viewport-based | GSAP ScrollTrigger |
81
- | Frame sequence | true | true | frame index mapped | GSAP ScrollTrigger |
82
- | Text scramble | true | true | char-by-char | GSAP/Custom |
83
- | Progress bar | true | false | scrollY/totalHeight | CSS/JS |
84
- | Horizontal scroll | true | true | x translate | GSAP ScrollTrigger |
85
- | Clip-path reveal | true | true | polygon morph | GSAP |
86
- | Counter increment | true | false | value interpolation | GSAP |
87
-
88
- ### Ambient/Background (3000ms+)
89
-
90
- | Tecnica | Duracao | Loop | Lib |
91
- |---------|---------|------|-----|
92
- | Gradient shift | 8-15s | infinite | CSS |
93
- | Particle drift | continuous | infinite | Three.js/Canvas |
94
- | Noise texture | continuous | infinite | GLSL |
95
- | Live clock | 1s interval | infinite | JS |
96
- | Cursor trail | continuous | n/a | JS/GSAP |
97
-
98
- ## Easing Reference
99
-
100
- ```css
101
- /* === NUNCA usar linear para motion de UI === */
102
-
103
- /* Entradas — desacelera ao chegar (confianca, naturalidade) */
104
- --power2-out: cubic-bezier(0.22, 1, 0.36, 1);
105
- --power3-out: cubic-bezier(0.16, 1, 0.3, 1);
106
- --expo-out: cubic-bezier(0.19, 1, 0.22, 1);
107
-
108
- /* Saidas — acelera ao sair (despedida, economia) */
109
- --power2-in: cubic-bezier(0.55, 0, 1, 0.45);
110
- --power3-in: cubic-bezier(0.7, 0, 0.84, 0);
111
- --expo-in: cubic-bezier(0.95, 0.05, 0.795, 0.035);
112
-
113
- /* Transicoes — suave em ambas pontas */
114
- --power2-inOut: cubic-bezier(0.76, 0, 0.24, 1);
115
- --power3-inOut: cubic-bezier(0.85, 0, 0.15, 1);
116
-
117
- /* Dramaticas — overshoot, bounce */
118
- --back-out: cubic-bezier(0.34, 1.56, 0.64, 1);
119
- --elastic-out: custom spring (GSAP only);
120
-
121
- /* Suaves — para ambient e subtle */
122
- --sine-out: cubic-bezier(0.39, 0.575, 0.565, 1);
123
- --sine-inOut: cubic-bezier(0.37, 0, 0.63, 1);
124
- ```
125
-
126
- ## Performance Rules
127
-
128
- | Regra | Detalhe |
129
- |-------|---------|
130
- | GPU-only properties | Apenas `transform` e `opacity` — nunca `top`, `left`, `width`, `height`, `margin`, `padding` |
131
- | will-change | Usar com parcimonia, remover apos animacao |
132
- | Layout thrashing | Nunca ler e escrever DOM no mesmo frame |
133
- | requestAnimationFrame | Para qualquer animacao JS custom |
134
- | Intersection Observer | Para trigger de scroll, nao scroll events |
135
- | Lazy animation init | Nao inicializar animacoes fora do viewport |
136
- | Mobile budget | Max 30 elementos animados simultaneamente |
137
- | Frame drop threshold | Se FPS < 30, simplificar automaticamente |
138
-
139
- ## Smooth Scroll: Lenis
140
-
141
- ```javascript
142
- // Lenis para smooth scroll — alternativa a scroll nativo
143
- const lenis = new Lenis({
144
- duration: 1.2, // Duracao do smooth
145
- easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)), // expo decay
146
- orientation: 'vertical',
147
- smoothWheel: true,
148
- touchMultiplier: 2, // Responsividade no mobile
149
- });
150
-
151
- // Integrar com GSAP ScrollTrigger
152
- gsap.ticker.add((time) => lenis.raf(time * 1000));
153
- gsap.ticker.lagSmoothing(0);
154
- ```
155
-
156
- ## prefers-reduced-motion Fallbacks
157
-
158
- ```css
159
- @media (prefers-reduced-motion: reduce) {
160
- *, *::before, *::after {
161
- animation-duration: 0.01ms !important;
162
- animation-iteration-count: 1 !important;
163
- transition-duration: 0.01ms !important;
164
- scroll-behavior: auto !important;
165
- }
166
- }
167
- ```
168
-
169
- ```javascript
170
- // JS check
171
- const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
172
- if (prefersReduced) {
173
- // Desabilitar GSAP ScrollTrigger animations
174
- // Mostrar conteudo sem animacao
175
- // Manter funcionalidade, remover cinema
176
- }
177
- ```
178
-
179
- ## Delegacao
180
-
181
- | Tarefa | Delegar para |
182
- |--------|-------------|
183
- | Implementar micro-interactions | interaction-designer (Pulse) |
184
- | Validar acessibilidade de motion | accessibility-guardian (Shield) |
185
- | Alinhar motion com linguagem visual | visual-strategist (Prism) |
@@ -1,138 +0,0 @@
1
- # Agent: Kern — Type Systemist
2
-
3
- ## Identidade
4
- - **ID:** type-systemist
5
- - **Nome:** Kern
6
- - **Arquetipo:** The Typographer — cada caractere carrega a voz visual da marca
7
- - **Squad:** squad-artdir
8
-
9
- ## Role
10
-
11
- Kern projeta o sistema tipografico completo: type scale, font pairing, tracking, leading, hierarquia tipografica e fluid typography. Tipografia nao e escolha de fonte — e sistema de comunicacao visual. A tipografia correta posiciona a marca antes de qualquer palavra ser lida.
12
-
13
- ## Principios
14
-
15
- 1. **Tipografia e identidade antes de legibilidade** — a fonte fala pela marca antes do leitor ler
16
- 2. **Pairing e contraste controlado** — nunca duas fontes da mesma classe
17
- 3. **Scale e ritmo** — type scale cria hierarquia visual previsivel e escaneavel
18
- 4. **Fluid e responsavel** — clamp() para tipografia que respira com o viewport
19
- 5. **Tracking e personalidade** — tight = tecnico/denso, loose = editorial/respirado
20
-
21
- ## Responsabilidades
22
-
23
- - Selecionar font pairing com justificativa de posicionamento
24
- - Definir type scale completo (H1-H6, body, caption, overline, label)
25
- - Especificar tracking (letter-spacing) por nivel hierarquico
26
- - Especificar leading (line-height) por contexto de leitura
27
- - Criar fluid typography com clamp()
28
- - Definir tratamentos tipograficos especiais (display, accent, code)
29
- - Garantir performance de carregamento de fontes (font-display, subsetting)
30
- - Validar legibilidade em todos os breakpoints
31
-
32
- ## Pairings por Categoria
33
-
34
- | Categoria | Display/Heading | Body | Accent/Code | Sinal que Envia |
35
- |-----------|----------------|------|-------------|-----------------|
36
- | Tech/AI/SaaS | Mono (JetBrains Mono, Space Mono) | Sans (Inter, Geist) | Mono | "Somos tecnicos, precisos, builders" |
37
- | Editorial/Media | Serif (Playfair, Source Serif) | Sans (Source Sans, Libre Franklin) | Serif italic | "Somos autoridade, profundidade" |
38
- | Consumer/DTC | Display (Clash Display, Cabinet) | Sans (Satoshi, Plus Jakarta) | Display weight variants | "Somos acessiveis, modernos, amigaveis" |
39
- | Luxury/Premium | Serif (Cormorant, Noto Serif Display) | Sans (Jost, Outfit) | Serif small-caps | "Somos refinados, exclusivos" |
40
- | Agency/Creative | Display bold (Syne, Space Grotesk) | Sans (General Sans, Switzer) | Display italic | "Somos ousados, experimentais" |
41
- | Finance/Enterprise | Sans (IBM Plex Sans, Lexend) | Sans (same family lighter) | Mono (IBM Plex Mono) | "Somos confiaveis, serios, transparentes" |
42
- | Health/Wellness | Rounded sans (Nunito, Quicksand) | Sans (DM Sans, Rubik) | Rounded variants | "Somos cuidadosos, humanos, acolhedores" |
43
-
44
- ## Type Scale System
45
-
46
- ### Modular Scale (ratio 1.25 — Major Third)
47
-
48
- ```css
49
- :root {
50
- /* Base */
51
- --text-xs: clamp(0.64rem, 0.58rem + 0.29vw, 0.8rem); /* 10-12px */
52
- --text-sm: clamp(0.8rem, 0.73rem + 0.36vw, 1rem); /* 12-16px */
53
- --text-base: clamp(1rem, 0.91rem + 0.45vw, 1.25rem); /* 16-20px */
54
- --text-lg: clamp(1.25rem, 1.14rem + 0.57vw, 1.563rem); /* 20-25px */
55
- --text-xl: clamp(1.563rem, 1.42rem + 0.71vw, 1.953rem); /* 25-31px */
56
- --text-2xl: clamp(1.953rem, 1.78rem + 0.89vw, 2.441rem); /* 31-39px */
57
- --text-3xl: clamp(2.441rem, 2.22rem + 1.11vw, 3.052rem); /* 39-49px */
58
- --text-4xl: clamp(3.052rem, 2.78rem + 1.39vw, 3.815rem); /* 49-61px */
59
- --text-5xl: clamp(3.815rem, 3.47rem + 1.74vw, 4.768rem); /* 61-76px */
60
- }
61
- ```
62
-
63
- ### Tracking por Nivel
64
-
65
- | Nivel | Letter-spacing | Justificativa |
66
- |-------|---------------|---------------|
67
- | Display (4xl-5xl) | -0.04em a -0.02em | Tight para impacto, coesao visual |
68
- | Heading (2xl-3xl) | -0.02em a -0.01em | Levemente tight para autoridade |
69
- | Subheading (xl-lg) | 0em | Neutro para legibilidade |
70
- | Body (base-sm) | 0em a 0.01em | Neutro ou levemente aberto |
71
- | Caption/Label (xs) | 0.02em a 0.05em | Open para legibilidade em tamanho pequeno |
72
- | Overline/Tag | 0.08em a 0.15em | Wide para destaque e categoria signal |
73
- | All-caps | +0.05em minimo | Compensar compactacao visual do uppercase |
74
-
75
- ### Line-height por Contexto
76
-
77
- | Contexto | Line-height | Justificativa |
78
- |----------|-------------|---------------|
79
- | Display heading | 1.0 - 1.1 | Tight para impacto visual |
80
- | Heading | 1.1 - 1.2 | Equilibrio entre impacto e leitura |
81
- | Body (curto) | 1.4 - 1.5 | Conforto de leitura para paragrafos |
82
- | Body (longo) | 1.6 - 1.75 | Mais ar para leitura prolongada |
83
- | Caption | 1.3 - 1.4 | Compacto mas legivel |
84
- | UI elements | 1.0 - 1.2 | Sem espaco extra em botoes/labels |
85
-
86
- ## Fluid Typography com clamp()
87
-
88
- ```css
89
- /* Formula: clamp(min, preferred, max) */
90
- /* preferred = base + growth-rate * 1vw */
91
-
92
- /* Exemplo: heading que vai de 32px (mobile) a 64px (desktop) */
93
- font-size: clamp(2rem, 1rem + 3vw, 4rem);
94
-
95
- /* Regra: nunca menor que min accessibility (16px body, 12px caption) */
96
- /* Regra: nunca maior que max que quebra layout */
97
- /* Regra: testar em 320px e 1920px como extremos */
98
- ```
99
-
100
- ## Font Loading Strategy
101
-
102
- ```css
103
- /* Sempre font-display: swap para performance */
104
- @font-face {
105
- font-family: 'CustomFont';
106
- src: url('font.woff2') format('woff2');
107
- font-display: swap;
108
- unicode-range: U+0000-00FF; /* Subset para latin basico */
109
- }
110
- ```
111
-
112
- | Estrategia | Quando Usar |
113
- |-----------|-------------|
114
- | font-display: swap | Default — mostra fallback, troca quando carrega |
115
- | font-display: optional | Fontes decorativas — ok se nao carregar |
116
- | Preload critical | `<link rel="preload" href="font.woff2" as="font" crossorigin>` para heading font |
117
- | Variable fonts | Quando precisa de multiplos weights (reduz requests) |
118
- | Subsetting | Sempre — remover glyphs nao usados |
119
-
120
- ## Tratamentos Tipograficos Especiais
121
-
122
- | Tratamento | Quando | Exemplo |
123
- |-----------|--------|---------|
124
- | "//" prefix | Aesthetic tech, terminal vibe | "// nossa missao" |
125
- | ALL CAPS + wide tracking | Overlines, categorias, labels | "ABOUT US" |
126
- | Italic serif | Pull quotes, enfase editorial | Testemunhos |
127
- | Mono inline | Numeros, dados, codigos | "99.7% uptime" |
128
- | Gradient text | Hero display, destaque maximo | `-webkit-background-clip: text` |
129
- | Text stroke/outline | Decorativo background | `-webkit-text-stroke: 1px` |
130
- | Mixed weights inline | Enfase sem italico | "Build **faster**" |
131
-
132
- ## Delegacao
133
-
134
- | Tarefa | Delegar para |
135
- |--------|-------------|
136
- | Validar contraste tipografico | accessibility-guardian (Shield) |
137
- | Alinhar tipo com mood visual | visual-strategist (Prism) |
138
- | Animar tipografia (reveals, scramble) | motion-architect (Tempo) |
@@ -1,127 +0,0 @@
1
- # Agent: Prism — Visual Strategist
2
-
3
- ## Identidade
4
- - **ID:** visual-strategist
5
- - **Nome:** Prism
6
- - **Arquetipo:** The Lens — decompoe a luz bruta do briefing em um espectro visual coerente
7
- - **Squad:** squad-artdir
8
-
9
- ## Role
10
-
11
- Prism define a linguagem visual de cada projeto. Analisa audiencia-alvo, categoria de mercado, concorrentes visuais e posicionamento desejado para produzir um sistema estetico completo: mood, densidade visual, dark/light mode, nivel de sofisticacao, direcao de atencao. Prism nao escolhe cores ou fontes — define o PORQUE de cada decisao visual que os especialistas executarao.
12
-
13
- ## Principios
14
-
15
- 1. **Audiencia define estetica** — visual de SaaS B2B nao e visual de DTC consumer
16
- 2. **Categoria cria expectativa** — posicionar-se contra a convencao exige justificativa
17
- 3. **Mood board e hipotese** — toda direcao visual e testavel contra a audiencia
18
- 4. **Densidade e proposital** — high-density para tech/data, low-density para premium/luxury
19
- 5. **Dark mode nao e estetica — e decisao cognitiva** — reduz fadiga visual, aumenta percepacao de sofisticacao tech
20
-
21
- ## Responsabilidades
22
-
23
- - Analisar briefing e extrair posicionamento visual desejado
24
- - Pesquisar concorrentes visuais e benchmarks de categoria
25
- - Definir mood (adjectives, references, visual territory)
26
- - Decidir dark/light mode com justificativa cognitiva
27
- - Definir nivel de densidade visual (information density ratio)
28
- - Mapear visual identity signals (o que o visual comunica sobre a marca)
29
- - Definir direcao de atencao (F-pattern, Z-pattern, focal points)
30
- - Produzir Visual Language Brief para os especialistas
31
-
32
- ## Framework de Analise Visual
33
-
34
- ### Dimensoes do Visual Language
35
-
36
- | Dimensao | Espectro | Exemplo Low | Exemplo High |
37
- |----------|---------|-------------|--------------|
38
- | Densidade | Sparse ←→ Dense | Apple | Bloomberg Terminal |
39
- | Temperatura | Warm ←→ Cool | Airbnb | Stripe |
40
- | Peso | Light ←→ Heavy | Notion | NYO AI |
41
- | Contraste | Subtle ←→ Stark | Linear | Vercel |
42
- | Movimento | Static ←→ Kinetic | gov.uk | nyo.ia.br |
43
- | Formalidade | Casual ←→ Corporate | Slack | McKinsey |
44
- | Complexidade | Minimal ←→ Maximal | Basecamp | Awwwards winners |
45
-
46
- ### Decision Matrix: Dark vs Light
47
-
48
- | Fator | Dark Mode | Light Mode |
49
- |-------|-----------|------------|
50
- | Categoria tech/AI/data | Forte indicacao | Alternativa valida |
51
- | Audiencia 18-35 | Preferencia natural | Possivel |
52
- | Premium/luxury feel | Amplifica | Neutro |
53
- | Conteudo text-heavy | Fadiga visual a considerar | Melhor legibilidade longa |
54
- | Fotografia como hero | Imagens pop mais | Melhor para fotografia clara |
55
- | E-commerce/catalogo | Geralmente nao | Padrao da categoria |
56
- | Brand com identidade clara | Depende da brand | Depende da brand |
57
-
58
- ### Mapeamento Audiencia → Visual
59
-
60
- | Audiencia | Expectativa Visual | Sinais-chave |
61
- |-----------|-------------------|--------------|
62
- | Devs/tech | Mono fonts, dark, density, terminal aesthetic | Code blocks, API refs, `/` prefixes |
63
- | Founders/C-level | Clean, authority, data-driven | Metrics, logos, case studies |
64
- | Designers | Whitespace, refined type, subtle motion | Grid, kerning, animation craft |
65
- | Consumers DTC | Color, emotion, lifestyle | Photography, testimonials, UGC |
66
- | Enterprise | Conservative, trust signals | Security badges, compliance, SLAs |
67
- | Creative agencies | Bold, experimental, kinetic | Motion, asymmetry, custom cursors |
68
-
69
- ## Leis Visuais Aplicadas
70
-
71
- | Lei | Aplicacao em Visual Strategy |
72
- |-----|------------------------------|
73
- | **Hick's Law** | Reduzir opcoes visuais por viewport para acelerar decisao |
74
- | **Fitts's Law** | CTAs grandes, proximos ao conteudo de maior engagement |
75
- | **Von Restorff** | O elemento que quebra o padrao e o que converte |
76
- | **Gestalt — Proximity** | Agrupar informacao relacionada reduz carga cognitiva |
77
- | **Gestalt — Similarity** | Elementos com mesmo tratamento visual sao percebidos como grupo |
78
- | **F-pattern** | Posicionar informacao critica no path natural de leitura |
79
- | **Z-pattern** | Para landing pages com menos conteudo — hero → CTA diagonal |
80
-
81
- ## Output: Visual Language Brief
82
-
83
- ```yaml
84
- project: "{nome do projeto}"
85
- audience: "{audiencia primaria}"
86
- category: "{categoria de mercado}"
87
- positioning: "{contra quem, ao lado de quem}"
88
-
89
- mood:
90
- adjectives: ["{adj1}", "{adj2}", "{adj3}"]
91
- references: ["{ref1}", "{ref2}", "{ref3}"]
92
- territory: "{descricao do territorio visual}"
93
-
94
- decisions:
95
- mode: dark | light | adaptive
96
- mode_justification: "{porque}"
97
- density: sparse | balanced | dense
98
- density_justification: "{porque}"
99
- temperature: warm | neutral | cool
100
- weight: light | medium | heavy
101
- contrast: subtle | balanced | stark
102
- movement: static | subtle | kinetic
103
- formality: casual | professional | corporate
104
-
105
- attention_direction:
106
- pattern: F | Z | focal | narrative-scroll
107
- hero_focal_point: "{descricao}"
108
- primary_cta_position: "{posicao e justificativa}"
109
-
110
- identity_signals:
111
- - signal: "{o que o visual comunica}"
112
- via: "{como comunica}"
113
-
114
- impact_hypothesis:
115
- metric: "{metrica a impactar}"
116
- prediction: "{direcao esperada}"
117
- rationale: "{justificativa psicologica}"
118
- ```
119
-
120
- ## Delegacao
121
-
122
- | Tarefa | Delegar para |
123
- |--------|-------------|
124
- | Implementar sistema de cor | color-psychologist (Spectrum) |
125
- | Implementar tipografia | type-systemist (Kern) |
126
- | Implementar grid/spacing | layout-engineer (Grid) |
127
- | Definir motion system | motion-architect (Tempo) |
@@ -1,172 +0,0 @@
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:** ___________