Guia do Tech Lead / Engineer

Como Tech Leads e Engineers podem usar o Freshbase para registrar decisões técnicas e conectar planejamento com execução.

Este guia mostra como Tech Leads e Engineers podem usar o Freshbase para registrar decisões técnicas, entender contexto de features e conectar planejamento com execução.

​

Seu fluxo no Freshbase

Como Tech Lead, seu foco está em decisões técnicas e contexto:

Decisão técnica surge (reunião, discussão, análise)
    ↓
Registra no Freshbase (Chat ou Inbox)
    ↓
Documenta trade-offs e alternativas
    ↓
Conecta com tarefas no Linear
    ↓
Time tem contexto para implementar

​

1. Registre decisões técnicas (ADRs)

Architecture Decision Records são essenciais para rastreabilidade. O Freshbase facilita:

​

Criando um ADR pelo Chat

“Crie um ADR sobre a decisão de usar PostgreSQL em vez de MongoDB para o módulo de relatórios. Os fatores foram: necessidade de queries complexas, time já conhece SQL, e requisito de consistência transacional.”

O assistente gera um documento estruturado com:

• Contexto do problema
• Decisão tomada
• Alternativas consideradas
• Consequências

​

A partir de reuniões

Quando uma decisão técnica é tomada em reunião:

1. A transcrição é processada automaticamente
2. A decisão aparece no Inbox
3. Ao aprovar, você pode pedir ao assistente para expandir em um ADR completo

Registre decisões no momento em que são tomadas. Depois de uma semana, o contexto e os motivos ficam mais difíceis de lembrar.

​

2. Entenda o contexto antes de implementar

O Freshbase centraliza todo o contexto de um projeto:

​

Explorando a Base

“Me dê um resumo de tudo que foi decidido sobre o módulo de pagamentos” “Quais requisitos existem para a feature de busca avançada?”

​

Entendendo decisões passadas

“Por que decidimos usar gRPC em vez de REST para a comunicação entre serviços?” “Quais foram os trade-offs discutidos na escolha do banco de dados?”

​

Identificando lacunas

“Quais requisitos não-funcionais ainda não foram definidos para o módulo de autenticação?”

O assistente tem acesso a todos os documentos da Base e pode cruzar informações de diferentes reuniões e especificações.

​

3. Explore trade-offs com o Chat

O Chat é ideal para pensar sobre decisões técnicas antes de implementar:

​

Análise de alternativas

“Compare as abordagens de cache: Redis vs Memcached vs cache in-memory para nosso caso de uso de sessões”

​

Avaliação de impacto

“Se migrarmos o serviço de notificações para event-driven, quais são os impactos nos serviços existentes?”

​

Planejamento de implementação

“Quebre a migração do monolito para microsserviços em fases incrementais”

Use o modo Pro do Chat para análises técnicas detalhadas. O resultado inclui mais nuances e considerações.

​

4. Conecte com o Linear

A integração com o Linear liga planejamento a execução:

​

Criando issues a partir de especificações

“Crie issues no Linear para as subtarefas da história de busca avançada”

​

Referenciando tarefas em documentos

O assistente pode buscar issues existentes no Linear e referenciar nos documentos da Base.

​

Fluxo completo

Decisão documentada no Freshbase
    ↓
Tarefas criadas no Linear (via Chat)
    ↓
Devs implementam com contexto completo
    ↓
Decisões e requisitos sempre rastreáveis

Como configurar integrações

Guia detalhado

​

5. Revise extrações técnicas no Inbox

O Inbox traz extrações relevantes para o time técnico:

• Decisões técnicas de reuniões — vale registrar como ADR?
• Tarefas de implementação — criar issue no Linear?
• Dependências identificadas — precisa de atenção antes de começar?

Não ignore itens técnicos no Inbox. Uma tarefa “verificar certificado SSL do staging” pode parecer menor, mas é o tipo de coisa que se perde sem registro.

​

6. Mantenha contexto para o time

Como Tech Lead, você é a ponte entre decisões e execução:

​

Constitution para padrões técnicos

Se seu time tem padrões recorrentes (ex: “sempre usar TypeScript strict mode”, “APIs devem seguir REST Level 3”), coloque na Constitution da Base. O assistente respeita essas regras ao gerar documentos.

​

Glossário técnico

Cadastre termos técnicos do projeto no glossário:

• Nomes de serviços, módulos e componentes
• Acrônimos usados pelo time
• Termos de domínio com significado técnico específico

​

Rotina sugerida

Quando	O que fazer
Após reuniões técnicas	Revisar Inbox, aprovar decisões, criar ADRs
Antes de iniciar uma feature	Explorar a Base para entender contexto e requisitos
Ao tomar uma decisão	Registrar via Chat imediatamente
No planejamento do sprint	Usar Chat para decompor tarefas e criar issues no Linear
Semanalmente	Verificar se decisões recentes estão documentadas

​

Dicas para Tech Leads

• ADRs são investimento. Documentar decisões agora economiza horas de discussão no futuro.
• Pergunte “por quê?” à Base. O Freshbase pode cruzar informações de múltiplas reuniões e docs para explicar o contexto de uma decisão.
• Use Constitution. Regras técnicas recorrentes na Constitution evitam que o assistente gere documentos fora dos padrões.
• Linear + Freshbase = fluxo completo. Conectar os dois elimina o gap entre “o que decidimos” e “o que estamos implementando”.