Skip to content

docs(readme): accurate agent/provider counts, add TOC, GEO/AEO + alternatives positioning - #1

Open
imsankz wants to merge 1 commit into
mainfrom
docs/readme-seo-fixes
Open

docs(readme): accurate agent/provider counts, add TOC, GEO/AEO + alternatives positioning#1
imsankz wants to merge 1 commit into
mainfrom
docs/readme-seo-fixes

Conversation

@imsankz

@imsankz imsankz commented Aug 26, 2026

Copy link
Copy Markdown
Owner

What

Fixes factual drift in README and improves discoverability for GEO/AEO + programmatic SEO searches.

Changes

  • Agent count 20+ → 19 (matches agents/ dir; was inconsistent w/ AGENTS.md)
  • LLM providers 6 → 7 (added undocumented openai-compat.ts — LM Studio, vLLM, Ollama)
  • Installer tool list: added Amp
  • Removed hardcoded "50 tests" count
  • Added Table of Contents (19 sections, 448 lines)
  • Intro now mentions GEO/AEO citations and positions as Surfer/Clearscope/MarketMuse alternative

Why

  • Old counts drift → trust erosion
  • 7th provider was invisible → missed use case for self-hosted LLM users
  • No TOC hurts long-form scannability and LLM extraction
  • GEO/AEO + alternatives are high-intent search terms the README wasn't capturing

Verify

git diff main..docs/readme-seo-fixes -- README.md — 29+/8-, all on README, no code changes.

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