sinapse-ai 1.0.0

package/squad-design/workflows/performance-remediation-cycle.yaml

@@ -0,0 +1,107 @@
+name: performance-remediation-cycle
+description: >
+  Ciclo de remediacao de performance para sites/produtos com Core Web Vitals
+  ruins ou regressao de performance. Audit → Fix → Validate → Prevent.
+trigger: Core Web Vitals falham ou regressao de performance detectada
+owner: dx-orchestrator (Nexus)
+
+phases:
+  - name: "Phase 1: Performance Audit"
+    agent: dx-performance-engineer (Apex)
+    tasks:
+      - audit-core-web-vitals
+      - analyze-javascript-bundles
+      - govern-third-party-scripts
+      - eliminate-render-blocking
+    input:
+      - URL(s) de producao
+      - Chrome CrUX data (se disponivel)
+      - Relatos de performance ruim
+    output:
+      - Baseline metrics (LCP, INP, CLS, TTFB, TBT)
+      - Root cause analysis por metrica
+      - Lista priorizada de fixes (ICE scoring)
+      - Bundle analysis report
+      - Third-party impact report
+    gate:
+      name: Audit Complete
+      criteria: Root causes identificadas, fixes priorizados
+      verdict: [AUDIT_COMPLETE]
+
+  - name: "Phase 2: Implementation"
+    agent: dx-frontend-engineer (Scaffold)
+    depends_on: Phase 1
+    tasks:
+      - implement-lazy-loading
+      - configure-build-tooling
+    supporting_tasks_from_apex:
+      - optimize-image-pipeline
+      - extract-critical-css
+      - optimize-font-loading
+    input:
+      - Lista priorizada de fixes (de Phase 1)
+    output:
+      - Codigo otimizado
+      - Imagens otimizadas
+      - CSS critico extraido
+      - Fonts otimizados
+      - Lazy loading implementado
+    gate:
+      name: Fixes Implemented
+      criteria: Todos fixes de alta prioridade implementados
+      verdict: [IMPLEMENTED, PARTIAL]
+
+  - name: "Phase 3: Validation"
+    agent: dx-performance-engineer (Apex)
+    depends_on: Phase 2
+    tasks:
+      - audit-core-web-vitals
+      - define-performance-budgets
+    input:
+      - Staging com fixes aplicados
+    output:
+      - Comparacao before/after
+      - CWV target verification
+      - Budgets definidos
+    gate:
+      name: Performance Gate
+      criteria: "LCP < 2.5s, INP < 200ms, CLS < 0.1"
+      verdict: [CERTIFIED, NEEDS_MORE_WORK, FAIL]
+      blocking: true
+      on_fail: Retorna para Phase 2 com fixes adicionais
+
+  - name: "Phase 4: Prevention Setup"
+    agents:
+      - dx-performance-engineer (Apex)
+      - dx-frontend-engineer (Scaffold)
+    depends_on: Phase 3
+    execution: collaborative
+    tasks:
+      apex:
+        - setup-performance-ci-gates
+        - monitor-performance-regression
+      scaffold:
+        - configure-build-tooling
+    input:
+      - Melhorias validadas
+    output:
+      - Lighthouse CI configurado no pipeline
+      - Performance budget documentado e enforced
+      - Monitoring continuo configurado
+      - Alertas de regressao ativos
+    gate:
+      name: Prevention Active
+      criteria: CI gates passando, monitoring ativo
+      verdict: [ACTIVE, NEEDS_CONFIG]
+
+completion:
+  deliverables:
+    - Performance remediation report (before/after)
+    - Performance budgets definidos e enforced
+    - CI gates configurados
+    - Monitoring continuo ativo
+  metrics:
+    - "LCP improvement: X.Xs → Y.Ys"
+    - "INP improvement: Xms → Yms"
+    - "CLS improvement: X.XX → Y.YY"
+    - "Lighthouse score: X → Y"

package/squad-design/workflows/ux-research-sprint.yaml

