Stage 1~6 단계적 Python 학습. Claude Code 하네스로 단계별 가드레일.
bash scripts/bootstrap.sh이후 Claude Code에서 /stage status로 현재 단계 확인.
notebooks/— Stage별 학습 노트북 (NN_주제.ipynb+ jupytext 페어링.py)src/— 모듈 단위 학습 코드 (Stage 5+)tests/— pytest (Stage 3+ 본격 사용, 그 전에도 작성 가능)notes/— 자유 노트.claude/— Claude Code 하네스 (훅·명령·에이전트)docs/superpowers/— 설계 문서·구현 계획
| Stage | 주제 | 검증 |
|---|---|---|
| 1 | 기초 문법 | 직접 손으로 100줄, AI 사용 금지 |
| 2 | 객체지향 | OOP 코드 5개 직접 재구성 |
| 3 | 테스트·디버깅 | pytest 커버리지 80% |
| 4 | 표준 라이브러리 | 표준 라이브러리로 리팩토링 |
| 5 | 디자인 패턴 | 패턴 5개 명명 |
| 6 | 아키텍처 패턴 | 미니 프로젝트 |
/stage status,/stage next,/stage override <이유>/check [파일],/test,/coverage/explain <파일>:<라인>,/diff-syntax <파일>
- 패키지 관리:
uv(Python 3.13) - 린터·포매터:
ruff - 타입 검사:
mypy --strict - 테스트:
pytest+pytest-cov - 노트북:
jupyter+jupytext페어링 - pre-commit:
nbstripout+jupytext --sync+ruff
docs/superpowers/specs/2026-05-03-python-learning-harness-design.md