A payload and its manifest pass from an identified producer to a verifying consumer within a finite retention window. Matching bytes and a familiar filename alone do not establish provenance or indefinite availability.

CI artifacts need an explicit handoff contract

A CI job can finish successfully while the next job receives the wrong files. An artifact is a stored output handed to another step, job, person, or release process. Its name alone rarely identifies everything the consumer needs to know. Treat the handoff as a contract covering the producing run, source revision, payload, integrity evidence, access policy, and availability window. Those details turn “download the build” into a checkable operation. ...

September 3, 2027 · 5 min · XB Field Notes
Mandatory job results converge on an aggregate check. A separate repository rule must require the correct check for the intended event and revision; workflow YAML alone does not enforce merging.

GitHub Actions workflows gate the build

A workflow can produce evidence for a merge decision, but YAML alone does not make that evidence mandatory. A dependable build gate connects the intended event, the exact revision being tested, meaningful test results, and a repository rule requiring the correct check. Review those connections together. A green badge on some earlier run is not proof that the proposed merge has satisfied today’s requirements. ...

September 2, 2027 · 5 min · XB Field Notes
Copying app.py before pip makes a source-only edit rerun installation. Copying dependency inputs first, installing, then copying app.py lets that installation result be reused.

Copy dependency inputs before application code

Dockerfile order determines which earlier inputs an expensive build operation depends on. If application source is copied before dependency installation, changing that source can make the installation run again even when the dependency declaration is unchanged. Copying the dependency inputs first, installing them, and copying application code afterward creates a smaller dependency boundary that matches the work the installer actually needs. ...

August 17, 2027 · 5 min · XB Field Notes