# Designing project context course

> When quality varies person to person in the same repository, the cause is rarely prompting skill — it is that nobody designed what gets loaded into a session…

- Canonical: https://learning.reopt.ai/en/courses/claude-code-project-context
- Language: en
- HTML: https://learning.reopt.ai/en/courses/claude-code-project-context

---

[Claude Code essentials](/en/tracks/claude-code-foundations)

# Designing project context

Reproducible results through CLAUDE.md and a context budget

When quality varies person to person in the same repository, the cause is rarely prompting skill — it is that nobody designed what gets loaded into a session. Turn memory layers, conditional rules, compaction survival, and boundary expansion into judgement criteria so rules are actually loaded and actually followed.
Intermediate 8 lessons 515 XP About 89 min

Source · Handbook · Claude Code advanced usage & command mastery · Source reviewed 2026-07-25

Complete the prerequisite courses first
[Safe working flow](/en/courses/claude-code-safe-workflow) to unlock this course.

[Study prerequisites](/en/courses/claude-code-safe-workflow)

![Designing project context course](/images/home/track-claude-code-foundations.png)
0%

Course progress 9 learning steps

## What you'll learn

- Place rules deliberately across managed, user, project, and local memory load order.
- Split expected compliance from guaranteed compliance across CLAUDE.md and PreToolUse hooks.
- Cut startup load with `paths:` conditional rules and design for compaction survival.
- Set session boundaries and cleanup around --add-dir asymmetry and auto-memory scope.

1

## 1. 메모리 계층: 무엇이 먼저 실리는가

네 겹의 메모리가 어떤 순서로 이어 붙는지 확인하고 규칙의 자리를 정합니다.

- 덮어쓰기가 아니라 이어 붙이기 관리 정책·사용자·프로젝트·로컬 메모리의 로드 순서와 적재 시점 Concept 45 XP
- 메모리 계층 판별 퀴즈 어디에 저장되고 언제 적재되는지 구분하기 Quiz 50 XP

2

## 2. 지침과 강제의 경계

준수를 기대할 규칙과 보장해야 할 규칙을 서로 다른 자리에 배치합니다.

- CLAUDE.md는 왜 가끔 무시되는가 전달 방식의 차이로 결정되는 강제력과 훅의 역할 Concept 45 XP
- 실전: 지켜지지 않는 규칙을 옮겨라 문서·시스템 프롬프트·훅·REVIEW.md 중 어디에 둘지 결정 Scenario 60 XP

3

## 3. 조건부 로딩과 압축 생존성

시작 적재량을 실제로 줄이면서 압축 후에도 남을 규칙을 설계합니다.

- 언제 실릴지가 언제 사라질지를 정한다 paths: 조건부 규칙의 절약 효과와 /compact 이후의 손실 Concept 45 XP
- 컨텍스트 예산 점검표 지금 세션에서 바로 확인할 수 있는 적재·생존 항목 Checklist 55 XP

4

## 4. 경계 확장과 흔적 정리

--add-dir로 범위를 넓힐 때의 비대칭과 세션 종료 후 남는 상태를 다룹니다.

- 접근을 넓히는 것과 설정을 상속하는 것은 다르다 추가 디렉토리의 로딩 비대칭, 자동 메모리의 범위, 로컬 상태 정리 Concept 45 XP
- 워크북: 멀티 루트 세션과 종료 절차 교차 분석 범위·신뢰 검토·메모리 감사·정리 런북을 한 장으로 Workbook 70 XP

## Final challenge

Turn what you learned into a reusable work artifact.

- 최종 챌린지 · 우리 저장소 컨텍스트 예산 설계서 로드 인벤토리부터 강제 지점과 운영 규칙까지 한 장으로 정리 Complete lessons first 100 XP

---

Site guide for agents: https://learning.reopt.ai/llms.txt · Sitemap: https://learning.reopt.ai/sitemap.xml · Contact: https://learning.reopt.ai/contact