🏆 Claude Certified Architect Foundations

Tarefa → [Planejamento] → [Tool Use] → [Observação] → [Replanning?] → Resultado
              ↑_______________________________________________|

Cada iteração = uma chamada à API = custo de tokens + latência.

• Tarefa simples e determinística → chamada única
• Latência crítica (<200ms) → cada tool call adiciona round-trip
• Zero tolerância a erros → agentes podem encadear erros

Hub-and-Spoke:      Pipeline:           Peer-to-Peer:
    [Hub]           [A]→[B]→[C]         [A]↔[B]
   / | \                                  ↕    ↕
 [A][B][C]                               [C]↔[D]

• Evita prompt injection via resultados de tools maliciosos
• Reduz tokens → menor custo
• Previne decisões além do escopo do subagente

• Confiança do modelo abaixo do threshold
• Ação irreversível (deletar dados, enviar email, fazer transação)
• Tarefa fora do escopo das tools disponíveis

~/.claude/CLAUDE.md           ← User-level (global, todos os projetos)
    ↓ sobrescrito por
/projeto/CLAUDE.md             ← Project-level (compartilhado via git)
    ↓ sobrescrito por
/projeto/subdir/CLAUDE.md      ← Path-specific (maior precedência)

{"hooks":{"PostToolUse":[{"matcher":"Write","hooks":[{"type":"command","command":"npm test"}]}]}}

# Headless mode (-p = não-interativo)
claude -p "Review PR for security issues" --output-format json

<role>Você é um analisador de contratos jurídicos.</role>
<task>Extraia as informações estruturadas.</task>
<output_format>
Responda APENAS com JSON válido. Sem texto adicional.
{"partes":[...],"valor":number,"vigencia":"YYYY-MM-DD"}
</output_format>
<constraints>
- Campos ausentes: use null
- Datas: ISO 8601
- Valores: centavos (integer)
</constraints>

tools=[{"name":"extrair","input_schema":{"type":"object",
  "properties":{"valor":{"type":"integer"},"data":{"type":"string","format":"date"}},
  "required":["valor","data"]}}]

def call_with_retry(client, prompt, schema, max_retries=3):
    for attempt in range(max_retries):
        response = client.messages.create(...)
        try:
            data = json.loads(response.content[0].text)
            validate(data, schema)
            return data
        except (JSONDecodeError, ValidationError) as e:
            if attempt == max_retries - 1: raise
            prompt += f"\n\nErro anterior: {e}. Corrija e tente novamente."

{"mcpServers":{
  "database":{"command":"node","args":["./db.js"],"env":{"DB_URL":"${DATABASE_URL}"}},
  "search":{"url":"https://api.empresa.com/mcp","transport":"http"}
}}

system=[{"type":"text","text":"...1000 linhas de contexto...",
         "cache_control":{"type":"ephemeral"}}]
# Primeira chamada: custo cheio
# Próximas 5 minutos: ~90% desconto nos tokens de entrada

Query → Embedding → Busca vetorial → Top-K chunks → Injetados no contexto

• Batch API: alto volume sem necessidade de resposta imediata → desconto de custo
• Streaming: melhora percepção de latência pelo usuário — não reduz tempo total
• Context window: até 200K tokens nos modelos atuais

1. Acesse: anthropic.com/news/claude-partner-network
2. Registre sua organização (gratuito)
3. Acesse: anthropic.skilljar.com/claude-certified-architect-foundations-access-request
4. Complete os cursos preparatórios
5. Agende o exame (USD 99 ou gratuito nos primeiros 5.000 do Partner Network)

Parallel Tool Use

Claude pode chamar múltiplas tools simultaneamente em uma única resposta. O campo tool_use no response pode conter um array de tool calls. Seu código deve executar todas em paralelo e retornar todos os resultados antes da próxima iteração.

// Claude retorna múltiplas tool calls de uma vez:
{
  "type": "tool_use",
  "name": "get_weather",
  "id": "toolu_01"
}, {
  "type": "tool_use",
  "name": "get_news",
  "id": "toolu_02"
}
// Execute ambas em paralelo → retorne ambos tool_results

1. Acesse anthropic.com/learn ou claude.com/resources/courses
2. Crie conta gratuita no Skilljar (plataforma usada pela Anthropic)
3. Complete os cursos preparatórios recomendados
4. Acesse anthropic.skilljar.com/claude-certified-architect-foundations-access-request
5. Agende o exame (USD 99 ou gratuito nos primeiros 5.000 do Partner Network)
6. Exame disponível na plataforma Skilljar — 60 questões, 120 min