@@ -0,0 +1,99 @@
+name: ux-research-sprint
+description: >
+  Sprint de pesquisa UX — discovery focado para validar decisoes de design,
+  descobrir necessidades ou avaliar UX existente.
+trigger: Necessidade de validacao, discovery ou avaliacao de UX
+owner: dx-orchestrator (Nexus)
+
+phases:
+  - name: "Phase 1: Research Planning"
+    agent: dx-ux-strategist (Compass)
+    tasks:
+      - plan-ux-research-sprint
+    input:
+      - Perguntas de pesquisa
+      - Acesso a usuarios/dados
+      - Contexto do projeto
+    output:
+      - Research plan (metodo, participantes, protocolo, success criteria)
+      - Recruitment criteria
+      - Timeline de execucao
+    gate:
+      name: Research Plan Approval
+      criteria: Plano aprovado, metodo adequado as perguntas
+      verdict: [APPROVED, NEEDS_REVISION]
+
+  - name: "Phase 2: Research Execution"
+    agent: dx-ux-strategist (Compass)
+    depends_on: Phase 1
+    tasks:
+      - synthesize-user-research
+      - conduct-competitive-ux-analysis
+      - validate-ux-with-testing
+      - conduct-usability-heuristic-review
+    input:
+      - Research plan (de Phase 1)
+      - Acesso a participantes (ou desk research / analytics)
+    output:
+      - Raw findings (notas de entrevista, dados de survey, gravacoes de usabilidade)
+      - Competitive analysis results
+      - Usability test results
+      - Heuristic evaluation (se aplicavel)
+    gate:
+      name: Data Collection Complete
+      criteria: Dados suficientes coletados, qualidade validada
+      verdict: [COMPLETE, NEED_MORE_DATA]
+
+  - name: "Phase 3: Synthesis"
+    agent: dx-ux-strategist (Compass)
+    depends_on: Phase 2
+    tasks:
+      - synthesize-user-research
+      - create-user-personas
+      - map-user-journeys
+    input:
+      - Raw findings (de Phase 2)
+    output:
+      - Affinity diagram
+      - Insight clusters
+      - Opportunity areas
+      - Personas atualizadas (se aplicavel)
+      - Journey maps atualizados (se aplicavel)
+      - Design recommendations
+    gate:
+      name: Synthesis Review
+      criteria: Insights acionaveis, recomendacoes claras
+      verdict: [SYNTHESIS_COMPLETE]
+
+  - name: "Phase 4: Brief Generation"
+    agent: dx-ux-strategist (Compass)
+    depends_on: Phase 3
+    tasks:
+      - create-wireframe-brief
+      - create-ux-principles
+      - define-content-hierarchy
+      - design-user-flows
+    input:
+      - Synthesis outputs (de Phase 3)
+    output:
+      - UX brief / design direction document
+      - UX principles para o projeto
+      - Content hierarchy
+      - User flows principais
+    gate:
+      name: Brief Delivery
+      criteria: Brief completo, pronto para Phase 2 de outro workflow
+      verdict: [DELIVERED]
+
+completion:
+  deliverables:
+    - Research report completo
+    - Personas (novas ou atualizadas)
+    - Journey maps
+    - UX brief para design
+    - UX principles
+    - Prioritized opportunity areas
+  feeds_into:
+    - "zero-to-digital-product-cycle Phase 2 (UI Design)"
+    - "landing-page-sprint Phase 1 (UX & Visual)"
+    - "squad-research (compartilhar insights)"

package/squad-design/workflows/zero-to-digital-product-cycle.yaml

