Files
marco ad4b73b668 feat(telegram): add automated AI insight delivery system
Implements ThorAgentIA bot that generates and sends scheduled insights
via Telegram using configurable AI providers. Includes environment
configuration, scheduling, and setup automation.
2026-08-16 20:09:57 -03:00

1.8 KiB

ThorAgentIA - Regras para IA Coder

Estas regras devem ser seguidas por qualquer agente de IA trabalhando no projeto ThorAgentIA.

1. Escopo e Propósito

  • O ThorAgentIA é um sistema automatizado de envio de insights via Telegram.
  • Não adicionar interface gráfica ou web. O sistema roda apenas no terminal Linux.
  • Não modificar a lógica de horário (07:00 às 22:00 por padrão) a menos que explicitamente solicitado.

2. Linguagem e Conteúdo

  • Todo insight gerado deve estar em português brasileiro.
  • O insight deve ter pelo menos 20 linhas.
  • O tom deve ser motivador, prático e direto ao ponto.
  • Não usar markdown excessivo (evitar títulos, negrito, etc. dentro do insight).

3. Estrutura de Arquivos

  • Não mover arquivos de lugar sem instrução explícita.
  • Não remover arquivos sem instrução explícita.
  • O arquivo .env é sensível. Nunca incluir valores reais de API keys em commits.

4. Dependências

  • Adicionar dependências apenas no requirements.txt.
  • Não usar bibliotecas externas sem necessidade. Preferir requests para HTTP.
  • Usar openai oficial para interação com OpenAI.

5. Código Python

  • Seguir PEP 8.
  • Usar type hints quando possível.
  • Tratar exceções de forma clara.
  • Não deixar código de debug ou prints excessivos no main.py.
  • Manter a lógica de agendamento simples e confiável.

6. Telegram

  • Respeitar limites da API do Telegram (mensagens até 4096 caracteres).
  • Tratar erros de rede com retries ou mensagens de erro claras.

7. Segurança

  • Nunca commitar .env com dados reais.
  • Validar entradas do .env no startup.

8. Alterações

  • Qualquer alteração significativa deve ser documentada no README.md.
  • Alterações em variáveis de ambiente devem ser refletidas no README.