Premissas¶
A cliente é professora e fala com o time em reunião marcada. Uma dúvida de produto no meio da sprint não tem resposta em minutos, como teria num time de empresa. Parar a tarefa até a próxima reunião custa dias; decidir em silêncio custa retrabalho.
A saída é a mesma dos dois lados: ✅ decidir, registrar a decisão como premissa e seguir.
A regra¶
Apareceu uma dúvida de produto no meio da tarefa:
- Não pare. Escolha a interpretação mais provável e mais barata de reverter.
- Registre a premissa — como afirmação, não como pergunta.
- Marque no código onde ela foi usada.
- Siga a tarefa.
- Na próxima reunião, a premissa entra na pauta, e a cliente confirma ou refuta.
É premissa ou não é?¶
| Dúvida | Premissa? |
|---|---|
| "O prognóstico considera respondentes inativos?" | ✅ produto — a cliente decide |
| "O relatório exporta PDF ou CSV?" | ✅ produto |
| "Esse campo é obrigatório na primeira versão?" | ✅ produto |
| "Isso vai no service ou no repository?" | ❌ técnica — está em Backend |
| "Que nome dou para a branch?" | ❌ técnica — está em Branches |
Dúvida técnica não vira premissa. Ela está neste site, no molde, ou é pergunta para um AGES III — e, se não estava escrita, a resposta vira página aqui.
Como escolher a interpretação¶
Nesta ordem:
- O que o produto já faz em situação parecida.
- O mais barato de reverter. Entre "guardar o campo e não mostrar" e "não guardar", guarde: coluna nova depois é migration simples; dado que nunca foi gravado não volta.
- O menor escopo. Na dúvida entre fazer uma coisa ou três, faça uma.
- O que não trava outra pessoa. Prefira a interpretação que mantém o contrato de API.
Nunca escolha "o mais completo, porque dá mais trabalho". Premissa errada com escopo grande é a mais cara de desfazer.
Onde registrar¶
O registro de todas as premissas — o ledger — fica no creed-ai-context, em
decisoes/premissas.md.
Cada uma tem um ID P-NNN que nunca se reaproveita, a data, a interpretação adotada,
o motivo, o custo de reverter e o status.
- Você trabalha com o
creed-ai-context? Acrescente a linha no ledger, com o próximo número livre, e abra o PR de documentação logo — premissa sem commit é invisível para o time, e duas pessoas acabam pegando o mesmo número. - ✅ Não trabalha? Escreva a premissa na seção Premissas do seu PR, como "premissa nova, sem número", e marque um AGES III no PR. Ele a leva ao ledger e devolve o número — você não espera por isso para seguir a tarefa.
Como marcar no código¶
Um comentário no ponto em que a premissa decide o comportamento — o mesmo formato que já está no código:
// > 🟡 Premissa P-004 — mínimo de 8 caracteres, sem regra extra de
// complexidade. Confirmar com o time.
Quando a premissa é confirmada, o marcador sai. Quando é refutada, vira tarefa de correção — e o comentário diz exatamente onde mexer.
O ciclo de vida¶
🟡 aberta ──reunião──▶ ✅ confirmada (vira regra; o marcador sai do código)
└──▶ ❌ refutada (vira tarefa de correção no ClickUp)
└──▶ 🟡 segue aberta (entra na pauta seguinte)
Premissa refutada não é erro do time — é o mecanismo funcionando. Erro é a premissa que nunca foi registrada e virou comportamento silencioso do produto.