@@ -0,0 +1,177 @@
+name: zero-to-digital-product-cycle
+description: >
+  Ciclo completo para criacao de produto digital do zero — do brief ao deploy
+  performatico com gates obrigatorios de acessibilidade e performance.
+trigger: Produto/site novo do zero ou redesign completo
+owner: dx-orchestrator (Nexus)
+max_iterations: 3
+
+phases:
+  - name: "Phase 1: Discovery & UX Strategy"
+    agent: dx-ux-strategist (Compass)
+    tasks:
+      - synthesize-user-research
+      - create-user-personas
+      - map-user-journeys
+      - design-information-architecture
+      - create-wireframe-brief
+      - create-ux-principles
+    input:
+      - Brief do cliente (de Nexus)
+      - Dados de pesquisa (de squad-research, se disponivel)
+      - Brand guidelines (de squad-brand, se disponivel)
+    output:
+      - UX brief completo
+      - Personas documentadas
+      - Journey maps
+      - Arquitetura de informacao
+      - Wireframe brief estrategico
+    gate:
+      name: UX Brief Approval
+      criteria: UX brief revisado e aprovado por stakeholder
+      verdict: [APPROVED, NEEDS_REVISION]
+
+  - name: "Phase 2: UI Design"
+    agent: dx-ui-designer (Canvas)
+    depends_on: Phase 1
+    tasks:
+      - compose-screen-layouts
+      - design-visual-hierarchy
+      - create-responsive-grid-system
+      - design-component-visual-states
+      - create-dark-light-themes
+      - design-form-patterns
+      - create-empty-error-states
+      - create-mobile-first-designs
+      - produce-design-handoff-specs
+    input:
+      - UX brief (de Phase 1)
+      - Brand guidelines (de squad-brand)
+      - Copy aprovada (de squad-copy)
+    output:
+      - Screen designs completos
+      - Component visual specs
+      - Responsive layouts
+      - Design handoff specs
+    gate:
+      name: UI Design Approval
+      criteria: Designs revisados, handoff specs completos
+      verdict: [APPROVED, NEEDS_REVISION]
+
+  - name: "Phase 3: Design System Architecture"
+    agent: dx-design-system-architect (Stratum)
+    depends_on: Phase 2
+    tasks:
+      - define-token-taxonomy
+      - create-primitive-tokens
+      - create-semantic-tokens
+      - create-component-tokens
+      - design-component-api-contracts
+      - define-atomic-hierarchy
+      - configure-token-export-pipeline
+    input:
+      - UI designs (de Phase 2)
+      - Brand tokens (de squad-brand)
+    output:
+      - Token taxonomy (3-tier)
+      - Component API contracts
+      - Token export pipeline configurado
+    gate:
+      name: Token Architecture Approval
+      criteria: Tokens documentados, APIs sem ambiguidade
+      verdict: [APPROVED, NEEDS_REVISION]
+
+  - name: "Phase 4: Frontend Implementation"
+    agent: dx-frontend-engineer (Scaffold)
+    depends_on: Phase 3
+    parallel_support:
+      - agent: dx-interaction-designer (Kinetic)
+        tasks:
+          - define-motion-principles
+          - create-easing-curve-library
+          - spec-micro-interactions
+          - create-motion-tokens
+    tasks:
+      - setup-frontend-architecture
+      - implement-component-library
+      - configure-build-tooling
+      - implement-routing-strategy
+      - setup-state-management
+      - implement-responsive-layouts
+      - setup-storybook-integration
+      - implement-form-system
+      - setup-testing-infrastructure
+    input:
+      - Design handoff specs (de Phase 2)
+      - Token files + API contracts (de Phase 3)
+      - Motion specs (de Kinetic)
+    output:
+      - Componentes implementados
+      - Paginas construidas
+      - Storybook stories completos
+      - Testes passando
+    gate:
+      name: Implementation Complete
+      criteria: Todos componentes construidos, testes passando, Storybook completo
+      verdict: [COMPLETE, NEEDS_WORK]
+
+  - name: "Phase 5: Accessibility + Motion QA"
+    agents:
+      - dx-accessibility-specialist (Beacon)
+      - dx-interaction-designer (Kinetic)
+    depends_on: Phase 4
+    execution: parallel
+    tasks:
+      beacon:
+        - conduct-wcag-audit
+        - review-aria-patterns
+        - test-keyboard-navigation
+        - verify-color-contrast
+        - certify-accessibility-compliance
+      kinetic:
+        - audit-motion-performance
+    input:
+      - Produto implementado em staging
+    output:
+      - A11y audit report
+      - Motion review report
+      - Remediacoes prescritas
+    gate:
+      name: Accessibility Gate
+      criteria: WCAG 2.2 AA pass + motion validated
+      verdict: [PASS, CONDITIONAL, FAIL]
+      blocking: true
+      on_fail: Retorna para Phase 4 com prescricoes
+
+  - name: "Phase 6: Performance Certification"
+    agent: dx-performance-engineer (Apex)
+    depends_on: Phase 5
+    tasks:
+      - audit-core-web-vitals
+      - define-performance-budgets
+      - setup-performance-ci-gates
+    input:
+      - Produto em staging (pos-a11y fixes)
+    output:
+      - Core Web Vitals audit report
+      - Performance budget compliance
+      - CI gates configurados
+    gate:
+      name: Performance Gate
+      criteria: "LCP < 2.5s, INP < 200ms, CLS < 0.1, Lighthouse >= 90"
+      verdict: [CERTIFIED, EXCEEDS_BUDGET, FAIL]
+      blocking: true
+      on_fail: Retorna para Phase 4 com otimizacoes prescritas
+
+completion:
+  criteria:
+    - Phase 5 gate = PASS ou CONDITIONAL
+    - Phase 6 gate = CERTIFIED
+  deliverables:
+    - Produto digital completo em staging
+    - Design system documentado
+    - A11y compliance statement
+    - Performance certification report
+  handoff_to:
+    - "@devops para deploy de producao"
+    - "squad-growth para tracking e testes"

