advpl-specialist
Plugin para Claude Code especializado em ADVPL e TLPP para desenvolvimento no ecossistema TOTVS Protheus
O que e o advpl-specialist?
O advpl-specialist e um plugin para Claude Code especializado em ADVPL e TLPP para desenvolvimento no ecossistema TOTVS Protheus.
Ele transforma o Claude Code em um assistente completo para o dia a dia de quem trabalha com Protheus — seja escrevendo codigo, revisando customizacoes, consultando documentacao ou entendendo processos de negocio.
Desde a v1.5.0, o conhecimento do plugin tambem funciona fora do Claude Code: as 18 skills sao instalaveis no GitHub Copilot, Cursor, Gemini CLI, Codex e mais de 70 agentes com um unico comando (npx skills add thalysjuvenal/advpl-specialist). Veja Outras IAs.
Para quem e?
Desenvolvedores ADVPL/TLPP
- Gerar codigo seguindo convencoes e boas praticas TOTVS
- Migrar codigo procedural ADVPL para TLPP orientado a objetos
- Diagnosticar erros de compilacao, runtime e performance
- Revisar codigo com foco em seguranca, performance e modernizacao
- Gerar testes unitarios com o framework ProBat
- Consultar referencia de funcoes nativas, tabelas SX e APIs REST
- Refatorar codigo com padroes before/after
Consultores Funcionais
- Entender customizacoes sem precisar ler codigo (explicacao em nivel funcional)
- Gerar scripts de dicionario SX a partir de descricao em linguagem natural
- Consultar processos de negocio, rotinas e integracoes entre modulos
- Gerar changelog formatado para entregar ao cliente
Numeros do plugin
O advpl-specialist oferece um conjunto extenso de recursos prontos para uso:
| Recurso | Quantidade | Descricao |
|---|---|---|
| Comandos | 14 | Invocaveis diretamente no Claude Code |
| Agentes | 10 | Especializados em tarefas especificas |
| Skills | 18 | Bases de conhecimento com templates, regras e referencia |
Principais capacidades
Geracao de codigo
Gere funcoes, classes TLPP, estruturas MVC completas, REST APIs, Web Services SOAP, pontos de entrada, TReport, FWFormBrowse, Jobs e Workflow — tudo seguindo as convencoes TOTVS.
Migracao ADVPL para TLPP
Converta codigo procedural ADVPL para TLPP orientado a objetos com classes, namespaces e includes corretos.
Diagnostico e revisao
Analise erros de compilacao e runtime, identifique problemas de performance e locks, e revise codigo com 26 regras de boas praticas, performance, seguranca e modernizacao, alem do catalogo SonarQube com 44 codigos.
Referencia embutida
Consulte mais de 180 funcoes nativas documentadas, 9 tabelas SX, REST API patterns, 50 erros comuns e 16 pontos de entrada mais usados — tudo offline. Para casos nao cobertos, o plugin busca automaticamente no TDN (TOTVS Developer Network).
Processos de negocio
Consulte rotinas, tabelas, parametros MV_* e integracoes de 8 modulos ERP: Compras, Estoque, Faturamento, Financeiro, Contabilidade, Fiscal, PCP e Manutencao.
Documentacao automatica
Gere cabecalhos Protheus.doc, documentacao tecnica completa e documentacao de API REST a partir do codigo-fonte.
Portabilidade multi-IA
Use as mesmas 18 skills no GitHub Copilot, Cursor, Gemini CLI, Codex e outros agentes, com templates de instrucoes (AGENTS.md, copilot-instructions.md) e os 14 comandos compilados para .github/prompts/, .cursor/commands/ e .gemini/commands/. Detalhes em Outras IAs.
Autor
Criado por Thalys Augusto — desenvolvedor e consultor TOTVS Protheus.
- GitHub: thalysjuvenal
- LinkedIn: thalysjuvenal
Proximos passos
- Instalacao — Como instalar o plugin
- Primeiro comando — Tutorial rapido para comecar a usar
- Comandos — Lista completa de comandos disponiveis
- Outras IAs — Uso com Copilot, Cursor, Gemini CLI, Codex e skills.sh