sinapse-ai 9.4.0 → 9.5.0

package/squads/squad-artdir/templates/art-direction-brief-template.md

@@ -0,0 +1,215 @@
+# Art Direction Brief: {{project_name}}
+
+**Generated by:** squad-artdir (Canvas)
+**Date:** {{date}}
+**Version:** 1.0
+
+---
+
+## 1. Project Overview
+
+- **Project:** {{project_name}}
+- **Type:** {{landing_page | website | campaign | product_page}}
+- **Client:** {{client_name}}
+- **Objective:** {{primary_conversion_objective}}
+- **URL (if existing):** {{url}}
+
+---
+
+## 2. Audience
+
+### Primary
+- **Description:** {{who they are}}
+- **Demographics:** {{age, role, industry}}
+- **Psychographics:** {{values, motivations, pain points}}
+- **Tech savviness:** {{low | medium | high}}
+- **Visual expectations:** {{what they expect from this category}}
+
+### Secondary (if applicable)
+- **Description:** {{secondary audience}}
+
+---
+
+## 3. Visual Language (Pilar 1)
+
+### Mood
+- **Adjectives:** {{adj1}}, {{adj2}}, {{adj3}}, {{adj4}}, {{adj5}}
+- **References:** {{ref_url_1}}, {{ref_url_2}}, {{ref_url_3}}
+- **Territory:** {{visual territory description}}
+
+### Decisions
+
+| Decision | Value | Psychological Justification |
+|----------|-------|---------------------------|
+| Mode | {{dark / light / adaptive}} | {{justification}} |
+| Density | {{sparse / balanced / dense}} | {{justification}} |
+| Temperature | {{warm / neutral / cool}} | {{justification}} |
+| Weight | {{light / medium / heavy}} | {{justification}} |
+| Contrast | {{subtle / balanced / stark}} | {{justification}} |
+| Movement | {{static / subtle / kinetic}} | {{justification}} |
+
+### Attention Direction
+- **Pattern:** {{F / Z / focal / narrative-scroll}}
+- **Hero focal point:** {{description}}
+- **Primary CTA position:** {{position + justification}}
+
+---
+
+## 4. Color System (Pilar 2)
+
+### Accent
+- **Color:** {{hex}}
+- **Name:** {{descriptive name}}
+- **Neuropsychological rationale:** {{brain science justification}}
+
+### Neutral
+- **Base:** {{hex}}
+- **Hue:** {{true-neutral / warm / cool}}
+
+### Semantic
+- Success: {{hex}} | Warning: {{hex}} | Error: {{hex}} | Info: {{hex}}
+
+### Von Restorff Application
+{{Where accent appears and why — accent ONLY on conversion elements}}
+
+### WCAG Compliance
+| Pair | Ratio | Level |
+|------|-------|-------|
+| CTA text on surface | {{ratio}} | AAA |
+| Body text on surface | {{ratio}} | AA |
+| Caption on surface | {{ratio}} | AA |
+
+---
+
+## 5. Typography (Pilar 3)
+
+### Font Selection
+
+| Role | Font | Justification |
+|------|------|--------------|
+| Heading | {{font}} | {{positioning signal}} |
+| Body | {{font}} | {{readability + category match}} |
+| Accent/Code | {{font}} | {{purpose}} |
+
+### Type Scale
+{{Scale ratio (e.g., Major Third 1.25) + clamp() values}}
+
+### Tracking & Leading
+{{Rules per level — tight headings, normal body, wide labels}}
+
+### Special Treatments
+{{List special typographic treatments with rationale}}
+
+---
+
+## 6. Motion System (Pilar 4)
+
+### Philosophy
+{{What personality does motion express in this project}}
+
+### Library Selection
+- **Primary:** {{GSAP / Framer Motion / CSS}}
+- **Scroll:** {{Lenis / native}}
+- **Justification:** {{why these libs}}
+
+### Hero Technique
+{{Description + implementation approach + Disney principle}}
+
+### Timing Defaults
+| Category | Duration | Easing |
+|----------|----------|--------|
+| Micro | {{range}} | {{easing}} |
+| Entrance | {{range}} | {{easing}} |
+| Exit | {{range}} | {{easing}} |
+| Scroll | scrub | N/A |
+| Ambient | {{range}} | {{easing}} |
+| Stagger | {{value}}ms | N/A |
+
+### Reduced Motion
+{{Fallback strategy for prefers-reduced-motion}}
+
+---
+
+## 7. Information Architecture (Pilar 5)
+
+### Section Sequence
+
+| # | Section | Cognitive Role | Principle | Content |
+|---|---------|---------------|-----------|---------|
+| 1 | {{name}} | {{HOOK}} | {{principle}} | {{content description}} |
+| 2 | {{name}} | {{PROMISE}} | {{principle}} | {{content description}} |
+| ... | ... | ... | ... | ... |
+
+### Retention Devices
+{{Zeigarnik loops, curiosity gaps, progressive disclosure points}}
+
+### Peak & End Moments
+- **Peak:** {{what + where + why}}
+- **End:** {{what + where + why}}
+
+---
+
+## 8. CRO Patterns (Pilar 6)
+
+### Patterns Applied
+
+| Pattern | Location | Principle | Impact Hypothesis |
+|---------|----------|-----------|------------------|
+| {{name}} | {{section}} | {{principle}} | {{metric: direction, rationale}} |
+| ... | ... | ... | ... |
+
+### CTA Strategy
+- **Primary:** {{text + position + style}}
+- **Secondary:** {{text + position + style}}
+- **Sticky:** {{trigger + content}}
+
+### Risk Reversal
+{{How top objections are addressed}}
+
+---
+
+## 9. Layout & Spacing (Pilar 7)
+
+### Grid
+- **Columns:** {{12-column / custom}}
+- **Max width:** {{value}}
+- **Gutter:** {{value per breakpoint}}
+
+### Spacing Scale
+{{4px baseline with section spacing 96-192px}}
+
+### Full-bleed vs Contained
+{{Per section decision with rationale}}
+
+### Responsive Strategy
+{{Mobile-first with breakpoints at 640, 1024, 1440px}}
+
+---
+
+## 10. Accessibility
+
+- **WCAG target:** {{AA / AAA}}
+- **Reduced motion:** mandatory fallbacks for all animations
+- **Color blindness:** verified safe
+- **Keyboard nav:** complete
+- **Screen reader:** tested
+- **Skip link:** present
+
+---
+
+## 11. Impact Hypotheses
+
+| Metric | Prediction | Rationale |
+|--------|-----------|-----------|
+| {{metric}} | {{direction + estimated %}} | {{psychological principle}} |
+| ... | ... | ... |
+
+---
+
+## 12. Implementation Notes
+
+{{Technical considerations, performance budgets, browser support, dependencies}}
+
+---
+
+*Generated by squad-artdir | Every pixel carries behavioral intent*

