Skip to content

docs(readme): drop unverified GPT-Researcher comparison chart - #3

Merged
AgentMindCloud merged 1 commit into
mainfrom
fix/readme-drop-unverified-gpt-researcher-comparison
Apr 30, 2026
Merged

docs(readme): drop unverified GPT-Researcher comparison chart#3
AgentMindCloud merged 1 commit into
mainfrom
fix/readme-drop-unverified-gpt-researcher-comparison

Conversation

@AgentMindCloud

Copy link
Copy Markdown
Owner

Why

The "Compared to GPT-Researcher" section in the README claimed a 16-row "Honest scorecard" capability comparison table — but the data backing it doesn't exist:

  • benchmarks/results/latest.md is a placeholder that explicitly says "No public benchmark run has landed yet" and "No fabricated numbers will ever ship in this file."
  • The capability claims (e.g. "Hidden multi-agent debate", missing features on the GPT-Researcher side) were never robustly verified.

Shipping a comparison table without backing data — under a heading that explicitly says Honest scorecard — is a credibility risk on launch day.

Changes

  • ❌ Removed the entire ## Compared to GPT-Researcher section (table + intro + legend).
  • ✅ Kept the ## Benchmarks section. It correctly describes the harness + methodology and is honest that no numbers have shipped yet ("Round 1 numbers land … the next time the workflow lands a green run with the keys configured").
  • ✏️ Softened the footer credit from "Inspired in spirit (and benchmarked against) [assafelovic/gpt-researcher]" to "Inspired in spirit by …; the benchmarks/ harness runs head-to-head once API keys are configured." — past-tense framing was misleading.

What stays untouched

  • benchmarks/ directory: runners (gpt_researcher.py, orchestra.py), harness.py, methodology.md, goals.yaml — all unchanged. The infrastructure is real; only the unverified marketing claim is removed.
  • Reinstate the comparison the day the recurring benchmarks workflow lands a green run with real numbers.

Test plan

  • CI green (this is a docs-only edit; nothing should regress)
  • After merge: README on main no longer shows the comparison table

Generated by Claude Code

The "Compared to GPT-Researcher" section claimed a 16-row "Honest
scorecard" comparison capability table, but the data backing it
doesn't exist:

- benchmarks/results/latest.md is a placeholder that explicitly
  says "No public benchmark run has landed yet" and "No fabricated
  numbers will ever ship in this file."
- The capability claims (e.g. "Hidden multi-agent debate", missing
  features on the GPT-Researcher side) were never robustly verified.

Shipping a comparison table without backing data — under a heading
that explicitly says "Honest scorecard" — is a credibility risk on
launch day. Removed.

Kept:
- The `## Benchmarks` section: it correctly describes the harness
  + methodology and is honest that no numbers have shipped yet.
- The footer credit, softened from "(and benchmarked against)" to
  "Inspired in spirit by ...; the benchmarks/ harness runs
  head-to-head once API keys are configured." Past-tense framing
  was misleading.

The `benchmarks/` directory itself — runners, harness, methodology,
goals corpus — stays untouched. Reinstate the comparison once the
recurring benchmarks workflow lands a green run with real numbers.
@AgentMindCloud
AgentMindCloud merged commit 525ae59 into main Apr 30, 2026
10 checks passed
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