Skip to content

docs(deep-agents): five capability pages teach through their running examples - #1035

Merged
blove merged 12 commits into
mainfrom
blove/docs-example-first-deep-agents
Sep 6, 2026
Merged

docs(deep-agents): five capability pages teach through their running examples#1035
blove merged 12 commits into
mainfrom
blove/docs-example-first-deep-agents

Conversation

@blove

@blove blove commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

PR 5 of the example-first docs program (plan: docs/superpowers/plans/2026-09-06-docs-example-first-products.md, PR 5 table; spec: docs/superpowers/specs/2026-09-05-docs-example-first-content-design.md).

Pages rewritten: deep-agents/capabilities/{filesystem,memory,planning,skills,subagents}.

Walkthroughs deleted: the five cockpit/deep-agents/*/python/docs/guide.md files; PENDING_PAGES drops the five entries (16 remain).

Example sources: comment-only #region markers in ten graphs/components (inline-template markers included; each example project builds); three stale docstrings/comments corrected where they contradicted the current deepagents 0.7.11 behavior or the adapter (planning's "default todo middleware", subagents' "namespace matching", memory's "getState").

Facts settled (each verified against deepagents 0.7.11, langchain middleware, and libs/langgraph/libs/chat source): create_deep_agent always installs FilesystemMiddleware, ships SubAgentMiddleware through the default general-purpose subagent, does not install TodoListMiddleware, and adds Memory/Skills middleware when passed; files values are FileData records; HITL resumes need one decision per hanging tool call; PrivateStateAttr keys are absent from the values stream but present on the checkpoint, which is why two examples republish them through a small middleware; customEvents() is per run and value() hydrates from history; subagent attribution matches child streams by description (exact, containment, single candidate), not by namespace; CompositeBackend strips and re-adds the mount prefix.

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 12 commits September 5, 2026 23:00
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>
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>
…cision counts, cards

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ming a default todo middleware; wording precision

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…'s comments name history hydration

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…attribution is by description; example comments corrected

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ention, one sentence after each block

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…allout; the orchestrator docstring matches the page

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.

Project Deployment Actions Updated
threadplane Ready Ready Preview Sep 6, 2026 6:04am UTC

Request Review

@blove
blove enabled auto-merge (squash) September 6, 2026 06:00

@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 a09f77a into main Sep 6, 2026
37 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