Codebase — a inteligência do código (knowledge graph)¶
O que é¶
graphify transforma qualquer pasta de arquivos (código, docs, papers, imagens, vídeo) num
knowledge graph navegável — persistente entre sessões, com trilha de auditoria honesta
(EXTRACTED/INFERRED/AMBIGUOUS por edge) e detecção de comunidades. No monorepo, o
grafo vive em graphify-out/ (commitado, viaja no clone). A skill codebase é a
consumidora — quem consulta o grafo pra responder pergunta de arquitetura ("como X
funciona", "quem chama Y"). Ferramenta de apoio, não é etapa de nenhum loop.
Três saídas por build: graph.html (visualização interativa), GRAPH_REPORT.md (relatório
em linguagem simples), graph.json (dados brutos, GraphRAG-ready).
Instalação e manutenção¶
O que viaja no clone: o grafo, a skill, os hooks de consulta. O que não viaja: o binário da
CLI (por máquina) e os git hooks de auto-update. Setup: bash scripts/setup-graphify.sh
(idempotente) — instala a CLI, regenera marcadores locais, builda o grafo se não existir, e
instala os hooks post-commit/post-checkout. Depois de rodar, todo git commit rebuilda
o grafo automaticamente em background.
Comandos do dia a dia: graphify query "<pergunta>", graphify path "A" "B",
graphify explain "Modulo". Manutenção: /graphify --update (incremental),
/graphify --cluster-only, /graphify (rebuild completo, raro).
Onde pesa no ciclo de dev¶
| Onde | Como usa | Por quê |
|---|---|---|
pr-guardian (passo 3) |
graphify query/path em todo arquivo/função/endpoint tocado — só lê |
Blast radius — o risco mais pesado do veredito |
deep-search (passo 1) |
graphify explain/query/path na área da issue |
Achar causa raiz e bounded context antes do PRD |
to-build (pré-flight) |
graphify query/explain/path na área afetada |
Mapear conexões antes de mudar código |
backlog-scout (execução) |
Consulta o grafo pra mapear área + callers | Mesma lógica do to-build |
prod-guardian (pós-merge) |
Roda graphify sobre a área mergeada e commita a atualização |
Regenerar é pós-merge; pr-guardian só lê |
Regra que atravessa o harness: consultar o grafo primeiro é mais barato que grep/leitura
arquivo-por-arquivo — é o que dá ao pr-guardian confiança pro veredito de blast radius, e
ao deep-search/to-build o mapa antes de agir.
Regras¶
- Nunca inventa edge — incerteza vira
AMBIGUOUS. - Consulta ≠ rebuild — no dia a dia, todo agente consulta; só reconstrói quando o grafo está claramente desatualizado.
- O hook de commit já mantém o grafo fresco — rebuild manual completo é raro.
Relacionado¶
comite-de-agentes · loop-engineering · skills · engenharia-regenerativa · visao-geral