Deep Dive DVC Capstone Map

Guide Fit

flowchart TD
  family["Reproducible Research"] --> program["Deep Dive DVC"]
  program --> pressure["A concrete learner or reviewer question"]
  pressure --> guide["Deep Dive DVC Capstone Map"]
  guide --> next["Modules, capstone, and reference surfaces"]

flowchart TD
  question["Name the current module or question"] --> choose["Choose one capstone route"]
  choose --> inspect["Inspect the matching guide, file, or command"]
  inspect --> next_move["Stop when one honest proof route is visible"]

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	Command Guide
which repository surface matches the current module	the table below	Capstone File Guide
which command should prove the current claim	Command Guide	Capstone Review Worksheet
what is safe for downstream trust	Release Audit Checklist	Release Review Guide
what survives local loss and remote restore	Recovery Review 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	Command Guide
Modules 04-06	truthful stage edges, params, metrics, and experiment comparison	Capstone File Guide
Modules 07-08	collaboration pressure and recovery boundaries	Recovery Review Guide
Modules 09-10	downstream trust, migration boundaries, and stewardship judgment	Release Audit Checklist

Module-to-capstone map

Module	Main learner question	Capstone surface	First command
01 Reproducibility Failures	why rerunnable scripts are weaker than explicit state contracts	README.md, data/raw/, Repository Layer 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/, Verification 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.