> ## Documentation Index
> Fetch the complete documentation index at: https://freshbase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Tip>
  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.
</Tip>

## 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"

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

## 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
```

<Card title="Como configurar integrações" icon="arrow-right" href="/how-to/setup-integrations">
  Guia detalhado
</Card>

## 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?

<Warning>
  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.
</Warning>

## 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".