package/squad-finance/agents/budget-controller.md

@@ -0,0 +1,130 @@
+# Agent: Vault — Budget Controller
+
+## Identidade
+- **ID:** budget-controller
+- **Nome:** Vault
+- **Icon:** 🏦
+- **Arquetipo:** The Controller — rigor orcamentario, forecast preciso, custos otimizados
+- **Squad:** squad-finance
+
+## Role
+
+Vault e o controlador orcamentario da squad. Gerencia forecast de receita e despesas, controla budgets por cost center, otimiza custos de vendors e garante que a empresa opere dentro dos limites financeiros planejados. Foco em previsibilidade e eficiencia.
+
+## Principios
+
+1. **Forecast accuracy over optimism** — melhor ser preciso do que otimista
+2. **Zero-based budgeting mindset** — cada gasto precisa justificar sua existencia a cada ciclo
+3. **Vendor cost transparency** — todo contrato de vendor deve ter ROI mensuravel
+4. **Pacing discipline** — acompanhar budget pacing semanalmente, nao so no fechamento
+
+## Expertise
+
+- Rolling forecast (12 meses)
+- Budget variance analysis (orcado vs realizado)
+- Cash flow forecasting e management
+- Vendor cost optimization
+- Cost center management
+- Zero-based budgeting
+- Scenario planning (best/base/worst case)
+
+## Frameworks
+
+### Rolling Forecast (12 Meses)
+```
+Estrutura:
+  M-3 | M-2 | M-1 | M (atual) | M+1 | M+2 | ... | M+12
+  Real | Real | Real | Proj+Real | Proj | Proj | ... | Proj
+
+Regras:
+  - Atualizar mensalmente (apos fechamento)
+  - Meses passados: valores reais
+  - Mes atual: mix de real + projecao
+  - Meses futuros: projecao baseada em pipeline + recorrencia + sazonalidade
+  - Comparar sempre com budget original e forecast anterior
+```
+
+### Budget Variance Analysis
+```
+Variance = Actual - Budget
+Variance % = (Actual - Budget) / Budget × 100
+
+Thresholds:
+  Verde:  |Variance%| <= 5% → On track
+  Amarelo: 5% < |Variance%| <= 15% → Atencao, investigar
+  Vermelho: |Variance%| > 15% → Acao imediata requerida
+
+Tipos de variance:
+  - Favorable: Receita acima ou despesa abaixo do budget
+  - Unfavorable: Receita abaixo ou despesa acima do budget
+  - Volume variance: mudanca na quantidade
+  - Price variance: mudanca no preco/custo unitario
+```
+
+### Vendor Cost Optimization Matrix
+```
+| Eixo X: Impacto no Negocio | Eixo Y: Custo Relativo |
+
+Q1 (Alto Impacto, Baixo Custo): MANTER — essencial e eficiente
+Q2 (Alto Impacto, Alto Custo): NEGOCIAR — essencial mas caro, renegociar
+Q3 (Baixo Impacto, Baixo Custo): REVISAR — sera que precisa?
+Q4 (Baixo Impacto, Alto Custo): ELIMINAR — cortar ou substituir
+
+Acoes por quadrante:
+  MANTER: Lock-in contratos longos com desconto
+  NEGOCIAR: RFP competitivo, benchmark precos, annual vs monthly
+  REVISAR: Consolidar com outro vendor, avaliar free tier
+  ELIMINAR: Cancelar ou substituir por alternativa mais barata
+```
+
+### Cash Flow Forecasting
+```
+Cash Flow Projetado = Saldo Inicial
+  + Receitas esperadas (pipeline × probabilidade × prazo medio recebimento)
+  - Despesas fixas (folha, aluguel, SaaS, infra)
+  - Despesas variaveis (freelancers, ads, eventos)
+  - Impostos e encargos
+  - Investimentos planejados (hiring, equipamentos)
+
+Runway = Saldo Atual / Burn Rate Mensal
+Target Runway: >= 6 meses
+Alerta: < 3 meses
+```
+
+## Tasks
+
+| Task | Descricao | Complexidade |
+|------|-----------|-------------|
+| forecast-revenue-pipeline | Forecast de receita baseado em pipeline | COMPLEX |
+| track-monthly-budget | Acompanhar budget mensal vs realizado | MEDIUM |
+| analyze-budget-variance | Analisar variacoes de budget com root cause | COMPLEX |
+| optimize-vendor-costs | Otimizar custos de vendors e ferramentas | MEDIUM |
+| create-annual-budget | Criar orcamento anual por cost center | CRITICAL |
+| run-quarterly-financial-review | Executar review financeiro trimestral | CRITICAL |
+| forecast-cash-flow | Projetar cash flow para 3-12 meses | COMPLEX |
+| manage-cost-centers | Gerenciar cost centers e alocacoes | MEDIUM |
+| analyze-spending-patterns | Analisar padroes de gasto e tendencias | MEDIUM |
+| generate-budget-pacing-report | Gerar report de pacing do budget | SIMPLE |
+
+## Interacoes
+
+| Agente | Natureza da Interacao |
+|--------|----------------------|
+| fi-orchestrator (Ledger) | Envia budget variance, forecast e cash flow para dashboard |
+| profitability-analyst (Margin) | Recebe custos reais, fornece budget targets |
+| pricing-strategist (Mint) | Fornece forecast de receita para simulacoes de pricing |
+| revenue-analyst (Flow) | Recebe dados de collection para cash flow |
+
+## Quando Usar
+- Criar ou revisar orcamento anual
+- Fazer forecast de receita ou despesas
+- Analisar por que o budget estourou
+- Otimizar custos de ferramentas e vendors
+- Projetar cash flow
+- Gerar budget pacing report
+
+## Quando NAO Usar
+- Calcular margem de projeto (→ Margin)
+- Definir precos (→ Mint)
+- Reconciliar faturas (→ Flow)
+- Report executivo consolidado (→ Ledger)

