/advpl-validate

Pre-compila AdvPL/TLPP localmente sem AppServer. Detecta erros de sintaxe. Aceita arquivo ou pasta inteira (batch). Output em tabela markdown.

Assinatura: /advpl-validate <arquivo.prw OU pasta>

/advpl-validate usa o advpls appre (pre-compilador oficial TOTVS) pra detectar erros de sintaxe sem precisar de conexao com AppServer. Rapido, local, gratuito.

Como usar

# Arquivo unico
/advpl-validate C:\fontes\MATA010.prw

# Pasta recursiva (batch — varre .prw, .tlpp, .prg, .prx)
/advpl-validate ./src/customizacoes/

Modo arquivo (output classico)

===OK===
Validado sem erros. Pre-processado: 12389 bytes

# OU em caso de erro:
===ERRPRW===
mata010(47) Error C2024  Unclosed control structures
===END===

Modo pasta (tabela markdown)

===BATCH===
Validando 12 fonte(s) em: ./src/

| #  | Arquivo                | Status | Detalhe
|----|------------------------|--------|--------
| 1  | MATA010.prw            | OK     | 12389 bytes
| 2  | FINA070.prw            | ERROR  | fina070(47) Error C2024 Unclosed control structures
| 3  | rotina-old.prw         | OK     | 8421 bytes

===SUMMARY===
Total: 12 | OK: 10 | Erros: 1 | Warnings: 1

Exit codes

Codigo	Significado
0	Todos OK
1	Pelo menos 1 erro/warning
2	Configuracao invalida (sem includes, sem advpls)

Casos de uso

Pre-commit hook — bloquear commit se houver erro de sintaxe
CI/CD gate — exit code 1 bloqueia merge
Auditoria mensal — varrer todo o repositorio custom
Pre-deploy — confirmar que tudo pre-compila antes de subir RPO

Limitacoes

Nao detecta erros semanticos (variavel usada antes de declarar via Local — vira Public implicit). Pra isso use /advpl-find-issues.
Nao testa execucao real — so sintaxe. Pra testar producao use /advpl-compile.
Includes complexos com #xcommand podem dar falso positivo.

Instalacao

A skill faz parte do pacote claude-advpl-skill open source. Baixe e instale:

curl -O https://archtecgroup.com.br/downloads/claude-advpl-skill-v0.2.1.zip
unzip claude-advpl-skill-v0.2.1.zip
bash install.sh
# OU Windows PowerShell:
.\install.ps1

Documentacao tecnica completa: GitHub maycondev/claude-advpl-skill

Caso de uso real (post): Auditando 800 linhas de AdvPL em 30 segundos

Suporte / Customizacao

Precisa adaptar a skill pro seu fluxo, integrar em pipeline CI/CD custom, ou usar em ambiente corporativo com NDA?

A ArchTec oferece consultoria especializada em automacao de dev Protheus com Claude/AI. Fale com nossos especialistas →