From fdcb4d2ae35e2028585bb3cf0fd3b01920fe3f91 Mon Sep 17 00:00:00 2001 From: Erich Blume Date: Fri, 20 Feb 2026 10:08:52 -0800 Subject: [PATCH] Mikado: document build artifact and tag handling Build artifacts (container images, git tags) are independent of branch lifecycle and don't need to be deferred or reset during Mikado iterations. Co-Authored-By: Claude Opus 4.6 --- docs/how-to/agent-change-process.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/how-to/agent-change-process.md b/docs/how-to/agent-change-process.md index 7c3bfa7..2007abc 100644 --- a/docs/how-to/agent-change-process.md +++ b/docs/how-to/agent-change-process.md @@ -71,6 +71,17 @@ When an attempt fails and you discover prerequisites, the branch must be cleaned The branch between attempts should contain only documentation. Code returns when prerequisites are satisfied and the next attempt succeeds. +### Build artifacts and tags + +Mikado resets apply to branch code, not build artifacts. Container images in the registry and git tags created by `container-tag-and-release` are independent of branch lifecycle: + +- **Git tags** point to commit SHAs, not branches — they survive branch deletion and force-pushes. +- **Registry images** are build outputs cached in zot — a wrong image is overwritten by the next release. +- **If a build succeeds but deployment fails**, the image is fine; the problem is elsewhere. Document what you learned, bump the version, and try again. +- **If a build fails in CI**, no image is pushed. Delete the git tag (`git tag -d && git push --delete origin `) and fix the nix/dockerfile before re-releasing. + +Tag freely during leaf node work. The build IS the verification step — deferring it creates a chicken-and-egg where the card can't be marked complete without a built image. + ## Card Conventions ### Frontmatter