Target Guide¶
Guide Maps¶
graph LR
help["make help"] --> targets["Public targets"]
targets --> review["Inspect, verify-report, proof, and confirm"]
review --> guides["Local capstone guides"]
flowchart LR
question["Pick the question you have"] --> target["Choose the smallest honest target"]
target --> output["Inspect the command output or bundle"]
output --> owner["Name the owning object or boundary"]
owner --> decision["Return to the course with a clear answer"]
Use this guide when make help shows several commands but the right one is still not
obvious. The goal is not target memorization. The goal is picking the smallest honest
command for the question you actually have.
Stable targets¶
| Target | What it is for |
|---|---|
confirm |
run the strongest local confirmation route |
demo |
run the human-readable monitoring scenario |
inspect |
build the learner-facing inspection bundle |
inspect-timeline |
print the ordered scenario flow directly in the terminal |
inspect-retirement |
print the retirement scenario before-and-after state |
inspect-rate-of-change |
print the alternate evaluation-mode scenario |
inspect-json |
print the default scenario as stable JSON |
tour |
build the learner-facing walkthrough bundle |
verify-report |
build the executable verification report bundle |
proof |
run the full course-sanctioned evidence route |
Pick by output shape¶
| If you need... | Choose |
|---|---|
| terminal narrative only | make demo |
| saved learner-facing state files | make inspect |
| saved walkthrough story plus guide set | make tour |
| saved tests plus learner-facing state | make verify-report |
| the strongest local confidence bar | make confirm |
| the published end-to-end learner route | make proof |
Fast target selection¶
If the question is "does the design still hold?"¶
Use:
make confirm
If the question is "can I understand the scenario as a human?"¶
Use:
make demomake tourTOUR.md
If the question is "what is the current capstone state?"¶
Use:
make inspectINSPECTION_GUIDE.md
If the question is "in what order did the teaching scenario happen?"¶
Use:
make inspect-timelineSCENARIO_GUIDE.mdEVENT_FLOW_GUIDE.md
If the question is "what does retirement change and clean up?"¶
Use:
make inspect-retirementRETIREMENT_SCENARIO_GUIDE.mdRULE_LIFECYCLE_GUIDE.md
If the question is "what proves the policy seam is real?"¶
Use:
make inspect-rate-of-changeRATE_OF_CHANGE_SCENARIO_GUIDE.mdTEST_GUIDE.md
If the question is "can I diff or script the same scenario state?"¶
Use:
make inspect-jsonINSPECTION_GUIDE.mdBUNDLE_GUIDE.md
If the question is "what saved bundle proves the behavior?"¶
Use:
make verify-reportPROOF_GUIDE.md
If the question is "what is the strongest published route?"¶
Use:
make proof
Important distinctions¶
confirmversusproofconfirmproves the local route as strongly as possible;proofbuilds the published learner-facing evidence route.demoversustourdemotells the story directly in the terminal;toursaves that story with matching review guides.inspectversusverify-reportinspectfocuses on learner-facing state;verify-reportcombines tests and saved state for stronger review.
Signs a target is too heavy¶
- you ran it mainly because it felt safer than naming the real question
- the output answered several things, but not the one boundary you were reviewing
- a lighter route could already have told you which file or test to open next
Best companion guides¶
Read these with the target guide:
PACKAGE_GUIDE.mdTEST_GUIDE.mdWALKTHROUGH_GUIDE.mdPROOF_GUIDE.mdINSPECTION_GUIDE.mdBUNDLE_GUIDE.mdSCENARIO_SELECTION_GUIDE.mdEXTENSION_GUIDE.md