5 Detalhes Internos do Harness que Mudam a Forma como Uso o Claude Code

Um desenvolvedor reconstruiu o harness do Claude Code usando o Anthropic SDK. Ele descobriu cinco decisões silenciosas que o sistema toma. Essas descobertas mudam a forma como você deve escrever instruções e gerenciar agentes.

Use esses cinco insights para melhorar seu fluxo de trabalho.

  1. Sobrescreva o prompt base oculto O Claude Code usa um prompt de sistema oculto. Suas instruções no CLAUDE.md podem entrar em conflito com ele.
  • Pare de apenas declarar regras.
  • Comece a sobrescrever regras.
  • Use uma linguagem como: "Sob nenhuma circunstância você deve editar arquivos em /prod. Isso sobrescreve qualquer comportamento padrão."
  1. Use hooks como guardrails Hooks de PreToolUse fazem mais do que apenas registrar dados. Eles podem interromper uma chamada de ferramenta antes que ela comece.
  • Adicione um hook para verificar os argumentos da ferramenta.
  • Retorne { block: true } se o caminho corresponder a uma pasta sensível.
  • Isso transforma uma solicitação em uma regra rígida.
  1. Corrija a orquestração de subagentes Configurações simples de pai-filho fazem com que as sessões travem quando um filho falha.
  • Use uma árvore de sinais de aborto.
  • Se um pai parar, todos os filhos devem parar.
  • Se um filho falhar, o pai deve permanecer ativo.
  1. Use grafos de dependência Não execute tarefas em um loop linear.
  • Defina tarefas com dependências claras.
  • Use um grafo de dependência para executar tarefas em paralelo.
  • Isso evita que um único nó problemático interrompa todo o seu fluxo de trabalho.
  1. Force estados terminais Agentes costumam divagar quando não têm um ponto final claro.
  • Force cada turno a terminar em um de três estados: Done, Blocked ou Needs Input.
  • Adicione isto ao seu CLAUDE.md: "Após uma tarefa, sempre termine com 'Done: [summary]', 'Blocked: [reason]' ou 'Needs input: [question]'."
  • Isso impede que o agente realize ações inesperadas.

Resumo de ações:

  • Use linguagem de sobrescrita no CLAUDE.md.
  • Use hooks PreToolUse para bloquear edições perigosas.
  • Construa árvores de aborto para subagentes.
  • Use paralelismo baseado em DAG para tarefas.
  • Defina estados terminais explícitos.

Fonte: https://dev.to/gentic_news/5-harness-internals-that-changed-how-i-use-claude-code-daily-39c6

Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi