Capstone Walkthrough

Page Maps

graph LR
  family["Reproducible Research"]
  program["Deep Dive DVC"]
  section["Capstone"]
  page["Capstone Walkthrough"]
  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"]

Use this page when you want the first honest pass through the DVC capstone. The goal is to understand the repository contract, state story, and publish boundary before widening into stronger review routes.

Walkthrough route

1. Run make PROGRAM=reproducible-research/deep-dive-dvc capstone-walkthrough.
2. Read capstone/dvc.yaml, capstone/dvc.lock, and capstone/params.yaml in that order.
3. Open capstone/src/incident_escalation_capstone/publish.py.
4. Inspect capstone/publish/v1/manifest.json.
5. Read Capstone File Guide or Capstone Architecture Guide only if ownership is still unclear.

What the walkthrough should teach

• where declaration ends and recorded execution state begins
• which promoted files another person may trust downstream
• which questions need ordinary verification versus recovery or release review

Stop here when

• you can name the authoritative file for declaration, recorded state, and promotion
• you know whether your next step is verification, recovery review, or stewardship review