sinapse-ai 1.0.0

package/squad-finance/tasks/track-pricing-performance.md

@@ -0,0 +1,65 @@
+---
+task: track-pricing-performance
+responsavel: "@pricing-strategist"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: period
+    tipo: string
+    origem: "usuario"
+    obrigatorio: true
+
+Saida:
+  - campo: pricing_performance_report
+    tipo: document
+    destino: "fi-orchestrator"
+
+Checklist:
+  - "[ ] Calcular metricas de pricing do periodo"
+  - "[ ] Comparar com periodo anterior"
+  - "[ ] Identificar tendencias"
+  - "[ ] Recomendar ajustes"
+---
+
+# Task: Track Pricing Performance
+
+## Metadata
+- **Agent:** pricing-strategist (Mint)
+- **Squad:** squad-finance
+- **Complexity:** MEDIUM
+
+## Objetivo
+Acompanhar performance de pricing ao longo do tempo para identificar tendencias e necessidade de ajustes.
+
+## Steps
+
+1. **Calcular metricas:**
+   - Average deal size
+   - Rate realization
+   - Win rate por faixa de preco
+   - Desconto medio concedido
+   - Mix de receita por tier
+2. **Comparar com periodo anterior:**
+   - Deal size trending up/down?
+   - Win rate estavel?
+   - Descontos aumentando?
+3. **Identificar sinais de problema:**
+   - Win rate caindo + deal size subindo = preco alto demais
+   - Win rate subindo + deal size caindo = preco baixo demais
+   - Descontos subindo = rate card desalinhado com mercado
+
+## Output
+- Dashboard de pricing performance
+- Tendencias com interpretacao
+- Recomendacoes de ajuste (se necessario)
+
+## Quality Gates
+- [ ] Dados de pelo menos 3 periodos para tendencia
+- [ ] Win rate e desconto cruzados
+- [ ] Recomendacoes fundamentadas em dados
+
+## Quando Usar
+- Review mensal de pricing
+- Planejamento de reajuste anual

package/squad-finance/tasks/track-recurring-revenue.md

@@ -0,0 +1,75 @@
+---
+task: track-recurring-revenue
+responsavel: "@revenue-analyst"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: mrr_data
+    tipo: object
+    origem: "billing, contratos"
+    obrigatorio: true
+
+Saida:
+  - campo: recurring_revenue_report
+    tipo: document
+    destino: "fi-orchestrator"
+
+Checklist:
+  - "[ ] Calcular MRR e ARR"
+  - "[ ] Decompor em componentes"
+  - "[ ] Calcular churn e expansion"
+  - "[ ] Projetar tendencia"
+---
+
+# Task: Track Recurring Revenue
+
+## Metadata
+- **Agent:** revenue-analyst (Flow)
+- **Squad:** squad-finance
+- **Complexity:** MEDIUM
+
+## Objetivo
+Acompanhar receita recorrente (MRR, ARR) com decomposicao em componentes.
+
+## Steps
+
+1. **MRR atual:**
+   ```
+   MRR = Σ contratos_recorrentes_mensais
+   ARR = MRR × 12
+   ```
+2. **Decomposicao MRR:**
+   ```
+   MRR_inicio_mes
+   + New MRR (novos clientes)
+   + Expansion MRR (upgrades, novos servicos)
+   - Contraction MRR (downgrades)
+   - Churn MRR (cancelamentos)
+   = MRR_final_mes
+   ```
+3. **Metricas:**
+   ```
+   Net New MRR = New + Expansion - Contraction - Churn
+   NRR = MRR_final / MRR_inicio × 100
+   GRR = (MRR_inicio - Contraction - Churn) / MRR_inicio × 100
+   Quick Ratio = (New + Expansion) / (Contraction + Churn)
+   Target Quick Ratio: >= 4.0
+   ```
+4. **Tendencia:** MRR dos ultimos 12 meses com growth rate
+
+## Output
+- MRR e ARR atual
+- Decomposicao de MRR (new, expansion, contraction, churn)
+- NRR, GRR, Quick Ratio
+- Tendencia 12 meses
+
+## Quality Gates
+- [ ] Todos os contratos recorrentes mapeados
+- [ ] Decomposicao fecha com MRR final
+- [ ] Quick Ratio interpretado corretamente
+
+## Quando Usar
+- Acompanhamento mensal de receita recorrente
+- Avaliacao de saude do negocio

