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