/advpl-setup

/advpl-setup e a primeira skill que voce roda apos instalar o pacote claude-advpl-skill. Configura o ambiente pra todas as outras skills (validate, compile, etc) funcionarem.

O que faz

• Verifica se Node.js 16+ esta instalado
• Instala o binario advpls via npm install -g @totvs/tds-ls
• Pede pasta de includes do Protheus (.ch, .th) — tipicamente C:\includes
• Valida que a pasta tem arquivos essenciais (protheus.ch, prtopdef.ch, topconn.ch)
• Define variavel de ambiente ADVPL_INCLUDES persistente

Como usar

/advpl-setup

Roda interativamente. Voce so confirma os caminhos sugeridos.

Quando rodar

• Primeira instalacao da skill — uma unica vez
• Quando outras skills (/advpl-validate, /advpl-compile) reclamam "binario nao encontrado" ou "includes nao configurados"
• Apos trocar de maquina ou reinstalar Node

Output esperado

[OK] Node.js 20.10.0 detectado
[OK] @totvs/tds-ls instalado em /usr/local/lib/node_modules/
[OK] advpls binario funciona — versao 2.1.0
[OK] Includes em C:\includes (155 arquivos .ch/.th)
[OK] Variavel ADVPL_INCLUDES configurada
=== Setup completo ===

Pegadinhas

• Includes nao publicos da TOTVS — voce precisa ter pasta com .ch (saem do AppServer ou TDS-VSCode). Geralmente C:\includes ou similar.
• Permissoes NPM global em Linux/Mac pode pedir sudo. Em Windows funciona direto.
• Includes desatualizados (release Protheus antigo) podem dar warnings — atualizar regularmente.

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 →