package/squad-finance/tasks/triage-financial-alerts.md

@@ -0,0 +1,67 @@
+---
+task: triage-financial-alerts
+responsavel: "@fi-orchestrator"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: alerts
+    tipo: array
+    origem: "agentes da squad, sistemas financeiros"
+    obrigatorio: true
+
+Saida:
+  - campo: triaged_alerts
+    tipo: document
+    destino: "stakeholders relevantes"
+
+Checklist:
+  - "[ ] Coletar alertas de todos os agentes"
+  - "[ ] Classificar por severidade"
+  - "[ ] Atribuir responsavel e prazo"
+  - "[ ] Comunicar alertas criticos imediatamente"
+---
+
+# Task: Triage Financial Alerts
+
+## Metadata
+- **Agent:** fi-orchestrator (Ledger)
+- **Squad:** squad-finance
+- **Complexity:** MEDIUM
+
+## Objetivo
+Triar alertas financeiros de todos os agentes, classificar por severidade e encaminhar para acao imediata quando necessario.
+
+## Inputs
+- Alertas de cada agente:
+  - Margin: projeto com margem negativa, cliente nao-rentavel
+  - Mint: rate realization abaixo de 75%, pricing abaixo do floor
+  - Vault: budget estourado, cash runway < 3 meses, variance > 15%
+  - Flow: aging > 60 dias, concentracao > 30%, DSO > 60
+
+## Steps
+
+1. **Coletar alertas** de todos os agentes
+2. **Classificar severidade:**
+   - CRITICO: cash runway < 3 meses, cliente > 40% receita com aging > 90
+   - ALTO: margem negativa em projeto ativo, budget variance > 20%
+   - MEDIO: DSO > 60, rate realization < 75%, concentracao > 25%
+   - BAIXO: variance 5-15%, aging 30-60 dias
+3. **Definir acao:** para cada alerta, definir acao, responsavel e prazo
+4. **Comunicar:** alertas CRITICOS imediatamente, ALTO em 24h, MEDIO semanal
+
+## Output
+- Lista de alertas priados com severidade, acao, responsavel e prazo
+- Alertas criticos em destaque
+- Tendencia: alertas novos vs resolvidos vs recorrentes
+
+## Quality Gates
+- [ ] Nenhum alerta critico ignorado
+- [ ] Todos os alertas tem acao definida
+- [ ] Responsaveis notificados dentro do prazo
+
+## Quando Usar
+- Check semanal de saude financeira
+- Anomalia detectada por qualquer agente
+- Pre-reuniao de diretoria

package/squad-finance/templates/client-profitability-report-template.md

