A ascensão das ferramentas de Inteligência Artificial Generativa transformou radicalmente a produtividade na engenharia de software. Hoje, assistentes de código conseguem gerar classes inteiras, refatorar algoritmos complexos e propor padrões de projeto em segundos.
No entanto, como Engenheiro de Software trabalhando em ambientes corporativos de alta complexidade, esbarrei repetidamente no maior gargalo dessas ferramentas: a alucinação contextual e a quebra de fronteiras arquiteturais.
Quem nunca viu uma IA sugerir a criação de um arquivo no diretório errado? Ou pior, fazer a camada de Domain depender diretamente de um componente de Infrastructure, violando frontalmente os princípios da Clean Architecture?
Para resolver esse problema de forma determinística, decidi criar o Code Property Graph (CPG): um ecossistema que mapeia toda a estrutura estática do código (camadas, namespaces, classes e dependências) e atua como uma "guarda de fronteira" contra as alucinações da IA.
O projeto, que disponibilizei de forma open-source no meu GitHub (CodePropertyGraph), foi desenhado em três grandes módulos, abraçando uma abordagem que chamo de Paradigma Híbrido (Relacional + Grafo).
