synapos 2.5.0

package/.synapos/core/best-practices/content/blog-post.md

@@ -0,0 +1,238 @@
+---
+id: blog-post
+version: "1.0.0"
+domain: [custom]
+whenToUse: "Quando o squad escreve artigos para blog"
+---
+
+# Blog Post
+
+> Guia para escrever artigos que educam, posicionam e geram tráfego orgânico consistente.
+
+---
+
+## Princípios
+
+- **Escolha um problema real** — artigos que resolvem dúvidas concretas têm mais tráfego e retenção
+- **Profundidade > quantidade** — um artigo excelente supera cinco mediocres em SEO e autoridade
+- **Escreva para o leitor, não para o Google** — SEO é consequência de conteúdo útil, não o contrário
+- **Estrutura é respeito pelo tempo do leitor** — use headers, listas e bullets para facilitar a leitura escaneada
+- **Um artigo, uma ideia central** — se você precisa de mais de um parágrafo para explicar o tema, provavelmente são dois artigos
+
+---
+
+## Tipos de Artigo
+
+| Tipo | Objetivo | Quando usar |
+|------|----------|-------------|
+| **Tutorial / How-to** | Ensinar a fazer algo passo a passo | Quando o leitor quer resolver uma tarefa específica |
+| **Explicativo / Conceitual** | Esclarecer um conceito ou tecnologia | Quando há confusão sobre "o que é" ou "como funciona" |
+| **Comparativo** | Comparar opções, ferramentas ou abordagens | Quando o leitor está avaliando alternativas |
+| **Opinião / Ponto de vista** | Posicionar a marca em um debate do setor | Quando queremos gerar discussão e autoridade |
+| **Estudo de caso** | Mostrar resultado real com contexto completo | Quando temos evidência concreta para compartilhar |
+| **Listicle** | Lista de recursos, ferramentas ou práticas | Quando o conteúdo é naturalmente enumerável |
+| **Guia definitivo** | Cobrir um tema de forma abrangente | Quando queremos ranquear para termos amplos de alto volume |
+
+---
+
+## Estrutura Padrão
+
+```markdown
+# [Título — claro, específico, com keyword principal]
+
+[Meta description / subtítulo — 1 a 2 frases resumindo o valor do artigo]
+
+---
+
+## Introdução (100–200 palavras)
+- Identifique o problema ou pergunta que o artigo resolve
+- Estabeleça por que o leitor deveria continuar
+- Apresente o que será coberto (não spoile a solução, crie antecipação)
+
+---
+
+## [Seção 1 — H2]
+
+### [Subseção 1.1 — H3, se necessário]
+
+## [Seção 2 — H2]
+
+## [Seção 3 — H2]
+
+---
+
+## Conclusão (100–150 palavras)
+- Resuma o insight principal
+- Reforce o benefício para quem aplicar o que foi ensinado
+- CTA claro: próximo passo, link relacionado, comentário, newsletter
+
+---
+
+*Tags: [keyword1], [keyword2], [keyword3]*
+```
+
+---
+
+## Título
+
+O título é o maior fator de clique. Deve comunicar o benefício e incluir a keyword principal.
+
+### Fórmulas que funcionam
+
+| Fórmula | Exemplo |
+|---------|---------|
+| Como + resultado específico | "Como reduzir o tempo de onboarding em 50%" |
+| Número + tema + benefício | "7 práticas de documentação que times de alto desempenho usam" |
+| Guia completo de + tema | "Guia completo de documentação técnica para times de produto" |
+| O que é + explicação direta | "O que é arquitetura de microsserviços e quando usar" |
+| Por que + afirmação | "Por que documentação ruim é o maior risco técnico do seu time" |
+| Comparativo | "Notion vs Confluence: qual usar para documentação técnica?" |
+
+### Checklist de título
+
+- [ ] Inclui a keyword principal?
+- [ ] Comunica o benefício ou resultado para o leitor?
+- [ ] Tem menos de 60 caracteres (para não cortar no Google)?
+- [ ] Desperta curiosidade ou urgência?
+- [ ] É específico (não genérico)?
+
+---
+
+## Introdução
+
+Os primeiros 2 parágrafos decidem se o leitor continua ou sai.
+
+### Estrutura recomendada
+
+1. **Hook** — uma pergunta, dado surpreendente ou afirmação direta
+2. **Agitação do problema** — por que isso importa para o leitor
+3. **Promessa** — o que o artigo vai entregar
+
+### Exemplo
+
+```
+Você já abriu uma base de código sem documentação e passou horas
+tentando entender o que uma função faz? Provavelmente sim.
+
+Documentação técnica desatualizada ou inexistente é responsável
+por 23% do tempo perdido em times de engenharia, segundo pesquisa
+da Stack Overflow (2024). É um custo invisível que se acumula.
+
+Neste guia, você vai aprender como estruturar uma base de
+documentação técnica que o time realmente mantém — com exemplos
+práticos, templates prontos e um processo de atualização contínua.
+```
+
+---
+
+## Conteúdo
+
+### Comprimento ideal por tipo
+
+| Tipo | Palavras | Objetivo |
+|------|----------|----------|
+| Quick guide | 500–800 | Resposta rápida para dúvida específica |
+| Artigo padrão | 1.000–1.500 | Cobertura sólida de um tema |
+| Artigo aprofundado | 1.500–2.500 | Autoridade e ranqueamento de termos competitivos |
+| Guia definitivo | 2.500–5.000 | Dominar termos amplos, conteúdo referência |
+
+### Boas práticas de escrita
+
+- **Um parágrafo = uma ideia** — se o parágrafo está longo, quebre em dois
+- **Frases curtas** — máximo 20 palavras para textos técnicos
+- **Use exemplos concretos** para cada conceito abstrato apresentado
+- **Dados e fontes** — sempre cite a origem de estatísticas
+- **Código em blocos formatados** — nunca inline em parágrafo denso
+- **Imagens com legenda** — toda imagem deve ter alt text e legenda descritiva
+
+### Hierarquia de headers
+
+```
+# H1 — Título (apenas 1 por artigo)
+## H2 — Seções principais (3 a 7 por artigo)
+### H3 — Subseções (use com moderação)
+#### H4 — Raramente necessário
+```
+
+---
+
+## SEO Básico
+
+### On-page
+
+| Elemento | Recomendação |
+|----------|--------------|
+| **Keyword no título** | Obrigatório, preferencialmente no início |
+| **Keyword no H1** | Igual ao título ou variação próxima |
+| **Keyword nos H2s** | 1 a 2 ocorrências naturais |
+| **Keyword no primeiro parágrafo** | Nas primeiras 100 palavras |
+| **Meta description** | 150–160 caracteres, com keyword e benefício |
+| **URL** | Curta, com keyword, sem stop words (`/documentacao-tecnica`) |
+| **Alt text nas imagens** | Descritivo, com keyword quando relevante |
+| **Links internos** | Mínimo 2 links para outros artigos relevantes |
+| **Links externos** | 1 a 3 para fontes autoritativas |
+
+### Intenção de busca
+
+Antes de escrever, identifique a intenção:
+
+- **Informacional** — "o que é X", "como funciona Y" → artigo explicativo
+- **Navegacional** — buscas por marca → não é o foco de blog
+- **Transacional** — "comprar X", "contratar Y" → landing page, não blog
+- **Comparativo** — "X vs Y", "melhor X" → artigo comparativo
+
+---
+
+## Conclusão
+
+A conclusão deve:
+
+1. Resumir o insight central (não repetir tudo)
+2. Reforçar o benefício para quem aplicou o conteúdo
+3. Ter um CTA claro e único
+
+### CTAs por objetivo
+
+| Objetivo | CTA |
+|----------|-----|
+| Gerar leads | "Baixe o template completo" |
+| Aumentar pageviews | "Leia também: [artigo relacionado]" |
+| Construir comunidade | "O que você faria diferente? Deixe nos comentários" |
+| Converter | "Teste gratuitamente por 14 dias" |
+| Newsletter | "Receba novos artigos toda semana" |
+
+---
+
+## Revisão e Publicação
+
+### Fluxo
+
+```
+Rascunho → Revisão de conteúdo → Revisão de SEO → Revisão de tom → Publicação
+```
+
+### Checklist final
+
+**Conteúdo:**
+- [ ] O artigo resolve o problema prometido no título?
+- [ ] Há exemplos concretos para cada conceito?
+- [ ] Dados e afirmações têm fonte?
+- [ ] A conclusão tem CTA claro?
+
+**SEO:**
+- [ ] Keyword no título, H1, primeiro parágrafo e H2s?
+- [ ] Meta description escrita?
+- [ ] URL configurada (curta, com keyword)?
+- [ ] Alt text em todas as imagens?
+- [ ] Links internos adicionados?
+
+**Formatação:**
+- [ ] Headers em hierarquia correta?
+- [ ] Parágrafos curtos com espaço entre eles?
+- [ ] Código em blocos formatados?
+- [ ] Revisado para ortografia e gramática?
+
+**Distribuição:**
+- [ ] Post de LinkedIn preparado para divulgação?
+- [ ] Newsletter incluída no calendário?
+- [ ] Tags e categoria corretas na plataforma?

