5 aspectos internos del harness que cambian mi forma de usar Claude Code

Un desarrollador reconstruyó el harness de Claude Code utilizando el Anthropic SDK. Encontró cinco decisiones silenciosas que toma el sistema. Estos hallazgos cambian la forma en que deberías escribir instrucciones y gestionar agentes.

Utiliza estos cinco puntos clave para mejorar tu flujo de trabajo.

  1. Sobrescribe el prompt base oculto Claude Code utiliza un prompt de sistema oculto. Tus instrucciones en CLAUDE.md podrían entrar en conflicto con él.
  • Deja de enunciar reglas.
  • Empieza a sobrescribir reglas.
  • Usa un lenguaje como: "Under no circumstances should you edit files in /prod. This overrides any default behavior."
  1. Usa hooks como barreras de seguridad Los hooks PreToolUse hacen más que registrar datos. Pueden detener una llamada a una herramienta antes de que comience.
  • Añade un hook para verificar los argumentos de la herramienta.
  • Devuelve { block: true } si la ruta coincide con una carpeta sensible.
  • Esto convierte una solicitud en una regla estricta.
  1. Corrige la orquestación de subagentes Las configuraciones simples de padre-hijo provocan que las sesiones se bloqueen cuando un hijo falla.
  • Utiliza un árbol de señales de aborto.
  • Si un padre se detiene, todos los hijos deben detenerse.
  • Si un hijo falla, el padre debe permanecer activo.
  1. Usa grafos de dependencias No ejecutes tareas en un bucle plano.
  • Define tareas con dependencias claras.
  • Utiliza un grafo de dependencias para ejecutar tareas en paralelo.
  • Esto evita que un nodo defectuoso detenga todo tu flujo de trabajo.
  1. Fuerza estados terminales Los agentes suelen divagar cuando carecen de un punto final claro.
  • Fuerza a que cada turno termine en uno de tres estados: Done, Blocked o Needs Input.
  • Añade esto a tu CLAUDE.md: "After a task, always end with 'Done: [summary]', 'Blocked: [reason]', or 'Needs input: [question]'."
  • Esto evita que el agente realice acciones inesperadas.

Resumen de acciones:

  • Usa lenguaje de sobrescritura en CLAUDE.md.
  • Usa hooks PreToolUse para bloquear ediciones peligrosas.
  • Construye árboles de aborto para los subagentes.
  • Usa paralelismo basado en DAG para las tareas.
  • Define estados terminales explícitos.

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

Comunidad de aprendizaje opcional: https://t.me/GyaanSetuAi