Skip to content

docs: document extending a built-in agent kit - #25748

Open
dvdksn wants to merge 5 commits into
docker:mainfrom
dvdksn:codex/fix-150-claude-kit-example
Open

docs: document extending a built-in agent kit#25748
dvdksn wants to merge 5 commits into
docker:mainfrom
dvdksn:codex/fix-150-claude-kit-example

Conversation

@dvdksn

@dvdksn dvdksn commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Keep the mixin and sandbox-kit overview sections conceptual and link them to canonical runnable examples. Update the built-in agent fork example to use extends: claude, inheriting Docker's full Claude integration while overriding only the entrypoint to use manual permission mode.

@netlify /ai/sandboxes/customize/kits/

Closes docker/sbx-releases#150

Generated by Codex

)

The abbreviated example incorrectly reinstalled Claude Code and did not explain which production details it omitted.
Remove the duplicate installer and describe the sandbox integration hidden by the abbreviation.

Co-Authored-By: Claude <noreply@anthropic.com>
@netlify

netlify Bot commented Aug 10, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit d3849fc
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a79c54777ed7b00075f0b1f
😎 Deploy Preview https://deploy-preview-25748--docsdocker.netlify.app/ai/sandboxes/customize/kits/
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@docker-agent docker-agent 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.

Assessment: 🟢 APPROVE

The change removes a redundant setup.install block from the built-in Claude kit example and adds a clear, accurate paragraph explaining what the abbreviated spec omits and directing custom-agent authors to the full guide. The new text is concise, correctly scoped, and free of style-guide violations. No actionable issues found.

The revised built-in Claude example still described an incomplete spec that readers could not reuse.
Replace it and the related fork example with a working extends-based variant that restores approval prompts.

Co-Authored-By: Claude <noreply@anthropic.com>
@dvdksn dvdksn changed the title docs: clarify built-in Claude kit example docs: document extending a built-in agent kit Aug 10, 2026
dvdksn and others added 2 commits August 10, 2026 10:30
The kits overview repeated the complete extends example from the dedicated examples page.
Keep the runnable example in one place and link to it from the conceptual overview.

Co-Authored-By: Claude <noreply@anthropic.com>
The kits overview retained a full Ruff example after the sandbox example moved to the dedicated examples page.
Keep both kit-type sections conceptual and link to the canonical mixin patterns.

Co-Authored-By: Claude <noreply@anthropic.com>
@dvdksn
dvdksn requested review from a team and mdelapenya August 10, 2026 11:09
@dvdksn
dvdksn marked this pull request as ready for review August 10, 2026 11:09

@docker-agent docker-agent 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.

Assessment: 🟡 NEEDS ATTENTION

Comment thread content/manuals/ai/sandboxes/customize/kit-examples.md

@docker-agent docker-agent 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.

Assessment: 🟡 NEEDS ATTENTION

Comment thread content/manuals/ai/sandboxes/customize/kit-examples.md

@docker-agent docker-agent 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.

Assessment: 🟢 APPROVE

The changes are well-scoped and match the existing document's character. The kits.md overview sections are trimmed to conceptual prose and link to canonical runnable examples in kit-examples.md. The fork example is cleanly updated to use extends: claude with only an entrypoint override. No style violations, no missing redirects, no front-matter issues, no broken anchors.

The overview omitted MCP integration and described inherited volumes differently from the detailed example. Use the same verified inheritance list on both pages.

Co-Authored-By: Codex <noreply@openai.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

sbx kit feedback

3 participants