@@ -0,0 +1,129 @@
+---
+template: client-profitability-report-template
+squad: squad-finance
+description: "Template de report de rentabilidade por cliente"
+used_by:
+  - analyze-client-profitability
+  - client-profitability-audit
+---
+
+# Client Profitability Report — {{client_name}}
+
+## Periodo: {{period}}
+## Data do Report: {{report_date}}
+
+---
+
+## 1. Resumo Executivo
+
+| Indicador | Valor | Status |
+|-----------|-------|--------|
+| Receita total | R$ {{receita_total}} | |
+| % da receita da empresa | {{pct_receita}}% | {{status_concentracao}} |
+| COGS | R$ {{cogs_total}} | |
+| Gross Margin | {{gross_margin}}% | {{status_gm}} |
+| Custo de servicing | R$ {{servicing}} | |
+| Net Margin | {{net_margin}}% | {{status_nm}} |
+| DSO medio | {{dso}} dias | {{status_dso}} |
+| Lifetime (meses) | {{lifetime}} | |
+| **Classificacao** | **{{classificacao}}** | {{star_cow_question_dog}} |
+
+---
+
+## 2. Receita Detalhada
+
+### Por Projeto
+
+| Projeto | Receita | Horas | Rate Efetivo | Gross Margin |
+|---------|---------|-------|-------------|-------------|
+| {{proj_1}} | R$ {{p1_rev}} | {{p1_hours}} | R$ {{p1_rate}} | {{p1_gm}}% |
+| {{proj_2}} | R$ {{p2_rev}} | {{p2_hours}} | R$ {{p2_rate}} | {{p2_gm}}% |
+| {{proj_3}} | R$ {{p3_rev}} | {{p3_hours}} | R$ {{p3_rate}} | {{p3_gm}}% |
+| **Total** | **R$ {{receita_total}}** | **{{total_hours}}** | **R$ {{avg_rate}}** | **{{gross_margin}}%** |
+
+### Por Tipo
+
+| Tipo | Receita | % |
+|------|---------|---|
+| Projeto | R$ {{proj_rev}} | {{proj_pct}}% |
+| Retainer | R$ {{ret_rev}} | {{ret_pct}}% |
+| Consulting | R$ {{cons_rev}} | {{cons_pct}}% |
+
+---
+
+## 3. Custos Detalhados
+
+### COGS
+
+| Rubrica | Valor | % COGS |
+|---------|-------|--------|
+| Equipe de delivery | R$ {{equipe_delivery}} | {{eq_pct}}% |
+| Freelancers | R$ {{freelancers}} | {{fr_pct}}% |
+| Ferramentas diretas | R$ {{tools}} | {{tl_pct}}% |
+| **Total COGS** | **R$ {{cogs_total}}** | **100%** |
+
+### Custo de Servicing
+
+| Rubrica | Valor |
+|---------|-------|
+| Account Manager | R$ {{am_cost}} ({{am_hours}}h) |
+| Pre-venda | R$ {{presale_cost}} ({{presale_hours}}h) |
+| Relacionamento | R$ {{relac_cost}} |
+| **Total Servicing** | **R$ {{servicing}}** |
+
+---
+
+## 4. P&L do Cliente
+
+```
+Receita Liquida                    R$ {{receita_total}}
+(-) COGS                           R$ {{cogs_total}}
+────────────────────────────────────────────
+Gross Profit                       R$ {{gross_profit}}
+Gross Margin                       {{gross_margin}}%
+
+(-) Custo de Servicing             R$ {{servicing}}
+(-) Overhead Alocado               R$ {{overhead}}
+────────────────────────────────────────────
+Net Profit                         R$ {{net_profit}}
+Net Margin                         {{net_margin}}%
+```
+
+---
+
+## 5. Client Profitability Matrix
+
+```
+                    Alta Receita          Baixa Receita
+Alta Margem    [  STAR ★  ]          [ QUESTION MARK ? ]
+Baixa Margem   [ CASH COW $ ]        [    DOG ✗    ]
+
+Este cliente: {{classificacao}} — {{quadrante_descricao}}
+```
+
+---
+
+## 6. Historico de Rentabilidade
+
+| Periodo | Receita | Gross Margin | Net Margin | Tendencia |
+|---------|---------|-------------|------------|-----------|
+| {{period_1}} | R$ {{p1_rev}} | {{p1_gm}}% | {{p1_nm}}% | |
+| {{period_2}} | R$ {{p2_rev}} | {{p2_gm}}% | {{p2_nm}}% | {{trend_2}} |
+| {{period_3}} | R$ {{p3_rev}} | {{p3_gm}}% | {{p3_nm}}% | {{trend_3}} |
+
+---
+
+## 7. Recomendacao
+
+**Acao:** {{recomendacao_acao}} (Investir / Renegociar / Expandir / Descontinuar)
+
+**Justificativa:**
+{{recomendacao_justificativa}}
+
+**Impacto financeiro estimado:**
+{{impacto_financeiro}}
+
+**Proximos passos:**
+1. {{passo_1}}
+2. {{passo_2}}
+3. {{passo_3}}

package/squad-finance/templates/financial-dashboard-template.md

