Repolode
wquguru

wquguru/harness-books

Dos libros gratuitos en línea que explican cómo se diseñan y controlan los harnesses de agentes para modelos que escriben código, como Claude Code y Codex.

Estrellas
3,194
Forks
387
Issues abiertos
6
Último commit
hace 6 meses

¿Qué es?

Harness Books es un par de libros sobre ingeniería de harnesses: el sistema que rodea a un modelo que escribe código y lo controla cuando se ejecuta dentro de terminales, repositorios, sistemas de permisos y flujos de trabajo de equipo. Los libros tratan la organización de prompts en capas, los bucles de consulta, los permisos de herramientas, la gestión del contexto, la recuperación ante errores, la verificación multiagente y las reglas de equipo, con el objetivo de mantener acotado y sujeto a rendición de cuentas un sistema de este tipo.

El primer libro, A Design Guide to Claude Code, toma Claude Code como tema y se centra en la estructura de ejecución. Explica por qué un sistema incorpora componentes como un plano de control, un bucle de consulta y rutas de recuperación. El segundo, The Harness Design Philosophies of Claude Code and Codex, compara ambas herramientas y examina cómo controla cada una la ejecución, incluidos los sandboxes, los lenguajes de políticas, las skills y los hooks.

Los dos libros se pueden leer en línea en inglés y chino, y también se pueden descargar en PDF. El repositorio incluye además un script de compilación en Python para generar los sitios localmente.

Funciones clave

  • 01Aborda los bucles de consulta, los permisos de herramientas, la gestión del contexto y la recuperación ante errores en sistemas de agentes.
  • 02Compara Claude Code y Codex en cuanto al diseño del plano de control, los sandboxes y los lenguajes de políticas.
  • 03Explica cómo las skills, los hooks y las reglas locales incorporan las prácticas del equipo a un sistema de agentes.
  • 04Disponibles para leer en línea en inglés y chino, con descargas en PDF.
  • 05Incluye un script de Python para generar localmente los sitios de los libros bilingües.

Casos de uso

  • Desarrolladores que crean su propio agente de programación y quieren entender sus capas de control.
  • Responsables de ingeniería que deciden cómo gobernar las herramientas de programación con IA en un equipo.
  • Ingenieros que comparan las arquitecturas de Claude Code y Codex antes de elegir una herramienta.

Inicio rápido

  1. 1

    Leer los libros en línea

  2. 2

    Compilar los libros localmente (Book 1, inglés)

    python3 tools/book-kit/build_honkit.py book1-claude-code --locale en
  3. 3

    Crear el sitio Pages unificado

    python3 tools/book-kit/build_pages_site.py

Antes de usarlo

  • El proyecto es un conjunto de libros, no software, y no tiene ninguna licencia indicada.
  • La compilación local requiere ejecutar scripts de compilación de Python y guarda los resultados en dist/.

Temas

Preguntas frecuentes

¿Qué es harness-books?
Dos libros gratuitos en línea que explican cómo se diseñan y controlan los harnesses de agentes para modelos que escriben código, como Claude Code y Codex. Harness Books es un par de libros sobre ingeniería de harnesses: el sistema que rodea a un modelo que escribe código y lo controla cuando se ejecuta dentro de terminales, repositorios, sistemas de permisos y flujos de trabajo de equipo. Los libros tratan la organización de prompts en capas, los bucles de consulta, los permisos de herramientas, la gestión del contexto, la recuperación ante errores, la verificación multiagente y las reglas de equipo, con el objetivo de mantener acotado y sujeto a rendición de cuentas un sistema de este tipo.
¿harness-books es gratuito? ¿Qué licencia tiene?
harness-books no declara ninguna licencia. Su código es público, pero sin licencia no tienes permiso explícito para reutilizarlo; consulta al autor antes de depender de él.
¿harness-books sigue mantenido?
Sin commits en más de 6 meses. El último commit de harness-books fue el 19 abr 2026.
¿Para qué puedo usar harness-books?
Desarrolladores que crean su propio agente de programación y quieren entender sus capas de control. Responsables de ingeniería que deciden cómo gobernar las herramientas de programación con IA en un equipo. Ingenieros que comparan las arquitecturas de Claude Code y Codex antes de elegir una herramienta.
¿Cómo se instala harness-books?
Leer los libros en línea Compilar los libros localmente (Book 1, inglés): python3 tools/book-kit/build_honkit.py book1-claude-code --locale en Crear el sitio Pages unificado: python3 tools/book-kit/build_pages_site.py
¿Dónde consigo harness-books?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/wquguru/harness-books

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados