Development
Plugin
advpl-specialist
Plugin para Claude Code especializado em ADVPL e TLPP para desenvolvimento no ecossistema TOTVS Protheus — para desenvolvedores e consultores funcionais. Documentacao completa:
Plugin Signal82/100Strong
maintained90
capable79
documented100
adopted48
Install on Claude Code
> /plugin marketplace add thalysjuvenal/advpl-specialist> /plugin install advpl-specialist@advpl-specialist-marketplace
In this plugin
- skills
- advpl-code-generation
- advpl-code-review
- advpl-debugging
- advpl-refactoring
- advpl-to-tlpp-migration
- advpr-test-automation
- changelog-patterns
- code-explanation
- documentation-patterns
- embedded-sql
- probat-testing
- protheus-business
- protheus-locks-deadlocks
- protheus-reference
- query-builder
- smartx-development
- sx-configuration
- tdn-lookup
- commands
- agents
What's inside
Skills
18/advpl-code-generationUse when the user asks to generate, create, or scaffold ADVPL/TLPP code for TOTVS Protheus -- User Functions, Static Functions, TLPP classes, MVC (Model/View/Controller), REST APIs, SOAP web services, entry points (pontos de entrada), TReport/FWMsPrinter reports, jobs, or/advpl-code-reviewUse when the user asks to review, audit, or check the quality of ADVPL/TLPP code for TOTVS Protheus before merge or deploy -- covering best practices (RecLock/MsUnlock pairing, variable scope, area management, error handling), performance bottlenecks, security vulnerabilities/advpl-debuggingUse when the user asks to debug, diagnose, or fix an ADVPL/TLPP error on TOTVS Protheus -- compilation errors (syntax, missing includes, undeclared variables), runtime failures (NIL access, type mismatch, array bounds), performance issues (slow queries, memory leaks), database/advpl-refactoringUse when the user asks to refactor, clean up, or restructure existing ADVPL/TLPP code on TOTVS Protheus without changing its behavior -- extracting long functions (>100 lines), simplifying deeply nested conditionals, removing dead code, improving variable naming (Hungarian/advpl-to-tlpp-migrationUse when the user asks to migrate, convert, compatibilize, or modernize legacy ADVPL procedural code to TLPP object-oriented classes on TOTVS Protheus -- turning User Functions/Static Functions into namespaced classes with methods and data properties, replacing Private/Public/advpr-test-automationUse when the user wants to write, run, or troubleshoot automated regression tests for Protheus routines with ADVPR (Advanced Protheus Robot) -- covering FWTestHelper API, TestSuite/GPS de Testes setup, headless execution via FwExecSuite, and per-pattern scripting (MVC,
Show all 18 skillsShow fewer
/changelog-patternsUse when the user asks to generate a changelog, release notes, or delivery notes from ADVPL/TLPP code changes on TOTVS Protheus -- analyzing diffs or a list of changed files, classifying each change (NEW/FIX/CHANGE/REMOVE/REFACTOR), assessing business impact (ALTO/MEDIO/BAIXO),/code-explanationUse when the user asks to explain what a piece of ADVPL/TLPP code does in plain language, adapting the explanation depth for a junior developer (line-by-line), a senior developer (business logic, design decisions, risks), or a functional consultant (no technical terms) -- e.g./documentation-patternsUse when the user wants to generate technical documentation for ADVPL/TLPP code on TOTVS Protheus -- Protheus.doc header blocks (@type, @param, @return, @author, @since, @history), complete routine documentation (tables read/written, MV_* parameters, entry points, execution/embedded-sqlUse when the user needs to write, review, or migrate SQL queries in ADVPL/TLPP using BeginSQL/EndSQL blocks and macro expressions (%table%, %xfilial%, %notDel%, %exp%, %Order%) instead of raw TCQuery string concatenation -- covering INNER/LEFT JOIN patterns, aggregations/probat-testingUse when the user needs to write or run unit, functional, or integration tests for TLPP code using ProBat (tlppCore's native testing engine) -- covering @TestFixture, @Test, @Setup/@TearDown, @OneTimeSetUp/@OneTimeTearDown, @Skip, @ErrorLog annotations, the full assertion/protheus-businessUse when the user needs to understand a TOTVS Protheus ERP business process, module workflow, or cross-module integration -- covering Compras (COM), Estoque (EST), Faturamento (FAT), Financeiro (FIN), Contabilidade (CTB), Fiscal (FIS), PCP, and Manutencao de Ativos (MNT),/protheus-locks-deadlocksUse when the user needs to understand, diagnose, or prevent Protheus record locks and deadlocks -- covering RecLock/MsUnlock/SoftLock/LockByName semantics, BeginTran/EndTran transaction scoping, lock leak and deadlock diagnostics (TopMemoStatus, MonitorActiveLocks, DBAccess/protheus-referenceUse when the user needs to look up a TOTVS Protheus native function's syntax/parameters/return value, the SX data dictionary structure (SX1-SX9, SIX), REST API endpoint patterns (FWRest, WsRestFul), MV_* system parameter behavior, SX3 field validation, or whether a function is/query-builderUse when the user needs to build, choose the pattern for, or optimize a SQL query against Protheus ERP tables -- covering Workarea (DbSelectArea/DbSeek) vs Embedded SQL vs TCSqlExec pattern choice, mandatory D_E_L_E_T_/xFilial filters, SIX index-aligned WHERE ordering,/smartx-developmentUse when the user wants to build, migrate, or troubleshoot a Smart X routine -- TOTVS's metadata-driven UI framework that generates modern PO-UI screens from a data dictionary Object/Model/Interface/Launcher chain. Covers the model.tlpp/interface.tlpp/launcher artifacts, ADVPL/sx-configurationUse when the user needs to generate or validate Protheus data dictionary configuration scripts -- covering SX2 (table headers), SX3 (fields), SIX (indexes), SXG (field groups), SXA (form folders/tabs), SX1 (report questions), SX5 (generic tables), SXB (F3 lookup queries), and/tdn-lookupUse as the escalation strategy when local ADVPL/TLPP reference material lacks an answer -- a tiered approach (local cache first, then TDN Confluence REST API via WebFetch, then Playwright against the API, then WebSearch, then visual site search) for looking up native functions,
Agents
10changelog-generatorSpecialized agent for generating changelogs from ADVPL/TLPP code changes - analyzes diffs and produces structured release notescode-generatorSpecialized ADVPL/TLPP code generation agent for TOTVS Protheus - creates functions, classes, MVC structures, REST APIs, Web Services, and entry points following best practices and naming conventionscode-reviewerSpecialized ADVPL/TLPP code review agent - analyzes existing code for best practices, performance issues, security vulnerabilities, and modernization opportunitiesdebuggerSpecialized agent for diagnosing and resolving ADVPL/TLPP errors in TOTVS Protheus - compilation errors, runtime errors, performance issues, database locks, and log analysisdoc-generatorSpecialized agent for generating technical documentation from ADVPL/TLPP source code - Protheus.doc headers, routine docs, API docsdocs-referenceSpecialized agent for looking up Protheus documentation - native functions, SX data dictionary, REST APIs, MV parameters, and TOTVS framework reference with local + TDN online search
Show all 10 agentsShow fewer
migratorSpecialized agent for migrating ADVPL procedural code to TLPP object-oriented code, modernizing legacy Protheus applications with classes, namespaces, and OOP patternsprocess-consultantSpecialized agent for consulting Protheus ERP business processes, module workflows, routines, integrations, and understanding how business operations work in TOTVS ProtheusrefactorerSpecialized ADVPL/TLPP refactoring agent - analyzes code structure and suggests safe improvements without changing behaviorsx-configuratorSpecialized agent for generating Protheus SX data dictionary configuration scripts - SX3 fields, SIX indexes, SX1 questions, SX5 generic tables, SX7 triggers
Commands
13/advprGera scripts de automação de testes ADVPR (Advanced Protheus Robot) - TestSuite, TestGroup, TestCase para rotinas MVC, ExecAuto, relatórios, processamento, webservice, Smart View, TOTVS Message e SmartLink/diagnoseDiagnose errors and problems in ADVPL/TLPP code - compilation errors, runtime errors, performance issues, and log analysis/docsLook up Protheus documentation - native functions, SX data dictionary, REST APIs, MV parameters, and framework reference/documentGenerate technical documentation from ADVPL/TLPP source code - Protheus.doc headers, routine docs, API docs/explainExplain ADVPL/TLPP code in plain language for developers and functional consultants/generateGenerate ADVPL/TLPP code - functions, classes, MVC structures, REST APIs, Web Services, and entry points for TOTVS Protheus
Show all 13 commandsShow fewer
/migrateMigrate ADVPL procedural code to TLPP object-oriented code with classes, namespaces, and modern patterns/processConsult Protheus ERP business processes, module workflows, routines and integrations/refactorRefactor ADVPL/TLPP code - extract functions, simplify logic, remove dead code, improve naming/reviewReview ADVPL/TLPP code for best practices, performance, security, and modernization/smartxGera ou migra rotinas Smart X (telas web modernas a partir de metadados) - modelo, interface e launcher TLPP; conversão de mBrowse/AxCadastro/MVC para Smart X/sxgenGenerate Protheus SX data dictionary configuration scripts - SX2 tables, SX3 fields, SIX indexes, SXG groups, SXA folders, SX1 questions, SX5 generic tables, SXB lookups, SX7 triggers/testGenerate ProBat unit tests for TLPP classes and functions
Badges
6
README
1advpl-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
- Funcionalidades
- Instalacao
- Uso com Copilot, Cursor, Gemini e outras IAs
- Commands
- Exemplos
- Agents
- Referencia Interna
- Estrutura do Projeto
- Referencia Embutida
- Contribuindo
- Changelog
- Licenca
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, FWMSPrinter (relatorios PDF por coordenadas), 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
- Conversao automatica para CP1252 - Todo arquivo ADVPL/TLPP (
.prw,.tlpp,.prx,.ch,.prg,.apw,.aph,.tlh) escrito ou editado pelo plugin e automaticamente convertido para Windows-1252 (CP1252), encoding esperado pelo TOTVS Protheus. Caracteres incompativeis (ex: emojis, kanji) geram um warning visivel e o arquivo permanece em UTF-8 — o plugin nunca bloqueia o fluxo. Requericonvno PATH (presente nativamente em macOS, Linux, WSL e Git Bash).
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 SX2, SX3, SIX, SXG, SXA, SX1, SX5, SXB 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
Uso com Copilot, Cursor, Gemini e outras IAs
O advpl-specialist tambem funciona fora do Claude Code, em GitHub Copilot, Cursor, Gemini CLI, Codex e mais de 70 agentes de IA.
Passo 1: Skills (qualquer agente)
npx skills add thalysjuvenal/advpl-specialist
Instala as 18 skills em Copilot CLI, Codex, Cursor, Gemini CLI, OpenCode e 70+ agentes.
Passo 2: Instrucoes de repositorio
Copie AGENTS.md, .github/copilot-instructions.md e CLAUDE.md para a raiz do SEU repositorio Protheus.
Passo 3: Comandos (opcional)
Copie a pasta da sua plataforma para o seu repositorio:
.github/prompts/(Copilot — funciona no VS Code/Visual Studio/JetBrains; NAO funciona em github.com nem no coding agent).cursor/commands/(Cursor).gemini/commands/(Gemini CLI)
Nota Codex: coberto por AGENTS.md + skills (os custom prompts do Codex estao deprecated; as skills ficam em .agents/skills/ no projeto).
Nota manutencao: os comandos sao gerados a partir de ai-commands/src/ via node scripts/build-ai-commands.mjs — nao edite as saidas manualmente.
Commands
| 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 |
/advpl-specialist:advpr | Gerar scripts de automacao de testes ADVPR (Advanced Protheus Robot) - TestSuite/TestGroup/TestCase para MVC, ExecAuto, relatorios, processamento, webservice, Smart View, TOTVS Message e SmartLink |
/advpl-specialist:smartx | Gerar ou migrar rotinas Smart X (telas web modernas a partir de metadados) - modelo, interface e launcher TLPP; conversao de mBrowse/FWMBrowse/MVC para Smart X |
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
# Gerar script de teste ADVPR para rotina MVC
/advpl-specialist:advpr --type mvc "incluir prospect TMKA260"
# Gerar rotina Smart X (modelo + interface + launcher)
/advpl-specialist:smartx --mode generate "cadastro de produtos SB1"
Exemplos
Consulte a pasta examples/ para seis cenarios end-to-end prontos para executar, com prompts exatos, output esperado e variacoes.
| # | Cenario | Comando principal |
|---|---|---|
| 01 | Gerar MVC completo para tabela customizada ZA1 | /advpl-specialist:generate |
| 02 | Migrar ADVPL procedural (FATA001) para TLPP | /advpl-specialist:migrate |
| 03 | Diagnosticar erro de lock infinito em RecLock | /advpl-specialist:diagnose |
| 04 | Criar endpoint REST em TLPP com namespace | /advpl-specialist:generate |
| 05 | Revisar codigo focando em performance | /advpl-specialist:review |
| 06 | Gerar dicionario SX3 + SIX + SX1 para nova tabela | /advpl-specialist:sxgen |
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 |
Referencia Interna
Os agents e commands carregam automaticamente bases de conhecimento internas (skills/*/reference.md) conforme necessario. Estas referencias nao aparecem como skills invocaveis — o usuario interage exclusivamente pelos Commands acima.
| Referencia | 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) |
advpr-test-automation | Automacao de testes ADVPR (FWTestHelper): TestSuite/Group/Case, MVC, ExecAuto, relatorios, webservice, SmartLink, Smart View |
smartx-development | Desenvolvimento Smart X: modelo/interface/launcher a partir de metadados, conversao de browse (SetSmartX), pontos de entrada, migracao de legado e troubleshooting |
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 |
query-builder | Decisao Workarea vs SQL, FWPreparedStatement, consciencia de indices SIX, queries cross-database |
protheus-locks-deadlocks | Semantica de locks (RecLock/MsUnlock/DBAccess), leaks, prevencao (BEGIN SEQUENCE/RECOVER, SoftLock) e diagnostico de deadlocks |
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 SX2/SX3/SIX/SXG/SXA/SX1/SX5/SXB/SX7 com validacoes e pictures |
tdn-lookup | Estrategia de busca online no TDN via API REST do Confluence (4 tiers) |
Estrutura do Projeto
advpl-specialist/
├── .claude-plugin/
│ ├── plugin.json # Metadata do plugin
│ └── marketplace.json # Catalogo do marketplace
├── .github/
│ ├── ISSUE_TEMPLATE/
│ │ ├── bug_report.md # Template para reportar bugs
│ │ └── feature_request.md # Template para sugestoes
│ └── pull_request_template.md # Template para PRs
├── agents/ # 10 agents especializados
│ ├── code-generator.md
│ ├── code-reviewer.md
│ ├── migrator.md
│ ├── debugger.md
│ ├── docs-reference.md
│ ├── process-consultant.md
│ ├── refactorer.md
│ ├── doc-generator.md
│ ├── changelog-generator.md
│ └── sx-configurator.md
├── commands/ # 14 commands invocaveis
│ ├── generate.md
│ ├── migrate.md
│ ├── diagnose.md
│ ├── docs.md
│ ├── review.md
│ ├── test.md
│ ├── process.md
│ ├── explain.md
│ ├── refactor.md
│ ├── document.md
│ ├── changelog.md
│ ├── sxgen.md
│ ├── advpr.md
│ └── smartx.md
├── skills/ # 18 referencias internas (reference.md + supporting files)
│ ├── advpl-code-generation/ # Padroes MVC, REST, SOAP, PE, TReport, FWFormBrowse, Jobs, Workflow
│ ├── advpl-to-tlpp-migration/ # Regras e checklist de migracao
│ ├── advpl-debugging/ # Erros comuns e performance
│ ├── advpl-code-review/ # 26 regras de revisao + catalogo SonarQube (44 codigos)
│ ├── probat-testing/ # Testes unitarios ProBat (TLPP)
│ ├── advpr-test-automation/ # Automacao de testes ADVPR: FWTestHelper, MVC, ExecAuto, relatorios, webservice, SmartLink, Smart View
│ ├── smartx-development/ # Smart X: modelo/interface/launcher, conversao de browse, PEs, migracao
│ ├── protheus-business/ # 8 modulos ERP (COM, EST, FAT, FIN, CTB, FIS, PCP, MNT)
│ ├── embedded-sql/ # BeginSQL/EndSQL, macros, patterns
│ ├── query-builder/ # Decisao Workarea vs SQL, FWPreparedStatement, indices SIX, cross-DB
│ ├── protheus-locks-deadlocks/ # Locks/deadlocks: semantica, leaks, prevencao e diagnostico
│ ├── protheus-reference/ # 190+ funcoes nativas, SX, REST API, funcoes restritas
│ ├── code-explanation/ # Explicacao de codigo com 3 niveis de audiencia
│ ├── advpl-refactoring/ # 6 padroes de refatoracao com before/after
│ ├── documentation-patterns/ # Templates Protheus.doc, documentacao completa, API
│ ├── changelog-patterns/ # Tipos de mudanca, impacto, formatos
│ ├── sx-configuration/ # Dicionario SX2/SX3/SIX/SXG/SXA/SX1/SX5/SXB/SX7 completo
│ └── tdn-lookup/ # Busca online no TDN via API Confluence
├── hooks/ # SessionStart hook
│ ├── hooks.json
│ └── session-start
├── CHANGELOG.md # Historico de versoes
├── CODE_OF_CONDUCT.md # Codigo de conduta
├── CONTRIBUTING.md # Guia de contribuicao
├── LICENSE # Licenca MIT
├── SECURITY.md # Politica de seguranca
└── README.md
Referencia Embutida
O plugin inclui referencia local para consulta rapida:
- 190+ funcoes nativas documentadas com sintaxe, parametros e exemplos
- 10 funcoes FW* de gestao de empresa/filial (FWCodFil, FWCodEmp, FWFilial, FWCompany, etc.)
- 195+ funcoes restritas da TOTVS catalogadas com alternativas documentadas
- 9 tabelas SX (SX1-SX9, SIX) com campos e uso programatico, e geracao de scripts para SX2/SX3/SIX/SXG/SXA/SX1/SX5/SXB/SX7
- REST API patterns completos para WsRestFul e TLPP annotations
- 50 erros comuns com causa e solucao
- 10 categorias de otimizacao de performance com before/after
- 16 pontos de entrada mais usados por modulo
- Templates de classes TLPP (Service, Repository, DTO)
- MVC completo com MenuDef, ModelDef, ViewDef e FWMVCRotAuto
- Embedded SQL completo com BeginSQL/EndSQL, macros, JOINs, aggregations
Para casos nao cobertos localmente, o plugin busca no TDN (TOTVS Developer Network) automaticamente. Se o acesso ao TDN falhar (timeout, erro ou conteudo vazio), o plugin utiliza o Playwright MCP como fallback — abrindo a pagina em um navegador real para extrair a documentacao via snapshot de texto ou captura visual.
Contribuindo
Contribuicoes sao bem-vindas! Leia o CONTRIBUTING.md para saber como participar.
Contribuidores
Obrigado a quem contribui com o projeto:
- Henrique Patriota (@suportem3, M3 Case) — referencia FWMSPrinter para relatorios PDF por coordenadas (PR #12) e referencia de pontos de entrada em rotinas MVC (PR #13).
Changelog
Veja o CHANGELOG.md para o historico completo de versoes.
Licenca
File tree
313thalysjuvenal/advpl-specialistView on GitHub
.claude-plugin/
marketplace.json
plugin.json
.cursor/
commands/
advpr.md
changelog.md
diagnose.md
docs.md
document.md
explain.md
generate.md
migrate.md
process.md
refactor.md
review.md
smartx.md
sxgen.md
test.md
.gemini/
commands/
advpr.toml
changelog.toml
diagnose.toml
docs.toml
document.toml
explain.toml
generate.toml
migrate.toml
process.toml
refactor.toml
review.toml
smartx.toml
sxgen.toml
test.toml
.github/
copilot-instructions.md
FUNDING.yml
ISSUE_TEMPLATE/
bug_report.md
feature_request.md
prompts/
advpr.prompt.md
changelog.prompt.md
diagnose.prompt.md
docs.prompt.md
document.prompt.md
explain.prompt.md
generate.prompt.md
migrate.prompt.md
process.prompt.md
refactor.prompt.md
review.prompt.md
smartx.prompt.md
sxgen.prompt.md
test.prompt.md
pull_request_template.md
workflows/
collect-traffic.yml
deploy-docs.yml
validate-plugin.yml
.gitignore
.markdownlint-cli2.jsonc
agents/
AGENTS.md
changelog-generator.md
code-generator.md
code-reviewer.md
debugger.md
doc-generator.md
docs-reference.md
migrator.md
process-consultant.md
refactorer.md
sx-configurator.md
ai-commands/
README.md
src/
advpr.md
changelog.md
diagnose.md
docs.md
document.md
explain.md
generate.md
migrate.md
process.md
refactor.md
review.md
smartx.md
sxgen.md
test.md
CHANGELOG.md
CLAUDE.md
CODE_OF_CONDUCT.md
commands/
advpr.md
changelog.md
diagnose.md
docs.md
document.md
explain.md
generate.md
migrate.md
process.md
refactor.md
review.md
smartx.md
sxgen.md
test.md
CONTRIBUTING.md
documentation/
.gitignore
app/
api/
search/
route.ts
docs/
[[...slug]]/
page.tsx
layout.tsx
global.css
layout.tsx
page.tsx
components/
mdx.tsx
content/
docs/
agentes/
changelog-generator.mdx
code-generator.mdx
code-reviewer.mdx
debugger.mdx
doc-generator.mdx
docs-reference.mdx
meta.json
migrator.mdx
process-consultant.mdx
refactorer.mdx
sx-configurator.mdx
changelog.mdx
comandos/
advpr.mdx
changelog.mdx
diagnose.mdx
docs.mdx
document.mdx
explain.mdx
generate.mdx
meta.json
migrate.mdx
process.mdx
refactor.mdx
review.mdx
smartx.mdx
sxgen.mdx
test.mdx
contribuicao.mdx
exemplos.mdx
index.mdx
instalacao.mdx
meta.json
outras-ias.mdx
plugins-complementares.mdx
primeiro-comando.mdx
processos/
compras.mdx
contabilidade.mdx
estoque.mdx
faturamento.mdx
financeiro.mdx
fiscal.mdx
manutencao.mdx
meta.json
pcp.mdx
referencia/
dicionario-sx.mdx
funcoes-nativas.mdx
meta.json
parametros-mv.mdx
rest-api.mdx
skills/
advpl-code-generation.mdx
advpl-code-review.mdx
advpl-debugging.mdx
advpl-refactoring.mdx
advpl-to-tlpp-migration.mdx
advpr-test-automation.mdx
changelog-patterns.mdx
code-explanation.mdx
documentation-patterns.mdx
embedded-sql.mdx
meta.json
probat-testing.mdx
protheus-business.mdx
protheus-locks-deadlocks.mdx
protheus-reference.mdx
query-builder.mdx
smartx-development.mdx
sx-configuration.mdx
tdn-lookup.mdx
lib/
layout.shared.tsx
source.ts
next-env.d.ts
next.config.mjs
package-lock.json
package.json
postcss.config.mjs
public/
favicon.svg
og-image.png
source.config.ts
tsconfig.json
examples/
01-gerar-mvc-za1/
README.md
02-migrar-fata001/
FATA001-antes.prw
README.md
03-diagnosticar-lock/
README.md
04-gerar-rest-tlpp/
README.md
05-review-com-focus-performance/
exemplo-lento.prw
README.md
06-sxgen-tabela-customizada/
README.md
encoding-tests/
fixtures/
.gitkeep
01-ascii-puro.prw
02-acentos-ptbr.prw
03-translit-symbols.prw
04-emoji-fail.prw
05-already-cp1252.prw
06-utf8-bom.prw
07-not-advpl.txt
08-tlpp-class.tlpp
ascii-puro.txt
cp1252-acentos.txt
utf8-acentos.txt
utf8-bom.txt
utf8-emoji.txt
run-tests.sh
README.md
hooks/
hooks.json
lib/
convert-encoding.sh
detect-protheus-version.sh
post-tool-use-encoding
session-start
LICENSE
README.md
scripts/
build-ai-commands.mjs
SECURITY.md
skills/
advpl-code-generation/
catalogo-top-50-pes.md
patterns-fwformbrowse.md
patterns-fwmsprinter.md
patterns-jobs.md
patterns-mvc.md
patterns-pontos-entrada-mvc.md
patterns-pontos-entrada.md
patterns-rest.md
patterns-soap.md
patterns-treport.md
patterns-workflow.md
reference.md
SKILL.md
templates-classes.md
advpl-code-review/
reference.md
rules-best-practices.md
rules-modernization.md
rules-performance.md
rules-security.md
SKILL.md
sonarqube-rules-catalog.md
advpl-debugging/
common-errors.md
performance-tips.md
reference.md
SKILL.md
advpl-refactoring/
reference.md
SKILL.md
advpl-to-tlpp-migration/
migration-checklist.md
migration-rules.md
reference.md
SKILL.md
advpr-test-automation/
api-fwtesthelper.md
best-practices.md
gps-de-testes.md
patterns-execauto.md
patterns-mvc.md
patterns-processing.md
patterns-reports.md
patterns-routine-prep.md
patterns-smartlink.md
patterns-smartview.md
patterns-totvs-message.md
patterns-webservice.md
reference.md
SKILL.md
changelog-patterns/
reference.md
SKILL.md
code-explanation/
reference.md
SKILL.md
documentation-patterns/
reference.md
SKILL.md
embedded-sql/
reference.md
SKILL.md
probat-testing/
patterns-unit-tests.md
reference.md
SKILL.md
protheus-business/
modulo-compras.md
modulo-contabilidade.md
modulo-estoque.md
modulo-faturamento.md
modulo-financeiro.md
modulo-fiscal.md
modulo-manutencao.md
modulo-pcp.md
reference.md
SKILL.md
protheus-locks-deadlocks/
diagnostics.md
patterns-prevention.md
reference.md
SKILL.md
protheus-reference/
native-functions.md
reference.md
rest-api-reference.md
restricted-functions.md
SKILL.md
sx-dictionary.md
sx3-common-fields.md
query-builder/
cross-database.md
index-awareness.md
patterns-fwpreparedstatement.md
patterns-workarea.md
reference.md
SKILL.md
smartx-development/
patterns-advpl-integration.md
patterns-interface.md
patterns-launcher-browse.md
patterns-migration.md
patterns-model.md
reference.md
SKILL.md
troubleshooting.md
sx-configuration/
reference.md
SKILL.md
tdn-lookup/
reference.md
SKILL.mdFAQ
advpl-specialist is a Claude Code plugin with 18 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes advpl-code-generation, advpl-code-review, advpl-debugging. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is advpl-specialist?
- Plugin para Claude Code especializado em ADVPL e TLPP para desenvolvimento no ecossistema TOTVS Protheus — para desenvolvedores e consultores funcionais. Documentacao completa:
- How do I install advpl-specialist?
- Run these in Claude Code: /plugin marketplace add thalysjuvenal/advpl-specialist then /plugin install advpl-specialist@advpl-specialist-marketplace. Then prompt normally.
- Does advpl-specialist auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is advpl-specialist free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.