Skip to content

docs: README, CONTRIBUTING and CLAUDE.md reflect the harness x model benchmark - #53

Merged
jkbennitt merged 2 commits into
masterfrom
cursor/harness-benchmark-docs-c7cd
Sep 4, 2026
Merged

docs: README, CONTRIBUTING and CLAUDE.md reflect the harness x model benchmark#53
jkbennitt merged 2 commits into
masterfrom
cursor/harness-benchmark-docs-c7cd

Conversation

@jkbennitt

Copy link
Copy Markdown
Member

Follow-up to #52 (which landed before these docs edits were pushed). No code changes.

README

  • New Harnesses section: the two benchmark axes (--harness × --model), a table of felix / baseline / opencode / grok-build / template with where each lives and how to install it, matrix examples, and how coding-agent harnesses attach over the RLE MCP server.
  • Historical results table labelled as the felix-only, scoring-1.1 spread and marked non-comparable to 1.2 runs.
  • Scoring: states plainly that plan_coherence is measured post-resolution and is a floor, not a harness ranker; notes the harness_failed quarantine and per-run harness metadata.
  • Development: both CI configurations (with / without the felix extra), boundary check, contract job.
  • Related Repos: the three harness repos; felix-agent-sdk marked as the optional extra.

CONTRIBUTING

  • --smoke-test now means mock LLM as well as mock game; the old "smoke test with real LLM" recipe (no longer true) is removed.
  • No-felix test recipe matching CI; live example for a coding-agent harness.
  • New Testing a harness plugin section (rle.testing.run_harness_smoke, ScriptedMcpHarness).
  • Docker example runs a harness matrix.

CLAUDE.md

  • Harnesses table; the agents / CentralPost / conflict-resolution / helix sections are now explicitly scoped to the Felix harness (they previously read as system-wide).
  • SSE flow described via harness.step(...); "all 10 metrics" fixed.
  • Provider / Model Configuration explains that provider/model are strings interpreted by the selected harness, with per-harness naming examples.
  • Conventions and the CI job list updated (test-no-felix, external-plugin-contract, boundary check).
Open in Web Open in Cursor 

cursoragent and others added 2 commits September 4, 2026 17:33
- README: Harnesses section (axis explanation, table of felix/baseline/
  opencode/grok-build/template with install lines, matrix examples, how
  coding-agent harnesses attach over MCP); results table labelled as the
  pre-1.2 felix-only spread; plan_coherence caveat and quarantine/metadata
  notes under Scoring; Development shows both CI configurations; Related
  Repos lists the harness repos
- CONTRIBUTING: smoke test means mock LLM too (old 'real LLM smoke' recipe
  removed), no-felix test recipe, live coding-agent example, 'Testing a
  harness plugin' section
- CLAUDE.md: Harnesses table; Felix-specific sections (agents, CentralPost,
  conflict resolution, helix) labelled as such; SSE flow via harness.step;
  provider/model semantics per harness; conventions and CI job list updated

Co-authored-by: Jason <jkbennitt@users.noreply.github.com>
Co-authored-by: Jason <jkbennitt@users.noreply.github.com>
@jkbennitt
jkbennitt marked this pull request as ready for review September 4, 2026 17:45
@jkbennitt
jkbennitt merged commit fd82549 into master Sep 4, 2026
5 checks passed
@jkbennitt
jkbennitt deleted the cursor/harness-benchmark-docs-c7cd branch September 4, 2026 17:46
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.

2 participants