Setup

Read .claude/rules/teaching-rules.md and follow it for everything below.

ACTION: Silently stage bundled scenario assets without overwriting student work:

cp -rn ".claude/skills/start-1-6/assets/." .

Teach this lesson from the bundled script. Follow every Say block verbatim, stop at every Check gate, and have the agent perform every Action. Do not expose instructor metadata.

Module 1.6: Project Memory

Your Role

Teach the verified project-context loading model. Keep the constitution metaphor as useful guidance, not a guarantee of precedence or permanence.

Module Learning Objectives

By the end of this module, students should:

1. Know what belongs in a root CLAUDE.md
2. Know that root CLAUDE.md and .claude/rules/*.md load in full each session
3. Know that nested CLAUDE.md files load lazily when their path is touched
4. See and use the TaskFlow example
5. Know when to start a clean session with Cmd+N

Teaching Flow

Say:

"Welcome to Module 1.6!

Repeatedly explaining your product, users, terminology, and writing preferences is tedious. Project context files solve that problem by giving Claude a shared source of guidance.

Here is a useful metaphor: CLAUDE.md is the constitution; prompts are legislation. Put stable project guidance in the constitution and use prompts for the task at hand. This helps keep work consistent, but it is guidance, not a promise that one file can never be interpreted or overridden."

Check: Ask whether the distinction makes sense, then wait.

What loads and when

Say:

"The verified loading model is:

• A root CLAUDE.md loads in full for the session
• Files in .claude/rules/*.md load in full for the session
• A nested CLAUDE.md loads lazily when that path is touched

This lesson is running from the /start-1-6 skill. In a real Desktop project, put shared project context in the root CLAUDE.md; nested CLAUDE.md files load lazily when that path is touched. If you want a clean reload after changing these files, create a new session with Cmd+N."

Check: Wait for the student to confirm.

Explore the TaskFlow example

Say:

"I staged a realistic TaskFlow example for this lesson. Open TASKFLOW_CLAUDE.md.

It contains product context, personas, writing style, terminology, team references, and practical rules. In a real project, you would adapt it and name the root copy CLAUDE.md."

Check: Wait for the student to open and review it.

Say:

"Now ask me: Using TASKFLOW_CLAUDE.md, write a user story for dark mode."

Check: Wait for the request.

Action: Read TASKFLOW_CLAUDE.md, then write a concise dark-mode user story that follows its terminology, format, and acceptance-criteria guidance. Explain which guidance influenced the output.

Say:

"Notice what happened: the context file supplied the company vocabulary and quality bar, while your prompt supplied today's task. That is the constitution-and-legislation pattern in practice.

Use root context for stable shared guidance. Use .claude/rules/*.md for focused full-session rules. Use nested context only when a particular area needs its own instructions."

Check: Ask whether the student has questions, then wait.

Wrap up

Say:

"Module 1.6 complete! 🎉

You now understand the verified loading locations, how to structure reusable project guidance, and when a fresh session can give you a clean reload. Next we'll cover Desktop navigation and control."

Check: Answer questions, then continue to the sendoff.

Sendoff

ACTION: Silently run the following progress update. Do not mention it to the student.

mkdir -p .fspm
[ -f .fspm/progress.json ] || printf '{"name":null,"completed_lessons":[],"current_lesson":"","last_updated":""}' > .fspm/progress.json
L="cc-pms-1-6"; C="cc-pms-1-7"; T="$(date -u +%FT%TZ)"
if command -v jq >/dev/null 2>&1; then
  tmp=$(mktemp)
  jq --arg l "$L" --arg c "$C" --arg t "$T" '.completed_lessons = ((.completed_lessons + [$l]) | unique) | .current_lesson = $c | .last_updated = $t' .fspm/progress.json > "$tmp" && mv "$tmp" .fspm/progress.json
else
  python3 - "$L" "$C" "$T" <<'PY'
import json,sys
l,c,t = sys.argv[1:4]
p = ".fspm/progress.json"; d = json.load(open(p))
if l not in d.get("completed_lessons",[]): d.setdefault("completed_lessons",[]).append(l)
d["current_lesson"] = c; d["last_updated"] = t
json.dump(d, open(p,"w"))
PY
fi

Next lesson: Type /start-1-7 in the composer.