A IA escreve o código. Você decide nos portões.
O UTF-SDD é o método da disciplina de Tópicos Especiais da UTFPR. Ele existe para que, no fim do semestre, você consiga explicar cada linha que entrou no seu projeto — inclusive as que não foi você que digitou.
| commit | o que entrou | escreveu | autorizou |
|---|---|---|---|
| 9c1e04a | spec e plano da issue 27 | você | você |
| 4b7ad12 | spec: rascunho para aprovada | você | você |
| e30f8a6 | tarefa 1: entidade Orçamento | IA | você |
| 7fd2b90 | tarefa 2: recusa orçamento vencido | IA | você |
| 1a5c8e3 | tarefa 3: aviso ao aprovar | IA | você |
| c02d7f5 | docs: prd e arquitetura no mesmo commit | IA | você |
O problema que o método resolve
Pedir código para uma inteligência artificial é fácil. Qualquer pessoa gera uma tela funcionando em cinco minutos. O problema aparece semanas depois: o sistema faz coisas que ninguém pediu, ninguém lembra por que uma regra existe e, quando é preciso mudar algo, a vontade é apagar tudo e recomeçar.
Nesta disciplina você não é avaliado por gerar código rápido. Você é avaliado por dirigir a IA, auditar o que ela gerou e explicar as decisões técnicas. Você é o engenheiro e o arquiteto; a IA é a sua equipe de execução.
Se o Pull Request for a primeira vez que você olha o código, o método falhou. A regra de ouro, do guia da disciplina
O que é um portão
O UTF-SDD é um SDD por portões (Gated Spec-Driven Development). Portão é um ponto onde o trabalho para e espera por uma decisão sua — decisão que fica registrada em algum lugar que outra pessoa consegue conferir depois. Neste site, um portão aparece assim:
status: rascunho por status: aprovada e commite essa
linha. O commit fica no git log, com o seu nome. Nenhum agente mexe nesse campo.
São quatro portões por história, mais o Pull Request no fim. Nenhum deles é burocracia: cada um existe porque, sem ele, alguma coisa que você deveria ter decidido seria decidida pela IA no seu lugar, sem você perceber.
Três compromissos
Spec-Driven Development não é invenção desta disciplina. O que distingue a variante daqui são três compromissos que o método não abre mão.
Nada avança sem uma decisão sua, registrada
Aprovar a spec, aceitar a explicação do tutor, triar cada apontamento da revisão, autorizar cada commit. A decisão vira arquivo ou vira commit — memória de conversa não conta, porque não sobrevive à sessão e não prova nada na defesa.
Quem revisa nunca é quem escreveu
O implementador começa com o contexto limpo. Dois revisores diferentes olham o resultado, e nenhum dos dois tem permissão de escrita — eles apontam, não corrigem. Um agente que corrige o próprio trabalho herda o próprio ponto cego e some com a evidência do erro.
Todo artefato é evidência para a defesa
Specs, planos, pareceres, decisões de triagem e mensagens de commit não existem para encher pasta. Eles existem para provar, no dia da arguição, que você entendeu o que assinou.
Quem produz o quê
O método gira em torno de doze artefatos. Desses doze, a IA produz sozinha apenas três: o código, o plano de tarefas e os pareceres de revisão. A ficha da disciplina já vem pronta no template. Todo o resto precisa da sua direção.
| Artefato | Onde fica | Quem dirige |
|---|---|---|
README.md | raiz | você |
docs/prd.md | o que o produto faz | você |
docs/architecture.md | onde as coisas moram | você |
docs/user-flows.md | o que a pessoa vive na tela | você |
docs/design-tokens.md | cores, espaçamento, tipografia | você |
docs/checklist.md | a ficha da disciplina | vem no template |
| Issue | GitHub Projects | você |
spec.md | o que precisa existir | você aprova |
plan.md | como será construído | IA |
| Pareceres | reviews/ | IA |
| Código | apps/ | IA |
| Pull Request | GitHub | você |
Comece por aqui
Se você acabou de criar o seu repositório pelo Use this template, siga nesta ordem:
- Entenda o ciclo — a Fase 0, o ciclo de uma história e os quatro portões.
- Veja os comandos — o que digitar em cada etapa e o que sai de cada um.
- Conheça os papéis — quem escreve, quem revisa e por que a trava de escrita importa.
- Leia
docs/checklist.mdno seu repositório — é a ficha da disciplina, com as regras e as entregas.
Este site ensina o método. A regra escrita, valendo como fonte da verdade, está no guia da disciplina e no tutorial, dentro do repositório. Quando os dois divergirem, vale o que está no repositório.