2026 — Estudo de caso
Vaga Viva
- Java
- Spring Boot
- PostgreSQL
- GitHub App
Quem estuda para uma vaga aprende com tutoriais genéricos, que não se parecem com o trabalho pedido, e com correções que entregam a resposta.
Hack Brasil 2026 · trilha Acesso à educação · dupla, com Guilherme Bessa
em construçãoMeu papel. Projetei o gerador determinístico do plano, a integração com o GitHub (GitHub App, login, webhooks e provisionamento dos repositórios dos alunos), o revisor socrático de PRs e a escolha de arquétipo, além do deploy contínuo. Escrevi os ADRs.
01 Problema
Quem estuda para uma vaga aprende com tutoriais genéricos, que não se parecem com o trabalho pedido, e com correções que entregam a resposta. O Vaga Viva transforma uma vaga real num projeto de estudo no GitHub: missões como issues, testes que falham até a missão estar pronta e um revisor de PR que só faz perguntas.
02 Restrições
- O custo por aluno precisa ser previsível.
- O LLM pode cair a qualquer momento.
- Vagas trazem dados de terceiros (LGPD e regulamento do hackathon).
- Prazo de hackathon.
03 Decisões
Vocabulário fechado de competências (ESCO)
A mesma vaga gera sempre as mesmas competências, e a extração pode ser medida contra rótulos humanos. O erro aceito é deixar de reconhecer uma tecnologia, nunca inventar uma.
ADR 0001 ↗Regras escolhem, o LLM só redige
O plano é reproduzível e testável, e se o LLM cair o aluno recebe o projeto com textos padrão. Quem decide se a missão foi concluída são os testes, não o modelo.
ADR 0002 ↗A vaga é lida em memória e descartada
Ficam só as competências, o nível e o arquétipo.
ADR 0003 ↗Um domínio fictício por arquétipo, testes marcados por missão
Um único repositório-modelo validado por stack; o plano liga e desliga testes por tag em vez de apagar arquivos.
ADRs 0004 e 0005 ↗
04 Resultado
API publicada automaticamente a cada push que passa nos testes de integração (PostgreSQL real via Testcontainers). Em construção durante o Hack Brasil 2026.