Digital Thread and Reproducibility Templates — Operating Quantum Computers

This appendix provides starter artifacts for chapters 147 through 150. Adapt the schemas to the platform. Do not treat them as complete compliance artifacts.

Configuration baseline record

Illustrative listing · yaml

baseline_id: qbase-2026-04-20-001
status: candidate
owner: team-quantum-platform
created_at: 2026-04-20T09:00:00Z
review_by: 2026-04-27T09:00:00Z
components:
  hardware_topology_id: topo-prod-qpu-17-v3
  calibration_snapshot_id: cal-prod-qpu-17-20260420T0830Z
  compiler_target_id: target-prod-qpu-17-20260420T0915Z
  runtime_contract_id: sampler-prod-small-v6
  mitigation_profile_id: mitigation-zne-lite-v2
  access_policy_id: quantum-access-prod-v4
  evidence_schema: qevidence.v7
promotion_checks:
  - topology_consistency
  - calibration_freshness
  - benchmark_regression
  - admission_policy_validation
  - evidence_schema_compatibility

Diagram loads as you read

Configuration baseline record · Figure 1

View diagram source

flowchart LR
    Baseline[Baseline record] --> Components[Component IDs]
    Baseline --> Checks[Promotion checks]
    Baseline --> Owner[Owner]
    Checks --> Decision{Promote?}

Baseline diff template

Illustrative listing · markdown

# Baseline diff: qbase-old -> qbase-new

## Summary

## Changed components

| Component | Old | New | Expected impact |
|---|---|---|---|

## Regression results

## Workload impact

## Rollback plan

## Approval

Reproducible build attestation

Illustrative listing · yaml

artifact_type: quantum_experiment_bundle
artifact_digest: sha256:...
source:
  repo: git@example.com:quantum/workloads.git
  commit: abc123
builder:
  id: qbuild-prod-01
  build_definition: .github/workflows/quantum-build.yml
  started_at: 2026-04-20T10:00:00Z
  finished_at: 2026-04-20T10:06:00Z
environment:
  image_digest: sha256:...
  dependency_lock_digest: sha256:...
  sdk_versions:
    qiskit: x.y.z
    provider_plugin: a.b.c
quantum:
  compiler_target_id: target-prod-qpu-17-20260420T0915Z
  runtime_contract_id: sampler-prod-small-v6

Diagram loads as you read

Reproducible build attestation · Figure 2

View diagram source

flowchart TB
    Source[Source] --> Builder[Builder]
    Builder --> Bundle[Bundle]
    Bundle --> Attestation[Attestation]
    Attestation --> Admission[Admission control]

Notebook promotion checklist

Illustrative listing · markdown

- [ ] Restart-run-all succeeds from a clean kernel
- [ ] Inputs are declared in a config file
- [ ] No hidden local paths are required
- [ ] Dependencies are pinned
- [ ] Credentials are not stored in the notebook
- [ ] Outputs are regenerated or read from immutable artifact URIs
- [ ] Notebook role is declared: scratchpad, analysis, report, tutorial
- [ ] Claim-bearing logic has been moved to script or workflow
- [ ] Evidence package URI is included

Diagram loads as you read

Notebook promotion checklist · Figure 3

View diagram source

stateDiagram-v2
    [*] --> Notebook
    Notebook --> Script
    Script --> Workflow
    Workflow --> Runbook
    Runbook --> Evidence

SPC signal record

Illustrative listing · yaml

signal_id: spc-2026-04-20-017
metric: two_qubit_error_edge_set_p95
scope: qpu-17.edge-set-production
window: 2026-04-20T08:00Z/2026-04-20T12:00Z
rule_triggered: two_points_beyond_upper_warning_limit
baseline_id: qbase-2026-04-20-001
estimated_impact:
  affected_workloads:
    - vqe-small
    - qaoa-routing
recommended_action: hold_affected_workloads_and_run_edge_diagnostic
owner: calibration-oncall

Diagram loads as you read

SPC signal record · Figure 4

View diagram source

flowchart LR
    Signal[SPC signal] --> Scope[Scope]
    Signal --> Impact[Impact]
    Signal --> Action[Action]
    Action --> Evidence[Evidence record]