package/.synapos/core/best-practices/content/copywriting.md

@@ -0,0 +1,164 @@
+---
+id: copywriting
+version: "1.0.0"
+domain: [custom]
+whenToUse: "Quando o squad cria textos persuasivos para qualquer canal"
+---
+
+# Copywriting
+
+> Guia para escrever textos que geram ação — com clareza, relevância e voz consistente.
+
+---
+
+## Princípios
+
+- **Escreva para uma pessoa, não para um público** — quanto mais específico o leitor imaginado, mais eficaz o texto
+- **Benefício antes de feature** — o leitor quer saber o que ganha, não como funciona
+- **Clareza > criatividade** — um texto simples que comunica bem supera um texto sofisticado que confunde
+- **Cada palavra tem um custo** — se não acrescenta, corta
+- **Voz consistente** — o texto deve soar como a marca, sempre
+
+---
+
+## Estrutura AIDA
+
+Framework clássico para estruturar copy persuasivo:
+
+| Etapa | Objetivo | Pergunta a responder |
+|-------|----------|----------------------|
+| **Atenção** | Parar o scroll | "Por que eu deveria ler isso?" |
+| **Interesse** | Gerar curiosidade | "Isso é relevante para mim?" |
+| **Desejo** | Criar querer | "Quero isso na minha vida?" |
+| **Ação** | Converter | "O que eu faço agora?" |
+
+### Exemplo
+
+```
+[Atenção]
+Você perde 2 horas por dia respondendo as mesmas perguntas.
+
+[Interesse]
+Times de suporte com mais de 3 pessoas gastam em média 40% do tempo
+em perguntas repetitivas — perguntas que já foram respondidas antes.
+
+[Desejo]
+Com o Synapse, sua base de conhecimento responde por você.
+Automaticamente. Sem treinamento, sem setup complexo.
+
+[Ação]
+Teste grátis por 14 dias — sem cartão de crédito.
+```
+
+---
+
+## Estrutura PAS
+
+Para copy de problema/dor — especialmente eficaz em landing pages e emails:
+
+- **P — Problema:** Identifique a dor com precisão
+- **A — Agitação:** Amplifique as consequências do problema não resolvido
+- **S — Solução:** Apresente a saída de forma clara e crível
+
+### Exemplo
+
+```
+[Problema]
+Documentação desatualizada causa retrabalho e decisões erradas.
+
+[Agitação]
+Quando os docs não acompanham o produto, novos devs perdem dias
+tentando entender como o sistema realmente funciona. Bugs surgem
+de suposições erradas. Onboarding vira um pesadelo.
+
+[Solução]
+O Synapse mantém sua documentação viva — atualizada a cada sprint,
+vinculada ao código, acessível a qualquer membro do time.
+```
+
+---
+
+## Headlines
+
+A headline decide se o resto será lido. Invista tempo aqui.
+
+### Fórmulas que funcionam
+
+| Fórmula | Exemplo |
+|---------|---------|
+| Número + benefício | "5 maneiras de reduzir o churn sem aumentar o suporte" |
+| Como + resultado | "Como documentar uma API em 30 minutos" |
+| Pergunta direta | "Seu time ainda usa planilha para roadmap?" |
+| Promessa específica | "Reduza o tempo de onboarding em 50% no primeiro mês" |
+| Antes/depois | "De docs bagunçados para base de conhecimento estruturada" |
+
+### Checklist de headline
+
+- [ ] Comunica o benefício principal?
+- [ ] É específica (números, resultados concretos)?
+- [ ] Faz o leitor querer continuar?
+- [ ] Está alinhada com o que o restante do texto entrega?
+- [ ] Evita jargão que o leitor pode não conhecer?
+
+---
+
+## CTA — Call to Action
+
+O CTA é a instrução de ação. Deve ser claro, urgente e de baixo atrito.
+
+### Boas práticas
+
+- Use verbos no imperativo: "Comece", "Baixe", "Descubra", "Teste"
+- Específico > genérico: "Ver planos" > "Saiba mais"
+- Reduza o atrito aparente: "Teste grátis" > "Compre agora"
+- Um CTA principal por peça — não divida a atenção
+
+### Exemplos por contexto
+
+| Contexto | CTA fraco | CTA forte |
+|----------|-----------|-----------|
+| Trial | "Clique aqui" | "Começar teste gratuito" |
+| Download | "Baixar" | "Baixar o guia em PDF" |
+| Contato | "Entre em contato" | "Falar com especialista" |
+| Demo | "Ver mais" | "Agendar demonstração" |
+
+---
+
+## Tom de Voz
+
+### Dimensões
+
+| Dimensão | Definição |
+|----------|-----------|
+| **Formal ↔ Informal** | Trata o leitor como "você" ou "sr./sra."? |
+| **Técnico ↔ Acessível** | Usa jargão do setor ou explica tudo? |
+| **Direto ↔ Narrativo** | Vai direto ao ponto ou conta uma história? |
+| **Sério ↔ Descontraído** | Tom corporativo ou mais próximo e humano? |
+
+### Como manter consistência
+
+1. Defina as 3 palavras que descrevem a voz da marca
+2. Para cada palavra, liste 2 exemplos de como soa e 2 de como NÃO soa
+3. Revise todo copy contra esse padrão antes de publicar
+
+---
+
+## Revisão e Edição
+
+### Processo recomendado
+
+1. **Escreva sem filtro** — dump de ideias, sem autocensura
+2. **Estruture** — organize seguindo AIDA, PAS ou estrutura definida
+3. **Corte pela metade** — elimine o que não acrescenta
+4. **Leia em voz alta** — identifica frases que travam
+5. **Revise para o leitor** — troque "nós" por "você" onde possível
+6. **Revisão final** — ortografia, gramática, links
+
+### Checklist de qualidade
+
+- [ ] O benefício principal está claro nos primeiros 2 parágrafos?
+- [ ] Há um CTA claro e único?
+- [ ] O texto está na voz definida para a marca?
+- [ ] Está escrito para o leitor certo?
+- [ ] Sem jargão não explicado?
+- [ ] Revisado por pelo menos uma segunda pessoa?

