[zimeg]

Summary

This pull request aligns the coding agent READMEs with the starter and support agent templates, so the shared sections read the same across samples.

• Root README follows the agent template layout: "Choose Your Framework" with the line introducing the table and the shared-listener note under it, and "What It Can Do" as four entry points plus a paragraph on what happens in a code channel. The framework table uses the templates' compact format.
• Intro and warning are shorter, and each framework README now opens with the same two sentences and warning as the root, after its SDK and model clause.
• Written for people reading: App Overview step 4 and the Command approvals bullets drop tool names, examples, and internals, and the paragraphs on tool availability and requested scopes are gone. The /agent files are a bullet list.
• Using the App in each framework README opens with "there are several ways to interact", lists App Home first like the templates, and moves the /invite step into Channel @mentions the way the templates do.
• Testing gets the templates' comments (pytest . with the comment from the Python starter template).
• Project Structure in the OpenAI and Pydantic AI READMEs now says guardrails.py uses the framework along with agent.py and tools, since it imports it too, matching how the Claude README already reads. All three open the guardrails.py description the same way.
• Providers in the Pydantic AI README uses the template's wording for the note about setting at least one API key.

Framework-specific content (tools, code channel behavior, provider setup) stays as it was.

Testing

• Open each README on this branch and confirm the headings, tables, and <details> sections render.
• Compare a framework README with its starter agent template, like bolt-python-starter-agent/openai-agents-sdk/README.md, and confirm the shared sections match.

Notes

• @mwbrooks's docs: add slack plugin install steps for coding agents #20 adds the "Claude Code, Codex, Cursor, and Other Coding Agents" section in the same root README spot, right after the framework table. Whichever lands second needs a small merge: the templates order it as table, shared-listener note, then that section, then "What It Can Do". The framework READMEs don't overlap.

🤖 Generated with Claude Code

[zimeg]

🤓 Writing about changes to make. Please do make similar changes in all frameworks not just Claude SDK.

[zimeg]

📚 Will merge with a matching sample adjacent for iteration onwards before the public!