docs: reference the verify-before-execute principle from BUILD.md #276

Merged
clawdie merged 1 commit from docs/build-verify-before-execute-pointer into main 2026-07-19 13:02:19 +02:00
Owner

Adds one paragraph to the Testing section, right under the verification order — whose item 1 ("static artifact verification on the build host") is exactly where the borrowed-tool xkbcomp failure lived: build-host checks that exercise image-resident binaries must run chrooted into the image, not borrowed to the host loader (libxkbfile.so.1 incident, fixed by #275). Points to colibri docs/wiki/verify-before-execute.md for the full principle (colibri PR #433).

Notes:

  • Merge after #275 so the note's "until #275 chrooted it" reads as fact; pairs with colibri #433 which carries the wiki page it points to.
  • This branch previously held a stale first draft (d3430a8, based on pre-#270 main, referencing a nonexistent doc/AGENT-EXECUTOR-BRIEF.md) — replaced by this version on current main. The draft's declare-PASS-criteria-before-running bullets already live in the forge-ops skill's executor-brief template.

Gates: ./scripts/check-format.sh green.

🤖 Generated with Claude Code

Adds one paragraph to the Testing section, right under the verification order — whose item 1 ("static artifact verification on the build host") is exactly where the borrowed-tool xkbcomp failure lived: build-host checks that exercise image-resident binaries must run **chrooted into the image**, not borrowed to the host loader (`libxkbfile.so.1` incident, fixed by #275). Points to colibri `docs/wiki/verify-before-execute.md` for the full principle (colibri PR #433). Notes: - Merge **after** #275 so the note's "until #275 chrooted it" reads as fact; pairs with colibri #433 which carries the wiki page it points to. - This branch previously held a stale first draft (d3430a8, based on pre-#270 main, referencing a nonexistent `doc/AGENT-EXECUTOR-BRIEF.md`) — replaced by this version on current main. The draft's declare-PASS-criteria-before-running bullets already live in the forge-ops skill's executor-brief template. Gates: `./scripts/check-format.sh` green. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs: reference the verify-before-execute principle from BUILD.md
All checks were successful
format-check / prettier (pull_request) Successful in 8s
064d3431fc
The Testing section's verification order starts with 'static artifact
verification on the build host' — exactly where the borrowed-tool
xkbcomp failure lived (#275). Add the rule: build-host checks that
exercise image-resident binaries must run chrooted into the image,
with a pointer to colibri docs/wiki/verify-before-execute.md for the
full principle.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
clawdie deleted branch docs/build-verify-before-execute-pointer 2026-07-19 13:02:20 +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!276
No description provided.