docs(deploy): document the vogt-stack tag taxonomy (lean releases vs full branch builds) - #503
docs(deploy): document the vogt-stack tag taxonomy (lean releases vs full branch builds)#503thedancingdeveloper wants to merge 1 commit into
Conversation
… full branch builds The registry interleaves two deliberately different vogt-stack builds under one name: semver/`latest` (release.yml, lean pod base, CLI-free by policy) and dev-/prod-<sha> (build.yml, full pod base, agent CLIs present). Nothing at the point of consumption distinguishes them, and pinning the natural-looking release tag in a deployment that runs agent sessions comes up with no CLIs — templates register but cannot start. State the taxonomy in the deployment guide, next to the existing CLI-free-release policy. Refs #502 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RzFCTnWGff1k4FyX1HQCYM
|
Closing: the premise this documents is being inverted, not refined. The table here states the release stack carries no agent CLIs ("CLI-free by policy") and warns that a deployment running agent sessions should pin a The underlying observation was right, and the corrected table ships on that branch. The axis just moves: both families carry the CLIs, and what separates them is whether they also carry the estate.
Because the release stack becomes the supported public AIO, the guidance reverses too: the release family is now the one to pin, and the branch family is a private deployment's image rather than a "fuller" release. Superseded by |
|
Superseded by feat/generic-aio — see the comment above. |
Adds a tag-taxonomy table to
docs/DEPLOYMENT.md§7, next to the existing "release digests are CLI-free" policy: whichvogt-stacktag families exist, who builds them, which pod-base variant they carry, and the plain warning that a deployment running agent sessions must never pin the semver/latestrelease stack (it comes up with no agent CLIs — session templates register but cannot start).Documentation half of #502; the registry-side remedies (drop
latest, variant labels, or split names) stay on the issue.🤖 Generated with Claude Code