protheus

Plugin protheus from marketplace claude-skills-dataagile in dataagile/dataagile-agent-kit. Commands read from the repo's manifest — 1 month ago.

Skills (37)

• advpl-tlpp-sdd

  Plan and implement Protheus projects/features with 4 adaptive phases — Specify, Design, Tasks, Execute. Auto-sizes depth based on complexity. Creates atomic tasks with verification criteria, atomic commits, requirement traceability, and persistent memory across sessions. Specific to AdvPL/TLPP + Pro

• brainstorm

  Planejamento de desenvolvimento ADVPL/TLPP — intake de MIT044, explora o projeto, faz perguntas, propõe abordagens e gera design aprovado antes de qualquer código. Encadeia /protheus:plan.

• clean-architecture

  Aplica os princípios de Clean Architecture (livro de Robert Martin, o Uncle Bob) ao desenvolvimento ADVPL/TLPP — regra de dependência, separação em camadas (domínio, caso de uso, adaptador, framework Protheus), SOLID em TLPP OO e organização de fontes por domínio. Use quando o dev pedir para "organi

• code-review

  Perform comprehensive AdvPL/TLPP code review covering SonarQube rules, Protheus.doc documentation, security, performance, clean code, and TOTVS Protheus framework best practices. Use when a user says "review this code", "code review", "check this source", "audit this AdvPL/TLPP", or needs a structur

• compile

  Compila fontes ADVPL/TLPP no AppServer Protheus via TDS-CLI (advpls). AÇÃO COM EFEITO COLATERAL — nunca auto-ativa, requer invocação explícita com namespace completo.

• context-map

  Generate a context map of all files relevant to a task before implementing changes. Use when a user says "map the codebase for this change", "what files are affected", "show me dependencies", or before starting implementation to identify files to modify, dependencies, test files, and reference patte

• create-implementation-plan

  Create machine-readable implementation plan files for features, refactoring, upgrades, design, architecture, or infrastructure. Use when a user says "create implementation plan", "plan this upgrade", "plan this refactor", or needs a structured, phased plan with requirements, constraints, tasks, and

• data-dictionary-lookup

  Query the TOTVS Protheus ERP data dictionary (SX2 tables, SX3 fields, SIX indexes, SX6 parameters, SX5 generic tables, SX7 triggers, SX1 questions, SX9 relationships, SXB standard lookups, SXG/SXA groups). Use when the user asks 'what fields does SA1 have', 'what is the index of SE1', 'parameter MV_

