Proof Ladder¶
Guide Fit¶
flowchart TD
family["Python Programming"] --> program["Python Object-Oriented Programming"]
program --> pressure["A concrete learner or reviewer question"]
pressure --> guide["Proof Ladder"]
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 page when you are deciding how much proof you need. Not every OOP question needs the strongest capstone command, and using the heaviest route too early often hides the actual design issue.
The ladder¶
| Need | Smallest honest proof | Escalate when |
|---|---|---|
| understand the course promise | Course Home and Start Here | you still cannot place the module you need |
| understand one module promise | Module Promise Map and the module overview | the ownership rule is still fuzzy |
| know whether you are ready to move on | Module Checkpoints | you cannot explain the checkpoint in code |
| inspect the capstone shape | Capstone Map and Capstone File Guide | you need executable evidence |
| review architecture and boundaries | Capstone Architecture Guide and Capstone Walkthrough | you need durable saved evidence |
| review executable evidence | Capstone Proof Guide and make PROGRAM=python-programming/python-object-oriented-programming capstone-confirm |
you need to modify or extend the capstone itself |
What each rung cannot prove on its own¶
- reading pages can explain the intended ownership, but they cannot prove current behavior
- inspection bundles can show state and narrative clearly, but they cannot replace targeted behavioral checks
- confirmation routes can prove the current local contract, but they cannot repair a vague question or an unclear ownership claim
- published proof routes can prove the learner-facing path still works, but they are too heavy for every narrow design question
Rules for escalation¶
- Read before you run when the question is architectural.
- Run before you speculate when the question is behavioral.
- Use the smallest proof that answers the current question.
- Escalate one rung at a time instead of jumping directly to confirmation.
Common misuse¶
- using
capstone-confirmto answer a question that a module overview already settles - treating saved proof artifacts as if they replace reading the design surfaces
- reading the capstone without knowing what module promise you are trying to confirm
- escalating to the strongest route before deciding which object or boundary is actually under review
Escalation checkpoints¶
Before you move up one rung, make sure you can answer these:
- what exact claim am I trying to prove
- which object or boundary should own that claim
- what weaker route already failed to answer it honestly
The ladder keeps the proof route proportional. That makes the capstone support the course instead of overshadowing it.