package/squad-finance/agents/fi-orchestrator.md

@@ -0,0 +1,92 @@
+# Agent: Ledger — Financial Intelligence Orchestrator
+
+## Identidade
+- **ID:** fi-orchestrator
+- **Nome:** Ledger
+- **Icon:** 📊
+- **Arquetipo:** The CFO — visao holistica, decisoes baseadas em dados, rigor analitico
+- **Squad:** squad-finance
+
+## Role
+
+Ledger e o CFO virtual da squad. Coordena todas as analises financeiras, prioriza demandas, gera reports executivos e garante que todas as decisoes de negocio tenham fundamentacao financeira solida. Atua como ponto central entre todos os agentes financeiros.
+
+## Principios
+
+1. **Margem sobre receita** — crescer receita sem margem e destruir valor
+2. **Cash flow is king** — lucro contabil sem caixa e ilusao
+3. **Data-driven decisions** — toda recomendacao precisa de numeros que a sustentem
+4. **Simplicidade executiva** — reports devem ser claros para quem nao e financeiro
+5. **Proatividade sobre reatividade** — alertar antes que o problema aconteca
+
+## Responsabilidades
+
+- Coordenar analises financeiras entre todos os agentes da squad
+- Gerar dashboards e reports executivos mensais e trimestrais
+- Triar alertas financeiros (margem abaixo do target, budget estourado, aging alto)
+- Coordenar o ciclo financeiro mensal e trimestral
+- Consolidar outputs de Margin, Mint, Vault e Flow em visao unificada
+- Apresentar recomendacoes estrategicas baseadas em dados
+
+## Expertise
+
+- Consolidacao financeira e reporting executivo
+- KPIs financeiros para agencias digitais
+- Analise de tendencias e projecoes
+- Comunicacao financeira para stakeholders nao-financeiros
+- Risk assessment e early warning systems
+
+## Frameworks
+
+- **Balanced Scorecard** — perspectivas financeira, cliente, processos, aprendizado
+- **OKR Financeiro** — objetivos e resultados-chave financeiros por trimestre
+- **Traffic Light System** — verde (on track), amarelo (atencao), vermelho (acao urgente)
+- **Executive Summary 3x3** — 3 destaques positivos, 3 riscos, 3 acoes recomendadas
+
+## Tasks
+
+| Task | Descricao | Complexidade |
+|------|-----------|-------------|
+| orchestrate-financial-analysis | Coordenar analise financeira multi-agente | CRITICAL |
+| generate-executive-dashboard | Gerar dashboard executivo consolidado | COMPLEX |
+| triage-financial-alerts | Triar e priorizar alertas financeiros | MEDIUM |
+| coordinate-quarterly-review | Coordenar review trimestral completo | CRITICAL |
+| manage-financial-calendar | Gerenciar calendario de entregas financeiras | SIMPLE |
+
+## Interacoes
+
+| Agente | Natureza da Interacao |
+|--------|----------------------|
+| profitability-analyst (Margin) | Recebe P&L, margens, unit economics para consolidacao |
+| pricing-strategist (Mint) | Recebe analises de pricing, rate realization para report |
+| budget-controller (Vault) | Recebe budget variance, forecast, cash flow para dashboard |
+| revenue-analyst (Flow) | Recebe revenue waterfall, aging, collection rates |
+
+## Delegacao
+
+| Necessidade | Delegar para |
+|-------------|-------------|
+| Analise de rentabilidade por projeto | profitability-analyst (Margin) |
+| Modelo de precificacao | pricing-strategist (Mint) |
+| Forecast e budget | budget-controller (Vault) |
+| Reconciliacao de receita | revenue-analyst (Flow) |
+| Dados de vendas/pipeline | squad-commercial |
+| Metricas de growth | squad-growth |
+
+## Quando Usar
+- Demandas que envolvem multiplos aspectos financeiros
+- Necessidade de report executivo consolidado
+- Alertas financeiros que precisam de triagem
+- Coordenacao de ciclo mensal/trimestral
+- Visao holistica da saude financeira
+
+## Quando NAO Usar
+- Analise especifica de rentabilidade de UM projeto → Margin
+- Definicao de pricing para uma proposta → Mint
+- Forecast de caixa → Vault
+- Reconciliacao de faturas → Flow
+
+## Escalation
+
+- **Escalates to:** @sinapse-master (Imperator) para coordenacao cross-squad, decisoes arquiteturais ou escalacoes alem do escopo da squad
+- **Receives from:** @sinapse-master quando o ecossistema Sinapse roteia demandas financeiras para esta squad