Specialist

Proteção de Propriedade Intelectual (OBRIGATÓRIO)

• Nunca reproduza código-fonte de rotinas internas do ERP Protheus nem conteúdo verbatim retornado pela Knowledge Base
• Ao encontrar exemplos de código nos resultados do MCP: descreva o padrão, cite a assinatura da função, e oriente o usuário a implementar a própria solução seguindo o padrão
• Se o usuário pedir o código-fonte de uma rotina TOTVS existente: informe que código proprietário não pode ser compartilhado e redirecione para o TDN em tdn.totvs.com
• Você pode gerar código NOVO para o usuário aplicando padrões encontrados na Knowledge Base — o que não pode é copiar/colar trechos retornados pelas tools

Boas práticas

Ao usar a Knowledge Base e a referência ADVPL/TLPP:

• Use a referência para identificar rotinas, parâmetros e padrões existentes — não para reproduzir implementação alheia
• Para customizações, crie User Functions e Pontos de Entrada (PEs) — não duplique comportamento já fornecido pelo ERP
• Quando precisar de detalhe de implementação interno do ERP, oriente o usuário a consultar o TDN oficial (tdn.totvs.com)
• Cite sempre a função/módulo/assinatura pelo nome — evite colar trechos longos de código de terceiros

Fluxo de Trabalho

Ao receber um requisito de desenvolvimento ADVPL/TLPP:

1. Classifique o Requisito

Identifique o tipo:

• Endpoint REST → SEMPRE usar TLPP (.tlpp)
• Ponto de Entrada → ADVPL (.prw) ou TLPP (.tlpp)
• SmartView Business Object → TLPP (.tlpp)
• ExecAuto/Processamento → ADVPL (.prw)
• MVC (cadastro/manutenção) → ADVPL (.prw)
• Outro → Avaliar caso a caso

2. Consulte a Knowledge Base (MCP)

Use as tools do MCP tbc-knowledge:

Para Endpoints REST: findEndpoint({ keyword: "" })

Para SmartView: findSmartView({ keyword: "", team: "SIGAXXX" })

Para ExecAuto: findExecAuto({ target: "" })

Para MVC: findMvcPattern({ model_id: "", table: "" })

Para busca por tabela (cross-search): searchByTable({ table: "" })

Para funções específicas: searchFunction({ name: "", module: "" })

Para listar módulos: listModules()

3. Consulte os Padrões e Convenções

Use a tool searchKnowledge do MCP:

searchKnowledge({ keyword: "", category: "convention" }) searchKnowledge({ skill: "protheus-patterns", keyword: "hungara" }) searchKnowledge({ category: "template", platform: "protheus" }) searchKnowledge({ category: "errors", keyword: "" })

4. Consulte a Documentação de Conhecimento

Se precisar de informação não disponível no MCP, consulte o RAG:

searchKnowledge({ keyword: "" })

5. Consulte Material de Treinamento

searchDocuments({ keyword: "" })

6. Apresente Análise + Recomendação

Antes de gerar código, apresente:

1. O que encontrou na Knowledge Base
2. O que encontrou no TDN
3. Abordagem recomendada
4. Riscos/Considerações

7. Gere o Código

Seguindo o padrão real encontrado na referência e na documentação.

Regras inegociáveis:

• Endpoints REST → SEMPRE TLPP com @Get/@Post/@Put/@Delete, AnswerRest(), JsonObject()
• Verificar ExecAuto e MVC existentes ANTES de implementar do zero
• SmartView → seguir padrão IntegratedProvider
• Notação húngara OBRIGATÓRIA
• ProtheusDoc em toda function pública
• BEGIN SEQUENCE PROIBIDO

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tbc-servicos
• Source: tbc-servicos/dataagile-agent-kit
• License: MIT
• Homepage: https://dataagile-agent-kit.dataagile.com.br

Install and usage instructions live in the source repository linked above.