Claude Code's power multiplies when it understands your whole codebase. Today you use /add to give Claude context across files, write a CLAUDE.md that encodes your project's conventions, and make changes that require understanding multiple files simultaneously.
By the end of this lesson you will use /add to include multiple files in context, write a CLAUDE.md that captures architecture decisions and coding conventions, complete a task that requires changes across three files, and understand how Claude uses context to make consistent decisions.
CLAUDE.md is the foundation of Day 2. Every concept that follows builds on the mental model you establish here. The most effective approach is to understand the principle first, then apply it — skipping straight to implementation creates gaps that compound into confusion later.
Work through each example in this lesson sequentially. The concepts connect, and the order is deliberate. If something is unclear, slow down at that point rather than pushing past it — a ten-minute pause now saves hours of debugging later.
Understanding CLAUDE.md requires seeing it in motion. The code below is not a complete application — it is a minimal, working illustration of the key mechanism. Study the pattern, run it, break it deliberately, then fix it. That cycle builds real comprehension.
Once the basic pattern works, the logical next step is project context. This is where the abstraction becomes useful — you move from understanding the mechanism to applying it to real problems. The transition is usually smaller than it feels. Most of the hard work happened in Section 1.
/add command completes today's picture. It is where CLAUDE.md and project context converge into a pattern you can apply to novel problems. This integration step is often where the day's learning consolidates — if the earlier sections felt abstract, this one typically makes them click.
Implementing CLAUDE.md alone handles the happy path. Real systems encounter edge cases, invalid input, and unexpected state. Missing project context means missing those guards.
Combining CLAUDE.md with project context gives you a complete, defensible implementation. The extra lines cost ten minutes; the robustness they add is worth hours of debugging time.
Several mistakes appear consistently when engineers encounter Multi-File Projects and CLAUDE.md for the first time. Recognizing them now costs nothing; encountering them in production costs hours.
Two intensive days (Thu–Fri) with an instructor who has taught thousands of engineers. Cohorts in 5 cities, June–June–October 2026 (Thu–Fri).
Reserve Your Seat — $1,490Before moving on, you should be able to answer these without looking: