marco
ad4b73b668
Implements ThorAgentIA bot that generates and sends scheduled insights via Telegram using configurable AI providers. Includes environment configuration, scheduling, and setup automation.
52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
# 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.
|