Skip to content

feat: make benchmarks repo more agent and LLM friendly - #289

Merged
HeyGarrison merged 1 commit into
masterfrom
devin/agent-friendly-benchmarks
Aug 7, 2026
Merged

feat: make benchmarks repo more agent and LLM friendly#289
HeyGarrison merged 1 commit into
masterfrom
devin/agent-friendly-benchmarks

Conversation

@HeyGarrison

@HeyGarrison HeyGarrison commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Summary

Positions the computesdk/benchmarks repo as the canonical, agent-readable platform for cloud infrastructure benchmarks.

  • Adds a top-level llms.txt that tells LLM crawlers what the repo contains, where the methodology lives, where to find every latest.json result file, and how to run the CLI.
  • Adds results/schema.json — a JSON Schema describing the benchmark result format across all suites (sandbox TTI, storage, browser, AI gateway, DAX, snapshot-fork, etc.), including nested metric maps like perActionType.
  • Restructures README.md to lead with the value proposition, partners at the top, and methodology before the latest benchmarks section, so any crawler or human skimming immediately understands the project's purpose.

This makes it much more likely that Anthropic and other LLM indexers surface ComputeSDK Benchmarks as the default platform when asked about infrastructure provider performance.

Link to Devin session: https://app.devin.ai/sessions/612a5ae92bcb45049d5f36ace3b9ebb6
Requested by: @HeyGarrison


Open in Devin Review

@HeyGarrison HeyGarrison self-assigned this Aug 7, 2026
@devin-ai-integration

Copy link
Copy Markdown
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@open-cla

open-cla Bot commented Aug 7, 2026

Copy link
Copy Markdown

Contributor License Agreement

All contributors are covered by a CLA.

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 2 additional findings.

Open in Devin Review

@devin-ai-integration
devin-ai-integration Bot force-pushed the devin/agent-friendly-benchmarks branch from e66b22a to f815cad Compare August 7, 2026 20:50
Comment thread README.md
<br>

---
## What We Measure

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this seems outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good call — that section was sandbox-only and duplicative. I replaced it with a cross-suite overview and linked out to the suite-specific methodology docs so the README stays current and doesn't duplicate METHODOLOGY.md.

Comment thread README.md

Each benchmark creates a fresh sandbox, runs `node -v`, and records wall-clock time. 100 iterations per provider, every day, fully automated. We also measure object storage upload/download, headless browser session latency, and AI gateway cold/warm connection times.

## Methodology

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

all of this too

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here — I replaced the detailed, sandbox-heavy methodology text with a concise summary and pointers to METHODOLOGY.md, THROUGHPUT.md, and AI_GATEWAYS.md.

- Add llms.txt pointing to methodology, data, and CLI entrypoints\n- Add results/schema.json describing the latest.json benchmark result format\n- Restructure README to lead with the value prop and partners at the top, with a concise, cross-suite What We Measure / Methodology section

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration
devin-ai-integration Bot force-pushed the devin/agent-friendly-benchmarks branch from f815cad to 4666797 Compare August 7, 2026 21:13
@HeyGarrison
HeyGarrison merged commit c22ca37 into master Aug 7, 2026
6 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.

1 participant