Claude tutorialTutorial 09: Custom Legal Skills, Hooks & Agents
Build custom skills for your firm's workflows, create compliance hooks, and deploy multi-agent systems for complex legal tasks.
What You'll Learn
Este tutorial mostra como construir skills jurídicos personalizados, adicionar verificações de segurança (hooks) e executar fluxos multi-agente. É necessário certo conforto técnico.
Nível expert
Habilidades de desenvolvedor recomendadas. Tempo estimado: 120 minutos.
Verificação de fontes do Claude Code 2.1.181
Claude Code 2.1.181 adiciona /config key=value, uma configuração opt-in sandbox.allowAppleEvents para Apple Events do macOS em sandbox, CLAUDE_CLIENT_PRESENCE_FILE, retry melhorado quando a conexão com a API cai durante o raciocínio, Write/Edit mais seguro em unidades de rede e pastas sincronizadas na nuvem, visibilidade de falhas de MCP tools/list, além de várias correções para background sessions, subagents, Remote Control, área de transferência, settings e fusos horários. A Claude Code Action allowlisted também elevou seus defaults integrados para Claude Code 2.1.181 e Claude Agent SDK 0.3.181. Para repositórios jurídicos, reteste mudanças em managed settings, permissões de automação do macOS, comportamento de escrita em pastas cloud, health checks de MCP, retenção de histórico de background sessions, controles de profundidade de subagents e version pins do GitHub Action antes que workflows não supervisionados toquem pastas com dados de clientes.
Verificação de fontes do Claude Code 2.1.183
Claude Code 2.1.183 reforça a segurança do auto-mode bloqueando comandos destrutivos de git e destruição de infraestrutura que não foram solicitados, avisa quando um modelo solicitado está deprecated ou é auto-updated, adiciona a configuração attribution.sessionUrl para atribuição de commits e PRs, corrige a classificação de scheduled tasks e webhook triggers para que não possam aprovar pending actions, e corrige a exposição de ferramentas MCP auth-stub em modo headless e SDK. A Claude Code Action allowlisted também elevou seus defaults integrados para Claude Code 2.1.183 e Agent SDK 0.3.183. Para repositórios jurídicos, reteste destructive-command review gates, approval boundaries de webhooks e scheduled tasks, warnings de retirada de modelos, política de atribuição de PR, exposição de autenticação MCP e version pins antes que workflows não supervisionados toquem pastas com dados de clientes.
Claude Action filtra reviews de PR
Um commit allowlisted do Claude Code Action de junho de 2026 agora filtra pull-request reviews e inline review comments até o authorized trigger time, alinhando-se ao filtro já existente para issue/PR comments e bodies. Para legal PR agents, fixe uma version que inclua esse fix, trate review threads adicionados após o trigger como contexto de referência não confiável, mantenha checkout credentials não persistentes e exija human merge review antes que mudanças redigidas por agentes cheguem a repositórios com dados de clientes.
Objetivos de aprendizagem
Ao final deste tutorial, você poderá:
- Compreender a arquitetura do Claude Code (Skills, Hooks, Sub-agents)
- Construir skills jurídicos personalizados para os fluxos do seu escritório
- Criar hooks para controle de qualidade e verificação de conformidade
- Implantar sistemas multi-agente para tarefas jurídicas complexas
Parte 1: Entendendo a stack Claude Code
Visão geral da arquitetura
Skills: Instruções especializadas e melhores práticas armazenadas em arquivos que o Claude lê com base no contexto.
Hooks: Scripts que executam em pontos específicos do ciclo de vida de execução do Claude.
Sub-agents: Agentes autônomos iniciados para lidar com subtarefas específicas.
Servidores MCP: Conexões com ferramentas externas (veja Tutorial 07).
Plugins: Pacotes de Skills + Hooks + MCP.
Aplicação jurídica
| Componente | Aplicação jurídica |
|---|---|
| Skills | Codificar playbooks, procedimentos de revisão e padrões de redação |
| Hooks | Aplicar conformidade, impedir ações não autorizadas, audit logging |
| Sub-agents | Paralelizar revisão de documentos e tarefas de pesquisa |
| Plugins | Empacotar fluxos do escritório para distribuição |
Parte 2: Construindo skills jurídicos personalizados
O que são Skills?
Skills são instruções especializadas armazenadas em arquivos que o Claude lê com base no contexto. Ao contrário de prompts (uma vez), os Skills persistem e ativam automaticamente.
Estrutura de arquivo Skill
Criar um skill de revisão de contratos
Etapa 1: Crie o diretório do skill (veja a seção em inglês para o comando).
Etapa 2: Escreva o SKILL.md com Purpose, Activation, Instructions e Output format.
Etapa 3: Adicione exemplos good/bad em examples/.
Parte 3: Hooks para qualidade e conformidade
Os hooks executam antes/depois de ações. Use-os para: validar saídas antes do envio, bloquear ações não autorizadas, registrar acessos a dados sensíveis.
Nota de produção: Hooks podem bloquear ou alterar um workflow. Teste-os em sandbox com permissões, níveis de effort e servidores MCP reais antes de usá-los em assuntos de clientes ou documentos privilegiados.
O que são Hooks?
Scripts que executam em pontos específicos: PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop. Veja a seção em inglês para a tabela.
Exemplo de hook de conformidade jurídica
Impedir alterações não autorizadas em pastas privilegiadas. Veja a seção em inglês para o código.
Outros casos de uso de hooks
Verificação de citações, controle de confidencialidade. Veja a seção em inglês para os exemplos.
Parte 4: Fluxos multi-agente jurídicos
Entender os sub-agents
O Claude pode iniciar sub-agents para tarefas específicas: paralelização (vários documentos revisados simultaneamente), especialização (agentes dedicados), isolamento (contexto separado).
Exemplo: Revisão de due diligence paralela
Vários agentes em paralelo (contratos de clientes, IP, emprego, litígios). Veja a seção em inglês para o código.
Exemplo: Pesquisa + redação
Agente pesquisa → agente redação → agente revisão. Veja a seção em inglês para o fluxo.
Parte 5: Empacotar Skills em plugins
Estrutura de plugin
Diretório com plugin.json, SKILL.md, .mcp.json, hooks/, commands/, resources/. Veja a seção em inglês para a estrutura completa.
Manifesto do plugin
O formato e o esquema do manifesto evoluem. Consulte a referência oficial de plugins.
Instalação e distribuição
claude --plugin-dir, claude plugin install, claude plugin enable. Veja a seção em inglês para os comandos.
Parte 6: Considerações de segurança
Segurança de skills
Verificação de fontes, revisão do código dos hooks, não incluir dados de clientes nos skills, controle de acesso.
Proteção de dados
Hooks UserPromptSubmit para sanitização. Veja a seção em inglês para o exemplo.
Requisitos de conformidade
- Skills revisados pela segurança de TI
- Hooks testados em sandbox
- Audit logging ativado
- Segregação de dados de clientes verificada
Faça agora
- Criar um skill personalizado para um processo de revisão do seu escritório
- Adicionar pelo menos um hook de segurança para conformidade ou auditoria
- Testar um fluxo multi-agente para processamento paralelo de documentos
- Documentar seu skill para sua equipe
- Considerar empacotar como plugin para distribuição
Páginas família relacionadas
Navegação
Quick Reference: Claude Code Commands
Official Claude screenshot from Claude Code. Terminal workflows should be paired with scoped folders, explicit permission modes, and a reviewable diff before legal workflow changes are accepted.
Sources
- Agent Skills Overview (Claude Docs)
- Agent Skills Quickstart (Claude Docs)
- Agent Skills Best Practices (Claude Docs)
- Use Skills in Claude Code
- Hooks Reference (Claude Code Docs)
- Create custom subagents (Claude Code Docs)
- Connect Claude Code to tools via MCP
- Plugins Reference (Claude Code Docs)