@@ -0,0 +1,97 @@
+---
+template: financial-dashboard-template
+squad: squad-finance
+description: "Template de dashboard financeiro executivo"
+used_by:
+  - generate-executive-dashboard
+  - monthly-financial-cycle
+  - quarterly-financial-review
+---
+
+# Financial Dashboard — {{period}}
+
+## Health Score: {{health_score}}/100 {{health_status}}
+
+---
+
+## 1. Revenue
+
+| Metrica | Valor | Target | Var | Status |
+|---------|-------|--------|-----|--------|
+| Receita Liquida | R$ {{rl}} | R$ {{rl_target}} | {{rl_var}}% | {{rl_status}} |
+| Growth MoM | {{growth_mom}}% | {{growth_target}}% | | {{growth_status}} |
+| MRR | R$ {{mrr}} | R$ {{mrr_target}} | | {{mrr_status}} |
+| NRR | {{nrr}}% | >=100% | | {{nrr_status}} |
+| Maior cliente % | {{top_client_pct}}% | <=15% | | {{conc_status}} |
+
+## 2. Profitability
+
+| Metrica | Valor | Target | Var | Status |
+|---------|-------|--------|-----|--------|
+| Gross Margin | {{gm}}% | >=50% | | {{gm_status}} |
+| EBITDA | R$ {{ebitda}} ({{ebitda_pct}}%) | >=15% | | {{ebitda_status}} |
+| Utilizacao | {{util}}% | 75% | | {{util_status}} |
+| Rev/Employee | R$ {{rev_emp}} | R$ 20K | | {{rev_emp_status}} |
+| Rate Realization | {{rr}}% | >=85% | | {{rr_status}} |
+
+## 3. Cash
+
+| Metrica | Valor | Target | Status |
+|---------|-------|--------|--------|
+| Saldo Atual | R$ {{saldo}} | | |
+| Runway | {{runway}} meses | >=6m | {{runway_status}} |
+| DSO | {{dso}} dias | <=45d | {{dso_status}} |
+| Collection Rate | {{collection}}% | >=90% | {{collection_status}} |
+| AR Total | R$ {{ar_total}} | | |
+
+## 4. Budget
+
+| Metrica | Valor | Target | Status |
+|---------|-------|--------|--------|
+| Pacing Index | {{pacing}} | 1.0 | {{pacing_status}} |
+| Variance YTD | {{variance_ytd}}% | <=5% | {{variance_status}} |
+| EAC | R$ {{eac}} | R$ {{budget_anual}} | {{eac_status}} |
+| Forecast Accuracy | {{forecast_acc}}% | >=90% | {{forecast_status}} |
+
+## 5. Unit Economics
+
+| Metrica | Valor | Benchmark | Status |
+|---------|-------|-----------|--------|
+| CAC | R$ {{cac}} | <R$ 8K | {{cac_status}} |
+| LTV | R$ {{ltv}} | | |
+| LTV:CAC | {{ltv_cac}}:1 | >=3:1 | {{ltv_cac_status}} |
+| Payback | {{payback}} meses | <=12m | {{payback_status}} |
+| Magic Number | {{magic}} | >=0.75 | {{magic_status}} |
+
+---
+
+## Alertas Ativos
+
+| Severidade | Alerta | Acao | Responsavel |
+|-----------|--------|------|-------------|
+| {{sev_1}} | {{alerta_1}} | {{acao_1}} | {{resp_1}} |
+| {{sev_2}} | {{alerta_2}} | {{acao_2}} | {{resp_2}} |
+| {{sev_3}} | {{alerta_3}} | {{acao_3}} | {{resp_3}} |
+
+---
+
+## Executive Summary 3x3
+
+### Destaques Positivos
+1. {{destaque_1}}
+2. {{destaque_2}}
+3. {{destaque_3}}
+
+### Riscos
+1. {{risco_1}}
+2. {{risco_2}}
+3. {{risco_3}}
+
+### Recomendacoes
+1. {{recomendacao_1}}
+2. {{recomendacao_2}}
+3. {{recomendacao_3}}
+
+---
+
+*Dashboard gerado por squad-finance em {{generation_date}}*

package/squad-finance/templates/monthly-p-and-l-template.md

