Rewrite the docs around the managed agent harness concept - #296
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The structure was right and the content was not: the pages described what horsie's code does without using the vocabulary this space has settled on, so a reader who knows the field could not place it.
horsie is now introduced as an open-source managed agent harness. Agent = model + harness; horsie is the harness and you bring the model.
what-horsie-ismaps each primitive onto the component that owns it — harness, agent, environment, session, events, sandbox, checkpoint, trace — and two of those names were already horsie's, which is the point.The centrepiece is the argument for why this beats a CI job plus an agent process. A CI run is a process: state lives in it, so all that survives is a log, and isolation and execution are the same object, so you cannot pause without destroying the workspace. Here the session, the harness and the sandbox have three lifetimes, so a run can be paused, resumed, and steered — opened, read, answered, and retried one step at a time. That argument now leads the routines page too, since a scheduled run is where it pays off.
Two new pages in How it works: The harness (the loop, why the harness is the only part that decides, inner versus outer harness, guides versus sensors) and Context & memory (context rot, compaction, progressive disclosure, subagents as context isolation rather than parallelism, short- versus long-term memory). Every other page had a vocabulary pass.
what-horsie-isalso carries a table of what this category has that horsie does not yet — approval tiers, a secret vault, graded outcomes, versioned agents and memory, OpenTelemetry traces — with what exists instead. Better said by us than discovered by a reader.No other agent harness is named anywhere, and the prose linter now enforces that. The lowercase
codexin the device-login URL and the.claude-plugin/directory in the bundle format are left alone: those are things you configure, not products being referenced.