advpl-specialist
Plugin para Claude Code especializado em ADVPL e TLPP para desenvolvimento no ecossistema TOTVS Protheus — para desenvolvedores e consultores funcionais.
Documentacao completa: https://thalysjuvenal.github.io/advpl-specialist
Indice
Quick Start
Repositorio: https://github.com/thalysjuvenal/advpl-specialist
# 1. Adicione o marketplace do plugin (dentro do Claude Code)
/plugin marketplace add thalysjuvenal/advpl-specialist
# 2. Instale o plugin
/plugin install advpl-specialist@thalysjuvenal-advpl-specialist
# 3. Abra um projeto Protheus e use os comandos
/advpl-specialist:generate function FATA050 --module FAT
/advpl-specialist:diagnose "Variable does not exist: cCodCli"
/advpl-specialist:docs FWExecView
Funcionalidades
Para Desenvolvedores
- Geracao de codigo - Funcoes, classes TLPP, MVC, REST APIs, Web Services, pontos de entrada, TReport, FWFormBrowse, Jobs, Workflow
- Migracao ADVPL -> TLPP - Conversao de codigo procedural para orientado a objetos
- Diagnostico de erros - Analise de erros de compilacao, runtime, performance e locks
- Revisao de codigo - Analise com 24 regras de boas praticas, performance, seguranca e modernizacao (inclui deteccao de funcoes restritas da TOTVS e variaveis reservadas do sistema)
- Testes ProBat - Geracao de testes unitarios para codigo TLPP
- Referencia de documentacao - Funcoes nativas, dicionario SX, APIs REST, parametros MV_, funcoes FW de empresa/filial, lista de funcoes restritas da TOTVS
- Processos de negocio - Consulta de rotinas, tabelas, integracoes e fluxos de 8 modulos ERP
- Explicacao de codigo - Explicacao em linguagem simples com niveis junior, senior e funcional
- Refatoracao - Sugestoes de melhoria de estrutura com 6 padroes (RF-001 a RF-006)
- Documentacao automatica - Cabecalho Protheus.doc, documentacao completa e documentacao de API
- Changelog - Geracao de changelog a partir do git diff com classificacao de impacto
Para Consultores Funcionais
- Explicacao de codigo - Nivel funcional: entenda customizacoes sem ler codigo
- Geracao de dicionario SX - Descreva campos em linguagem natural e gere scripts SX3, SIX, SX1, SX5 e SX7
- Changelog - Documento de mudancas pronto para entregar ao cliente
Instalacao
Opcao 1: Via Marketplace (recomendado)
Adicione o marketplace e instale o plugin:
# Dentro do Claude Code, adicione o marketplace
/plugin marketplace add thalysjuvenal/advpl-specialist
# Instale o plugin
/plugin install advpl-specialist@thalysjuvenal-advpl-specialist
Opcao 2: Direto do diretorio local (para teste/desenvolvimento)
Clone o repositorio e inicie o Claude Code com a flag --plugin-dir:
git clone https://github.com/thalysjuvenal/advpl-specialist.git
claude --plugin-dir ./advpl-specialist
O plugin detecta automaticamente projetos Protheus (.prw, .tlpp, .prx, .ch) ao iniciar uma sessao.
Recomendado: Playwright MCP
O plugin utiliza o Playwright MCP como fallback quando o acesso direto a documentacao (WebSearch/WebFetch) falha. Com ele, o plugin abre a pagina em um navegador real para extrair o conteudo:
claude mcp add playwright -- npx @anthropic-ai/mcp-playwright@latest
Recomendado: Plugin superpowers
Para uma experiencia completa, recomendamos instalar o plugin oficial superpowers que adiciona skills de planejamento, brainstorming, debugging sistematico e code review:
/plugin marketplace add anthropics/claude-code-plugins
/plugin install superpowers@anthropics-claude-code-plugins
Commands
thalysjuvenal