@@ -0,0 +1,115 @@
+---
+template: monthly-p-and-l-template
+squad: squad-finance
+description: "Template de P&L mensal para agencias digitais"
+used_by:
+  - run-monthly-p-and-l
+  - monthly-financial-cycle
+---
+
+# P&L Mensal — {{month}} {{year}}
+
+## Resumo Executivo
+
+| Indicador | {{month}} | Mes Anterior | Var MoM | Budget | Var Budget | Status |
+|-----------|-----------|-------------|---------|--------|-----------|--------|
+| Receita Liquida | R$ {{rl}} | R$ {{rl_prev}} | {{var_mom}}% | R$ {{rl_budget}} | {{var_budget}}% | {{status}} |
+| Gross Margin | {{gm}}% | {{gm_prev}}% | {{gm_var}}pp | {{gm_target}}% | {{gm_var_b}}pp | {{status}} |
+| EBITDA | R$ {{ebitda}} | R$ {{ebitda_prev}} | {{ebitda_var}}% | R$ {{ebitda_budget}} | {{ebitda_var_b}}% | {{status}} |
+| EBITDA % | {{ebitda_pct}}% | {{ebitda_pct_prev}}% | | {{ebitda_pct_target}}% | | {{status}} |
+
+---
+
+## P&L Detalhado
+
+```
+RECEITA BRUTA                               R$ {{rb}}
+  (-) ISS                                   R$ {{iss}}
+  (-) PIS                                   R$ {{pis}}
+  (-) COFINS                                R$ {{cofins}}
+─────────────────────────────────────────────────────
+RECEITA LÍQUIDA                             R$ {{rl}}
+
+CUSTO DOS SERVIÇOS (COGS)
+  Folha de Delivery (loaded)                R$ {{folha_delivery}}
+  Freelancers e Terceirizados               R$ {{freelancers}}
+  Ferramentas Diretas de Projeto            R$ {{tools_diretas}}
+  Infra Direta (hosting, APIs)              R$ {{infra_direta}}
+─────────────────────────────────────────────────────
+TOTAL COGS                                  R$ {{cogs}}
+
+═════════════════════════════════════════════════════
+LUCRO BRUTO (Gross Profit)                  R$ {{gp}}
+GROSS MARGIN                                {{gm}}%
+═════════════════════════════════════════════════════
+
+DESPESAS OPERACIONAIS (OpEx)
+  Folha Admin e Comercial (loaded)          R$ {{folha_admin}}
+  Aluguel e Facilities                      R$ {{aluguel}}
+  Marketing e Vendas                        R$ {{marketing}}
+  SaaS e Ferramentas Corporativas           R$ {{saas_corp}}
+  Contabilidade e Juridico                  R$ {{contab_jurid}}
+  Viagens e Eventos                         R$ {{viagens}}
+  Outros                                    R$ {{outros}}
+─────────────────────────────────────────────────────
+TOTAL OpEx                                  R$ {{opex}}
+
+═════════════════════════════════════════════════════
+EBITDA                                      R$ {{ebitda}}
+EBITDA %                                    {{ebitda_pct}}%
+═════════════════════════════════════════════════════
+```
+
+---
+
+## Metricas Operacionais
+
+| Metrica | Valor | Target | Status |
+|---------|-------|--------|--------|
+| Utilizacao da equipe | {{utilizacao}}% | 75% | {{status}} |
+| Revenue per employee | R$ {{rev_per_emp}} | R$ 20.000 | {{status}} |
+| Headcount | {{headcount}} | {{headcount_plan}} | {{status}} |
+| Projetos ativos | {{projetos}} | | |
+| Horas faturadas | {{horas_fat}} | {{horas_target}} | {{status}} |
+
+---
+
+## P&L por Tipo de Receita
+
+| Tipo | Receita | % Total | Gross Margin | Margem % |
+|------|---------|---------|-------------|----------|
+| Retainer | R$ {{ret_rev}} | {{ret_pct}}% | R$ {{ret_gm}} | {{ret_gm_pct}}% |
+| Projetos | R$ {{proj_rev}} | {{proj_pct}}% | R$ {{proj_gm}} | {{proj_gm_pct}}% |
+| Consulting | R$ {{cons_rev}} | {{cons_pct}}% | R$ {{cons_gm}} | {{cons_gm_pct}}% |
+| **Total** | **R$ {{rl}}** | **100%** | **R$ {{gp}}** | **{{gm}}%** |
+
+---
+
+## Top 5 Clientes por Receita
+
+| # | Cliente | Receita | % Total | Gross Margin |
+|---|---------|---------|---------|-------------|
+| 1 | {{client_1}} | R$ {{c1_rev}} | {{c1_pct}}% | {{c1_gm}}% |
+| 2 | {{client_2}} | R$ {{c2_rev}} | {{c2_pct}}% | {{c2_gm}}% |
+| 3 | {{client_3}} | R$ {{c3_rev}} | {{c3_pct}}% | {{c3_gm}}% |
+| 4 | {{client_4}} | R$ {{c4_rev}} | {{c4_pct}}% | {{c4_gm}}% |
+| 5 | {{client_5}} | R$ {{c5_rev}} | {{c5_pct}}% | {{c5_gm}}% |
+
+---
+
+## Destaques e Alertas
+
+### Positivos
+1. {{destaque_1}}
+2. {{destaque_2}}
+3. {{destaque_3}}
+
+### Alertas
+1. {{alerta_1}}
+2. {{alerta_2}}
+3. {{alerta_3}}
+
+### Recomendacoes
+1. {{recomendacao_1}}
+2. {{recomendacao_2}}
+3. {{recomendacao_3}}

