Skip to content

docs(runtimes): three overviews teach through their running examples - #1036

Merged
blove merged 9 commits into
mainfrom
blove/docs-example-first-runtimes
Sep 6, 2026
Merged

docs(runtimes): three overviews teach through their running examples#1036
blove merged 9 commits into
mainfrom
blove/docs-example-first-runtimes

Conversation

@blove

@blove blove commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

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 and choosing-an-adapter.

Walkthroughs deleted: the three runtime guide.md files (their stale "Subagents: not demonstrated" rows contradicted the code, the matrix, and the committed wire captures); PENDING_PAGES drops the three entries (13 remain).

Example sources: comment-only #region markers in the two Python agents, the two Mastra .mjs files under deployments/ag-ui-mastra/ (Railway files untouched; node --check clean), and the three Angular components; the regenerated deployments/ag-ui-dev/deps/{aws_strands,microsoft_agent_framework} copies are committed (drift gate clean).

Facts settled (verified in libs/ag-ui/src and 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-level resume array, Mastra through forwardedProps.command with the CUSTOM on_interrupt payload as interrupt().value; all three stream subagents through SUBAGENT_* events emitted by an in-tree emitter or tee.

Verification: nx run-many -t test,lint green (website, cockpit-registry, cockpit-shell, scripts); generators no drift; prod build renders every page with data-example-file counts equal to tag counts; nx e2e website 124 passed.

🤖 Generated with Claude Code

blove and others added 9 commits September 5, 2026 23:21
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>
@vercel

vercel Bot commented Sep 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
threadplane Ignored Ignored Preview Sep 6, 2026 6:24am UTC

Request Review

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated approval: this PR received an intelligent (AI) code review. See the review comments on this PR.

@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Claude finished @blove's task in 0s —— View job


I'll analyze this and get back to you.

@blove
blove merged commit 635318b into main Sep 6, 2026
35 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