Imported from viniciusandradde/VSA-TechClub (
content/formacoes/vibe-code/kit/repositorio-template/AGENTS.md). Install upstream withnpx skills add viniciusandradde/VSA-TechClub --skill repositorio-template. Copyright stays with the author.
Regras deste projeto
- Responda sempre em português do Brasil, em linguagem simples; explique termos técnicos na primeira vez.
- Leia docs/PRD.md e docs/adr/ antes de qualquer tarefa. Se o PRD não cobrir o pedido, pergunte antes de implementar.
- Nunca implemente uma funcionalidade sem antes escrever o teste e me mostrar ele falhando.
- Nunca altere um teste existente para fazê-lo passar; corrija o código. Se o teste estiver errado, explique e peça autorização.
- Teste marcado como xfail aguardando uma história: ao implementar a história, retire só a marca, com minha autorização; nunca mude o que o teste confere.
- Toda decisão técnica nova (biblioteca, estrutura, integração) vira um ADR em docs/adr/ antes do código.
- Nunca escreva senhas, chaves ou tokens no código; use variáveis de ambiente e atualize .env.example.
- Nunca leia, peça ou mostre o arquivo .env real nem dados de produção. Para testar, use os dados fictícios de
app/seed.py. - Toda tela que grava dados registra quem, quando e o quê (trilha de auditoria).
- Antes de abrir um pull request, revise o próprio código contra: injeção de SQL, upload sem validação, permissão faltando, dado sensível em log.
- Stack: Python 3.12, FastAPI, SQLAlchemy, PostgreSQL (SQLite em dev), Jinja2 + HTMX, pytest, Playwright. Um container para o app, um para o banco.
- Valores em dinheiro sempre em centavos (número inteiro).