package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml

@@ -0,0 +1,78 @@
+name: conversion-audit-cycle
+version: "1.0.0"
+description: >
+  Auditoria de conversao de site/LP existente com diagnostico contra os 7 pilares,
+  audit de padroes CRO, e recomendacoes priorizadas por impacto/esforco.
+
+trigger: audit_request | cross_squad_request
+
+phases:
+  - id: diagnose
+    name: "Diagnostico Visual"
+    agent: visual-strategist
+    task: diagnose-visual-language
+    description: "Analisa a linguagem visual atual contra os 7 pilares"
+    inputs:
+      - url
+      - audience
+      - category
+      - objective
+    outputs:
+      - diagnostic_report
+      - pillar_scores
+      - top_gaps
+
+  - id: audit-cro
+    name: "Auditoria CRO"
+    agent: cro-persuasion
+    task: audit-conversion
+    description: "Audita padroes de conversao e identifica gaps"
+    depends_on: [diagnose]
+    inputs:
+      - url
+      - objective
+      - audience
+      - current_metrics (optional)
+    outputs:
+      - audit_report
+      - dimension_scores
+      - recommendations
+      - quick_wins
+
+  - id: synthesize
+    name: "Sintese e Priorizacao"
+    agent: artdir-orqx
+    description: "Consolida diagnostico visual + audit CRO em relatorio unico priorizado"
+    depends_on: [diagnose, audit-cro]
+    inputs:
+      - diagnostic_report
+      - audit_report
+      - pillar_scores
+      - dimension_scores
+    outputs:
+      - consolidated_report
+      - prioritized_actions
+      - quick_wins_final
+    sub_routing:
+      - ia-architect: IA recommendations
+      - accessibility-guardian: WCAG gaps
+
+  - id: recommend
+    name: "Recomendacoes de Art Direction"
+    agent: artdir-orqx
+    description: "Produz recomendacoes de art direction para corrigir os gaps"
+    depends_on: [synthesize]
+    condition: "overall_score < 7 OR client requests full brief"
+    inputs:
+      - consolidated_report
+      - prioritized_actions
+    outputs:
+      - art_direction_recommendations
+      - before_after_descriptions
+      - impact_hypotheses
+
+quality_gates:
+  - every_recommendation_has_impact_hypothesis: true
+  - every_recommendation_has_effort_estimate: true
+  - quick_wins_are_actionable_in_1_day: true
+  - scores_are_justified: true

