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.md       # o quê e por quê
├── PLAN.md       # como: arquitetura, stack, modelo de dados
├── TASKS.md      # tarefas numeradas: T001, T002, ...
├── AGENTS.md     # instruções para o agente (ou CLAUDE.md)
├── src/          # organização interna livre
├── tests/
└── prompts/
    ├── LOG.md    # todos os prompts, em ordem
    ├── custo.md  # tokens e custo por sessão
    └── sessoes/  # exportações brutas das ferramentas

Quem usar o Spec Kit pode manter a estrutura dele em specs/.

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

prompts/LOG.md: o índice

### P042
- Data e hora: 2026-09-30 21:14
- Quem digitou: Maria
- Ferramenta e modelo: Claude Code 2.x, claude-sonnet-5-5
- Sessão: sessoes/2026-09-30-2105-claude.jsonl
- Tarefa: T017
- Prompt: implementa o carrinho seguindo a T017 do TASKS.md, sem mexer no checkout
- Resultado: funcionou, mas duplicou a validação de estoque. Refeito em P043.
- Commits: a1b2c3d

O LOG pode ser gerado por script a partir de sessoes/. Quem digitou e Resultado são preenchidos por vocês.

prompts/custo.md

• Uma linha por sessão: data, ferramenta, modelo, tokens de entrada e de saída, custo em dólar
• E o plano usado: gratuito, assinatura ou API
• No Claude Code, rode /cost ou /usage antes de fechar a sessão

Commits

• Pequenos e frequentes, pelo menos um por tarefa. A mensagem começa pelo número dela
• Origem declarada em dois trailers no fim da mensagem

T017: carrinho de compras

Agent: claude-code/claude-sonnet-5-5
Prompts: P042-P043

• 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, prompts, sessões, horas e custo

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

Checklist de entrega

• URL pública no README.md, abrindo com um clique
• SPEC.md, PLAN.md e TASKS.md commitados antes do código
• prompts/LOG.md completo e prompts/sessoes/ com as exportações brutas
• prompts/custo.md preenchido
• Commits com Tnnn: na mensagem e os trailers Agent: e Prompts:
• Saída do cloc no README.md, com pelo menos 100 mil linhas
• Nenhum segredo no repositório