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

# Planejamento no Linear

> Pacote canônico de planejamento e o modelo operacional recomendado do Linear para este repositório.

# Planejamento no Linear

Este repositório agora tem um pacote de planejamento dedicado para o Linear em `planning/linear/`.

Esse pacote é a ponte de execução pretendida entre:

* documentos-fonte extensos em `docs/`
* gerenciamento de projeto ativo no Linear
* trabalho de implementação em nível de issue
* descobertas substanciais encontradas durante a implementação

## Arquivos canônicos

* `planning/linear/README.md`
* `planning/linear/OPERATING_MODEL.md`
* `planning/linear/PROJECT_BRIEF.md`
* `planning/linear/BACKLOG.yaml`
* `planning/linear/ISSUE_TEMPLATES.md`

## Estrutura recomendada no Linear

* um time principal para execução ativa
* iniciativas para frentes estratégicas
* projetos para resultados concretos
* milestones para checkpoints
* um documento `Overview` por projeto
* issues para fatias do tamanho de um PR

O workspace atual usa um portfólio de iniciativas/projetos em vez de um projeto guarda-chuva redundante.

## Por que isso existe

O repositório havia acumulado:

* um PRD extenso
* uma sequência de implementação numerada
* planejamento de migração
* backlog de hardening
* estratégia de feature flags
* revisão de customização e builder

Esses documentos ainda são valiosos, mas devem ser material-fonte, não superfícies de execução paralelas.

## Regra prática

Se um artefato de planejamento não mapeia claramente para:

* iniciativa
* projeto
* milestone
* issue
* documento de projeto

então provavelmente não deveria se tornar um novo documento de planejamento.

## Comportamento de sincronização

`pnpm linear:sync` e `pnpm linear:sync:apply` tratam `planning/linear/*` como a fonte para:

* iniciativas
* projetos
* milestones
* um documento `Overview` de projeto por projeto
* issues semente (seed issues)

Atualizações de projeto semeadas estão disponíveis, mas são explícitas em vez de automáticas:

```bash theme={null}
pnpm linear:sync:apply:with-updates
```

Bloqueadores substanciais, lacunas de paridade e lacunas arquiteturais encontradas durante a codificação não devem permanecer em logs de chat ou na prosa do PR. Eles devem se tornar uma issue do Linear criada ou atualizada antes do encerramento da sessão.

## Leia a seguir

* [Roadmap](/pt-BR/roadmap)
* [Revisão Adversarial](/pt-BR/operations/adversarial-review)
* [Arquitetura da Plataforma](/pt-BR/platform/architecture)