sinapse-ai 1.0.0

package/squad-brand/templates/brand-onboarding-template.md

@@ -0,0 +1,234 @@
+# Brand Onboarding Guide — {brand_name}
+
+> Guia pratico para adoção e uso correto da marca no dia a dia.
+
+---
+
+## 1. Bem-vindo a Marca {brand_name}
+
+### O que e este guia?
+{Explicação breve — este documento ajuda todos os colaboradores, parceiros e fornecedores a usar a marca corretamente no dia a dia.}
+
+### Para quem e?
+- Colaboradores internos (todos os departamentos)
+- Agencias parceiras
+- Fornecedores graficos
+- Freelancers e consultores
+
+### Onde encontrar tudo
+- **Brandbook completo:** {link_brandbook}
+- **Quick Reference Card:** {link_quick_ref}
+- **Biblioteca de assets:** {link_assets}
+- **Templates editaveis:** {link_templates}
+- **Design System / Figma:** {link_figma}
+
+---
+
+## 2. Nossa Marca em 30 Segundos
+
+### Quem Somos
+{1 paragrafo — resumo do posicionamento + proposito}
+
+### Nosso Tom de Voz
+{3 regras simples de como nos comunicamos}
+1. {Regra 1} — Ex: "{exemplo}"
+2. {Regra 2} — Ex: "{exemplo}"
+3. {Regra 3} — Ex: "{exemplo}"
+
+### Nossos Valores
+{Lista de 3-5 valores com uma frase cada}
+
+---
+
+## 3. Logo — Como Usar
+
+### Logo Correto
+{Imagem do logo principal}
+
+### Variacoes Disponiveis
+| Variacao | Quando Usar | Arquivo |
+|----------|-------------|---------|
+| Principal | Uso padrao, fundos claros | logo-primary.svg |
+| Horizontal | Espacos horizontais (header, footer) | logo-horizontal.svg |
+| Icone | Avatar, favicon, espacos pequenos | logo-icon.svg |
+| Negativo | Fundos escuros | logo-negative.svg |
+| Monocromatico | Impressao P&B, gravacao | logo-mono.svg |
+
+### Regras Basicas
+- Area de protecao: {medida} ao redor do logo
+- Tamanho minimo: {digital}px / {print}mm
+- **NUNCA:** distorcer, mudar cores, adicionar efeitos, rotacionar
+
+---
+
+## 4. Cores — Referencia Rapida
+
+| Cor | Nome | HEX | Uso |
+|-----|------|-----|-----|
+| {swatch} | Primaria | #{hex} | 70% — backgrounds, headers |
+| {swatch} | Secundaria | #{hex} | 25% — secoes, cards |
+| {swatch} | Acento | #{hex} | 5% — CTAs, destaques |
+| {swatch} | Texto | #{hex} | Texto principal |
+| {swatch} | Background | #{hex} | Fundos |
+
+### Regra 70/25/5
+{Explicacao visual da proporcao de cores}
+
+---
+
+## 5. Tipografia — Referencia Rapida
+
+### Fontes da Marca
+- **Display:** {font_name} — Para titulos e destaques
+- **Body:** {font_name} — Para textos corridos
+- **Mono:** {font_name} — Para codigo (se aplicavel)
+
+### Onde Baixar
+{Link para download das fontes + instrucoes de instalacao}
+
+### Hierarquia de Textos
+| Nivel | Fonte | Tamanho | Peso | Uso |
+|-------|-------|---------|------|-----|
+| H1 | {font} | {size}px | Bold | Titulo principal |
+| H2 | {font} | {size}px | Semi-bold | Subtitulo |
+| H3 | {font} | {size}px | Medium | Secoes |
+| Body | {font} | {size}px | Regular | Texto corrido |
+| Small | {font} | {size}px | Regular | Notas, legendas |
+
+---
+
+## 6. Templates Disponiveis
+
+### Como Usar os Templates
+1. Acesse a biblioteca: {link}
+2. Faca uma copia do template (nunca edite o original)
+3. Substitua o conteudo placeholder pelo seu
+4. Mantenha cores, fontes e layout intactos
+5. Em caso de duvida, consulte o Brand Manager
+
+### Lista de Templates
+| Template | Formato | Link |
+|----------|---------|------|
+| Apresentacao | Google Slides / PPTX | {link} |
+| Post Instagram (feed) | PSD / Canva | {link} |
+| Post Instagram (stories) | PSD / Canva | {link} |
+| Post LinkedIn | PSD / Canva | {link} |
+| Email signature | HTML | {link} |
+| Proposta comercial | DOCX | {link} |
+| Papel timbrado | DOCX | {link} |
+| Business card | PDF (enviar para grafica) | {link} |
+
+---
+
+## 7. Redes Sociais — Guia Rapido
+
+### Avatar e Cover
+- Avatar: usar logo icone (versao {variacao})
+- Cover: usar template de cover aprovado
+
+### Estilo Visual
+- Sempre usar templates oficiais
+- Fotos seguem o estilo: {estilo_fotografico}
+- Nunca usar stock generico sem tratamento
+
+### Tom de Voz Online
+{3-5 regras simples para redes sociais}
+- {Regra 1}
+- {Regra 2}
+- {Regra 3}
+
+### Hashtags Oficiais
+- Principal: #{hashtag}
+- Campanha: #{hashtag}
+- Comunidade: #{hashtag}
+
+---
+
+## 8. Email — Guia Rapido
+
+### Assinatura de Email
+{Exemplo visual da assinatura}
+
+**Como instalar:**
+1. {Passo 1}
+2. {Passo 2}
+3. {Passo 3}
+Instruções detalhadas: {link}
+
+### Newsletter
+- Usar template oficial: {link}
+- Header com logo: sempre
+- Footer com unsubscribe: obrigatorio
+- Fonte no email: {web-safe fallback}
+
+---
+
+## 9. O que NUNCA Fazer
+
+### Com o Logo
+- Nunca alterar as cores do logo
+- Nunca distorcer ou rotacionar
+- Nunca adicionar sombra, brilho ou efeitos
+- Nunca colocar sobre fundo que prejudique legibilidade
+- Nunca recriar o logo "de cabeca"
+
+### Com as Cores
+- Nunca usar cores fora da paleta oficial
+- Nunca alterar a saturacao ou brilho das cores
+- Nunca usar gradientes nao aprovados
+
+### Com a Tipografia
+- Nunca usar fontes nao oficiais em materiais de marca
+- Nunca alterar o espacamento ou deformar as letras
+- Nunca usar mais de 2 pesos na mesma peca
+
+### Com Fotos e Imagens
+- Nunca usar imagens pixeladas ou de baixa qualidade
+- Nunca aplicar filtros nao aprovados
+- Nunca usar stock generico sem curadoria
+
+---
+
+## 10. FAQ
+
+### "Posso usar o logo em fundo colorido?"
+{Resposta com exemplo do/don't}
+
+### "Que fonte uso se nao tenho a fonte da marca instalada?"
+{Resposta com fallback: ex: Arial/Helvetica como substituto}
+
+### "Preciso criar um material que nao tem template. O que faco?"
+{Resposta: contatar Brand Manager, usar Quick Reference como guia}
+
+### "Posso adaptar o logo para um evento especial?"
+{Resposta: provavelmente nao sem aprovacao. Contatar Brand Manager}
+
+### "Onde encontro os arquivos do logo em alta resolucao?"
+{Resposta com link direto}
+
+---
+
+## 11. Contatos
+
+| Funcao | Nome | Email | Quando Contatar |
+|--------|------|-------|-----------------|
+| Brand Manager | {nome} | {email} | Duvidas sobre uso, aprovacoes |
+| Design Lead | {nome} | {email} | Pedidos de design, templates |
+| Marketing | {nome} | {email} | Campanhas, redes sociais |
+
+---
+
+## 12. Checklist de Onboarding
+
+Use esta checklist para garantir que esta pronto:
+
+- [ ] Li este guia de onboarding completo
+- [ ] Instalei as fontes da marca no meu computador
+- [ ] Configurei minha assinatura de email
+- [ ] Tenho acesso a biblioteca de assets/templates
+- [ ] Sei onde encontrar o Brandbook completo
+- [ ] Sei quem contatar em caso de duvida
+- [ ] Entendo as regras basicas de uso do logo
+- [ ] Conhego as cores e tipografia da marca
+
+**Tempo estimado de onboarding: 20-30 minutos**

package/squad-brand/templates/brandbook-template.md

@@ -0,0 +1,157 @@
+# Brandbook Template — {brand_name}
+
+> Version: {version} | Date: {date} | Status: {draft|final}
+
+---
+
+## 1. Capa
+{Logo principal + nome da marca + "Brand Guidelines" + versao + data}
+
+## 2. Indice
+{Indice interativo com links para cada secao — gerado automaticamente}
+
+## 3. Introducao
+### Proposito deste documento
+{Por que este brandbook existe, como usar, para quem e}
+
+### Como usar este guia
+{Instrucoes de navegacao, quando consultar, contatos para duvidas}
+
+---
+
+## 4. Estrategia de Marca
+
+### 4.1 Posicionamento
+{Positioning statement + perceptual map + diferenciacao}
+
+### 4.2 Arquetipo
+{Arquetipo escolhido + justificativa + atributos}
+
+### 4.3 Manifesto
+{Proposito + Visao + Missao + Valores + Tagline}
+
+### 4.4 Tom de Voz
+{4 dimensoes + DOs/DON'Ts + exemplos por canal}
+
+### 4.5 Personas
+{3-5 personas com perfil completo}
+
+### 4.6 Brand Architecture
+{Hierarquia + naming rules}
+
+---
+
+## 5. Identidade Visual
+
+### 5.1 Paleta de Cores
+{Primaria + secundaria + acento + escalas + semanticas + acessibilidade}
+
+### 5.2 Tipografia
+{Display + body + mono + scale + pairing rules}
+
+### 5.3 Logo System
+{6+ variacoes + area protecao + minimo + proibidos}
+
+### 5.4 Fotografia
+{Estilo + iluminacao + composicao + DON'Ts}
+
+### 5.5 Ilustracao
+{Estilo + paleta + regras}
+
+### 5.6 Vocabulario Grafico
+{Formas + patterns + elementos}
+
+### 5.7 Tratamento de Imagem
+{Filtros + overlays + crops}
+
+### 5.8 Data Visualization
+{Paleta dados + chart styles + infographics}
+
+---
+
+## 6. Design System
+
+### 6.1 Tokens
+{3 niveis + naming + formatos}
+
+### 6.2 Grid
+{12-col + breakpoints + containers}
+
+### 6.3 Componentes
+{Componentes com anatomia + variacoes + ARIA + codigo}
+
+### 6.4 Dark Mode
+{Remapeamento + contrast + implementation}
+
+---
+
+## 7. Aplicacoes
+
+### 7.1 Business Cards
+{Design + specs}
+
+### 7.2 Stationery
+{Letterhead + envelope + folder}
+
+### 7.3 Apresentacoes
+{Template + slide types}
+
+### 7.4 Social Media
+{Templates por plataforma}
+
+### 7.5 Web
+{Templates de pagina}
+
+### 7.6 Packaging
+{Design + dieline + specs}
+
+### 7.7 Signage
+{Environmental branding}
+
+---
+
+## 8. Motion
+
+### 8.1 Motion Principles
+{Regras + easing + duration scale}
+
+### 8.2 Micro-Interactions
+{Por componente + codigo}
+
+### 8.3 Page Transitions
+{Tipos + scroll animations}
+
+### 8.4 Video Templates
+{Intro + outro + lower thirds}
+
+---
+
+## 9. Audio
+
+### 9.1 Sonic Identity
+{Sonic DNA + atributos sonoros}
+
+### 9.2 Audio Logo
+{3 versoes + specs}
+
+### 9.3 Notification Sounds
+{6 sons de interface}
+
+### 9.4 Audio Beds
+{5 moods + loops}
+
+---
+
+## 10. Governanca
+
+### 10.1 Aprovacao de Uso
+{Quem aprova + processo}
+
+### 10.2 Licenciamento
+{Parceiros + co-branding}
+
+### 10.3 Atualizacao
+{Processo + versionamento}
+
+### 10.4 Contatos
+{Responsaveis + emails}

package/squad-brand/templates/client-briefing-template.md

@@ -0,0 +1,66 @@
+# Client Briefing Template
+
+> Questionario completo para coleta de informacoes do cliente antes do inicio do projeto de marca.
+
+---
+
+## 1. Empresa & Fundacao (8 perguntas)
+1. Qual o nome da empresa? (Se ja tem, se esta aberto a mudanca)
+2. Quando foi fundada? Qual a historia de fundacao?
+3. Quem sao os fundadores? O que os motivou?
+4. Qual o setor de atuacao?
+5. Quais produtos/servicos oferece?
+6. Qual o tamanho da empresa? (funcionarios, faturamento, clientes)
+7. Onde atua? (local, regional, nacional, global)
+8. Qual o modelo de negocio? (B2B, B2C, D2C, marketplace)
+
+## 2. Proposito & Valores (6 perguntas)
+9. Por que a empresa existe ALEM do lucro?
+10. Se a empresa desaparecesse amanha, o que o mundo perderia?
+11. Quais sao os 3-5 valores inegociaveis da empresa?
+12. O que a empresa NUNCA faria, mesmo que desse dinheiro?
+13. Qual a visao de futuro? Onde quer estar em 5 anos?
+14. Qual mudanca no mundo a empresa quer provocar?
+
+## 3. Publico & Mercado (8 perguntas)
+15. Quem e o cliente ideal? Descreva em detalhes.
+16. O que esse cliente sente ANTES de usar seu produto/servico?
+17. O que sente DEPOIS?
+18. Quais as maiores dores/frustracoes do seu cliente?
+19. Como o cliente descobre voce? (canais principais)
+20. Quais sao seus 3-5 principais concorrentes?
+21. O que voce faz DIFERENTE deles?
+22. Qual concorrente voce mais admira? E qual mais detesta? Por que?
+
+## 4. Marca Atual (6 perguntas)
+23. Ja tem marca/logo? (Se sim, o que gosta e o que nao gosta)
+24. Se a marca fosse uma pessoa, como seria? (personalidade, idade, estilo)
+25. Quais 3 adjetivos descrevem como quer ser percebido?
+26. Quais 3 adjetivos NAO quer ser associado?
+27. Quais marcas (de qualquer setor) voce admira visualmente?
+28. Tem alguma cor, fonte ou estilo que ODEIA?
+
+## 5. Aspiracoes Visuais (6 perguntas)
+29. Prefere visual mais: minimalista ou elaborado?
+30. Prefere: moderno ou classico?
+31. Prefere: ousado/vibrante ou sutil/elegante?
+32. Prefere: tipografia forte (display) ou discreta (clean sans)?
+33. Tem referencia de sites/marcas que ama o visual?
+34. Vai precisar da marca em quais aplicacoes? (digital, print, video, embalagem, etc)
+
+## 6. Objetivos do Projeto (4 perguntas)
+35. O que motivou a busca por branding agora?
+36. Qual o resultado mais importante que espera desse projeto?
+37. Tem prazo ou data critica?
+38. Tem orcamento definido para implementacao pos-branding? (producao, materiais)
+
+## 7. Restricoes & Premissas (4 perguntas)
+39. Existe algo que NAO pode mudar? (nome, cor especifica, simbolo)
+40. Tem requisitos legais ou regulatorios? (setor financeiro, saude, etc)
+41. Quem sao os decisores finais? Quantas pessoas aprovam?
+42. Alguma informacao adicional que devemos saber?
+
+---
+
+**Total: 42 perguntas**
+Estimativa de tempo: 45-60 minutos para preenchimento completo.

package/squad-brand/templates/client-delivery-template.md

@@ -0,0 +1,74 @@
+# Client Delivery Presentation — Phase {N}: {phase_name}
+
+> Template para apresentacao de entrega ao cliente por fase.
+
+---
+
+## Slide 1: Capa
+{Logo do projeto + "Entrega {N}: {phase_name}" + data + Astro Brand Studio logo}
+
+## Slide 2: Agenda
+{Lista dos topicos que serao apresentados nesta entrega}
+
+## Slide 3: Recap do Briefing
+{Resumo do que ouvimos do cliente — demonstrar escuta ativa}
+- Proposito: {resumo}
+- Publico: {resumo}
+- Diferencial: {resumo}
+- Aspiracao: {resumo}
+
+## Slides 4-N: Conteudo da Fase
+{Conteudo especifico por fase:}
+
+### Phase 1 — Strategy:
+- Posicionamento + justificativa
+- Arquetipo + por que esse
+- Manifesto (texto completo)
+- Tom de voz + exemplos
+- Personas (visual + dados)
+
+### Phase 2 — Visual:
+- Paleta + psicologia por tras
+- Tipografia + personalidade
+- Logo system + variacoes
+- Moodboard
+- Sonic identity preview
+
+### Phase 3 — Assets:
+- Mockups gallery (produtos, apparel)
+- Business cards + stationery
+- Social media templates
+- Web templates preview
+
+### Phase 4 — System:
+- Design system overview
+- Componentes demo
+- Dark mode demo
+- Motion language demo
+- Video templates preview
+
+### Phase 5 — Final:
+- Brandbook walkthrough
+- Delivery package overview
+- Brand consistency score
+
+## Slide N+1: Justificativa
+{Por que cada decisao foi tomada — conectar com briefing}
+
+## Slide N+2: Proximos Passos
+{O que acontece depois da aprovacao}
+- Timeline para proxima fase
+- O que precisamos do cliente
+- Prazo para feedback
+
+## Slide Final: Obrigado
+{Logo + contatos + CTA para aprovacao}
+"Aguardamos sua aprovacao para prosseguir com a proxima fase."
+
+---
+
+## Notas de Apresentacao
+- Duracao: 30-60 min dependendo da fase
+- Formato: 16:9
+- Exportar: Google Slides + PPTX + PDF
+- Enviar PDF 24h antes para pre-leitura (opcional)

package/squad-brand/templates/preference-log-template.md

@@ -0,0 +1,122 @@
+# Preference Log — {NOME DO PROJETO/CLIENTE}
+
+> Registro progressivo de preferencias, decisoes e padroes identificados durante o desenvolvimento da marca.
+> Atualizado pelo brand-auditor (Sentinel) apos cada ciclo de aprovacao.
+
+---
+
+## Metadata
+
+| Campo | Valor |
+|-------|-------|
+| **Projeto** | {nome} |
+| **Cliente** | {nome} |
+| **Inicio** | {data} |
+| **Ultima atualizacao** | {data} |
+| **Ciclos de aprovacao** | {numero} |
+
+---
+
+## 1. Preferencias Visuais
+
+### Cores
+| Decisao | Aceito | Rejeitado | Padrao Identificado |
+|---------|--------|-----------|-------------------|
+| Paleta primaria | {cores aprovadas} | {cores rejeitadas} | {tendencia: tons quentes/frios, saturados/dessaturados} |
+| Paleta secundaria | {cores aprovadas} | {cores rejeitadas} | |
+| Acentos | {cores aprovadas} | {cores rejeitadas} | |
+
+### Tipografia
+| Decisao | Aceito | Rejeitado | Padrao Identificado |
+|---------|--------|-----------|-------------------|
+| Familia principal | {fonte aprovada} | {fontes rejeitadas} | {tendencia: serif/sans, geometrica/humanista} |
+| Display | {fonte aprovada} | {fontes rejeitadas} | |
+
+### Estilo Visual
+| Aspecto | Preferencia Demonstrada | Evidencia |
+|---------|------------------------|-----------|
+| Minimalismo vs densidade | | {ciclo X: escolheu opcao mais limpa} |
+| Foto vs ilustracao | | |
+| Cores solidas vs gradientes | | |
+| Cantos arredondados vs retos | | |
+| Espaco negativo | | |
+
+### Moodboard
+| Rodada | Imagens Selecionadas | Imagens Rejeitadas | Insight |
+|--------|---------------------|-------------------|---------|
+| 1 | {descricao} | {descricao} | {o que isso revela sobre gosto} |
+| 2 | {descricao} | {descricao} | |
+| 3 | {descricao} | {descricao} | |
+
+---
+
+## 2. Preferencias Estrategicas
+
+### Tom de Voz
+| Decisao | Aceito | Rejeitado | Padrao |
+|---------|--------|-----------|--------|
+| Tom geral | {ex: profissional-acessivel} | {ex: casual-gamer} | |
+| Formalidade | {nivel} | | |
+| Humor | {permitido/restrito} | | |
+
+### Posicionamento
+| Aspecto | Preferencia | Evidencia |
+|---------|------------|-----------|
+| Premium vs acessivel | | |
+| Tecnico vs humano | | |
+| Bold vs sutil | | |
+| Inovador vs confiavel | | |
+
+---
+
+## 3. Padroes de Decisao do Cliente
+
+### Como Decide
+- {ex: "Decide rapido quando ve referencias visuais, lento com opcoes so textuais"}
+- {ex: "Sempre pede segunda opiniao do socio antes de aprovar"}
+- {ex: "Rejeita primeira opcao por principio, aprova na segunda rodada"}
+
+### O que Prioriza
+1. {ex: "Estetica > funcionalidade nas primeiras fases"}
+2. {ex: "Diferenciacao > convencao"}
+3. {ex: "Simplicidade > sofisticacao tecnica"}
+
+### Red Flags (o que evitar)
+- {ex: "Nunca usar amarelo — associacao negativa pessoal"}
+- {ex: "Nao referenciar concorrente X — relacao complicada"}
+- {ex: "Evitar linguagem corporativa — quer parecer 'real'"}
+
+---
+
+## 4. Historico de Revisoes
+
+| Data | Fase | O que foi revisado | Feedback | Acao tomada |
+|------|------|-------------------|----------|-------------|
+| {data} | Discovery | {item} | {feedback verbatim} | {ajuste} |
+| {data} | Identity | {item} | {feedback verbatim} | {ajuste} |
+
+---
+
+## 5. Score de Alinhamento
+
+| Metrica | Valor | Tendencia |
+|---------|-------|-----------|
+| % entregas aceitas sem revisao | {X%} | {subindo/descendo/estavel} |
+| Media de rodadas de aprovacao | {X} | |
+| Satisfacao declarada (1-5) | {X} | |
+| Tempo medio de decisao | {X dias} | |
+
+---
+
+## 6. Insights para Proximos Projetos
+
+> Conclusoes gerais que podem ser aplicadas em projetos futuros com o mesmo cliente ou perfil similar.
+
+- {insight 1}
+- {insight 2}
+- {insight 3}
+
+---
+
+**Atualizado por:** brand-auditor (Sentinel)
+**Frequencia:** Apos cada ciclo de aprovacao

package/squad-brand/templates/quick-reference-template.md

@@ -0,0 +1,51 @@
+# Quick Reference Card — {brand_name}
+
+> Versao condensada do brandbook para uso diario.
+
+---
+
+## PAGINA 1 (FRENTE)
+
+### Logo
+{Logo principal}
+{3 variacoes essenciais: horizontal, icone, negativa}
+- Area de protecao: {medida}
+- Tamanho minimo: {digital} / {print}
+
+### Paleta de Cores
+| Cor | HEX | Uso |
+|-----|-----|-----|
+| Primaria | #{hex} | 70% — backgrounds, headers |
+| Secundaria | #{hex} | 25% — secoes, cards |
+| Acento | #{hex} | 5% — CTAs, highlights |
+| Neutro escuro | #{hex} | Texto principal |
+| Neutro claro | #{hex} | Backgrounds |
+
+### Tipografia
+- **Display:** {font_name} — headlines, hero text
+- **Body:** {font_name} — texto corrido, paragrafos
+- h1: {size}px | h2: {size}px | h3: {size}px | body: {size}px
+
+---
+
+## PAGINA 2 (VERSO)
+
+### Tom de Voz
+1. {Regra 1} — Exemplo: "{exemplo}"
+2. {Regra 2} — Exemplo: "{exemplo}"
+3. {Regra 3} — Exemplo: "{exemplo}"
+
+### DO's
+- {DO 1}
+- {DO 2}
+- {DO 3}
+
+### DON'Ts
+- {DON'T 1}
+- {DON'T 2}
+- {DON'T 3}
+
+### Contatos
+- Brand Manager: {nome} — {email}
+- Design: {nome} — {email}
+- Brandbook completo: {link}