git:20260712.6010b47 to git:20260807.443e141

12 added, 9 removed. Audit A to A.

---

- description: Orquestra Agent Team para executar o plano ADVPL/TLPP — protheus-implementer (haiku) 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:plan. Próximo passo: /protheus:deploy.

+ description: 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:plan. Próximo passo: /protheus:deploy.

disable-model-invocation: true

---

## Instruções para Claude

Leia o plano mais recente em `docs/plans/` (arquivo terminado em `-plan.md`).

Se não houver plano, recomende `/protheus:plan` primeiro.

---

## Pré-requisitos

- **Agent Teams** habilitado: `export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`

- **Claude Code v2.1.32+**

- Plano aprovado em `docs/plans/`

Se Agent Teams não estiver habilitado, informe o usuário e caia no fallback (Estágio 1-alt).

---

## Regra de Modelos (OBRIGATÓRIA)

| Papel | Modelo | Uso |

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

- | protheus-implementer | **haiku** | Implementação mecânica, TDD |

+ | protheus-implementer | **sonnet** | Implementação — exige raciocínio sobre regra de negócio |

| protheus-spec-reviewer | **sonnet** | Verificação de conformidade com spec |

| protheus-reviewer | **sonnet** | Qualidade de código ADVPL/TLPP |

- | Opus | **NUNCA automático** | Se complexo, sugerir ao dev — decisão é dele |

+ | Opus | **só no brainstorm** | O design já foi feito em opus (`/protheus:brainstorm`). Nenhum teammate escala sozinho |

+ | Haiku | **não usar aqui** | Haiku só em deploy/compilação (`protheus-deployer`) |

---

## Artefato de estado dos gates (gates.json)

Todo veredito de gate é GRAVADO em `docs/plans/<plan>.gates.json` — a skill seguinte LÊ o

arquivo em vez de confiar na memória da conversa. Atualize a chave do estágio ao concluí-lo:

`{ "tests_unit": {...}, "spec_review": "ok", "code_review": "ok", "lint": "ok", "deploy": {...}, "qa_e2e": {...} }`.

Pipeline retomável: sessão nova lê o arquivo e continua de onde parou.

## Estágio 0 — Criar Agent Team

Crie o time de implementação:

```

TeamCreate({

description: "Time de implementação ADVPL/TLPP com feedback bidirecional"

})

```

Os teammates serão despachados via Agent tool com:

- - `subagent_type: "protheus:protheus-implementer"` (haiku)

+ - `subagent_type: "protheus:protheus-implementer"` (sonnet)

- `subagent_type: "protheus:protheus-spec-reviewer"` (sonnet)

- `subagent_type: "protheus:protheus-reviewer"` (sonnet)

- `isolation: "worktree"` para implementador (trabalha em cópia isolada)

---

- ## Estágio 1 — Implementação (teammate haiku, worktree isolado)

+ ## Estágio 1 — Implementação (teammate sonnet, worktree isolado)

Para cada task de implementação do plano, despache o teammate `protheus-implementer`:

```

Agent({

subagent_type: "protheus:protheus-implementer",

isolation: "worktree",

- model: "haiku",

+ model: "sonnet",

prompt: "<conteúdo do implementer-prompt.md preenchido>"

})

```

Leia o template em `skills/implement/implementer-prompt.md` e preencha com:

- Texto completo da task

- Conteúdo do design doc

- Contexto adicional (tabelas, regras, dependências)

Tasks independentes podem rodar em paralelo (múltiplos Agent calls no mesmo bloco).

Tasks com dependência rodam em sequência.

### Tratamento de respostas:

- **DONE:** Avance para o Estágio 2

- **BLOCKED:** Analise o bloqueio. Se for dependência de outra task, reordene. Se for técnico, use SendMessage para fornecer contexto adicional ao implementador.

- **NEEDS_CONTEXT:** Responda a dúvida do implementador via SendMessage com contexto adicional.

### Fallback (sem Agent Teams):

Se Agent Teams não estiver disponível, use o padrão anterior:

- Despache via Agent tool sem TeamCreate

- Comunicação unidirecional (sem SendMessage de volta)

Aguarde conclusão de todas as tasks antes de avançar.

---

## Estágio 2 — Review Spec Compliance (teammate sonnet)

Despache o teammate `protheus-spec-reviewer`:

```

Agent({

subagent_type: "protheus:protheus-spec-reviewer",

model: "sonnet",

prompt: "<conteúdo do spec-reviewer-prompt.md preenchido>"

})

```

Leia o template em `skills/implement/spec-reviewer-prompt.md` e preencha com:

- Lista de artefatos implementados (com caminhos — se worktree, usar o path do worktree)

- Design doc original

- Tasks do plano

**Critério de avanço:** ✅ SPEC OK em todos os artefatos.

**Se houver ❌ SPEC FALHA:**

1. Identifique as divergências

2. Envie feedback ao implementador via SendMessage com as divergências

3. Após correção, repita o review spec

4. Só avance quando todos os artefatos estiverem ✅

---

## Estágio 3 — Review Qualidade de Código (teammate sonnet)

Despache o teammate `protheus-reviewer`:

```

Agent({

subagent_type: "protheus:protheus-reviewer",

model: "sonnet",

prompt: "<conteúdo do code-reviewer-prompt.md preenchido>"

})

```

Leia o template em `skills/implement/code-reviewer-prompt.md` e preencha com:

- Lista de artefatos aprovados no spec review

- Contexto do projeto

**Critério de avanço:** `Aprovado para compilação: SIM`

**Se houver CRÍTICOs:**

- Envie feedback direto ao implementador via SendMessage

- Ciclo: corrige (implementer) → re-review → avança

---

## Estágio 4 — Lint Gate (validação local)

Antes de encaminhar para deploy, rode lint local em todos os artefatos:

```bash

advpls appre /caminho/arquivo.prw -I /caminho/includes/

```

**Critério de avanço:** zero erros tipo "0" no lint.

**Se houver erros:**

```

GATE DE LINT — fluxo interrompido

Erros do advpls appre:

[erros com arquivo + linha]

Ações necessárias:

1. Corrija os erros nos artefatos indicados

2. Repita os reviews (Estágios 2 e 3) se a correção for substancial

3. Reexecute o lint após correção

```

---

## Estágio 5 — Merge Worktree + Encerramento

Se o implementador usou worktree isolado:

1. Revise as mudanças do worktree branch

2. Merge no branch principal do projeto

3. Limpe o worktree

Quando todos os estágios passarem:

```

Implementação concluída

Artefatos implementados: [lista]

Spec review: ✅ todos conformes

Code review: Aprovado para compilação: SIM

Lint: PASS (0 erros)

Worktree: merged e limpo

Próximo passo: /protheus:deploy

```

### Sobre complexidade

- Se durante a implementação identificar que uma task é complexa demais para haiku:

+ Se durante a implementação aparecer uma decisão de **design** que o brainstorm não

+ resolveu (nova camada, novo fonte, contrato diferente do aprovado), **pare** — isso não se

+ resolve na implementação:

```

- ⚠️ Task [N] pode se beneficiar do modelo opus para [motivo].

- Deseja escalar este task para opus? (decisão do dev)

+ ⚠️ Task [N] esbarra em decisão de design não coberta pelo design aprovado: [motivo].

+ Volte ao /protheus:brainstorm (opus) antes de continuar.

```

**Nunca escalar automaticamente.** A decisão é sempre do desenvolvedor.

---

## Consulta de Conhecimento

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

```

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

```