SDK Migration Guide Generation with Claude Code: Sandbox Policy

A production playbook for SDK migration guide generation in cross-industry operations using Claude Code: sandbox policy, run-scoped inputs, logs, typed results, and artifacts.

Audience: Developer experience teams

The problem

Developer experience teams need SDK migration guide generation to run repeatedly against old SDK docs, new SDK docs, examples, and changelogs. In cross-industry operations, the pain is not one good answer; it is repeatability, auditability, exception handling, and evidence that survives handoff.

Implementation path

Run SDK migration guide generation in an ephemeral sandbox, keep provider credentials in the broker, expose narrow tools, and store logs outside the workspace for review.

Tradeoffs and failure modes

A narrower runtime blocks ambient machine behavior, but it gives security reviewers a concrete boundary. For SDK migration guide generation, the practical test is whether a second run can be debugged, retried, and consumed by a product without reading the raw agent transcript.

Runtime boundary

filesystem: /skill and /skill/.argo/inputs only
network: deny by default
artifacts: /skill/output/artifacts
logs: retained outside sandbox
provider: Claude Code

Run this on Argo