From advpl-specialist
Generates ADVPL/TLPP code for TOTVS Protheus including User Functions, MVC, REST APIs, SOAP, reports, entry points, and jobs. Follows naming conventions and structural rules.
How this skill is triggered — by the user, by Claude, or both
Slash command
/advpl-specialist:advpl-code-generationThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill provides patterns, templates, and mandatory structural rules for generating new ADVPL (`.prw`) and TLPP (`.tlpp`) code for TOTVS Protheus. It covers naming conventions (module prefixes, Hungarian notation), the mandatory User Function skeleton with Protheus.doc headers and error handling, variable scope rules, TLPP namespace conventions (`custom.<agrupador>.<servico>`), and the 8/10/...
This skill provides patterns, templates, and mandatory structural rules for generating new ADVPL (.prw) and TLPP (.tlpp) code for TOTVS Protheus. It covers naming conventions (module prefixes, Hungarian notation), the mandatory User Function skeleton with Protheus.doc headers and error handling, variable scope rules, TLPP namespace conventions (custom.<agrupador>.<servico>), and the 8/10/255-character identifier length limits per construct type.
Activate this skill whenever the user requests new code creation: a new function, a TLPP class, an MVC screen, a REST endpoint, a SOAP web service, an entry point, a report, a batch job, or any new .prw/.tlpp file. It does not cover reviewing existing code (see advpl-code-review), fixing errors in existing code (see advpl-debugging), improving existing code structure without adding features (see advpl-refactoring), or converting legacy .prw to .tlpp (see advpl-to-tlpp-migration).
The reference and pattern files below hold the concrete templates -- read the specific pattern file that matches the type of code being generated instead of relying on memory.
| Reference file | Read when |
|---|---|
| reference.md | Always -- overview, naming conventions, mandatory User Function structure, namespace rules, identifier length limits, common mistakes |
| templates-classes.md | Generating a TLPP class (data, methods, constructor) |
| patterns-mvc.md | Generating an MVC screen (ModelDef/ViewDef/MenuDef) |
| patterns-rest.md | Generating a REST API endpoint (WsRestFul or TLPP @Get/@Post annotations) |
| patterns-soap.md | Generating a SOAP Web Service |
| patterns-treport.md | Generating a TReport-based report with embedded SQL |
| patterns-pontos-entrada.md | Generating a legacy (non-MVC) entry point (ponto de entrada) |
| patterns-pontos-entrada-mvc.md | Generating an MVC-based entry point |
| patterns-workflow.md | Generating a Protheus workflow routine |
| patterns-jobs.md | Generating a scheduled/background job |
| patterns-fwmsprinter.md | Generating a coordinate-based PDF report with FWMsPrinter |
| patterns-fwformbrowse.md | Generating a browse screen with FWFormBrowse |
| catalogo-top-50-pes.md | Looking up existing well-known entry points before creating a duplicate |
npx claudepluginhub thalysjuvenal/advpl-specialist --plugin advpl-specialistMigrates legacy ADVPL procedural code (.prw) to TLPP object-oriented classes (.tlpp) with namespaces, methods, and backward-compatible wrappers for TOTVS Protheus.
Creates new ABAP programs (Report, CRUD, ALV, Batch) with Main+Include structure supporting OOP or Procedural paradigms using a multi-phase coding and QA pipeline.
Compiles ADVPL source code via plugadvpl (TOTVS advpls wrapper). Includes a mandatory 4-step workflow for the Claude Code agent.