package/.synapos/core/best-practices/content/linkedin-post.md

@@ -0,0 +1,186 @@
+---
+id: linkedin-post
+version: "1.0.0"
+domain: [custom]
+whenToUse: "Quando o squad cria posts para LinkedIn"
+---
+
+# LinkedIn Post
+
+> Guia para escrever posts de LinkedIn com alcance orgânico, engajamento real e consistência de marca.
+
+---
+
+## Princípios
+
+- **O algoritmo favorece retenção** — posts que prendem o leitor até o fim ganham mais alcance
+- **Primeira linha é tudo** — antes do "ver mais" há uma linha e meia; ela decide o clique
+- **Concreto > abstrato** — histórias reais e números específicos superam generalidades
+- **Autenticidade converte** — o LinkedIn penaliza linguagem corporativa e recompensa voz humana
+- **Consistência > viralidade** — postar bem toda semana supera um post viral por mês
+
+---
+
+## Anatomia de um Post
+
+```
+[Gancho — 1 linha]
+Frase que para o scroll e força o "ver mais"
+
+[Corpo — 3 a 7 parágrafos curtos]
+Desenvolvimento da ideia com espaçamento entre parágrafos
+Uma ideia por parágrafo
+Sem blocos de texto densos
+
+[Conclusão — 1 a 2 linhas]
+Insight principal, takeaway ou convite à reflexão
+
+[CTA — 1 linha]
+Pergunta, call to comment ou próximo passo claro
+
+[Hashtags — 3 a 5]
+#Relevantes #Específicas #NãoGenéricas
+```
+
+---
+
+## Ganchos Que Funcionam
+
+A primeira linha precisa criar uma tensão que só se resolve lendo o resto.
+
+### Fórmulas
+
+| Tipo | Exemplo |
+|------|---------|
+| Contraintuitivo | "A melhor decisão da minha carreira foi recusar aquela promoção." |
+| Número específico | "Em 6 meses, reduzi o tempo de onboarding de 3 semanas para 4 dias." |
+| Pergunta incômoda | "Você ainda acha que documentação é responsabilidade do dev junior?" |
+| Confissão | "Por muito tempo, eu confundi produtividade com ocupação." |
+| Afirmação direta | "Times que não documentam não escalam. Simples assim." |
+| Storytelling | "Segunda-feira, 9h da manhã. A demo estava marcada para 10h e o ambiente de produção caiu." |
+
+### O que evitar no gancho
+
+- Frases genéricas: ~~"Hoje quero compartilhar algo importante"~~
+- Começar com "Eu": o algoritmo do LinkedIn desfavorece posts que começam com "I" (ou "Eu")
+- Spoilers: não entregue a conclusão na primeira linha
+
+---
+
+## Formatos por Objetivo
+
+### Storytelling (maior alcance orgânico)
+
+```
+[Situação inicial — contexto]
+[Complicação — o problema ou virada]
+[Ação — o que foi feito]
+[Resultado — concreto, com número se possível]
+[Lição — o que isso significa para o leitor]
+```
+
+**Exemplo:**
+```
+Assumi um time que tinha 40% de rotatividade ao ano.
+
+O problema não era salário. Não era stack tecnológica.
+Era documentação inexistente.
+
+Novos membros chegavam e passavam semanas tentando entender
+como as coisas funcionavam. Perguntando os mesmos. Perdendo
+confiança. Saindo.
+
+Em 4 meses, implementamos um protocolo de documentação contínua.
+Em 12 meses, a rotatividade caiu para 8%.
+
+Conhecimento documentado não é burocracia.
+É o que faz um time sobreviver ao crescimento.
+
+Qual é a maior lacuna de documentação no seu time hoje?
+```
+
+### Listicle (alto salvamento e compartilhamento)
+
+```
+[Gancho com número]
+[Lista com 1 item por linha, espaçado]
+[Conclusão curta]
+[CTA]
+```
+
+**Exemplo:**
+```
+5 sinais que seu processo de onboarding está quebrado:
+
+→ Novos devs ficam com medo de perguntar
+→ Ninguém sabe onde fica a documentação
+→ O "ritual" de integração depende de uma pessoa específica
+→ As primeiras semanas são passadas "observando" sem contribuir
+→ O turnover nos primeiros 6 meses é acima de 20%
+
+Se você reconhece 3 ou mais: o problema não é a pessoa, é o processo.
+
+Qual desses você já viveu?
+```
+
+### Opinião / Hot take (debate e comentários)
+
+```
+[Afirmação forte e direta]
+[Argumento 1]
+[Argumento 2]
+[Contra-argumento reconhecido]
+[Posição reafirmada]
+[Pergunta para debate]
+```
+
+---
+
+## Formatação
+
+- **Parágrafos curtos** — 1 a 3 linhas no máximo
+- **Uma linha em branco** entre cada parágrafo
+- **Negrito** só para o que é essencial — não abuse
+- **Emojis** com moderação — 0 a 3 por post dependendo do tom da marca
+- **Sem links no corpo do post** — coloque no primeiro comentário (o algoritmo penaliza links que tiram o leitor do LinkedIn)
+
+---
+
+## Hashtags
+
+- Use 3 a 5 hashtags específicas e relevantes
+- Evite hashtags genéricas demais (#vida, #trabalho) — muito ruído, pouco alcance
+- Prefira hashtags de nicho com comunidade ativa
+
+### Exemplos por área
+
+| Área | Hashtags recomendadas |
+|------|-----------------------|
+| Tech / Dev | #desenvolvimento #engenharia #software #tecnologia |
+| Produto | #productmanagement #produto #uxdesign |
+| Liderança | #liderança #gestão #cultura |
+| Carreira | #carreira #mercadodetrabalho #growth |
+
+---
+
+## Frequência e Consistência
+
+- **Mínimo recomendado:** 2x por semana
+- **Ideal:** 3 a 5x por semana
+- **Melhor horário (BR):** terça a quinta, 7h–9h ou 12h–13h
+- **Responda comentários** nas primeiras 1h — o algoritmo favorece posts com engajamento rápido
+
+---
+
+## Checklist de Qualidade
+
+Antes de publicar:
+
+- [ ] A primeira linha funciona como gancho sem precisar do "ver mais"?
+- [ ] Os parágrafos são curtos com espaço entre eles?
+- [ ] Há um CTA claro no final?
+- [ ] Sem links no corpo do post?
+- [ ] Tem 3 a 5 hashtags relevantes?
+- [ ] Está na voz da marca/pessoa?
+- [ ] Revisado para erros ortográficos?
+- [ ] Relido como se fosse a primeira vez para verificar clareza?