• ddd

  Aplica Domain-Driven Design (baseado em Implementing DDD, de Vaughn Vernon) ao desenvolvimento Protheus — linguagem ubíqua com o cliente, bounded contexts para organizar customizações, context mapping para integrações, e padrões táticos em TLPP (entidades, value objects, agregados, repositórios, ser

• deploy

  Compila artefatos ADVPL/TLPP no AppServer e gera patch .ptm para aplicação no ambiente. Lê CLAUDE.md para parâmetros, confirma com o dev, aciona protheus-deployer teammate e verifica logs. Acione após /protheus:implement. Próximo passo obrigatório: /protheus:qa.

• diagnose

  Diagnostica e resolve problemas em código ADVPL/TLPP para Protheus. Classifica erros de compilação, runtime, performance e locks de banco de dados. Propõe correção precisa e valida a solução.

• documentation-writer

  Generate ProtheusDOC comment blocks for AdvPL and TLPP source code. Use when a user says "document this function", "add ProtheusDOC", "write documentation block", "document this class/method", or needs structured source-code documentation following the Protheus.doc standard for functions, classes, m

• entry-point-designer

  Design and document Protheus Entry Points (Pontos de Entrada). Always generates TLPP by default; only generates AdvPL (.prw) when the user explicitly requests AdvPL. Covers User Function signatures, PARAMIXB parameter layouts, return value specifications, and ProtheusDOC documentation. Use when user

• feedback

  Registra um aprendizado de correção na base de conhecimento Protheus. Usar quando Claude erra e o dev corrige, para que o erro não se repita com outros devs. Conduz diálogo de confirmação antes de persistir.

• fwrest-client-generator

  Generate AdvPL/TLPP code that CONSUMES external REST APIs using the FWRest client class. Covers GET, POST, PUT, DELETE verbs, header construction, query/path parameters, JSON body serialization, authentication (No Auth, HTTP Basic, Bearer Token/JWT, OAuth 2.0), timeout, SSL, status code handling, er

• implement

  Orquestra Agent Team para executar o plano ADVPL/TLPP — protheus-implementer (sonnet) implementa em worktree isolado, protheus-spec-reviewer (sonnet) verifica spec, protheus-reviewer (sonnet) revisa qualidade. Comunicação bidirecional entre teammates. Gate de compilação via lint. Use após /protheus:

• init-project

  Inicializa um projeto Protheus ADVPL — explora o projeto existente, entrevista o desenvolvedor e gera CLAUDE.md com configuração do cliente (AppServer, ambiente, prefixo de tabelas).

• migrate

  Migra código ADVPL procedural (.prw) para TLPP orientado a objetos (.tlpp). Analisa dependências, propõe estrutura de classes com namespaces FSW.TBC.*, mantém wrappers para compatibilidade retroativa e gera checklist de validação.

• mvc-generator

  Generate Protheus MVC (Model-View-Controller) screen structures including ModelDef, ViewDef, MenuDef, and BrowseDef functions. Supports single-entity (Modelo 1) and master-detail (Modelo 3) patterns with FWFormModel, FWFormView, FWFormBrowse, validations, triggers, and entry point hooks. Use when us

• patterns

  Referência de padrões ADVPL/TLPP para Protheus: nomenclatura de arquivos (R[MOD][TYPE][SEQ].prw), notação húngara, dicionário de dados (SZ?, prefixo X, TB_), Pontos de Entrada (MVC e legado), MVC, FWMBrowse, namespaces, estrutura de pastas e Code Analysis.

• plan

  Decompõe o design aprovado do brainstorm em tasks concretas para teammates ADVPL. Gera plano tipado com artefatos R[MOD][TYPE][SEQ].prw/.tlpp, gates de lint e testes E2E Playwright (test-web). Use após /protheus:brainstorm.

• qa

  Gate de QA E2E contra ambiente Protheus compilado. Aciona /protheus:test-web (Playwright — visão real + evidências MIT010) e analisa qualidade. Se falhas, retorna para /protheus:implement. Acione após /protheus:deploy. Próximo passo: /protheus:verify.

• query-builder

  Build optimized and safe SQL queries for Protheus tables. Automatically includes mandatory filters (D_E_L_E_T_, branch), suggests appropriate indexes from SIX patterns, generates both Embedded SQL (preferring FWExecStatement) and Workarea (DBSelectArea/DBSeek) versions, and warns about common Prothe

• refactor-method-complexity-reduce

  Refactor given method `${input:methodName}` to reduce its cognitive complexity to `${input:complexityThreshold}` or below, by extracting helper methods. Use when user says 'reduce complexity', 'simplify method', 'cognitive complexity too high'.

• refactor

  Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.

• reviewer

  Revisa código ADVPL/TLPP verificando: nomenclatura de arquivo (R[MOD][TYPE][SEQ].prw), ProtheusDoc completo, notação húngara, declaração de variáveis, BEGIN SEQUENCE, RecLock/MsUnlock, xFilial, campos customizados (prefixo X), parâmetros (TB_), Pontos de Entrada (lógica em função externa). Gera rela

• smartview-relatorio

  Gera um relatório TOTVS SmartView de ponta a ponta, do código ao artefato renderizando dados. A partir de uma especificação (tabelas/campos Protheus, query SQL ou dados literais), gera o Business Object TLPP (IntegratedProvider), compila no AppServer via advpls (TDS CLI remoto), registra na discover

• specialist

  Especialista ADVPL/TLPP que consulta a Knowledge Base TBC (MCP), a documentação TDN (RAG) e os padrões TBC para gerar código Protheus de qualidade.

• sql-code-review

  Universal SQL code review assistant that performs comprehensive security, maintainability, and code quality analysis across SQL databases (PostgreSQL, SQL Server, Oracle). Focuses on SQL injection prevention, access control, code standards, and anti-pattern detection. Complements SQL optimization pr

• sql-optimization

  Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across SQL databases (PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guida

• sql

  Referência e geração de SQL embarcado em ADVPL/TLPP para Protheus. Cobre BeginSQL/EndSQL, macros essenciais (%table%, %xfilial%, %notDel%, %exp%, %Order%), TCSqlExec para INSERT/UPDATE/DELETE, joins, subconsultas e anti-patterns de segurança.

• test-web

  Ciclo completo de testes E2E do TOTVS Protheus via MCP Playwright com evidências e documentação. Cobre roteiro → aprovação → execução com screenshots → validação → error handling → persistência na base de conhecimento → geração de MIT010. Substitui TIR. Use quando precisar testar rotinas Protheus, v

• tir-test-generator

  Generate TIR (TOTVS Interface Robot) end-to-end test scripts in Python for Protheus SmartClient/Webapp screens. Supports CRUD screen tests, MVC screen tests, grid interaction, report tests, field validation, and message box assertions. Use when a user says "TIR test", "interface test", "e2e test Pro

• tlpp-rest-endpoint-generator

  Generate TLPP REST endpoints using annotation-based routing (@Get, @Post, @Put, @Patch, @Delete) with the oRest object. Follows TOTVS API standards (TTALK) including pagination, error model, standard headers, and Swagger documentation. Use when user says 'create REST endpoint', 'TLPP REST', '@Get an

• utf8-to-cp1252-conversion

  Convert AdvPL/TLPP source files from UTF-8 encoding to Windows-1252 (CP1252) after code generation. The Protheus compiler only supports CP1252 encoded files — any source created or modified by an AI agent will be in UTF-8 and must be converted before compilation. Use when user says 'convert encoding

• verify

  Gate final antes de produção. Checklist de conformidade TOTVS (MIT043, Code Analysis, patch .ptm), confirma com o dev e orienta distribuição ao cliente. Acione após /protheus:qa.

• writer

  Gera código ADVPL/TLPP para Protheus seguindo obrigatoriamente: nomenclatura de arquivo R[MOD][TYPE][SEQ].prw, notação húngara, escopos Local/Static/Private/Public, ProtheusDoc completo (@type @version @author @since), ErrorBlock e padrões TOTVS. Suporta: User Function, MVC completo, FWMBrowse, Pont

Subagents (5)

• advpl-expert

  Especialista em ADVPL/TLPP para TOTVS Protheus. Use para gerar código complexo, analisar Pontos de Entrada, criar estruturas MVC e revisar lógica de negócio. Conhece as convenções TOTVS, notação húngara, acesso a banco de dados e padrões de customização do ERP.

• protheus-deployer

  Compila e faz deploy de fontes ADVPL/TLPP no AppServer via advpls (TDS-CLI). Verifica pré-requisitos (review aprovado), gera compile.ini, executa advpls cli e valida log. Usar apenas após aprovação do protheus-reviewer. Reporta resultado ao team lead.

• protheus-implementer

  Implementa tasks do plano ADVPL/TLPP seguindo TDD. Recebe task via SendMessage, consulta MCP para convenções, implementa, testa com lint (advpls appre), auto-revisa e reporta status. Modelo sonnet — implementação exige raciocínio sobre regra de negócio. Use proactively após /protheus:plan.

• protheus-reviewer

  Revisa código ADVPL/TLPP em contexto isolado. Verifica notação húngara, declaração de variáveis, tratamento de erros, acesso ao banco de dados e boas práticas TOTVS. Retorna relatório estruturado com CRÍTICO/AVISO/SUGESTÃO e veredicto de compilação. Pode enviar correções direto ao implementador.

• protheus-spec-reviewer

  Verifica se a implementação ADVPL/TLPP corresponde exatamente ao design doc e à task especificada. Lê o código real — não confia no relatório do implementador. Retorna ✅ ou ❌ com referências file:line. Pode enviar feedback direto ao implementador.

MCP servers (2)

• tbc-knowledge

  runs: node ${CLAUDE_PLUGIN_ROOT}/dist/tbc-mcp-proxy.mjs

• po-ui

  runs: npx -y @po-ui/mcp

Hooks (5)

• SessionStart

  node "${CLAUDE_PLUGIN_ROOT}/hooks/session-context.cjs"

• PostToolUse

  "${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd" advpl-encoding.sh

• PostToolUse

  "${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd" advpl-lint.sh

• PostToolUse

  node "${CLAUDE_PLUGIN_ROOT}/hooks/sonar-lint.cjs"

• UserPromptSubmit

  node "${CLAUDE_PLUGIN_ROOT}/hooks/prompt-context.cjs"

Similar plugins