Purpose
This process turns the first paid museum pilot into auditable commercial evidence without confusing outreach, demonstrations, placeholders, or internal rehearsals with customer proof. It extends the existing entitlement, activation, support, KPI, and evidence-packet workflow in `managed-linked-art-pilot-runbook.md`.
Evidence Rule
Placeholder evidence never clears a commercial gate. Every accepted item must name the real tenant, museum, owner, date, source, and durable evidence reference. A draft, unsigned template, demo dataset, internal approval, or unverified verbal statement remains pending.
Stage 1: Signed Scope And Invoice Evidence
Owner: Sun & Rain Works commercial owner.
Required evidence:
- signed agreement, purchase order, or written scope approval;
- real museum legal name, buyer contact, review owner, and publication boundary;
- fixed fee or rate and approved change-control terms;
- Invoice evidence: invoice number, issue date, amount, currency, due date, buyer, and durable invoice reference;
- active exact-tenant manual entitlement using the same invoice reference.
Acceptance check: the buyer pack and entitlement validator accept the real references, and no synthetic marker appears in an account, tenant, or invoice identifier.
Stage 2: Source Receipt And Delivery Evidence
Owner: pilot delivery owner.
Required source receipt evidence:
- dataset name, version, format, source namespace, record count, received timestamp, transfer method, checksum, review owner, publication boundary, and deletion date.
Required Delivery evidence:
- delivery timestamp and recipient;
- immutable deliverable manifest with filenames or URLs and checksums;
- mapped and rejected record counts;
- validation output and results-report reference;
- delivery email or ticket reference;
- one correction-pass deadline.
Acceptance check: the delivery manifest accounts for every in-scope deliverable and links to the exact source version.
Stage 3: Acceptance Evidence
Owner: named museum review owner.
Required Acceptance evidence:
- accepted, accepted with listed corrections, or not accepted;
- decision date and reviewer identity;
- tested acceptance criteria and observed result;
- correction list and due date when applicable;
- next commercial decision: stop, extend, implement, host, or revisit later.
Silence is not acceptance and never authorizes publication.
Stage 4: Time And Cost Evidence
Owner: pilot delivery owner.
Record Time and cost evidence by work category:
| Category | Required measure |
|---|---|
| Discovery and scope | operator hours and loaded hourly cost |
| Data intake and mapping | operator hours and loaded hourly cost |
| Validation and review | operator hours and loaded hourly cost |
| Corrections and support | operator hours and loaded hourly cost |
| Infrastructure | tenant-attributable hosting, storage, API, and service cost |
| Third parties | licenses, contractors, payment fees, and approved travel |
The loaded operator rate must be defined before kickoff and used consistently. Record actual hours, not estimates, after work occurs.
Stage 5: Customer Feedback
Owner: museum review owner, captured by the commercial owner.
Required Customer feedback:
- dated reviewer name and role;
- what was useful, unclear, missing, or incorrect;
- whether the output improved the named workflow;
- a 0-10 likelihood-to-continue score plus explanation;
- requested changes and decision owner.
Do not turn edited marketing copy into customer evidence. Preserve the original response reference.
Stage 6: Testimonial Or Case Study Permission
Owner: museum communications authority.
Testimonial or case study permission must be separate from delivery acceptance. Record:
- exact approved quote, screenshots, museum name, logo use, and factual claims;
- approving person and authority;
- approved channels and publication date range;
- required attribution and review-before-publication step;
- withdrawal or correction contact.
No response means no permission. A private positive comment may inform product work but may not be published.
Stage 7: Retention Evidence
Owner: commercial owner.
Required Retention evidence is a dated customer action, not inferred product usage. Accepted signals are:
- signed extension;
- paid implementation statement of work;
- paid ongoing-service order;
- approved expanded scope;
- renewal or scheduled next paid phase.
Record the decision date, amount or scope, evidence reference, and next review date. A polite meeting, demo attendance, or unpriced future interest is not retention.
Stage 8: Gross-Margin Evidence
Owner: finance owner.
Required Gross-margin evidence uses recognized pilot revenue and attributable delivery cost for the same period:
gross profit = recognized pilot revenue - direct pilot costs
gross margin percent = gross profit / recognized pilot revenue * 100
Direct costs include loaded delivery labor, support labor, tenant infrastructure, payment fees, contractors, licenses, and approved travel. Report both the percentage and the underlying revenue and cost references. Do not include unpaid invoice amounts as recognized revenue under this operational calculation.
Closeout Packet
The pilot can support a commercial-readiness claim only when the exact tenant has:
- signed scope and a real invoice;
- active invoice-backed entitlement;
- source receipt and delivery manifests;
- written acceptance or a documented non-acceptance outcome;
- actual time, support, infrastructure, and direct-cost entries;
- preserved customer feedback;
- explicit permission for any published testimonial or case study;
- a real retention decision;
- a gross-margin calculation tied to the same revenue period;
- a generated strict pilot evidence packet with no commercial blockers.
Existing Commands
Use the current managed ledgers rather than inventing parallel evidence:
pnpm pilot:buyer-pack -- --account <account> --tenant <tenant> --organization "<museum>" --invoice-ref <invoice> --owner "<owner>"
pnpm pilot:activation --tenant=<tenant> --summary
pnpm pilot:support --tenant=<tenant> --summary
pnpm pilot:kpi --tenant=<tenant> --summary
pnpm pilot:evidence --tenant=<tenant> --account=<account> --markdown --check
Delivery manifests, acceptance records, original feedback, and permission records belong under an exact tenant evidence directory and must be referenced from the KPI or evidence packet. Do not store customer data in the public demonstration directory.