A atividade

• Cada dupla escolhe e constrói uma aplicação não trivial
• Exemplos: pedido de comida, carona e divisão de viagens, avaliação de lugares
• Construída com o agente, seguindo o fluxo spec, plan, tasks da Aula 5
• Vale 30 pontos, e é a única atividade prática do semestre

Requisitos

Uma aplicação no ar sem os prompts não será avaliada.

O repositório

• Um repositório novo e público no GitHub, separado do diário
• Nome sugerido: dsai-ap1-<nome-da-app>
• Os dois integrantes fazem commit com a própria conta: é pelo autor do commit que se sabe quem conduziu cada sessão
• Nada de upload pela interface web do GitHub. Tudo entra por git commit e git push

Estrutura de pastas

.
├── README.md      # URL, dupla, stack, como rodar, ferramentas, modelos, saída do cloc
├── SPEC/          # uma spec por parte do sistema, datada
├── src/           # organização interna livre
├── tests/
└── prompts/
    └── sessoes/   # exportações brutas das ferramentas

Opcionais: PLAN.md, TASKS.md, AGENTS.md, um índice dos prompts, o registro de custo. Usem se ajudar.

A pasta SPEC/

• Um arquivo por parte do sistema, com a data em que foi escrito: AAAA-MM-DD-<parte>.md
• Cada spec entra em um commit anterior ao código que ela descreve. O histórico do git mostra a ordem
• Ajuste pequeno: edite e faça commit. Mudança de rumo: um arquivo novo, datado, dizendo qual spec substitui

SPEC/
├── 2026-09-29-visao-geral.md
├── 2026-09-29-cadastro-e-login.md
├── 2026-09-30-cardapio.md
├── 2026-09-30-carrinho.md
└── 2026-10-01-pagamento.md   # substitui a parte de checkout de carrinho.md

O que vai em cada spec

# Carrinho (2026-09-30)

## O quê e por quê
O cliente junta itens de um restaurante antes de pagar.

## Critérios de aceitação
- itens de restaurantes diferentes não se misturam
- item sem estoque não entra no carrinho
- o total inclui a taxa de entrega

## Fora do escopo
Cupons de desconto.

Critérios de aceitação verificáveis são o que o agente usa para saber quando parar, e o que vocês usam para revisar.

Todo prompt conta

• Do primeiro ao último, incluindo os que falharam e os que foram refeitos
• Incluindo os de uma palavra: “continue”, “corrija”
• Incluindo os feitos em outra ferramenta, como um chat no navegador usado para rascunhar a spec
• Copiados como foram escritos, com erros de digitação. Nunca reescritos depois

prompts/sessoes/: a fonte de verdade

• Ao fim de cada sessão, a exportação bruta vai para a pasta, com o nome AAAA-MM-DD-HHMM-<ferramenta>.<ext>
• Claude Code: o .jsonl da sessão, em ~/.claude/projects/<pasta-do-projeto>/. O /export gera uma versão legível
• Codex CLI: os arquivos em ~/.codex/sessions/
• Outras ferramentas: a exportação de conversa da ferramenta. Se não houver, copie a conversa inteira para um .md
• Arquivos acima de 50 MB vão compactados com gzip

Commits

• Pequenos e frequentes, pelo menos um por parte do sistema
• Origem declarada em dois trailers no fim da mensagem: o agente e a spec que o commit implementa

carrinho: bloqueia item sem estoque

Agent: claude-code/claude-sonnet-5-5
Spec: SPEC/2026-09-30-carrinho.md

• Escrito à mão: Agent: none. Gerado e editado à mão: Agent: claude-code/claude-sonnet-5-5 + manual
• O histórico não se reescreve: sem squash, sem rebase do que já foi enviado, sem push --force
• A spec entra em commits anteriores ao código que ela descreve

Contagem de linhas

Apenas arquivos versionados, sem documentação nem dados:

cloc . --vcs=git \
  --exclude-dir=node_modules,vendor,dist,build,prompts \
  --exclude-lang=Markdown,JSON,YAML,CSV,Text,SVG \
  --not-match-f='(lock|\.min\.)'

A saída vai no README.md, com as linhas de teste separadas das demais.

Apresentação em 01/10

• 1. Abrir a URL, ao vivo, e mostrar o fluxo principal
• 2. A spec em um minuto: o que a aplicação faz e o que ficou de fora
• 3. Três prompts: o que melhor funcionou, o que pior funcionou e o que mudou o rumo do projeto, e por quê
• 4. Os números: linhas, specs, prompts, sessões e horas

Sem slides. O repositório e a aplicação bastam.

Checklist de entrega

• URL pública no README.md, abrindo com um clique
• Uma spec datada por parte do sistema em SPEC/, commitada antes do código
• prompts/sessoes/ com as exportações brutas de todas as sessões
• Ferramentas e modelos listados no README.md
• Commits com os trailers Agent: e Spec:
• Saída do cloc no README.md, com pelo menos 100 mil linhas
• Nenhum segredo no repositório