Skip to content

README: warmer, plain-language pitch for new readers#169

Merged
lezama merged 1 commit into
mainfrom
update/readme-onboarding-pitch
May 13, 2026
Merged

README: warmer, plain-language pitch for new readers#169
lezama merged 1 commit into
mainfrom
update/readme-onboarding-pitch

Conversation

@lezama
Copy link
Copy Markdown
Contributor

@lezama lezama commented May 13, 2026

Summary

Rewrites the opening of README.md so a plugin author who lands on the repo can tell in ten seconds:

  • whether Agents API is for them,
  • what they get out of the box,
  • what they still need to build themselves.

The existing Layer Boundary diagram, What Agents API Owns list, and everything below remain untouched. The duplicate "developer documentation" link is removed (the new lede already points there).

Test plan

  • Render the new README on GitHub and confirm the layout / link work.
  • Skim for tone consistency with the rest of the docs.

🤖 Generated with Claude Code

Rewrites the opening paragraphs so a plugin author landing on the repo can
tell within ten seconds (a) whether Agents API is for them, (b) what they
get for free, and (c) what they still need to build themselves. Keeps the
existing Layer Boundary block, capability list, and the rest of the README
intact — only the lede and a duplicated docs link are touched.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@lezama lezama merged commit 6a225cf into main May 13, 2026
2 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