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.
- package/.claude/CLAUDE.md +10 -4
- package/.claude/hooks/enforce-architecture-first.py +197 -197
- package/.claude/hooks/enforce-git-push-authority.sh +25 -4
- package/.claude/hooks/mind-clone-governance.py +193 -193
- package/.claude/hooks/read-protection.py +152 -152
- package/.claude/hooks/sql-governance.py +183 -183
- package/.claude/hooks/verify-packages.cjs +83 -0
- package/.claude/hooks/write-path-validation.py +195 -195
- package/.claude/rules/hook-governance.md +1 -0
- package/.claude/rules/mandatory-delegation.md +24 -0
- package/.claude/rules/project-intelligence.md +63 -0
- package/.claude/rules/response-format.md +4 -0
- package/.claude/rules/safe-collaboration.md +4 -2
- package/.claude/rules/security-data-protection.md +18 -0
- package/.claude/rules/squad-awareness.md +93 -67
- package/.claude/rules/token-economy.md +148 -0
- package/.codex/agents/analyst.md +90 -0
- package/.codex/agents/architect.md +78 -0
- package/.codex/agents/data-engineer.md +38 -0
- package/.codex/agents/developer.md +97 -0
- package/.codex/agents/devops.md +121 -0
- package/.codex/agents/product-lead.md +27 -0
- package/.codex/agents/project-lead.md +28 -0
- package/.codex/agents/quality-gate.md +89 -0
- package/.codex/agents/sprint-lead.md +28 -0
- package/.codex/agents/squad-creator.md +58 -0
- package/.codex/agents/ux-design-expert.md +28 -0
- package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
- package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
- package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
- package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
- package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
- package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
- package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
- package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
- package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
- package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
- package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
- package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
- package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
- package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
- package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
- package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
- package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
- package/.sinapse-ai/core/doctor/index.js +157 -50
- package/.sinapse-ai/core/ids/registry-updater.js +6 -1
- package/.sinapse-ai/core/logger/index.js +319 -0
- package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
- package/.sinapse-ai/core/telemetry/index.js +247 -0
- package/.sinapse-ai/data/entity-registry.yaml +1384 -944
- package/.sinapse-ai/development/agents/architect.md +5 -0
- package/.sinapse-ai/development/agents/data-engineer.md +38 -0
- package/.sinapse-ai/development/agents/developer.md +28 -0
- package/.sinapse-ai/development/agents/devops.md +4 -0
- package/.sinapse-ai/development/agents/product-lead.md +27 -0
- package/.sinapse-ai/development/agents/project-lead.md +28 -0
- package/.sinapse-ai/development/agents/quality-gate.md +4 -0
- package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
- package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
- package/.sinapse-ai/development/agents/squad-creator.md +58 -0
- package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
- package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
- package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
- package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
- package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
- package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
- package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
- package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
- package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
- package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
- package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
- package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
- package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
- package/.sinapse-ai/development/skills/model-router.md +92 -0
- package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
- package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
- package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
- package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
- package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
- package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
- package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
- package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
- package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
- package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
- package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
- package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
- package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
- package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
- package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
- package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
- package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
- package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
- package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
- package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
- package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
- package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
- package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
- package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
- package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
- package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
- package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
- package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
- package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
- package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
- package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
- package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
- package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
- package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
- package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
- package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
- package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
- package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
- package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
- package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
- package/.sinapse-ai/install-manifest.yaml +275 -140
- package/.sinapse-ai/local-config.yaml.template +65 -65
- package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
- package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
- package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
- package/.sinapse-ai/monitor/hooks/notification.py +30 -30
- package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
- package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
- package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
- package/.sinapse-ai/monitor/hooks/stop.py +30 -30
- package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
- package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
- package/.sinapse-ai/product/templates/adr.hbs +126 -126
- package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
- package/.sinapse-ai/product/templates/epic.hbs +213 -213
- package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
- package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
- package/.sinapse-ai/product/templates/prd.hbs +202 -202
- package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
- package/.sinapse-ai/product/templates/story.hbs +264 -264
- package/.sinapse-ai/product/templates/task.hbs +171 -171
- package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
- package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
- package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
- package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
- package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
- package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
- package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
- package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
- package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
- package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
- package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
- package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
- package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
- package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
- package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
- package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
- package/LICENSE +34 -34
- package/README.en.md +167 -20
- package/README.md +190 -22
- package/bin/cli.js +510 -196
- package/bin/postinstall.js +564 -0
- package/bin/sinapse-cli +283 -283
- package/bin/sinapse-graph.js +9 -0
- package/bin/sinapse-init.js +36 -4
- package/bin/sinapse-minimal.js +20 -9
- package/bin/sinapse.js +202 -122
- package/bin/utils/deprecation-warning.js +46 -0
- package/bin/utils/pre-push-safety.js +14 -0
- package/docs/TELEMETRY.md +131 -0
- package/docs/chrome-brain-upgrade-plan.md +624 -0
- package/docs/framework/orqx-plan.md +1 -1
- package/docs/installation/chrome-brain.md +17 -7
- package/docs/mega-upgrade-orchestration-plan.md +71 -0
- package/docs/pt/contributing.md +20 -0
- package/docs/research-synthesis-for-upgrade.md +511 -0
- package/docs/security-audit-report.md +306 -0
- package/package.json +20 -8
- package/packages/installer/src/config/configure-environment.js +19 -44
- package/packages/installer/src/detection/detect-project-type.js +181 -63
- package/packages/installer/src/installer/manifest-signature.js +32 -17
- package/packages/installer/src/wizard/i18n.js +12 -0
- package/packages/installer/src/wizard/ide-config-generator.js +8 -39
- package/packages/installer/src/wizard/index.js +119 -14
- package/packages/installer/src/wizard/questions.js +2 -3
- package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
- package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
- package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
- package/packages/sinapse-install/bin/edmcp.js +0 -0
- package/packages/sinapse-install/bin/sinapse-install.js +0 -0
- package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
- package/scripts/check-markdown-links.py +353 -353
- package/scripts/coverage-report-summary.js +169 -0
- package/scripts/generate-install-manifest.js +6 -2
- package/scripts/release-readiness.js +169 -0
- package/scripts/test-install-matrix-local.sh +153 -0
- package/scripts/validate-install-docs.js +394 -0
- package/scripts/validate-no-external-refs.js +376 -0
- package/scripts/validate-squad-orqx.js +302 -0
- package/scripts/validate-story-meta.js +263 -0
- package/squads/claude-code-mastery/CHANGELOG.md +1 -1
- package/squads/claude-code-mastery/README.md +2 -2
- package/squads/claude-code-mastery/squad.yaml +1 -1
- package/squads/squad-artdir/README.md +90 -0
- package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
- package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
- package/squads/squad-artdir/agents/color-psychologist.md +166 -0
- package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
- package/squads/squad-artdir/agents/design-system-architect.md +100 -0
- package/squads/squad-artdir/agents/ia-architect.md +169 -0
- package/squads/squad-artdir/agents/interaction-designer.md +162 -0
- package/squads/squad-artdir/agents/layout-engineer.md +163 -0
- package/squads/squad-artdir/agents/motion-architect.md +185 -0
- package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
- package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
- package/squads/squad-artdir/agents/product-surface-director.md +86 -0
- package/squads/squad-artdir/agents/type-systemist.md +138 -0
- package/squads/squad-artdir/agents/visual-strategist.md +127 -0
- package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
- package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
- package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
- package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
- package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
- package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
- package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
- package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
- package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
- package/squads/squad-artdir/package.json +20 -0
- package/squads/squad-artdir/squad.yaml +271 -0
- package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
- package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
- package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
- package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
- package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
- package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
- package/squads/squad-artdir/tasks/design-color-system.md +81 -0
- package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
- package/squads/squad-artdir/tasks/design-token-system.md +58 -0
- package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
- package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
- package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
- package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
- package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
- package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
- package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
- package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
- package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
- package/squads/squad-brand/squad.yaml +20 -6
- package/squads/squad-claude/knowledge-base/context-window-optimization.md +1 -1
- package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +2 -2
- package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
- package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
- package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
- package/squads/squad-content/squad.yaml +187 -27
- package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
- package/squads/squad-copy/squad.yaml +19 -4
- package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
- package/squads/squad-design/squad.yaml +19 -4
- package/.sinapse-ai/core/registry/service-registry.json +0 -6346
- package/.sinapse-ai/data/registry-update-log.jsonl +0 -1323
- package/.sinapse-ai/manifests/agents.csv +0 -29
- package/.sinapse-ai/manifests/tasks.csv +0 -204
- package/.sinapse-ai/manifests/workers.csv +0 -196
- package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
- 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 |
|