This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

07 February 2028
Download Asset

# CLAUDE.md


This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.


## Project Overview


This is a document-only repository containing a beginner-friendly Python debugging guide (`debug-guide.md`). It covers:


- A 4-step debug methodology (read errors → narrow scope → hypothesize → fix)

- Top 5 common beginner mistakes with fix examples

- A live debug walkthrough of a broken average-calculator

- Debug toolbox reference and psychological tips for beginners


## Working with This Repo


- No build, lint, or test infrastructure — this is a pure documentation repo

- All work is editing `debug-guide.md` in place

- Follow the existing tone: conversational, code-heavy, beginner-first

- Python examples use f-strings and built-in functions only (no external dependencies)