docs(runtimes): three overviews teach through their running examples - #1036
Merged
Conversation
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…e running example Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…e plan notes which products mirror into deployments Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
… leaner walk; portability thesis restored Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…errupt value precision; nine blocks; quickstart linked Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…d, capture link restored Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ings, and links Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
Contributor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR 6 of the example-first docs program (plan:
docs/superpowers/plans/2026-09-06-docs-example-first-products.md, PR 6 table; spec:docs/superpowers/specs/2026-09-05-docs-example-first-content-design.md).Pages rewritten:
runtimes/{aws-strands,mastra,microsoft-agent-framework}/overview— each now walks its backend, server, provider, and component in build order and keeps its portability sections; every matrix cell is byte-identical to before and agrees with the runtimes introduction andchoosing-an-adapter.Walkthroughs deleted: the three runtime
guide.mdfiles (their stale "Subagents: not demonstrated" rows contradicted the code, the matrix, and the committed wire captures);PENDING_PAGESdrops the three entries (13 remain).Example sources: comment-only
#regionmarkers in the two Python agents, the two Mastra.mjsfiles underdeployments/ag-ui-mastra/(Railway files untouched;node --checkclean), and the three Angular components; the regenerateddeployments/ag-ui-dev/deps/{aws_strands,microsoft_agent_framework}copies are committed (drift gate clean).Facts settled (verified in
libs/ag-ui/srcand the example sources): Strands' partial shared state comes from full-object snapshots with no delta hook, and the post-resume booking status is never emitted; Strands and MAF resume through the top-levelresumearray, Mastra throughforwardedProps.commandwith theCUSTOM on_interruptpayload asinterrupt().value; all three stream subagents throughSUBAGENT_*events emitted by an in-tree emitter or tee.Verification:
nx run-many -t test,lintgreen (website, cockpit-registry, cockpit-shell, scripts); generators no drift; prod build renders every page withdata-example-filecounts equal to tag counts;nx e2e website124 passed.🤖 Generated with Claude Code