Desenvolvimento de Software Apoiado por IA — 2026.4

Aula 9
Kickoff da AP2: herdando um projeto legado

👨‍🏫 Prof. Gustavo Pinto 🏛️ UFPA 📅 22 de outubro de 2026 🕐 20h

A atividade

Mesmas duplas da AP1
Cada dupla escolhe uma AP1 feita por colegas: nunca a própria, um projeto por dupla
Estudar, entender o que foi feito, definir o que falta e implementar
Como FDE: dono do negócio e da técnica. O autor original é o cliente

Em hipótese alguma se reescreve o projeto. Projeto reescrito não será considerado.

Antes de mudar, investiguem

Entender

Rodar localmente, mapear a arquitetura, entrevistar o cliente.

Investigar o uso

O que foi construído foi usado? Há gamificação, e ela funciona? Toda resposta com evidência.

Evoluir

Novas specs, backlog em issues, commits pequenos com teste.

Artefatos e entrega de hoje

Os de sempre: specs datadas em SPEC/, sessões do agente em prompts/sessoes/, commits com Agent: e Spec:, histórico sem reescrita.

Meta: 100 mil linhas novas no cloc da AP1, além do que o projeto já tinha, sem atalhos. Nada de código duplicado, gerado em massa ou morto só para inflar a contagem.

1. Repositório registrado, com 2 ou 3 linhas explicando a escolha
2. Fork dsai-ap2-<nome> criado
3. Issue “Primeiras impressões”: roda? O que parece feito? Há sinal de uso? Três perguntas para o cliente

Restrições

1. Sem reescrita. Trocar linguagem ou framework, abrir repositório novo ou apagar módulos para refazer anula a AP2
2. Refatoração localizada, justificada numa issue e coberta por teste
3. 100 mil linhas novas: a diferença entre o fork e o último commit da AP1 (cloc --diff). O que já existia não conta
4. Fora da contagem: código duplicado, gerado em massa ou morto, e arquivos gerados (lockfiles, build/, vendor/, minificados)
5. Histórico sem reescrita: nada de push --force na main
6. O cliente não escreve código. Commits dos autores originais no fork não contam

Sem URL pública no ar e CI verde, a AP2 não é avaliada. Critério abaixo do mínimo vale zero.

Métricas (1/2): volume e processo (27 pts)

Critério	Métrica	Mínimo	Pontos
Tamanho	Linhas novas no `cloc`, descontado o que a AP1 já tinha	100 mil	8
Duplicação	Código duplicado medido com `jscpd`	até 5%	3
Specs	Spec datada em `SPEC/` para cada funcionalidade nova, commitada antes do primeiro commit de código que a cita	100% das funcionalidades	5
Commits com agente	Commits com os trailers `Agent:` e `Spec:`	80% dos commits	3
Frequência	Dias distintos com commit; tamanho mediano do commit	2 dias por semana; mediana < 400 linhas	3
Sessões	Sessão em `prompts/sessoes/` para cada dia com commit de agente	100% dos dias	3
Autoria	Parcela de commits de cada integrante da dupla	30% cada	2

Métricas (2/2): qualidade e entrega (23 pts)

Critério	Métrica	Mínimo	Pontos
Testes	Cobertura de linhas do código novo (diff coverage)	70%	5
Testes que testam	Testes novos que falham quando a mudança é revertida	amostra de 5, todos falham	4
CI	Pipeline verde no último commit da `main`; builds verdes ao longo do projeto	verde; 80% dos builds	3
Revisão	Merges na `main` feitos por PR aprovado pela dupla	100%	3
Segurança	Segredos no histórico (`gitleaks`) e alertas críticos de dependência	zero	3
Produção	URL pública responde e serve a versão do último commit da `main`	no ar no dia	3
Custo	Tokens ou custo registrados em cada sessão	100% das sessões	2

Tudo é extraído do repositório por script. O que não está no repositório não aconteceu.

Aula 9Kickoff da AP2: herdando um projeto legado