dockerfluxodecaixapro/rules/01_COMPORTAMENTO_IA.md

Comportamento da IA

Este documento define as regras estritas de como a IA deve interagir com o ambiente e o usuário.

Execução de Comandos

1. Permissão e Autonomia: A IA PODE E DEVE executar comandos php ou docker diretamente. É OBRIGATÓRIO validar cada alteração com o fluxo de checagem autônomo.
2. Fluxo de Trabalho Obrigatório:
   • Após qualquer edição: Executar .\sys.ps1 lint ou .\sys.ps1 check.
   • Se houver erros de estilo: Executar .\sys.ps1 fix imediatamente.
   • Se houver falhas em testes: Investigar e corrigir antes de reportar ao usuário.
3. Método de Execução:
   • Preferencialmente via Docker: docker exec -w /app dockersyscms php [comando]
   • Via script utilitário (Windows): .\sys.ps1 [comando] (ex: test, lint, fix, check).
4. Procedimento para Scripts PHP:
   • Quando for necessário executar lógica PHP complexa:
     1. Crie um script PHP na pasta scripts/.
     2. Execute-o diretamente via Docker ou sys.ps1.
5. Validação via HTTP (Opcional):
   • Se preferir, a IA ainda pode usar a validação via HTTP (Invoke-WebRequest), mas a execução direta via Docker é preferencial para tarefas administrativas.

Operações de Banco de Dados

1. Acesso Direto: A IA tem permissão para executar consultas SQL diretamente no banco de dados do container.
2. Método de Execução:
   • Utilize o cliente mysql dentro do container:
   • Sintaxe: docker exec dockersyscms mysql -u root -proot -D syscms -e "SUA_QUERY_AQUI"
   • Para queries complexas ou dumps, considere criar um arquivo .sql temporário e executá-lo via redirecionamento de entrada, ou usar scripts PHP.
3. Segurança:
   • Tenha cautela com operações destrutivas (DROP, DELETE, TRUNCATE).
   • Sempre verifique o ambiente antes de rodar queries de modificação em massa.

Criação e Edição de Arquivos

1. Não criar arquivos desnecessários: Só crie arquivos se forem essenciais para a tarefa.
2. Preferir edição: Sempre tente editar arquivos existentes antes de criar novos.
3. Documentação: Não crie arquivos .md ou README a menos que explicitamente solicitado.

Respostas e Idioma

1. Idioma: Responda sempre no idioma solicitado pelo usuário (padrão: Português).
2. Código: Comentários no código devem ser OBRIGATORIAMENTE em Inglês e seguir o padrão PHPDoc.
   • Strings de usuário (mensagens de erro, interface) mantêm-se no idioma da aplicação.
3. Assertividade: Seja proativo. Se uma instrução for ambígua, assuma a ação mais lógica e execute-a. Não peça confirmação para cada passo trivial.