Metodologia — Backstage Freelaw

Ciclo de Produção

Cada feature, fix, ou evolução segue este ciclo. Sem atalhos. O ciclo garante que não se constrói lixo.

📋Super PRD1-2 dias

→

🎨Protótipo1-2 dias

→

🔄Iterar1-2 dias

→

📋PRD v20.5 dia

→

✅Aprovar0.5 dia

→

🤖Claude Code1-3 dias

→

🧪Testes0.5 dia

→

🚀Ship—

Detalhamento de cada etapa

1

Super PRD

A pessoa dona do gate escreve um mini-PRD cobrindo: o que precisa ser feito, por que, estado atual, o que muda, e criterios de aceitacao. Pode ser .md, .html, ou qualquer formato. Sobe pro servidor e registra no PRD Hub.

2

Protótipo (Figma)

Com base no PRD, cria-se um protótipo no Figma. Figma = canvas de exploração, NAO e source of truth de tokens/componentes (o código e). O protótipo serve pra alinhar expectativas visuais e de fluxo.

3

Iterar no protótipo

Time revisa o protótipo, faz ajustes direto no Figma. VDC + owner do gate validam. Perguntas de discovery são respondidas nessa fase. O protótipo evolui ate estar "bom o suficiente" (não perfeito).

4

PRD v2

Atualizar o mini-PRD com tudo que aprendeu na iteração do protótipo. Resolve ambiguidades, fecha decisões pendentes, e documenta o escopo final.

5

Aprovação

VDC + owner aprovam o PRD v2. Isso da o mandato para construir. Sem aprovação = sem código.

6

Claude Code produz

Com o PRD aprovado + protótipo como referencia, Claude (IA) produz o código seguindo as regras do AGENTS.md: Bun only, PRs ≤ 500 linhas, zero @ts-nocheck, auth em toda rota, testes inclusos.

7

Testes + Review

PR criado, review pelo owner do gate. Testes automaticos + teste manual. Se falhou, volta pro Claude ajustar.

8

Ship

Merge na main, deploy automatico (Vercel). Validar em produção. Atualizar status no Kanban.

Rituais do Time

Daily Report (async)

Todo dia, fim do dia

Cada pessoa envia um report curto (3 linhas max): o que fez, o que vai fazer amanha, se está bloqueado. Canal: Slack #backstage-daily ou ops.dev.

Sprint Planning (sincrono)

Segunda, inicio da sprint

Reunião de abertura. Revisar entregas da sprint anterior, definir scope da proxima, atribuir tarefas, fechar decisões. 45-60min. Usar ops.dev como base.

Mid-Sprint Check (sincrono)

Quinta ou Sexta

Checkpoint rapido (20-30min). Verificar progresso do board, identificar bloqueios, ajustar scope se necessário. Se sprint de 2 semanas, fazer na quinta da primeira semana.

Sprint Review + Demo

Ultima sexta da sprint

Cada pessoa mostra o que construiu (demo real, não slides). 5min por pessoa. Celebrar entregas, documentar aprendizados. Opcional: convidar stakeholders.

Sync com Migração

Bi-semanal (quarta)

Alinhamento com o time de migração (Carolina, Didico). O que eles precisam do Backstage, o que nos precisamos deles. 20min.

Script da Reunião de Sprint

Roteiro para o lider (Guilherme/VDC) conduzir a reunião de sprint. Adapte conforme a situação.

--- ABERTURA (5 min) --- VDC: "Bom dia, time. Sprint [N] comecando. Objetivo desta sprint: [resumo em 1 frase]." VDC: "Antes de comecar, resultado da sprint anterior:" [Abrir ops.dev/backstage/sprint1.html → tab Board] [Mostrar stats: X tasks concluidas de Y total] --- REVIEW (10 min) --- VDC: "Vamos rapidamente ver o que cada um entregou." [Chamar cada pessoa - 1-2min cada:] Pessoa: "Fiz X, Y e Z. [bloqueei em W / não consegui A porque B]." VDC: "OK, anotado." [Anotar no notes da decisão ou no board] --- DECISÕES (15 min) --- VDC: "Temos [N] decisões para fechar nesta sprint." [Abrir ops.dev/backstage/sprint1.html → tab Decisões] VDC: "Decisão [Dx]: [título]. Opções: A, B, C. Discussão?" [Dar 2min de discussão por decisão] VDC: "Fechado: opção [X]. Motivo: [1 frase]. Seguimos." [Clicar na opção no sprint planning + adicionar nota] --- ATRIBUIÇÕES (10 min) --- VDC: "Agora as tarefas desta sprint." [Abrir ops.dev/backstage/kanban.html] VDC: "[Pessoa], suas tarefas esta sprint: [listar 3-5 tarefas]." VDC: "Tem alguma duvida ou bloqueio que ja sabe?" [Mover cards do backlog para a coluna correta] --- DISCOVERY (5 min) --- VDC: "Discovery: cada um tem perguntas pendentes no Super PRD." [Abrir ops.dev/backstage/sprint1.html → tab Discovery] VDC: "[Pessoa], voce tem [N] perguntas. Prazo: responder ate [quinta]." --- ENCERRAMENTO (5 min) --- VDC: "Resumo: [1 frase do objetivo], [N tarefas atribuidas], [N decisões fechadas]." VDC: "Daily reports todo dia. Mid-sprint check na [quinta/sexta]." VDC: "Alguma duvida? Não? Vamos!"

Regras do Jogo

Deadline não muda: 30 de Abril de 2026. Se o prazo ameaca, corta-se ESCOPO, nunca o prazo.

Regras fundamentais

