# Add to your Claude Code skills
git clone https://github.com/thalysjuvenal/advpl-specialist
README.md
advpl-specialist
Plugin para Claude Code especializado em ADVPL e TLPP para desenvolvimento no ecossistema TOTVS Protheus — para desenvolvedores e consultores funcionais.
# 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
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
147,283
protheus
tlpp
totvs
totvs-protheus
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:
| Comando | Descricao |
|---------|-----------|
| /advpl-specialist:generate | Gerar codigo ADVPL/TLPP (funcoes, classes, MVC, REST, PE, TReport, FWFormBrowse, Jobs, Workflow) |
| /advpl-specialist:migrate | Migrar codigo ADVPL procedural para TLPP orientado a objetos |
| /advpl-specialist:diagnose | Diagnosticar erros e problemas em codigo ADVPL/TLPP |
| /advpl-specialist:docs | Consultar documentacao de funcoes, APIs e dicionario Protheus |
| /advpl-specialist:review | Revisar codigo ADVPL/TLPP (boas praticas, performance, seguranca, modernizacao) |
| /advpl-specialist:test | Gerar testes unitarios ProBat para codigo TLPP |
| /advpl-specialist:process | Consultar processos de negocio, rotinas e integracoes entre modulos |
| /advpl-specialist:explain | Explicar codigo em linguagem simples (nivel junior, senior ou funcional) |
| /advpl-specialist:refactor | Sugerir refatoracoes de estrutura sem mudar comportamento |
| /advpl-specialist:document | Gerar documentacao tecnica automatica (header, full, api) |
| /advpl-specialist:changelog | Gerar changelog formatado a partir do git diff |
| /advpl-specialist:sxgen | Gerar scripts de dicionario SX a partir de descricao em linguagem natural |
Exemplos
# Gerar uma User Function para o modulo de faturamento
/advpl-specialist:generate function FATA050 --module FAT
# Gerar uma classe TLPP
/advpl-specialist:generate class PedidoService
# Gerar estrutura MVC completa
/advpl-specialist:generate mvc CadProduto --module EST
# Migrar arquivo ADVPL para TLPP
/advpl-specialist:migrate src/FATA001.prw
# Diagnosticar um erro
/advpl-specialist:diagnose "Variable does not exist: cCodCli"
# Consultar documentacao de funcao
/advpl-specialist:docs FWExecView
# Explicar codigo para consultor funcional
/advpl-specialist:explain src/MATA461.prw --level funcional
# Sugerir refatoracoes
/advpl-specialist:refactor src/FATA001.prw
# Gerar documentacao completa
/advpl-specialist:document src/MATA461.prw --type full
# Gerar changelog desde uma data
/advpl-specialist:changelog --since 2026-03-01 --format markdown
# Gerar script de dicionario SX3
/advpl-specialist:sxgen --type sx3
Agents
| Agent | Descricao |
|-------|-----------|
| code-generator | Gera codigo ADVPL/TLPP seguindo convencoes e boas praticas |
| migrator | Converte codigo procedural ADVPL para TLPP com classes e namespaces |
| debugger | Diagnostica erros de compilacao, runtime, performance e locks |
| docs-reference | Consulta referencia local + TDN para funcoes, tabelas SX e APIs |
| code-reviewer | Analisa codigo existente para boas praticas, performance, seguranca e modernizacao |
| process-consultant | Consulta processos de negocio, rotinas, tabelas e integracoes entre modulos |
| refactorer | Analisa codigo e sugere refatoracoes de estrutura com before/after |
| doc-generator | Gera documentacao tecnica automatica a partir do codigo-fonte |
| changelog-generator | Analisa git diff e gera changelog formatado com classificacao de impacto |
| sx-configurator | Gera scripts de dicionario SX a partir de descricao em linguagem natural |
Skills
| Skill | Descricao |
|-------|-----------|
| advpl-code-generation | Padroes e templates para geracao de codigo (MVC, REST, PE, SOAP, TReport, FWFormBrowse, Jobs, Workflow) |
| advpl-to-tlpp-migration | Regras de conversao, checklist e exemplos before/after |
| advpl-debugging | Top 50 erros comuns, metodologia de debug, dicas de performance |
| advpl-code-review | 24 regras de revisao de codigo (boas praticas, performance, seguranca, modernizacao) |
| probat-testing | Framework ProBat para testes unitarios TLPP (annotations, assertions, patterns) |
| protheus-reference | 190+ funcoes nativas, dicionario SX, referencia REST API, funcoes FW*, lista de funcoes restritas |
| protheus-business | 8 modulos ERP com tabelas, rotinas, parametros MV_* e integracoes |
| embedded-sql | BeginSQL/EndSQL, macros %table%, %notDel%, %xfilial%, %exp%, column types |
| code-explanation | Metodologia de explicacao de codigo com 3 niveis de audiencia |
| advpl-refactoring | 6 padroes de refatoracao com before/after e regras de seguranca |
| documentation-patterns | Templates para Protheus.doc header, documentacao completa e API REST |
| changelog-patterns | Tipos de mudanca, niveis de impacto e formatos markdown/texto |
| sx-configuration | Definicoes completas SX3/SIX/SX1/SX5/SX7 com validacoes e pictures |
