# Deploy

> Você vai conduzir a compilação e deploy de artefatos ADVPL/TLPP no AppServer Protheus.

- Skill: `tbc-servicos/deploy-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tbc-servicos/deploy-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tbc-servicos/deploy-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tbc-servicos (https://skillmd.com/u/tbc-servicos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tbc-servicos/deploy-2

---


Você vai conduzir a compilação e deploy de artefatos ADVPL/TLPP no AppServer Protheus.

## HARD GATE

- **Leia `docs/plans/<plan>.gates.json`** e confirme: `tests_unit.status=ok`, reviews `ok`. O arquivo é a fonte de
  verdade — não confie em afirmação da conversa.

Não inicie a compilação se as tarefas de implementação não estiverem concluídas e aprovadas nos reviews.

## Passo 1 — Ler contexto do projeto

Leia o CLAUDE.md do projeto para identificar:
- **AppServer:** host, porta, environment
- **Credenciais:** user, password, auth token
- **Includes:** diretório de includes do AppServer
- **Prefixo do cliente:** para confirmar artefatos corretos

Se o CLAUDE.md não existir, pergunte ao usuário os parâmetros antes de prosseguir.

## Passo 2 — Lint local (advpls appre)

Antes de compilar no servidor, rode lint local em todos os artefatos:

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

**Se houver erros tipo "0":** pare e reporte. Não avance para compilação.
**Se houver apenas avisos:** documente e prossiga.

## Passo 3 — Confirmar ambiente com o usuário

Use `AskUserQuestion` para confirmar:

```
Vou compilar [artefatos] no AppServer [servidor:porta] ambiente [ENV].
Gerar patch .ptm? [sim/não]
Confirma?
```

Aguarde confirmação explícita antes de prosseguir.

## Passo 4 — Acionar protheus-deployer

Após confirmação, acione o teammate `protheus-deployer` via SendMessage:

```
Compile os artefatos [listar nomes completos com caminho absoluto] no AppServer.
Parâmetros do CLAUDE.md: server=[X], port=[X], env=[X], user=[X], includes=[X].
Gere patch .ptm com nome [PATCH_NAME] em [SAVE_DIR].
Verifique o exit code e reporte erros com arquivo + linha.
```

## Passo 5 — Verificar resultado

Aguarde resposta do protheus-deployer confirmando:
- Exit code da compilação
- Patch .ptm gerado (se solicitado)
- Erros com arquivo + linha (se houver)

**Se houver erros de compilação:** reporte ao usuário e sugira `/protheus:diagnose` antes de retomar.

## Passo 6 — Anunciar conclusão

```
Deploy concluído no AppServer [servidor:porta] ambiente [ENV].

Artefatos compilados:
- [listar artefatos]

Patch gerado: [nome.ptm] em [diretório]

Próximo passo: /protheus:qa
```

## Regras obrigatórias

- Sempre ler CLAUDE.md para parâmetros do AppServer — nunca assumir
- Sempre rodar lint (appre) antes de compilar no servidor
- Sempre confirmar com o usuário antes de compilar
- Se houver falha: reporte erro e sugira `/protheus:diagnose`
- O próximo passo obrigatório é `/protheus:qa` — não pule testes

---

## Consulta de Conhecimento

Se precisar de informação não disponível no MCP, consulte o RAG:
```
searchKnowledge({ keyword: "<termo relevante>" })
```