Repolode
Enviar
wquguru

wquguru/harness-books

Dois livros online gratuitos explicam como são projetados e controlados os harnesses de agentes para modelos que escrevem código, como Claude Code e Codex.

Ver no GitHubSite
Estrelas
3,194
Forks
387
Issues abertas
6
Último commit
há 6 meses

O que é?

Harness Books reúne dois livros sobre engenharia de harnesses: o sistema ao redor de um modelo que escreve código, responsável por controlá-lo quando ele é executado em terminais, repositórios, sistemas de permissões e fluxos de trabalho de equipes. Os livros abordam camadas de prompts, loops de consulta, permissões de ferramentas, governança de contexto, recuperação de erros, verificação multiagente e regras para equipes, com o objetivo de manter esse sistema limitado e responsável.

O primeiro livro, A Design Guide to Claude Code, tem o Claude Code como tema e se concentra na estrutura de runtime, explicando por que um sistema passa a incluir componentes como plano de controle, loop de consulta e caminhos de recuperação. O segundo, The Harness Design Philosophies of Claude Code and Codex, compara as duas ferramentas e analisa onde cada uma coloca o controle da execução, incluindo sandboxes, linguagens de políticas, skills e hooks.

Os dois livros podem ser lidos online em inglês e chinês, e cada um pode ser baixado em PDF. O repositório também inclui um script de build em Python para gerar os sites localmente.

Recursos principais

  • 01Aborda loops de consulta, permissões de ferramentas, governança de contexto e recuperação de erros em sistemas de agentes.
  • 02Compara Claude Code e Codex quanto ao design do plano de controle, às sandboxes e às linguagens de políticas.
  • 03Explica como skills, hooks e regras locais incorporam os hábitos da equipe a um sistema de agentes.
  • 04Disponível para leitura online em inglês e chinês, com downloads em PDF.
  • 05Inclui um script em Python para gerar localmente os sites dos livros bilíngues.

Casos de uso

  • Desenvolvedores que estão criando seu próprio agente de programação e querem entender suas camadas de controle.
  • Líderes de engenharia que precisam decidir como governar ferramentas de programação com IA na equipe.
  • Engenheiros que comparam as arquiteturas do Claude Code e do Codex antes de escolher uma ferramenta.

Início rápido

  1. 1

    Ler os livros online

  2. 2

    Compilar os livros localmente (Book 1, inglês)

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

    Montar o site Pages unificado

    python3 tools/book-kit/build_pages_site.py

Antes de usar

  • O projeto é um conjunto de livros, não um software, e não tem licença informada.
  • A compilação local exige a execução de scripts de build em Python e grava os arquivos gerados em dist/.

Tópicos

#ai-agents#claude-code#codex#llm#context-engineering#agent-design#ai-engineering#agentic-ai#developer-tools#prompt-engineering

Perguntas frequentes

O que é harness-books?
Dois livros online gratuitos explicam como são projetados e controlados os harnesses de agentes para modelos que escrevem código, como Claude Code e Codex. Harness Books reúne dois livros sobre engenharia de harnesses: o sistema ao redor de um modelo que escreve código, responsável por controlá-lo quando ele é executado em terminais, repositórios, sistemas de permissões e fluxos de trabalho de equipes. Os livros abordam camadas de prompts, loops de consulta, permissões de ferramentas, governança de contexto, recuperação de erros, verificação multiagente e regras para equipes, com o objetivo de manter esse sistema limitado e responsável.
harness-books é gratuito? Qual é a licença?
harness-books não declara licença. O código é público, mas sem licença você não tem permissão explícita para reutilizá-lo; fale com o autor antes de depender dele.
harness-books ainda é mantido?
Sem commits há mais de 6 meses. O último commit de harness-books foi em 19 de abr. de 2026.
Para que posso usar harness-books?
Desenvolvedores que estão criando seu próprio agente de programação e querem entender suas camadas de controle. Líderes de engenharia que precisam decidir como governar ferramentas de programação com IA na equipe. Engenheiros que comparam as arquiteturas do Claude Code e do Codex antes de escolher uma ferramenta.
Como instalar harness-books?
Ler os livros online Compilar os livros localmente (Book 1, inglês): python3 tools/book-kit/build_honkit.py book1-claude-code --locale en Montar o site Pages unificado: python3 tools/book-kit/build_pages_site.py
Onde consigo harness-books?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/wquguru/harness-books

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados