Harness Books

中文 README

Two 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?

These 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.

Core Claims

• Harness engineering is about how constraint structures organize execution.
• Once a code-writing model enters a real engineering environment, the main problem is no longer answer quality but behavioral consequences.
• Prompts, tools, permissions, state, recovery, verification, and institutions are not accessories around the system. They are organs in the same control structure.
• When comparing agent systems, the key question is not the feature checklist but where order is actually placed.
• If a team cannot turn individual experience into reusable rules, it will struggle to turn an agent into a stable system.

What The Two Books Focus On

Book 1: A Design Guide to Claude Code

The 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.

Start with Book 1 if these are the questions you care about:

• Why harness engineering is not just prompt engineering at a larger scale
• Why prompts are fundamentally part of the control plane rather than a chat box
• Why model mistakes should be treated as a runtime norm rather than an exceptional event
• Why multi-agent work and verification should not be blended into one vague mechanism
• How a team can solidify personal experience into reusable engineering institutions

Book 2: Comparing Claude Code and Codex

The 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.

Start with Book 2 if you care more about system choice, architectural judgment, or what to learn when building your