Plan

Skill tbc-servicos/dataagile-agent-kit/protheus/skills/plan

Plugin Claude Code para Protheus e ADVPL/TLPP — base 155k+ registros, Agent Teams, compilação TDS-CLI, testes TIR e MCP PO-UI

Install

npx -y skills add tbc-servicos/dataagile-agent-kit --skill plan

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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.

SKILL.md

4.3 KB, as published. Nobody here has run it

Instruções para Claude

Leia o design doc mais recente em docs/plans/ antes de começar. Se não houver design doc, recomende /protheus:brainstorm primeiro.

Passo 1 — Ler o design aprovado

ls -t docs/plans/*.md | head -3

Leia o design doc identificado. Extraia:

Lista de artefatos a implementar (nome do arquivo, tipo, responsabilidade)
Módulo Protheus (FAT, FIN, EST, COM, RH…)
Tabelas envolvidas
Regras de negócio críticas

Passo 2 — Decompor em tasks de implementação

Para cada artefato identificado no design, crie uma task com:

Task N: Implementar [NOME_ARQUIVO]
Teammate: protheus-implementer (haiku)
Artefato: R[MOD][TYPE][SEQ].prw (ou .tlpp)
Tipo: [User Function | MVC | Ponto de Entrada | Relatório]
Responsabilidade: [descrição funcional]
Contexto para o teammate:
  - Design doc: docs/plans/[arquivo].md
  - Tabelas: [lista]
  - Regras: [lista]
  - Padrões: consultar MCP para convenções atualizadas

Tasks de implementação podem rodar em paralelo quando os artefatos forem independentes (PE em arquivo próprio, funções sem dependência mútua).

Passo 3 — Adicionar tasks fixas de qualidade (sempre nesta ordem)

Após todas as tasks de implementação, adicione obrigatoriamente:

Task Review Spec Compliance

Task N+1: Review spec compliance
Teammate: protheus-spec-reviewer (sonnet)
Escopo: todos os artefatos implementados
Critério de aprovação: ✅ SPEC OK em todos os artefatos
Bloqueio: tasks de implementação devem estar concluídas

Task Review Qualidade

Task N+2: Review qualidade de código
Teammate: protheus-reviewer (sonnet)
Escopo: todos os artefatos aprovados no spec compliance
Critério de aprovação: Aprovado para compilação: SIM
Bloqueio: spec compliance aprovado

Task Lint Gate

Task N+3: Lint local (advpls appre)
Ação: rodar advpls appre em todos os artefatos
GATE: se lint retornar erros tipo "0" → fluxo para aqui
Critério de aprovação: zero erros tipo "0"
Bloqueio: ambos os reviews aprovados

Task Deploy (compilação + patch)

Task N+4: Compilar e gerar patch
Skill: /protheus:deploy
Ação: compilar no AppServer via advpls cli, gerar patch .ptm
Bloqueio: lint aprovado

Task Testes E2E Playwright

Engine oficial de E2E: Playwright (/protheus:test-web) — visão computacional real (screenshots + snapshot da tela). O TIR não é a forma oficial de testar (não tem visão computacional): use-o apenas, opcionalmente, como suíte de regressão CI gerada a partir da sessão Playwright já validada (ver nota em /protheus:qa).

Task N+5: Executar testes E2E Playwright (via /protheus:qa → /protheus:test-web)
Skill: /protheus:qa
Escopo: fluxos críticos de negócio identificados no design
Bloqueio: compilação bem-sucedida (RPO atualizado)

Passo 4 — Salvar o plano

Salve o plano completo em:

docs/plans/YYYY-MM-DD-[modulo]-[descricao]-plan.md

Formato do plano:

# Plano: [Descrição]

**Design:** docs/plans/[design-doc].md
**Módulo:** [MOD]
**Data:** YYYY-MM-DD

## Tasks de Implementação

| # | Artefato | Tipo | Teammate | Paralelo? |
|---|---------|------|----------|-----------|
| 1 | RFATA001.prw | User Function | protheus-implementer (haiku) | sim |
| 2 | PE_MATA010.prw | Ponto de Entrada MVC | protheus-implementer (haiku) | sim |

## Tasks de Qualidade e Deploy

| # | Task | Teammate/Skill | Bloqueada por |
|---|------|----------------|--------------|
| 3 | Spec compliance | protheus-spec-reviewer (sonnet) | 1, 2 |
| 4 | Qualidade código | protheus-reviewer (sonnet) | 3 |
| 5 | Lint gate (appre) | — | 4 |
| 6 | Compilação + patch | /protheus:deploy | 5 |
| 7 | Testes E2E Playwright | /protheus:qa | 6 |

Passo 5 — Encadear implementação

Após salvar o plano:

Plano salvo em docs/plans/[arquivo]-plan.md

Próximo passo:
  /protheus:implement

Consulta de Conhecimento

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

searchKnowledge({ keyword: "<termo relevante>" })