package/squad-finance/templates/pricing-proposal-template.md

@@ -0,0 +1,111 @@
+---
+template: pricing-proposal-template
+squad: squad-finance
+description: "Template de pricing para propostas comerciais"
+used_by:
+  - create-proposal-pricing
+  - design-service-tiers
+---
+
+# Proposta de Pricing — {{service_name}}
+
+## Cliente: {{client_name}}
+## Data: {{date}}
+
+---
+
+## 1. Entendimento da Necessidade
+
+{{descricao_necessidade}}
+
+**Objetivo do cliente:** {{objetivo_quantificado}}
+**Impacto esperado:** {{impacto_financeiro}}
+
+---
+
+## 2. Opcoes de Investimento
+
+### Opcao 1: Essentials
+**Investimento: R$ {{preco_good}}**
+
+| Inclui | |
+|--------|--|
+| {{feature_good_1}} | Sim |
+| {{feature_good_2}} | Sim |
+| {{feature_good_3}} | Sim |
+| {{feature_better_only}} | Nao |
+| {{feature_best_only}} | Nao |
+
+- **Prazo:** {{prazo_good}}
+- **Ideal para:** {{ideal_good}}
+
+---
+
+### Opcao 2: Professional (Recomendado)
+**Investimento: R$ {{preco_better}}**
+
+| Inclui | |
+|--------|--|
+| {{feature_good_1}} | Sim |
+| {{feature_good_2}} | Sim |
+| {{feature_good_3}} | Sim |
+| {{feature_better_1}} | Sim |
+| {{feature_better_2}} | Sim |
+| {{feature_best_only}} | Nao |
+
+- **Prazo:** {{prazo_better}}
+- **Ideal para:** {{ideal_better}}
+- **Por que recomendamos:** {{justificativa_better}}
+
+---
+
+### Opcao 3: Enterprise
+**Investimento: R$ {{preco_best}}**
+
+| Inclui | |
+|--------|--|
+| Tudo do Professional | Sim |
+| {{feature_best_1}} | Sim |
+| {{feature_best_2}} | Sim |
+| {{feature_best_3}} | Sim |
+
+- **Prazo:** {{prazo_best}}
+- **Ideal para:** {{ideal_best}}
+
+---
+
+## 3. Retorno sobre Investimento
+
+```
+Investimento (Professional): R$ {{preco_better}}
+Retorno projetado (12 meses): R$ {{retorno_projetado}}
+ROI: {{roi_pct}}%
+Payback: {{payback_meses}} meses
+```
+
+**Cases similares:**
+- {{case_1}}
+- {{case_2}}
+
+---
+
+## 4. Condicoes Comerciais
+
+| Item | Condicao |
+|------|---------|
+| Validade | 15 dias |
+| Pagamento | {{condicoes_pagamento}} |
+| Inicio | {{prazo_inicio}} |
+| Garantia | {{garantia}} |
+
+---
+
+## 5. Proximos Passos
+
+1. Alinhar escopo e opcao preferida
+2. Assinar contrato
+3. Kickoff em ate {{dias_kickoff}} dias uteis
+
+---
+
+*Proposta preparada por {{responsavel}} — {{empresa}}*