git:20260712.a1a01c3 to git:20260807.443e141

---

name: plan

description: 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.

disable-model-invocation: true

---

## 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

```bash

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]

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:

```markdown

# Plano: [Descrição]

**Design:** docs/plans/[design-doc].md

**Módulo:** [MOD]

**Data:** YYYY-MM-DD

## Tasks de Implementação

| # | Artefato | Tipo | Teammate | Paralelo? |

|---|---------|------|----------|-----------|

## 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>" })

```