Skip to content

Migrate the authoring kit to Docker Sandboxes kit spec v3 - #5

Open
mikesir87 wants to merge 1 commit into
mainfrom
kit/migrate-to-spec-v3
Open

mikesir87 wants to merge 1 commit into
mainfrom
kit/migrate-to-spec-v3

Conversation

@mikesir87

Copy link
Copy Markdown
Member

What

Moves kit/ from kit spec v2 to v3.

  • spec.yaml becomes simspace.yaml plus simspace.dockerfile. The descriptor declares agent-skill@1 per skill, agent-context (@1 and @2 via a YAML anchor, as the spec's own examples do during the runtime rollout), network-policy@1 and port@1.
  • Skills move from files/home/.claude/skills/ to skills/ and are copied into an overlay layer. v3 has no implicit file copy, so each skill needs an agent-skill@1 entry. The agent's own kit decides where skills land, so this isn't Claude-specific.
  • Publishing uses docker buildx build --push with the docker/sandbox-kit:3 frontend instead of sbx kit push. The workflow sets up buildx instead of installing sbx. The existence check, immutable-tag rule and by-digest latest retag are unchanged.
  • The unused SIGN option is removed. v3 signing is a separate cosign step.
  • AGENTS.md and kit/README.md are updated.

Verification

  • The descriptor and recipe build through the v3 frontend.
  • kit-tck validate passes all 19 checks on the exported OCI layout, and layer ownership is all 0/0.
  • DRY_RUN=1 ./scripts/publish-kit.sh v3.0.0 runs end to end locally.
  • Not verified: a real sandbox run (no sbx in my environment) or the workflow in CI. The PR run is a dry run, so it will exercise the build.

Before merging

Merging publishes v3 to latest. v3 kits can't compose with v1/v2 kits, so any repo pairing simspace-authoring-kit:latest with a v2 agent kit (simspace-starter's .sbxenv.yaml, for one) will stop resolving. Consider cutting a kit/v3.0.0 tag first, or moving the starter in step.

Also unconfirmed: the minimum sbx version. The Docker Learn guide says Kits v3 need at least v0.45, but I couldn't confirm that from the spec repo.

🤖 Generated with Claude Code

- spec.yaml -> simspace.yaml (+ simspace.dockerfile): v3 descriptor with
  agent-skill@1 per skill, agent-context (@1 and @2), network-policy@1 and
  port@1 capabilities. The skills move from files/home/ to skills/ and are
  copied into an overlay layer; v3 has no implicit file copy.
- Publish with `docker buildx build --push` using the docker/sandbox-kit:3
  frontend instead of `sbx kit push`; the workflow sets up buildx rather than
  installing sbx. The unused SIGN option is removed.
- Update AGENTS.md and the kit README.

Verified: descriptor + recipe build, and `kit-tck validate` passes all checks
on the exported OCI layout.

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

This branch has not been deployed

No deployments
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