Nível 2 — Ferramenta de trabalho · Módulo 2.4 — Skills de verdade

2.4.1 · Quem manda em quê: CLAUDE.md, skill, slash command, hook

4 min de vídeo TODOS

Objetivo: ao final, o consultor escolhe a superfície de instrução correta — CLAUDE.md, skill, slash command ou hook — para cada necessidade nova que aparecer no dia a dia.

O que você precisa levar desta aula

Convenção que vale sempre, para qualquer tarefa, em qualquer sessão → CLAUDE.md. Carrega do início ao fim, mesmo quando não é relevante para a tarefa do momento.
Procedimento ligado a um tipo específico de tarefa, que carrega sozinho só quando relevante → skill. Ação que só roda quando você a aciona explicitamente → slash command.
Regra que o Claude não pode pular, nunca, mesmo sob pressão de prazo → hook, porque é código que roda de verdade (enforcement) — não uma instrução que ele "segue" por interpretação.

As quatro superfícies, lado a lado

Superfície	Quando usar	Como carrega	No exemplo da aula (checklist de spec)
`CLAUDE.md`	Convenção universal, vale para todo o projeto	Carregado em toda sessão, do início, relevante ou não	"Toda FS segue o template da Wayon" — isso sim é universal
Skill	Procedimento ligado a um tipo de tarefa específico	Dispara sozinha quando a tarefa bate com a description	O checklist de revisão dispara quando você pede para revisar uma FS — e só então
Slash command	Ação que você decide quando rodar	Só executa quando você digita o comando	`/revisar-spec` — útil, mas não dispara se você esquecer de chamar
Hook	Regra que não pode ser pulada, nunca	Código executado antes/depois de uma ação, sem interpretação	Bloquear a entrega se um campo obrigatório do template estiver vazio — checagem binária, não julgamento

Por que hook não serve para "revisar com julgamento"

Hook é enforcement: roda um script, e o script aprova ou reprova com base numa condição verificável — arquivo existe, teste passou, campo está preenchido. "A seção de impacto está bem escrita" não é uma condição binária que um script possa avaliar sozinho. Para julgamento de conteúdo, a superfície certa é a skill: ela carrega o checklist e é o Claude — não um script — quem lê e avalia contra ele.

O teste de uma pergunta

Diante de uma necessidade nova, uma pergunta já filtra a maior parte dos casos: isso vale sempre, só para esse tipo de tarefa, só quando eu peço, ou nunca pode ser pulado? As quatro respostas mapeiam direto para as quatro superfícies, nessa ordem.

📖 Hooks — documentação oficial

Quiz — 6 questões

1."Toda mensagem enviada ao cliente Meridiano deve ser assinada 'Equipe Wayon', em qualquer projeto, sempre." Qual superfície?

a)CLAUDE.md
Correto. É uma convenção universal, válida em qualquer sessão, não ligada a um tipo específico de tarefa.
b)Skill
Skill carrega só quando a tarefa bate com uma description específica — uma convenção que vale sempre não deveria depender disso.
c)Slash command
Exigiria lembrar de chamar o comando toda vez que se escreve uma mensagem — o oposto de "sempre".

Ver resposta e por quê

✅a) Correto. É uma convenção universal, válida em qualquer sessão, não ligada a um tipo específico de tarefa.

❌b) Skill carrega só quando a tarefa bate com uma description específica — uma convenção que vale sempre não deveria depender disso.

❌c) Exigiria lembrar de chamar o comando toda vez que se escreve uma mensagem — o oposto de "sempre".

2.Um checklist de 15 itens, usado apenas quando alguém pede para revisar um roteiro de teste integrado — nunca em outro contexto.

a)Skill
Correto. Procedimento ligado a um tipo específico de tarefa, que carrega sozinho quando relevante.
b)CLAUDE.md
Carregaria em toda sessão, inclusive quando não há roteiro de teste nenhum sendo revisado.
c)Hook
Hook checa condição binária por código; avaliar um roteiro de teste inteiro exige julgamento, não uma checagem automática.

Ver resposta e por quê