PRD primeiro, código depois. Nada se constrói sem PRD documentado e aprovado.
Protótipo antes de código. Figma = explorar ideias. Código = executar ideias validadas.
Discovery antes de build. Sprint 1 e para descobrir o que funciona, o que falta, o que está quebrado.
Cada pessoa e dona de um domínio. Autonomia com responsabilidade. Se bloqueou, comunica imediatamente.
IA como membro do time. Claude produz código e testes. Humanos definem o que, como e por que.
PRs ≤ 500 linhas. PRs grandes não passam review. Quebrar em pedacos menores.
Zero @ts-nocheck, zero as any. TypeScript estrito. Se a tipagem e dificil, a interface está errada.
Auth em toda rota. Sem excecao. RLS obrigatório.
Bun only. Nada de npm ou yarn.
Daily reports. Sem report = sinal de bloqueio. VDC vai buscar.

Princípio de corte de escopo

Se ameaca o prazo: Cortar escopo na ordem: Desejaveis (P2) → Importantes (P1) → nunca Essenciais (P0). Se P0 ameaca, escalar para VDC imediatamente.

Time e Dominios

Pessoa	Domínio	Gates	Mini-PRD
VDC / Guilherme	Lider + Financeiro	G1, G5, Cross	Super PRD + validação
Alex	CRM / Revenue	G3, G5	Mini-PRD CRM
JP	Workflows / Integrações	G4, G6, G7	Mini-PRD Automações
Duda	Juridico / Prestadores / DS	G6	Mini-PRD Juridico
Giovanna	CS	G2	Mini-PRD CS
Clariny	Financeiro + RH	G1, MA9	PRD Clariny (pronto)

Workflow de Desenvolvimento

Depois que o PRD está aprovado, o código segue este fluxo (definido no AGENTS.md):

1

PLAN

Ler o PRD, mapear arquivos afetados, propor abordagem. Claude ou dev humano faz isso. Resultado: plano de implementação com lista de arquivos.

2

CLARIFY

Perguntas antes de codar. "O schema X existe? A rota Y precisa de auth? O componente Z ja foi criado?" Melhor perguntar do que assumir errado.

3

BUILD

Implementar. TypeScript estrito, Drizzle ORM, Tailwind 4, componentes do @freelaw/ui. PRs ≤ 500 linhas. Uma coisa por PR.

4

VALIDATE

Rodar testes, verificar build, checar TypeScript. bun run build, bun test, tsc --noEmit. Tudo verde antes de abrir PR.

5

SHIP

Abrir PR, descrever o que mudou e por que, pedir review. Merge → deploy automatico. Validar em produção.

Playbook do Lider (para Guilherme)

Guia pratico para liderar o time na Fase 0. Voce não precisa saber tudo — precisa garantir que as coisas certas acontecam.

Seu papel como lider: Destravar, priorizar, decidir, e cobrar. Voce não precisa codar tudo — precisa garantir que o time saiba O QUE fazer e TENHA CONDICOES de fazer.

5 responsabilidades diarias

Verificar daily reports. Se alguem não mandou, perguntar "ta bloqueado?". Silencio = problema.
Destravar bloqueios. Se alguem está parado, sua prioridade e resolver. Falar com quem precisa, tomar a decisão, ou escalar.
Atualizar o board. O Kanban (ops.dev/backstage/kanban.html) deve refletir a realidade. Mover cards, fechar decisões.
Proteger o escopo. Se alguem quer adicionar algo fora do PRD, a resposta e "primeiro documenta no PRD". Sem excecao.
Comunicar progresso. Uma vez por sprint (ou mais se necessário), reportar para Ju/stakeholders: o que entregou, o que vai entregar, riscos.

Como lidar com situações comuns

Situação	O que fazer
Alguem está bloqueado	Perguntar: "O que precisa pra destravar?" e resolver em < 24h
Escopo crescendo	Voltar pro PRD. "Isso está no escopo? Se não, vai pro backlog."
Decisão dificil	Usar a regra: "Qual opção destranca mais coisas?" Se 50/50, decide e segue.
Prazo ameacado	Cortar escopo (P2 → P1). Nunca cortar prazo. Comunicar stakeholders.
Alguem entregou mal	Review especifico: "Isso não atende X do PRD. Vamos ajustar." Sem julgamento.
Conflito entre prioridades	Voltar para os Gates. G1 e G3 sao os mais criticos. O resto e derivado.
Pessoa não responde discovery	Cobrar direto: "[Nome], preciso das respostas ate [data]. Posso ajudar?"
Feature request novo	"Legal. Escreve um mini-PRD e a gente avalia na proxima sprint."

Checklist para reunião de amanhã (Sprint 1)

Abrir ops.dev.freelaw.ai/backstage/sprint1.html no projetor/tela
Revisar as 10 decisões — quais voce ja tem opiniao formada?
Definir o objetivo da Sprint 1 em 1 frase
Confirmar que cada pessoa sabe seu domínio e suas tarefas
Pedir o Mini-PRD CRM do Alex (precisa subir pro servidor)
Confirmar que Clariny ja tem o PRD publicado (prd-clariny.vercel.app)
Definir prazo para discovery questions (sugestao: quinta-feira)
Explicar o ciclo: PRD → Protótipo → Iterar → PRD v2 → Aprovar → Claude Code
Mostrar o Kanban e explicar como usar
Definir formato dos daily reports (Slack ou outro canal)

Lembre-se: A Sprint 1 e de DISCOVERY. O objetivo não e construir features — e descobrir o que funciona, o que falta, e documentar tudo. A construção comeca na Sprint 2. Não se pressione para entregar código nesta sprint.