package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml

@@ -0,0 +1,98 @@
+name: full-art-direction-cycle
+version: "1.0.0"
+description: >
+  Ciclo completo de art direction — do briefing ao art direction brief
+  validado contra os 7 pilares. Produz os 8 deliverables padrao.
+
+trigger: user_briefing | cross_squad_request
+
+phases:
+  - id: diagnose
+    name: "Diagnostico Visual"
+    agent: visual-strategist
+    task: diagnose-visual-language
+    description: "Analisa estado atual (se URL) ou requisitos (se briefing)"
+    inputs:
+      - url (optional)
+      - briefing
+      - audience
+      - category
+      - objective
+    outputs:
+      - diagnostic_report
+      - pillar_scores
+    skip_if: "no URL provided AND project is greenfield"
+
+  - id: brief
+    name: "Art Direction Brief"
+    agent: artdir-orqx
+    task: create-art-direction-brief
+    description: "Gera o Art Direction Brief completo com todos os 8 deliverables"
+    depends_on: [diagnose]
+    inputs:
+      - briefing
+      - audience
+      - category
+      - objective
+      - diagnostic_report (from diagnose)
+    outputs:
+      - art_direction_brief
+      - design_tokens
+      - motion_spec
+      - wireflow
+      - component_spec
+      - cro_map
+      - implementation_guide
+      - validation_checklist
+    sub_routing:
+      - visual-strategist: visual language, mood
+      - color-psychologist: color system
+      - type-systemist: typography
+      - motion-architect: motion system
+      - ia-architect: information architecture
+      - cro-persuasion: CRO patterns
+      - layout-engineer: grid and spacing
+      - interaction-designer: micro-interactions
+
+  - id: validate
+    name: "Validacao 7 Pilares"
+    agent: artdir-orqx
+    task: validate-against-pillars
+    description: "Valida todos os deliverables contra os 7 pilares + WCAG + performance"
+    depends_on: [brief]
+    inputs:
+      - art_direction_brief
+      - design_tokens
+      - motion_spec
+      - wireflow
+      - cro_map
+    outputs:
+      - validation_report
+      - verdict
+    sub_routing:
+      - accessibility-guardian: WCAG validation
+    decision:
+      PASS: "Entrega os 8 deliverables como output final"
+      CONCERNS: "Entrega com concerns documentados"
+      FAIL: "Retorna ao phase brief com remediation list"
+
+  - id: remediate
+    name: "Remediacao"
+    agent: artdir-orqx
+    task: create-art-direction-brief
+    description: "Corrige gaps identificados na validacao"
+    depends_on: [validate]
+    condition: "verdict == FAIL"
+    max_iterations: 2
+    inputs:
+      - remediation list from validate
+      - original briefing
+    outputs:
+      - updated deliverables
+
+quality_gates:
+  - every_decision_cites_principle: true
+  - wcag_aaa_ctas: true
+  - reduced_motion_coverage: "100%"
+  - mobile_first: true
+  - impact_hypotheses: true

package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml

