{"data":{"slug":"wquguru-harness-books","name":"harness-books","tagline":"Two books on harness engineering for Claude Code and Codex detailing design philosophies such as constraints and query loops.","github_url":"https://github.com/wquguru/harness-books","owner":"wquguru","repo":"harness-books","owner_avatar_url":"https://avatars.githubusercontent.com/u/209866177?v=4","primary_language":"Python","stars":3119,"forks":372,"topics":["agentic-ai","ai-agents","ai-engineering","claude-code","codex","context-engineering","developer-tools","llm","prompt-engineering"],"archived":false,"github_pushed_at":"2026-04-19T03:01:21+00:00","maintenance_label":"Slowing","stars_delta_30d":417,"url":"https://www.graphcanon.com/tools/wquguru-harness-books","markdown_url":"https://www.graphcanon.com/tools/wquguru-harness-books.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/wquguru-harness-books","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=wquguru-harness-books","description":"📚 Two books on harness engineering — the design philosophies behind Claude Code & Codex: constraints, query loops, context governance, multi-agent verification. harness-books.agentway.dev","homepage_url":"http://harness-books.agentway.dev/","license":null,"open_issues":6,"watchers":15,"ai_summary":"A detailed exploration of the internal mechanisms driving AI agents like Claude Code and Codex through an analysis of their design approaches in two dedicated books. The content covers core topics like constraint implementation, context governance, prompt engineering, and more.","readme_excerpt":"# Harness Books\n\n[中文 README](./README.zh-CN.md)\n\n\n\n\nTwo books on harness engineering. They pursue the same engineering question: once a code-writing model is placed inside terminals, repositories, permission systems, and team workflows, what keeps the overall system bounded, continuous, and accountable for consequences?\n\n\n \n \n \n \n
\n \n \"Harness\n \n
\n Harness Engineering: A Design Guide to Claude Code\n
\n Read online ·\n Download PDF\n 		\n \n \"The\n \n
\n The Harness Design Philosophies of Claude Code and Codex\n
\n Read online ·\n Download PDF\n
\n\nThese books are not meant to walk line by line through the source code. They focus on how a harness organizes constraints and execution, and how an inherently unstable model can be folded into a sustainable engineering order. Prompt layering, query loops, permission decisions, context governance, failure recovery, multi-agent verification, local rules, and team institutions together form the organ system of a harness. The real danger is not that a model occasionally says something wrong, but that the system has no structure for handling consequences.\n\n## Core Claims\n\n- Harness engineering is about how constraint structures organize execution.\n- Once a code-writing model enters a real engineering environment, the main problem is no longer answer quality but behavioral consequences.\n- Prompts, tools, permissions, state, recovery, verification, and institutions are not accessories around the system. They are organs in the same control structure.\n- When comparing agent systems, the key question is not the feature checklist but where order is actually placed.\n- If a team cannot turn individual experience into reusable rules, it will struggle to turn an agent into a stable system.\n\n## What The Two Books Focus On\n\n### Book 1: A Design Guide to Claude Code\n\nThe first book uses Claude Code as the observation target and concentrates on runtime structure. Its concern is why a system eventually has to grow components such as a control plane, query loop, tool permissions, context governance, recovery paths, multi-agent verification, and team rules.\n\nStart with Book 1 if these are the questions you care about:\n\n- Why harness engineering is not just prompt engineering at a larger scale\n- Why prompts are fundamentally part of the control plane rather than a chat box\n- Why model mistakes should be treated as a runtime norm rather than an exceptional event\n- Why multi-agent work and verification should not be blended into one vague mechanism\n- How a team can solidify personal experience into reusable engineering institutions\n\n### Book 2: Comparing Claude Code and Codex\n\nThe second book places Claude Code and Codex side by side and asks where each harness places order. One path starts from runtime discipline; the other starts from a more structured control layer. Both systems can work, but they distribute authority differently.\n\nStart with Book 2 if you care more about system choice, architectural judgment, or what to learn when building your","github_created_at":"2026-04-01T04:30:32+00:00","created_at":"2026-07-11T11:58:31.664243+00:00","updated_at":"2026-09-20T06:54:39.291178+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"}],"tags":[{"slug":"agentic-ai","name":"agentic-ai"},{"slug":"ai-agents","name":"ai-agents"},{"slug":"context-engineering","name":"context-engineering"},{"slug":"prompt-engineering","name":"prompt-engineering"}],"trust":{"provenance":{"is_fork":false,"github_id":1198040849,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T06:54:36.488Z","maintenance":{"label":"Slowing","score":36,"methodology":"github_public_v1","releases_90d":0,"days_since_push":154,"last_release_at":null,"stars_delta_30d":417,"open_issues_delta_30d":1},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-11T11:58:32.887Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-09-20T06:54:37.904Z"},"languages":{"value":["python"],"source":"github.language","observed_at":"2026-09-20T06:54:37.904Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["When needing detailed insights into the internal mechanisms of AI agents like Claude Code and Codex for informed development efforts.","For developers looking to enhance their comprehension of constraint implementation and context governance within these specific models."],"when_not_to_use":["If seeking generic AI agent design guidelines that do not focus on the specifics of Claude Code or Codex implementations.","When the aim is to work with other types of AI agents or frameworks unrelated to the technologies detailed in harness-books."],"source":"enrich:decision_facts","observed_at":"2026-07-15T09:07:15.042Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"harness-books provides in-depth knowledge on Claude Code and Codex's design philosophies through two books focused on constraints, query loops, and more."}]}}