Imported from Valtemirsantos/agente_noticias (
AGENTS.md). Install upstream withnpx skills add Valtemirsantos/agente_noticias. Copyright stays with the author.
Instrucoes do projeto
Escopo
Estas instrucoes valem para todo o projeto agente_noticias.
Python
- Use Python 3.11 ou superior.
- Preserve a estrutura atual e prefira alteracoes pequenas e objetivas.
- Mantenha as chamadas HTTP usando
httpx. - Escreva documentacao e mensagens voltadas ao usuario em portugues do Brasil.
Testes e validacao
- Execute os testes com:
python -m unittest discover -s tests -p "test_*.py" -v - Compile os arquivos Python com:
python -m compileall -q agente_noticias.py noticias_api.py tests - Valide os testes depois de qualquer alteracao em codigo.
- Adicione ou atualize testes ao alterar comportamento.
Seguranca
- Nunca leia, exiba, registre ou versiona valores de
.env, tokens ou chaves de API. - Mantenha
.envignorado pelo Git; publique somente.env.examplecom placeholders. - Nao coloque chaves em URLs, logs, mensagens de erro, README ou codigo-fonte.
- Use o cabecalho
X-Api-Keypara enviar a chave da NewsAPI. - Registre somente metadados que nao contenham credenciais ou dados pessoais.
Git
- Nao faca commit de
.envou outros arquivos com segredos. - Verifique
git statusantes de commit e push. - Nao faca push sem executar os testes e a compilacao.
- Use mensagens de commit curtas e descritivas.