Skip to content

docs: README revamp — data-first hook, real trust scores - #10

Merged
JBAhire merged 6 commits into
mainfrom
docs/readme-viral-revamp
Jun 10, 2026
Merged

docs: README revamp — data-first hook, real trust scores#10
JBAhire merged 6 commits into
mainfrom
docs/readme-viral-revamp

Conversation

@JBAhire

@JBAhire JBAhire commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Rewrites the README to maximize shareability while staying 100% honest — every claim in it is pulled from the registry data itself.

Stacked on #7 (uses the 156-evaluation numbers and June 2026 entries; merge #7 first — this branch includes it).

What changed

  • Hook section first: real findings from the data (21/60 models retired/deprecated/superseded, archived MCP servers with unpatched SQLi, Context7's 86-perf/59-security gap, Assistants API sunset date). These are the screenshots people share.
  • Real numbers table: frontier-model trust scores (Fable 5, Opus 4.8, GPT-5.5, Gemini 3.1 Pro, Grok 4.3, DeepSeek V4, …) computed from the actual JSON — makes the 'capability ≠ trust' point in one glance.
  • Centered hero with per-category badges, both screenshots embedded, star-history chart, and a closing tagline.
  • Tightened everything else: collapsible coverage lists, 30-second start verified against real file paths, CVSS-style weighting example, honest comparison table (vs leaderboards / vendor model cards), contribution flow as the 'disagreement protocol'.
  • Fixes: stale Guard0-Security org links → guard0-ai; removed reference to a create-template npm script that doesn't exist; screenshot paths URL-encoded.

Deliberately NOT included

No fabricated testimonials, user counts, or 'as seen in' claims — the viral angle is the data itself.

Test plan

  • All scores in the table verified against data/*.json (mean of 5 dimension scores)
  • Code snippet fields verified to exist in claude-fable-5.json
  • All relative links point at files that exist; repo links point at guard0-ai org
  • Visual check of GitHub rendering after merge

JBAhire added 6 commits June 10, 2026 10:13
…ions

Models (22 new): Claude Fable 5, Opus 4.8/4.7/4.6, Sonnet 4.6, GPT-5.5,
GPT-5.4, GPT-5.3-Codex, Gemini 3.1 Pro, Gemini 3.5 Flash, Grok 4.3/4.1,
Nova 2 Lite, DeepSeek V3.2/V4, Qwen3.5, Kimi K2.6, GLM-5, MiniMax-M2,
Mistral Large 3, Gemma 4, Command A+.

Agents (16 new): Claude Code, Claude Agent SDK, OpenAI Agents SDK, Codex,
Google ADK, Gemini CLI, Jules, GitHub Copilot coding agent, Microsoft
Agent Framework, Devin, Cursor, Manus, smolagents, Strands, Mastra, Dify.

MCPs (12 new): Context7, Chrome DevTools, Playwright, Serena, Figma,
Stripe, Vercel, Hugging Face, Firecrawl, shadcn, Apify, Zapier.

Status corrections: Grok 3 retired, Gemini 2.0 Flash shut down,
Assistants API sunset 2026-08-26, OpenAI o-series/GPT-5.x deprecation
dates, archived MCP reference servers flagged (incl. unpatched SQLi in
postgres/sqlite), Langflow CVEs, MemGPT->Letta, Agent Builder rebrand,
AutoGen/SK maintenance mode, Llama 4 Behemoth marked never released.
…honest comparisons

- Lead with concrete registry findings (21/60 models stale, archived MCP
  SQLi, Context7 perf-vs-security gap, Assistants API sunset)
- Frontier model trust-score table with real dimension scores from the data
- Centered hero with badges per category, screenshots, star-history chart
- Collapsible coverage sections, scoring scale, comparison table vs
  leaderboards/model cards, 30-second start with real JSON paths
- Fix stale Guard0-Security links -> guard0-ai; remove reference to
  nonexistent create-template script
Fresh captures of the live site (hero with 156-systems count and the
Claude Fable 5 detail page); remove unused footer and stray screenshot.
# Conflicts:
#	README.md
#	data/models/claude-fable-5.json
#	data/models/claude-opus-4-7.json
#	data/models/claude-opus-4-8.json
#	data/models/gemma-4.json
@JBAhire
JBAhire merged commit 9e02479 into main Jun 10, 2026
5 checks passed
@JBAhire
JBAhire deleted the docs/readme-viral-revamp branch June 10, 2026 18:01
@netlify

netlify Bot commented Jun 10, 2026

Copy link
Copy Markdown

Deploy Preview for scintillating-liger-b66f71 ready!

Name Link
🔨 Latest commit d18089f
🔍 Latest deploy log https://app.netlify.com/projects/scintillating-liger-b66f71/deploys/6a29a3af92fd930008363224
😎 Deploy Preview https://deploy-preview-10--scintillating-liger-b66f71.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Jun 10, 2026

Copy link
Copy Markdown

Deploy Preview for scintillating-liger-b66f71 ready!

Name Link
🔨 Latest commit c02f236
🔍 Latest deploy log https://app.netlify.com/projects/scintillating-liger-b66f71/deploys/6a29a51126300b000874fa61
😎 Deploy Preview https://deploy-preview-10--scintillating-liger-b66f71.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Jun 10, 2026

Copy link
Copy Markdown

Deploy Preview for scintillating-liger-b66f71 ready!

Name Link
🔨 Latest commit 5024ad6
🔍 Latest deploy log https://app.netlify.com/projects/scintillating-liger-b66f71/deploys/6a29a5858ae35e00081b63d3
😎 Deploy Preview https://deploy-preview-10--scintillating-liger-b66f71.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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