Skip to content

Deep Dive DVC Capstone Map

Page Maps

graph LR
  family["Reproducible Research"]
  program["Deep Dive DVC"]
  section["Capstone"]
  page["Deep Dive DVC Capstone Map"]
  capstone["Capstone evidence"]

  family --> program --> section --> page
  page -.applies in.-> capstone
flowchart LR
  orient["Orient on the page map"] --> read["Read the main claim and examples"]
  read --> inspect["Inspect the related code, proof, or capstone surface"]
  inspect --> verify["Run or review the verification path"]
  verify --> apply["Apply the idea back to the module and capstone"]

Read the first diagram as a timing map: the capstone is a corroboration surface, not the first lesson. Read the second diagram as the route rule: choose one capstone route by module or question, inspect the matching surface, then stop when one honest proof route is visible.

Enter the capstone at the right time

Enter only when the module idea is already legible in the local exercise.

Return to the module first if:

  • you cannot yet explain the concept on a smaller repository
  • you do not know which command should prove the behavior
  • the repository feels larger than the concept you are studying

Choose the route by question

If the question is... Start here Escalate only if needed
what this repository promises Capstone Guide Capstone Walkthrough
which repository surface matches the current module the table below Capstone File Guide
which command should prove the current claim Command Guide Capstone Proof Guide
what is safe for downstream trust Capstone Proof Guide Capstone Review Worksheet
what survives local loss and remote restore Capstone Proof Guide Capstone Review Worksheet

Choose the route by module arc

Module arc What should already be clear locally First capstone route
Modules 01-03 state identity, cache truth, and environment boundaries Capstone Walkthrough
Modules 04-06 truthful stage edges, params, metrics, and experiment comparison Capstone File Guide
Modules 07-08 collaboration pressure and recovery boundaries Capstone Proof Guide
Modules 09-10 downstream trust, migration boundaries, and stewardship judgment Capstone Review Worksheet

Module-to-capstone map

Module Main question Capstone surface First command
01 Reproducibility Failures why rerunnable scripts are weaker than explicit state contracts README.md, data/raw/, Capstone File Guide make walkthrough
02 Data Identity what makes state durable instead of path-shaped dvc.lock, .dvc/cache, .dvc-remote/ make verify
03 Execution Environments how runtime assumptions become explicit repository state Makefile, pyproject.toml, src/incident_escalation_capstone/ make verify
04 Truthful Pipelines how declared stage edges differ from hopeful reruns dvc.yaml, dvc.lock, state/ make repro
05 Metrics and Parameters which controls and metrics are safe to compare params.yaml, metrics/, publish/v1/metrics.json make verify
06 Experiments how to vary the control surface without mutating the baseline params.yaml, experiment comparison bundle, publish/v1/ make experiment-review
07 Collaboration and CI which checks another maintainer can run without oral context Makefile, tests/, Review Route Guide make verify
08 Recovery and Scale what survives cache loss and what depends on the remote .dvc-remote/, publish/v1/, recovery bundle make recovery-review
09 Promotion and Auditability what downstream users may trust from the promoted bundle publish/v1/, publish/v1/manifest.json, dvc.lock make release-review
10 Governance and Migration whether another maintainer could review or migrate the repository safely README.md, dvc.yaml, dvc.lock, publish/v1/ make confirm

Good stopping point

Stop when you can name one capstone surface, one command, and one reason they are enough for the current module or question. If you still feel pulled toward the whole repository, step back to the smaller route.