Imported from bobffortes/Credit-Analyst (AGENTS.md). Install upstream with npx skills add bobffortes/Credit-Analyst. Copyright stays with the author.

Diretrizes de Engenharia e Agentes do Projeto

Este repositório utiliza um padrão de desenvolvimento orquestrado com foco em entregas completas (E2E), arquitetura monolítica modular e engenharia orientada a regras.

🤖 Papel do Agente Orquestrador (E2E Solution Orchestrator)

O agente orquestrador opera sob o seguinte protocolo rigoroso:

1. Levantamento Profundo de Requisitos (Q&A Iterativo)

• Antes de escrever qualquer código, o agente deve formular todas as perguntas necessárias ao usuário para esclarecer requisitos funcionais, regras de negócio, fluxos de dados, integrações de frontend/backend e restrições.
• O agente só inicia o desenvolvimento quando tiver reunido insumos suficientes para construir um plano de execução 100% sólido e detalhado.

2. Arquitetura Monolítica Modular Full-Stack

• O desenvolvimento deve sempre seguir os padrões definidos na regra architecture.md e na skill modular-monolith-best-practices.
• Backend: Módulos independentes com separação em domain, services, repositories, routes e schemas tipados.
• Frontend: Separação modular em features, components e serviços de comunicação (api_client).
• Contratos Claros: Schemas tipados e DTOs bem definidos entre backend e frontend.

3. Diretriz de Testes: Zero Criação de Testes Automatizados

• NÃO desenvolva testes unitários, testes de integração ou suítes de teste (como pytest, jest, unittest, etc.).
• Todo o foco deve estar na implementação real e resolução de problemas na camada funcional. Consulte engineering-standards.md.

4. Validação Final Obrigatória via Compilação / Build

• Ao finalizar a construção da solução, o agente deve obrigatoriamente executar a compilação estática ou build do projeto para verificar o sucesso da entrega:
  • Python: python -m py_compile $(find ... -name "*.py") e validação de imports.
  • TypeScript / Frontend: tsc --noEmit e npm run build.
• A entrega só é considerada pronta quando a compilação/build passar sem erros.

📑 Regras Modulares do Projeto (.agents/rules/)

• architecture.md: Arquitetura Monolítica Modular, camadas de backend e frontend.
• engineering-standards.md: Padrões de engenharia, ciclo de validação estática e zero testes.
• git-workflow.md: Padrões de Git, conventional commits, branches e reconciliação.
• rag-and-credit-domain.md: Diretrizes de IA, RAG, guardrails e regras de negócio de crédito.

📚 Skills Disponíveis no Repositório (.agents/skills/)

• git-workflow: Gestão de branches, commits semânticos, pull seguro com rebase, push e stash.
• git-conflict-resolution: Resolução e reconciliação segura de conflitos no Git.
• git-pr-workflow: Criação e gestão de Pull Requests via GitHub CLI (gh).
• modular-monolith-best-practices: Melhores práticas de backend e frontend monolítico modular.
• project-technical-explainer: Documentação técnica, arquitetura de RAG e contexto de negócio do Copiloto de Crédito.