✅a) Correto. Procedimento ligado a um tipo específico de tarefa, que carrega sozinho quando relevante.

❌b) Carregaria em toda sessão, inclusive quando não há roteiro de teste nenhum sendo revisado.

❌c) Hook checa condição binária por código; avaliar um roteiro de teste inteiro exige julgamento, não uma checagem automática.

3."Rodar a compilação e os testes de unidade sempre que um arquivo .abap for salvo, sem exceção, mesmo se o consultor esquecer de pedir."

a)Slash command
Dependeria do consultor lembrar de chamar — a exigência aqui é justamente "sem exceção, mesmo se esquecer".
b)Hook
Correto. É uma regra que não pode ser pulada — enforcement por código, não instrução seguida por interpretação.
c)CLAUDE.md
CLAUDE.md é instrução textual que o Claude segue por interpretação; não garante execução mesmo sob pressão, como o hook garante.

Ver resposta e por quê

❌a) Dependeria do consultor lembrar de chamar — a exigência aqui é justamente "sem exceção, mesmo se esquecer".

✅b) Correto. É uma regra que não pode ser pulada — enforcement por código, não instrução seguida por interpretação.

❌c) CLAUDE.md é instrução textual que o Claude segue por interpretação; não garante execução mesmo sob pressão, como o hook garante.

4.Gerar um relatório de status semanal do projeto, só quando o PM decide, no momento que ele decide, que é hora de gerar.

a)Slash command
Correto. Ação explícita, sob demanda, acionada quando o PM decide.
b)CLAUDE.md
Geraria a expectativa de relatório em toda sessão, não só quando o PM decide.
c)Hook
Hook roda automaticamente a partir de uma condição de sistema, não a partir de uma decisão pontual de quando o PM quer gerar algo.

Ver resposta e por quê

✅a) Correto. Ação explícita, sob demanda, acionada quando o PM decide.

❌b) Geraria a expectativa de relatório em toda sessão, não só quando o PM decide.

❌c) Hook roda automaticamente a partir de uma condição de sistema, não a partir de uma decisão pontual de quando o PM quer gerar algo.

5."Impedir que qualquer script gerado com apoio do Claude rode contra o ambiente PRD sem aprovação humana registrada — sem exceção, nenhuma vez."

a)Hook
Correto. Regra que não pode ser pulada, mesmo sob pressão — a definição exata de quando usar hook.
b)Skill
Skill é procedimento que o Claude segue por interpretação; uma trava "sem exceção, nenhuma vez" pede garantia de código, não de instrução seguida.
c)CLAUDE.md
CLAUDE.md é seguido por interpretação; não impede uma execução por garantia, só por instrução textual.

Ver resposta e por quê

✅a) Correto. Regra que não pode ser pulada, mesmo sob pressão — a definição exata de quando usar hook.

❌b) Skill é procedimento que o Claude segue por interpretação; uma trava "sem exceção, nenhuma vez" pede garantia de código, não de instrução seguida.

❌c) CLAUDE.md é seguido por interpretação; não impede uma execução por garantia, só por instrução textual.

6.Consolidar as atas de um workshop de MM-Compras num blueprint estruturado — procedimento usado só nessa etapa específica do projeto, não no resto do trabalho diário. ---

a)CLAUDE.md
Carregaria mesmo fora da etapa de consolidação de workshop, onde não é relevante.
b)Slash command
Funcionaria, mas exigiria lembrar de chamar o comando certo no meio de uma consolidação já em andamento — a skill dispara pelo reconhecimento da tarefa, sem essa dependência.
c)Skill
Correto. Ligado a um tipo específico de tarefa (consolidação de workshop), carrega sozinha quando essa tarefa aparece.

Ver resposta e por quê

❌a) Carregaria mesmo fora da etapa de consolidação de workshop, onde não é relevante.

❌b) Funcionaria, mas exigiria lembrar de chamar o comando certo no meio de uma consolidação já em andamento — a skill dispara pelo reconhecimento da tarefa, sem essa dependência.

✅c) Correto. Ligado a um tipo específico de tarefa (consolidação de workshop), carrega sozinha quando essa tarefa aparece.