Capstone Review Worksheet¶

Guide Fit¶

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

flowchart TD
  question["Name the exact question you need answered"] --> skim["Skim only the sections that match that pressure"]
  skim --> crosscheck["Open the linked module, proof surface, or capstone route"]
  crosscheck --> next_move["Leave with one next decision, page, or command"]

Read the first diagram as a timing map: this guide is for a named pressure, not for wandering the whole course-book. Read the second diagram as the guide loop: arrive with a concrete question, use only the matching sections, then leave with one smaller and more honest next move.

Use this worksheet when you want to review the capstone as a build-system specimen rather than just read it as course material.

Public Surface¶

Answer these first:

which targets are clearly public
which targets are clearly internal
whether the help text is enough for another maintainer to start correctly

Back to top

Truth And Convergence¶

Review these questions:

where are hidden inputs modeled
what would cause non-convergence
which files or rules are responsible for generated artifacts
whether selftest proves the core invariants clearly enough

Back to top

Parallel Safety¶

Review these questions:

which outputs have one writer
which recipes would become unsafe under -j if the graph lied
whether the repro pack covers the main race and ordering classes

Back to top

Architecture¶

Review these questions:

whether the mk/*.mk split is responsibility-driven
whether macros reduce duplication without hiding graph meaning
whether discovery, stamps, and contract rules are easy to locate

Back to top

Release And Stewardship¶

Review these questions:

whether dist and attest are separated cleanly
whether portability boundaries are explicit
whether another maintainer could extend the capstone without weakening its teaching value

Back to top