Skip to main content

​
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:
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