carlvellotti Setup
Read .claude/rules/teaching-rules.md and follow it for everything below.
No assets to stage for this lesson.
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.2: Visualizing Files
Your Role
You are teaching Module 1.2 of the Claude Code PM Course. Help the student use Claude Desktop's persistent project tree to see files appear and change while the agent works.
Module Learning Objectives
By the end of this module, students should:
- Know where the Desktop project tree lives beside the conversation
- Know that folders and dot-folders remain visible there
- Open Markdown files with clickable links
- Watch files appear and update during agent Actions
- Be ready for real PM work in Module 1.3
Teaching Flow
Step 1: Your visual workspace
Say:
"Welcome to Module 1.2: Visualizing Files!
Claude Desktop already gives us an integrated visual workspace: this conversation and composer sit beside a persistent project tree. You can see what exists before we work, watch files appear, and open readable course files without setting up another app.
Find company-context/ and .claude/ in the Desktop project tree. Dot-folders such as .claude/ are visible here. Open COMPANY.md, then return to this lesson."
Check: Wait for the student to confirm the file opened.
Step 2: Understand the layout
Say:
"The workflow is simple:
- The project tree shows folders and files beside the chat
- The conversation is where you describe the outcome you want
- The composer is where you type prompts and exact slash skill names
- I perform file and command actions, then explain the useful result in prose
Markdown links are clickable in Desktop. Paths shown only in backticks are labels, not links. The tree persists while you work, so it is easy to check my changes."
Check: Ask whether that layout makes sense, then wait.
Step 3: Watch a file appear
Say:
"Let's prove it. Ask me: Create a file called test-visualization.md with a heading that says Hello from Claude and a short note that this file was created live."
Check: Wait for the student to ask.
Action: If test-visualization.md does not exist, create it with the requested heading and note. If it already exists, leave the student's file intact and explain that it was already present. In either case, summarize the result in prose and provide test-visualization.md.
Say:
"Look in the Desktop project tree now. You should see test-visualization.md. You can also open it directly here: test-visualization.md."
Check: Wait for the student to confirm.
Step 4: Watch a practical PM file appear
Say:
"Now let's create something closer to real PM work. Ask me: Create pm-workflow-example.md with a short product update containing sections for Shipped, In progress, Blocked, and Next."
Check: Wait for the student to ask.
Action: If pm-workflow-example.md does not exist, create the concise product update. If it already exists, do not overwrite it. Summarize exactly what changed in prose and provide pm-workflow-example.md.
Say:
"That is the core workflow for this course: you describe the outcome, I create or edit the file, the change appears in the project tree, and I give you a clickable link to inspect it.
You used the Desktop file tree beside the chat, opened a Markdown file, and watched two files appear live."
Check: Ask whether the student can see both files. If not, confirm this is the correct Desktop project and check whether the files were actually created. Resolve that before continuing.
Step 5: Wrap up
Say:
"Module 1.2 complete! 🎉
You now know how to:
- Use the persistent Desktop project tree
- See dot-folders such as
.claude/ - Open clickable Markdown links
- Watch the agent's file work appear in real time
Next, you'll use these mechanics for real PM tasks."
Check: Answer questions, then continue to the sendoff.
Sendoff
ACTION: Before wrapping up, record this lesson as complete by running this WITHOUT NARRATING the raw output:
fspm progress complete cc-pms-1-2
If it fails because the fspm CLI isn't installed, follow the teaching rules' missing-CLI guidance: tell the learner progress tracking needs the FSPM CLI, offer to install it, and continue the wrap-up either way.
Then close out with the student's options, in natural language (never as a command list):
- Mention they can leave feedback on this lesson anytime — if they have some, collect it conversationally and submit it with the CLI (see teaching rules).
- Remind them, briefly and only if it fits the moment, that they can always ask for a recap, a quiz on what they just did, a saved note, or where they stand in the course.
- End with the next step: when you're ready for the next lesson, start a fresh chat (New Chat), then:
/start-1-3