@@ -0,0 +1,174 @@
+name: saas-platform-art-direction-cycle
+version: "1.0.0"
+description: >
+  Ciclo completo de art direction para SaaS / plataformas / produtos logados.
+  Diferente do full-art-direction-cycle (LP-focused), este workflow otimiza
+  para ergonomia cognitiva de uso diario + design system multi-surface +
+  premium packaging. Ativa os 10 Pilares (7 originais + 3 novos) com
+  Axiom, Atlas, Vertex e Aura como agentes primarios.
+
+trigger: user_briefing | cross_squad_request
+
+pillars_activated: [1, 2, 3, 4, 5, 7, 8, 9, 10]
+# Pilar 6 (CRO) fica PARTIAL — ativa so no pricing page e upgrade paths
+# Pilar 4 (Motion) fica PARTIAL — motion proposital, nao marketing flash
+
+phases:
+  - id: canon-consult
+    name: "Consulta ao Canon SaaS"
+    agent: platform-aesthetic-director
+    task: consult-saas-canon
+    description: "Vertex consulta o canon das 6 refs e retorna category-fit + principios extraidos"
+    inputs:
+      - product_category
+      - audience
+      - positioning
+      - pricing_posture
+      - proposed_references (optional)
+    outputs:
+      - canon_consultation
+      - category_fit_matrix
+      - custom_craft_candidates
+      - commodity_audit_result
+    blocking: "Se commodity_audit_result == FAIL, escalar para Aura e bloquear o ciclo ate remediar"
+
+  - id: token-system
+    name: "Design System Multi-Surface"
+    agent: design-system-architect
+    task: design-token-system
+    description: "Atlas desenha o sistema canonico de tokens e dialetos por surface"
+    depends_on: [canon-consult]
+    inputs:
+      - brand_tokens
+      - target_surfaces
+      - product_context
+      - canon_consultation (from canon-consult)
+    outputs:
+      - canonical_tokens
+      - surface_dialects
+      - token_registry
+      - versioning_protocol
+    sub_routing:
+      - color-psychologist: color tokens
+      - type-systemist: type tokens
+      - motion-architect: motion tokens
+      - layout-engineer: spacing tokens
+
+  - id: product-surface
+    name: "Art Direction de Surfaces Logadas"
+    agent: product-surface-director
+    task: design-product-surface
+    description: "Axiom desenha cada surface logada principal aplicando o Pilar 8"
+    depends_on: [token-system]
+    inputs:
+      - existing_tokens (from token-system)
+      - personas
+      - dark_mode_priority
+      - density_target
+    outputs:
+      - product_surface_brief
+      - empty_state_spec
+      - dark_mode_spec
+      - token_requests
+    sub_routing:
+      - ia-architect: disclosure e cognitive zones
+      - layout-engineer: grid e densidade
+      - interaction-designer: hover e micro-interactions
+    iterate_per_surface: true
+
+  - id: first-5-minutes
+    name: "First 5 Minutes Choreography"
+    agent: product-surface-director
+    co_agent: premium-packaging-strategist
+    task: first-5-minutes-choreography
+    description: "Axiom + Aura desenham a choreographia de onboarding (arrival, ceremony, orientation, first value, activation)"
+    depends_on: [product-surface]
+    inputs:
+      - product
+      - activation_metric
+      - premium_positioning
+    outputs:
+      - first_5_minutes_spec
+      - arrival_screen_design
+      - ceremony_spec
+      - first_value_experience
+      - activation_punctuation
+      - motion_budget
+
+  - id: premium-packaging
+    name: "Premium Packaging Brief"
+    agent: premium-packaging-strategist
+    task: create-premium-packaging-brief
+    description: "Aura entrega o brief completo de packaging premium aplicando os 5 principios nao-negociaveis"
+    depends_on: [canon-consult, token-system, product-surface, first-5-minutes]
+    inputs:
+      - product
+      - target_price
+      - competitor_price
+      - canon_consultation
+      - canonical_tokens
+      - first_5_minutes_spec
+    outputs:
+      - premium_packaging_brief
+      - custom_craft_spec
+      - friction_point_design
+      - restraint_audit
+      - pillar_10_checklist
+    sub_routing:
+      - type-systemist: custom type craft (se selecionado)
+      - motion-architect: motion signature (se selecionado)
+      - cro-persuasion: friction point no funil
+    blocking: "Aura bloqueia se 5 diagnostic questions nao forem respondidas"
+
+  - id: drift-audit
+    name: "Auditoria de Drift Multi-Surface"
+    agent: design-system-architect
+    task: audit-drift-multi-surface
+    description: "Atlas audita drift entre surfaces deployadas (se existem) contra os tokens canonicos"
+    depends_on: [token-system]
+    skip_if: "greenfield project"
+    inputs:
+      - product_url
+      - canonical_tokens
+      - surfaces_to_audit
+    outputs:
+      - drift_inventory
+      - remediation_priorities
+      - premium_impact_report
+
+  - id: validate
+    name: "Validacao 10 Pilares"
+    agent: artdir-orqx
+    task: validate-against-pillars
+    description: "Canvas valida todos os deliverables contra os 10 pilares (7 originais + 3 novos)"
+    depends_on: [canon-consult, token-system, product-surface, first-5-minutes, premium-packaging]
+    inputs:
+      - all previous phase outputs
+    outputs:
+      - validation_report
+      - verdict
+    sub_routing:
+      - accessibility-guardian: WCAG validation
+      - platform-aesthetic-director: canon adherence check
+    decision:
+      PASS: "Entrega os deliverables como output final"
+      CONCERNS: "Entrega com concerns documentados"
+      FAIL: "Retorna ao phase relevante com remediation list"
+
+  - id: remediate
+    name: "Remediacao"
+    agent: artdir-orqx
+    description: "Corrige gaps identificados na validacao"
+    depends_on: [validate]
+    condition: "verdict == FAIL"
+    max_iterations: 2
+
+quality_gates:
+  - commodity_audit_passed: true
+  - canonical_tokens_defined: true
+  - billing_pdf_and_email_in_surface_inventory: true
+  - dark_mode_parity: true
+  - custom_craft_element_identified: true
+  - first_5_minutes_choreography_documented: true
+  - five_premium_principles_honored: true
+  - pillar_8_9_10_validated: true