docs: document ISO versioning & release schema in AGENTS.md #94

Merged
clawdie merged 1 commit from document-iso-versioning into main 2026-06-21 20:37:48 +02:00
Owner

Promotes the ISO product-version/release scheme from scattered build.cfg/build.sh comments (and private agent memory) into contributor-visible AGENTS.md guidance. New Versioning & Release section:

  • ISO_VERSION is an explicit product version in build.cfg (0.11.0, unified with Colibri); no-version builds fail fast; image name = codename + version (clawdie-quindecim-0.11.0.img).
  • Component versions are provenance in build-manifest.json (version_scheme: "product"), not the image identity.
  • BUILD_CHANNEL dev|release; the release gate (build.sh:check_release_gate) requires every staged tree clean so the manifest fully describes the artifact.

Matches shipped code; no behavior change. Markdown format gate passes for AGENTS.md (the lone remaining PLAN-OPERATOR-USB-NEXT.md warning is pre-existing drift, untouched here).

🤖 Generated with Claude Code

Promotes the ISO product-version/release scheme from scattered `build.cfg`/`build.sh` comments (and private agent memory) into contributor-visible `AGENTS.md` guidance. New **Versioning & Release** section: - `ISO_VERSION` is an explicit product version in `build.cfg` (`0.11.0`, unified with Colibri); no-version builds fail fast; image name = codename + version (`clawdie-quindecim-0.11.0.img`). - Component versions are **provenance** in `build-manifest.json` (`version_scheme: "product"`), not the image identity. - `BUILD_CHANNEL` `dev`|`release`; the release gate (`build.sh:check_release_gate`) requires every staged tree clean so the manifest fully describes the artifact. Matches shipped code; no behavior change. Markdown format gate passes for `AGENTS.md` (the lone remaining `PLAN-OPERATOR-USB-NEXT.md` warning is pre-existing drift, untouched here). 🤖 Generated with Claude Code
clawdie added 1 commit 2026-06-21 16:47:41 +02:00
The product-version scheme was only captured in scattered build.cfg/build.sh
comments and agent memory. Promote it to contributor-visible guidance:
- ISO_VERSION is an explicit product version in build.cfg (0.11.0, unified
  with Colibri); no-version builds fail fast; image name = codename + version.
- Component versions are provenance in build-manifest.json (version_scheme
  "product"), not the image identity.
- BUILD_CHANNEL dev|release; release gate (build.sh:check_release_gate)
  requires clean staged trees so the manifest fully describes the artifact.

Matches shipped code; no behavior change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
clawdie merged commit 67e7bef002 into main 2026-06-21 20:37:48 +02:00
clawdie deleted branch document-iso-versioning 2026-06-21 20:37:51 +02:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: clawdie/clawdie-iso#94
No description provided.