---
name: code-intelligence
description: Usar CodeGraph, Lexa ou fallback rg para mapear arquivos, simbolos, dependências e impacto antes de Tech Spec, Execution ou Review em código brownfield.
---

# Code Intelligence SDD

## Objetivo

Dar ao agente um mapa curto e verificavel do código antes de decidir arquitetura, editar áreas compartilhadas ou revisar impacto. CodeGraph e Lexa são opcionais; o fluxo deve funcionar sem eles.

## Procedimento

1. Leia o Project Discovery e o Context Pack do stage atual.
2. Verifique disponibilidade sem instalar nada: `command -v codegraph`, `command -v lexa`, existencia de `.codegraph/` e `.lexa/graph.lexa`.
3. Se CodeGraph estiver disponível e indexado, use consultas de status, arquivos, impacto e afetados para orientar leitura.
4. Se Lexa estiver disponível e indexado, use `lexa status`, `lexa brief "<task>"`, `lexa outline <path>`, `lexa trace-deps <path>` e `lexa audit` quando relevantes.
5. Se nenhuma ferramenta existir, use `rg --files`, `rg`, manifests, testes e leitura focada de arquivos.
6. Registre no artefato de etapa qual caminho foi usado e quais evidências influenciaram a decisão.

## Regras

- Não trate indice como fonte canônica; código, testes e artefatos aprovados prevalecem.
- Não rode indexacao ou instalação sem pedido explicito.
- Não declare impacto completo sem validação por testes ou leitura de diffs.
- Redija segredos e ignore arquivos sensiveis.

## Fontes externas

- CodeGraph: https://github.com/colbymchenry/codegraph
- Lexa: https://github.com/anvia-hq/lexa
