Why are library docs still written for humans when the first reader is now an agent?

Cursor / Claude Code / Devin are now the primary reader of any new SDK; doc sites front-load tutorials, marketing, navigation chrome and screenshots that waste agent context window and degrade tool-call accuracy.

Category: Others · Trend: LLM · Opportunity score: 8.3 / 10

What is the “Why are library docs still written for humans when the first reader is now an agent?” problem in 2026?

Cursor / Claude Code / Devin are now the primary reader of any new SDK; doc sites front-load tutorials, marketing, navigation chrome and screenshots that waste agent context window and degrade tool-call accuracy.

Who has this problem?

AI-native developers using agentic coding (Cursor, Claude Code, Devin, Copilot) on libraries and APIs that haven't shipped agent-grade docs.

Evidence this problem is real

“Why are people still telling me what to do? I don't want to do anything. What is the thing I should copy-paste to my agent?”

Sourced from Andrej Karpathy, Sequoia Ascent 2026 summary (link)

Existing players in this space

  • Mintlify / ReadMe / GitBook — Beautiful human docs; AI-ready is a chatbot bolt-on, not structured agent contract.
  • Context7 — Aggregates llms.txt at consumer side; doesn't fix source library docs.
  • llms.txt standard — Convention with no opinionated tooling, validation, or coverage SLA.
  • Anthropic docs MCP / OpenAI cookbook — First-party only.

What existing players are missing

Stripe Atlas for agent-grade docs: ingest a repo + OpenAPI spec, output a versioned, tested, agent-shaped doc bundle the maintainer can host. Per-library SaaS to maintainers ($99-499/mo).

How Real Problem AI scores this opportunity

Aggregate score: 8.3 / 10. Four-axis rubric:

  • Problem severity: 8 / 10
  • AI feasibility today: 9 / 10
  • Market signal: 8 / 10
  • Competition gap: 8 / 10

How to build a solution: stack hints

  • OpenAPI + JSDoc / TSDoc parser
  • Tested example generation
  • llms.txt + MCP bundle builder
  • Per-version diff + regression checks

Related Others problems on Real Problem AI