How Cadora's deliverable pack works, step by step: an archived run already carries a checksummed evidence pack for a verifier; cadora deliverable pr1-verify turns the same run into a readable client-facing delivery report (deliverable.md) with an executive summary, what was delivered, quality and assurance, cost (FinOps), and an evidence appendix; every claim is exactly what the archive recorded, estimates flagged, checksummed not signed; --docx renders an optional Word copy via the cadora[deliverable] extra; the evidence pack is the proof for a verifier, the deliverable is the story for a stakeholder — same source, different reader.

Cadora · deliverable pack

The story on top of the proof

A run's evidence pack is the checksummed proof a verifier recomputes offline. But the person who signs off on the work usually isn't the verifier — they want the readable story. cadora deliverable turns one archived run into a client-facing delivery report: the persuasive narrative that sits on top of the same tamper-evident evidence, under the same honesty contract, for a different reader.

Surface · CLI + delivery reportRole · consultant / stakeholderCaptured · fixture run, aidlc-hitl
01

One archived run, two readers

The run finished green and its evidence pack already exists — report.json, checksums.txt, and a signature — the proof a verifier recomputes. What it doesn't do is read like something you hand a client. Both readers draw from the same archived run; the deliverable is the second surface over the same source of truth.

one run · two surfaces
story on top
Delivery report
deliverable.md · deliverable.docx
reader · stakeholder — reads the narrative and signs off
▲   both rendered from the same build_report() evidence   ▼
proof underneath
Evidence pack
report.html · report.json · checksums.txt · checksums.txt.sig
reader · verifier — recomputes every hash, offline

Same source, same honesty contract, different audience. The deliverable never adds a claim the evidence doesn't already support — it re-reads the pack's structured evidence, it doesn't re-derive anything.

02

cadora deliverable writes the report

One command reads the archived run and writes deliverable.md — a dependency-free Markdown delivery report. By default it lands beside the run at runs/pr1-verify/ (not inside the evidence pack's report/ — the deliverable is a sibling of the proof, not part of it).

zsh — cadora deliverable
$ cadora deliverable pr1-verify --archive-dir runs delivery pack for pr1-verify: md runs/pr1-verify/deliverable.md
One file, Markdown, renders anywhere — paste it into a doc, a ticket, or an email. Want a Word copy? Add --docx (step 05). The Markdown core needs no extra dependency.

Reads the same archive as cadora report. If the run isn't there you get no such run 'pr1-verify' in runs/ — point --archive-dir at the right directory.

03

The delivery report itself

Five sections, always in the same order: Executive summary, What was delivered (a per-node table across the AI-DLC phases), Quality & assurance, Cost (FinOps), and an Evidence appendix that points back at the checksummed pack. Every number is lifted from the archive — nothing is written by hand.

runs/pr1-verify/deliverable.md — rendered
Solution Delivery Report — aidlc-hitl
Run pr1-verify · generated by Cadora 0.10.0 · 2026-07-17T14:20:03+00:00
Executive summary

Cadora conducted an AI-DLC pipeline (aidlc-hitl) across 3 nodes on claude. Outcome: ✅ PASS. Total metered cost $0.1873 (1 node(s) priced from the public price table). Gate verdicts — passed: 1. Integrity findings: 0. Human-review decisions: 2.

What was delivered
NodeBackendModelOutcomeGateCost
requirementsclaudeclaude-opus-4-8$0.0642
designclaudeclaude-opus-4-8$0.0511
constructionclaudeclaude-sonnet-4-5passed$0.0720*

* = cost estimated from the public price table (backend reported tokens, not dollars).

Quality & assurance
  • Gate verdicts: passed: 1
  • Integrity: 0 finding(s) across 0 node(s)
  • Human review: 2 recorded decision(s)
  • Verifiable evidence: every claim above is checksummed — run cadora report pr1-verify for the portable, SHA-256-verified evidence pack.
Cost (FinOps)

Total: $0.1873 across 3 nodes, 1 estimated from the price table.

Evidence appendix
  • 23 archived file(s), each SHA-256 checksummed.
  • Honesty contract: this report claims exactly what the run archive recorded (gate verdicts, integrity findings, human-review decisions, per-node cost); it is checksummed, not signed.

The nodes are the AI-DLC phases — requirements and design (inception), then construction. The table is one row per node; there is no invented per-phase prose, only what the manifest recorded.

04

Every claim traces to the archive

The deliverable inherits the evidence pack's honesty contract wholesale. A gate verdict is what the gate returned; a cost is a backend-reported dollar figure or a price-table estimate — and if it's an estimate it carries an *. The report is checksummed, not signed, and it makes no claim about agent honesty beyond what the gates and integrity checks actually verified.

honesty contract — inherited
HONESTY CONTRACTexactly what the run archive recorded

The * on the construction node's cost isn't decoration — it says that figure came from the public price table (the backend reported tokens, not dollars). Estimates are always marked; nothing is silently rounded into a hard number.

05

An optional .docx, for the folder that expects Word

Some stakeholders want a Word document, not Markdown. --docx renders deliverable.docx alongside the Markdown, and --out drops the whole thing into a client-pack directory. The .docx path needs one optional extra — the Markdown core stays dependency-free without it.

zsh — cadora deliverable --docx
# one-time: install the optional docx extra $ pip install 'cadora[deliverable]' $ cadora deliverable pr1-verify --docx --out ./client-pack delivery pack for pr1-verify: md client-pack/deliverable.md docx client-pack/deliverable.docx
Without the extra, --docx stops clean: cadora deliverable --docx requires python-docx: pip install 'cadora[deliverable]'. Markdown alone never needs it.

The .docx carries the same summary and delivery table as the Markdown — same evidence, a format the client's document folder expects.

06

Who reads what

The two surfaces don't compete — they're aimed at different desks. Hand the evidence pack to whoever needs to check the work; hand the delivery report to whoever needs to understand and approve it. When a stakeholder wants to go deeper, the appendix points them straight at the pack.

two surfaces · two desks
evidence pack
The verifier

Wants proof, not prose. Recomputes every SHA-256 hash and checks the signature — offline, no live Cadora.

$ cadora verify pr1-verify
delivery report
The stakeholder

Wants the outcome, the cost, and the assurance in plain language. Reads the narrative; signs off.

open deliverable.md / .docx

The checksummed evidence pack — cadora report / sign / verify — is documented on its own. The deliverable cross-references it (the appendix names it) rather than repeating it.

The frames above reproduce real cadora deliverable output and the exact sections of deliverable.md, rendered as editable HTML rather than raster captures — lift them into Figma or iterate directly. This is Cadora's consulting endgame: the same tamper-evident run, told two ways — a checksummed proof for the verifier, and a readable delivery report for the stakeholder who signs.