← All insights

KN-13 · Delivery evidence

What does each stage of a software build prove?

A build stage owes the reviewer two things. Write a claim before the work starts, then hand over an artifact they can open to check it. A green run helps when the test answers the same question as the stage.

6 min readGuildBuild Team
AI agentsSoftware deliveryEvaluation
In this article

What a stage hands over

Write the claim beside the artifact in the requirement or work card. A test records what its assertions cover. Use it as evidence when those assertions match the stage claim. A reviewer needs an agreed reference such as a design, a sheet or a requirement so they can inspect the build independently of the builder’s report.

The six stages

Delivery stages and their evidence
StageWhat the reviewer opensWhat it establishes
IdeaDated request and proposed questionNames the claim to investigate
Proof of conceptSmallest real input, command and outputOne claim under stated conditions
PicturePinned page, sheet or schemaRequester accepts the shape
PrototypeReal data through the real pathDesign holds under observed constraints
Finished v1Product in use and a one-page owner guideIndependent acceptance against the agreed frame
LiveDated runs and failure recordsContinued operation over observed runs

An idea names a question without establishing demand or feasibility. A proof of concept tests one narrow risk in its stated setting. It leaves safety, cost, maintenance and other inputs for separate evaluation. A picture establishes the requester’s preference when they explicitly accept it. Feasibility and cost remain open.

A prototype exercises the whole path with real inputs, within the time, cost and machine constraints that matter. List its rough edges and operator dependencies. A finished v1 serves its intended user, has independent acceptance against the agreed frame, and has a one-page guide naming what it is, where it runs and who owns it. Live operation adds dated evidence and failure records. Each run covers its own observation window.

Figure 01Delivery framework

What can a reviewer establish at each stage?

  1. Idea

    Open the dated request.

    It names the question to investigate. Demand and feasibility remain open.

  2. Proof of concept

    Open one real input, command and output.

    It tests one claim under stated conditions. Keep other risks open.

  3. Picture

    Open the pinned page, sheet or schema.

    Requester approval establishes the intended shape. Feasibility and cost still need evidence.

  4. Prototype

    Follow real data through the real path.

    The run shows how the design behaves under observed constraints. Record rough edges and operator dependencies.

  5. Finished v1

    Open the accepted product and owner guide.

    Independent acceptance checks the agreed frame. The guide names where the product runs and who owns it.

  6. Live

    Open the dated runs and failure records.

    Name the revision and observation window. Continued operation is supported only across the runs observed.

One team’s working framework, informed by three field cases. The stages describe different kinds of evidence.

Three cases from a build team

  1. Click tests and visual approval. Three iterations of a page passed headless interaction tests. People looking at the page and screenshots spotted clipped labels, a drawer hiding the board and notifications stacking up. The tests established that buttons and drawers responded. The requester’s approval established that the design was ready to become a requirement.
  2. A sheet its owner could inspect. An inventory of 16 machines and 53 projects was assembled in conversation. Its owner caught four mistakes by eye, including a missing laptop and a team listed as a project. The team recorded the sheet as usable because its owner could see and check it. A separate build lacked a comparable handover.
  3. Three reports about one fix. The first scheduled run after a merge failed on a revision without either fix commit. A later count covered a window that crossed revisions. The acceptance result became interpretable when it named both the revision and the observation window. See the software factory field note.

What to do with it

  1. Write one sentence naming the claim, the conditions and the artifact before work starts.
  2. Inspect the artifact against the claim and the agreed frame before reading the builder’s report.
  3. Label the artifact by its job. A picture shows the expected shape. A proof of concept tests feasibility of one thing. A prototype exercises the broader design.
  4. For live operation, record the revision, observation window and any failures.

The inputs can go to another agent as reviewer too. A claim and an artifact give that agent the same comparison to make.

How we know

The ladder comes from one team’s October 2026 requirements discussions and three reported cases. The cases illustrate how the team assigned names and checked evidence. There was no controlled measurement, and the work was not rerun for publication. The one-page handover is the team’s working definition of readiness for its owner.