plugadvpl-index-usagelisted

# plugadvpl-index-usage — Skill-chefe Quando o projeto tem `.plugadvpl/index.db`, **Claude DEVE consultar o indice antes de qualquer `Read` em fonte ADVPL**. Fontes Protheus tem tipicamente 1.000-10.000 linhas — abrir cru queima contexto, escala mal e produz respostas vagas. > **Token math:** 20 results do indice ≈ 1.000 tokens. 1 fonte `.prw` cru ≈ 5.000-50.000 tokens. **10-50× menos contexto** por pergunta, sem perder precisao. ## Quando usar Esta skill ativa sempre que: - O projeto atual contem `.plugadvpl/` (detectado pelo fragment `<!-- BEGIN plugadvpl -->` em `CLAUDE.md`). - O usuario pergunta sobre arquivos `.prw`, `.prx`, `.tlpp`, `.apw` (ou pede analise/edicao). - **Antes de qualquer chamada `Read` em fonte ADVPL** — sem excecao. - Para localizar funcoes, callers/callees, uso de tabelas, parametros MV_, SQL embarcado, cadeias SX7, impacto de campos SX3. ## Regra de decisao — qual ferramenta usar | Pergunta do usuario | Comando primeiro | |----------------------------------------------------|-----------------------------------------------| | "O que faz o fonte X?" | `/plugadvpl:arch X` (veja workflow abaixo) | | "Onde esta a funcao Y?" | `/plugadvpl:find function Y` | | "Quem chama Y?" | `/plugadvpl:callers Y` | | "O que Y chama por dentro?" | `/plu