Home: README
Path placeholder: <repo-root> means the folder containing this repository's README.md.
This guide is your exact execution protocol for levels 0, 1, and 2.
Turn a beginner into a consistent builder of small, reliable Python tools.
cd <repo-root>/projects/level-0/01-terminal-hello-lab
python project.py --input data/sample_input.txt --output data/output_summary.json
pytest -qExpected output:
... output_summary.json written ...
2 passed
- Read project README first.
- Run baseline script.
- Run tests.
- Read
project.pytop to bottom. - Do one "alter" change.
- Do one "break" change.
- Fix and verify.
- Record root cause notes.
Choose one per project:
- Remove or rename a required input line and verify safe handling.
- Change a condition and verify tests catch bad behavior.
- Change output key names and verify tests fail then fix correctly.
- Minimum: 3 projects/week.
- Recommended: 5 projects/week.
- Accelerated: 7+ projects/week.
- Play: mutate constants and inputs and observe output changes.
- Build: run every step in this doc exactly.
- Dissect: rewrite one project with simpler variable names and comments.
- Teach-back: explain one finished project in 5 minutes to notes/voice.
By end of level 0:
- variables, strings, input/output, loops, files.
By end of level 1:
- conditionals, dictionaries, validation, parsing.
By end of level 2:
- transforms, retries, small pipeline reasoning.
- You can explain any line in one level-2
project.py. - You can add one new test and keep all tests green.
- You can induce one failure and recover in under 20 minutes.
- You can explain why your fix is correct.