Skip to content

docs: document the v1.13.0 harness improvements (closes #354)#355

Merged
erain merged 1 commit into
mainfrom
issue/354-docs-v1.13
Jun 10, 2026
Merged

docs: document the v1.13.0 harness improvements (closes #354)#355
erain merged 1 commit into
mainfrom
issue/354-docs-v1.13

Conversation

@erain

@erain erain commented Jun 10, 2026

Copy link
Copy Markdown
Owner

Closes #354. Docs-only.

Brings the prose docs in line with what v1.13.0 actually does:

  • README — new Harness reliability section (hardening / retries+overflow / guardrails / stall recovery / capability registry, with defaults and opt-outs); Coding tools now documents the edit repair ladder, head/tail truncation with spool files, read paging, and the toolset-assembled system prompt; Long context covers the structured snapshot, file ledger, and KeepRecentTokens.
  • design.md — loop walkthrough now includes the retry (ADR-0017), auto-continue, and guardrail steps.
  • provider-guide.md — new section on registering with the driver registry and declaring Capabilities conservatively.
  • coding-harness-roadmap.md — converted to a shipped record (status note + per-item ✅ with PR refs).
  • project-plan.md — Track A: harness-quality phase shipped as v1.13.0; remaining items listed.
  • building-agents.md — testing step warns that retries/guardrails are default-on and shows how to script fast-failing fakes (accurate about which knobs exist at which layer).

go build ./... green.

🤖 Generated with Claude Code

- README: new "Harness reliability" section (history hardening,
  classified retries + overflow recovery, guardrails, stall recovery,
  capability registry — defaults and opt-outs); Coding tools section
  documents the edit repair ladder, head/tail truncation + spool,
  read paging, and the toolset-assembled system prompt; Long context
  covers the structured snapshot, file ledger, and KeepRecentTokens.
- design.md: loop walkthrough gains the retry, auto-continue, and
  guardrail steps with the ADR-0017 pointer.
- provider-guide.md: new "Registering with the driver registry"
  section showing Capabilities declaration and the
  declare-conservatively rule.
- coding-harness-roadmap.md: marked shipped (v1.13.0) per item with
  PR references; header status note.
- project-plan.md: Track A records the harness-quality phase shipped
  as v1.13.0 and lists what remains (including deferred P3 notes).
- building-agents.md: testing step notes the retry/guardrail defaults
  and how to script failures that fail fast.

Co-Authored-By: Claude Fable 5 <[email protected]>
@erain erain merged commit 1f25a79 into main Jun 10, 2026
5 checks passed
@erain erain deleted the issue/354-docs-v1.13 branch June 10, 2026 00:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: document the v1.13.0 harness improvements across README, design.md, provider-guide

1 participant