Guia Pratico Prompts Agenticos

---
autor: George Marmelstein
projeto: Sistema Marmelstein
licenca: Todos os direitos reservados
ano: 2026
---

# Guia Prático: Prompts Agênticos no Claude Code

**Versão**: 1.1
**Data**: 29/01/2026
**Status**: Atualizado com Extended Thinking, Anti-padrões avançados e Técnicas Avançadas

---

## Sumário

1. [O que são Prompts Agênticos](#1-o-que-são-prompts-agênticos)
2. [Estrutura e Anatomia](#2-estrutura-e-anatomia)
3. [Raciocínio Profundo com Extended Thinking](#3-raciocínio-profundo-com-extended-thinking)
4. [Diferenças Importantes](#4-diferenças-importantes)
5. [Localização de Arquivos](#5-localização-de-arquivos)
6. [Ativação e Invocação](#6-ativação-e-invocação)
7. [Boas Práticas da Anthropic](#7-boas-práticas-da-anthropic)
8. [Anti-padrões a Evitar](#8-anti-padrões-a-evitar)
9. [Técnicas Avançadas](#9-técnicas-avançadas)
10. [Exemplos Práticos](#10-exemplos-práticos)
11. [Como Criar seu Prompt Agêntico](#11-como-criar-seu-prompt-agêntico)
12. [Aplicações no CLERK](#12-aplicações-no-clerk)

---

## 1. O que são Prompts Agênticos

### Definição

Um **Prompt Agêntico** é uma instrução estruturada e persistente que transforma Claude em um **especialista** para tarefas específicas. Diferente de um prompt de conversa comum (descartado ao final), um prompt agêntico é:

- **Armazenado em arquivo** - Reutilizável entre sessões
- **Especializado** - Define expertise em um domínio específico
- **Metodológico** - Inclui passos estruturados de trabalho
- **Restritivo** - Define o que o agente NÃO deve fazer

### Analogia Jurídica

| Prompt Normal | Prompt Agêntico |
|---------------|-----------------|
| Dar instrução pontual ao assessor: "Faça um parecer sobre este contrato" | Criar o **Manual do Assessor**: expertise, metodologia, responsabilidades, limites |
| Usado uma vez | Disponível para todos os processos similares |
| Você repete toda vez | Claude já sabe como agir |

### Diferença: Prompt Normal vs Prompt Agêntico

| Aspecto | Prompt Normal | Prompt Agêntico |
|---------|---------------|-----------------|
| **Escopo** | Uma conversa | Múltiplas sessões |
| **Persistência** | Descartado | Arquivo em `.claude/prompts/` |
| **Invocação** | Manual ("Faça X") | Via subagente |
| **Contexto** | Genérico | Especializado com metodologia |
| **Exemplo** | "Analise este contrato" | Arquivo `revisor-contratos.md` com persona, metodologia, formato |

---

## 2. Estrutura e Anatomia

### Estrutura Básica

Todo prompt agêntico segue este formato: