Course project template

First run

uv sync              # creates .venv and installs everything
claude               # start Claude Code in this folder

Inside Claude Code, type /permissions to see what it can and cannot touch here, and /usage to see how much of your weekly allowance is left.

Layout

data/raw/         original files, never edited
data/restricted/  confidential microdata — Claude cannot read this folder
data/processed/   cleaned, de-identified files your scripts produce
src/analysis/     reusable cleaning + modelling functions
scripts/          numbered, runnable steps (01_clean.py, 02_model.py, ...)
notebooks/        exploration and write-up; import from src/, don't redefine logic
outputs/          figures and tables, regenerated by scripts

Custom commands

• /explore-data <path> — first-pass description of a dataset
• /check-repro — verify the project runs end to end from a clean state
• /explain — plain-language explanation of the last result

Rules

Read CLAUDE.md. The same rules apply to you and to Claude.