Rename module from understanding-the-tools to fundamentals

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: ofriw

README.md

@@ -12,7 +12,7 @@ This course teaches systematic approaches to using AI coding assistants effectiv
 
 The course is organized into three modules with 10 hands-on lessons:
 
-1. **[Understanding the Tools](website/docs/understanding-the-tools)** - Mental models and architecture (Lessons 1-2)
+1. **[Fundamentals](website/docs/fundamentals)** - Mental models and architecture (Lessons 1-2)
 2. **[Methodology](website/docs/methodology)** - Prompting, grounding, workflow design (Lessons 3-5)
 3. **[Practical Techniques](website/docs/practical-techniques)** - Onboarding, planning, testing, reviewing, debugging (Lessons 6-10)
 
@@ -90,9 +90,9 @@ Serves the production build locally for testing.
 website/
 ├── docs/                              # Course modules and lessons
 │   ├── intro.md                       # Course introduction
-│   ├── understanding-the-tools/       # Module 1: Mental models
-│   │   ├── lesson-1-intro.md
-│   │   └── lesson-2-understanding-agents.md
+│   ├── fundamentals/                  # Module 1: Mental models
+│   │   ├── lesson-1-how-llms-work.md  # Lesson 1: LLMs Demystified
+│   │   └── lesson-2-how-agents-work.md # Lesson 2: Agents Demystified
 │   ├── methodology/                   # Module 2: Core techniques
 │   │   ├── lesson-3-high-level-methodology.md
 │   │   ├── lesson-4-prompting-101.md

scripts/PRESENTATION_README.md

@@ -36,7 +36,7 @@ node scripts/generate-presentation.js
 node scripts/generate-presentation.js --file intro.md
 
 # Generate for all files in a module
-node scripts/generate-presentation.js --module understanding-the-tools
+node scripts/generate-presentation.js --module fundamentals
 
 # Generate for all lessons
 node scripts/generate-presentation.js --all

scripts/README.md

@@ -93,17 +93,17 @@ Runs the original single-stage script (generates dialog inline without saving)
 output/podcasts/
 ├── manifest.json
 ├── intro.md
-├── understanding-the-tools/
-│   ├── lesson-1-intro.md
-│   └── lesson-2-understanding-agents.md
+├── fundamentals/
+│   ├── lesson-1-how-llms-work.md
+│   └── lesson-2-how-agents-work.md
 └── methodology/
     └── lesson-3-high-level-methodology.md
 ```
 
 **Script Format:**
 ```markdown
 ---
-source: understanding-the-tools/lesson-1-intro.md
+source: fundamentals/lesson-1-how-llms-work.md
 speakers:
   - name: Alex
     role: Instructor
@@ -129,13 +129,13 @@ Sam: I've been using them for a few months now...
 **Manifest:** `website/static/audio/manifest.json`
 ```json
 {
-  "understanding-the-tools/lesson-1-intro.md": {
-    "audioUrl": "/audio/understanding-the-tools/lesson-1-intro.wav",
+  "fundamentals/lesson-1-how-llms-work.md": {
+    "audioUrl": "/audio/fundamentals/lesson-1-how-llms-work.wav",
     "size": 1234567,
     "format": "audio/wav",
     "tokenCount": 5234,
     "generatedAt": "2025-11-01T12:34:56.789Z",
-    "scriptSource": "understanding-the-tools/lesson-1-intro.md"
+    "scriptSource": "fundamentals/lesson-1-how-llms-work.md"
   }
 }
 ```

scripts/audit-presentations.js

@@ -161,8 +161,8 @@ function main() {
     'practical-techniques/lesson-8-tests-as-guardrails.json',
     'practical-techniques/lesson-9-reviewing-code.json',
     'practical-techniques/lesson-10-debugging.json',
-    'understanding-the-tools/lesson-1-intro.json',
-    'understanding-the-tools/lesson-2-understanding-agents.json'
+    'fundamentals/lesson-1-how-llms-work.json',
+    'fundamentals/lesson-2-how-agents-work.json'
   ];
 
   console.log('📊 Auditing presentations for violations\n');

website/docs/CLAUDE.md

@@ -207,12 +207,12 @@ Each lesson should reference prerequisites when needed:
 ```markdown
 **Prerequisites:**
 
-- Completed [Understanding the Tools](../understanding-the-tools/index.md) (all lessons)
+- Completed [Fundamentals](../fundamentals/lesson-1-how-llms-work.md) (all lessons)
 - Understanding of REST API design
 ```
 
 ### Progressive Disclosure
 
 - Build on previous concepts
 - Reference earlier examples when relevant
-- Link to related lessons: `[See Lesson 2](../understanding-the-tools/lesson-2-understanding-agents.md)`
+- Link to related lessons: `[See Lesson 2: Agents Demystified](../fundamentals/lesson-2-how-agents-work.md)`

…nderstanding-the-tools/lesson-1-intro.md …s/fundamentals/lesson-1-how-llms-work.mdwebsite/docs/understanding-the-tools/lesson-1-intro.md renamed to website/docs/fundamentals/lesson-1-how-llms-work.md website/docs/understanding-the-tools/lesson-1-intro.md renamed to website/docs/fundamentals/lesson-1-how-llms-work.md

@@ -1,7 +1,7 @@
 ---
 sidebar_position: 1
-sidebar_label: 'Lesson 1: Introduction'
-title: 'Introduction to AI Agent-Driven Development'
+sidebar_label: 'Lesson 1: LLMs Demystified'
+title: 'Lesson 1: LLMs Demystified'
 ---
 
 Welcome to the future of software engineering. This course teaches you to **operate AI agents** that autonomously execute complex development tasks - from specification to deployment.
@@ -127,4 +127,4 @@ The next lesson covers agent architecture, execution workflows, and how your rol
 
 ---
 
-**Next:** [Lesson 2: Understanding Agents](../understanding-the-tools/lesson-2-understanding-agents.md)
+**Next:** [Lesson 2: Agents Demystified](./lesson-2-how-agents-work.md)

…e-tools/lesson-2-understanding-agents.md …fundamentals/lesson-2-how-agents-work.mdwebsite/docs/understanding-the-tools/lesson-2-understanding-agents.md renamed to website/docs/fundamentals/lesson-2-how-agents-work.md website/docs/understanding-the-tools/lesson-2-understanding-agents.md renamed to website/docs/fundamentals/lesson-2-how-agents-work.md

@@ -1,7 +1,7 @@
 ---
 sidebar_position: 2
-sidebar_label: 'Lesson 2: Understanding Agents'
-title: 'Understanding Agents'
+sidebar_label: 'Lesson 2: Agents Demystified'
+title: 'Lesson 2: Agents Demystified'
 ---
 
 import AbstractShapesVisualization from '@site/src/components/VisualElements/AbstractShapesVisualization';

website/docs/intro.md

@@ -1,7 +1,7 @@
 ---
 sidebar_position: 1
 slug: /
-title: 'AI Coding for Senior Engineers'
+title: 'Introduction'
 ---
 
 ## The Reality
@@ -43,7 +43,7 @@ You're the target audience if you:
 
 **Sequential consumption recommended.** Each module builds on previous concepts:
 
-1. Module 1: Understanding the Tools - Mental models and architecture
+1. Module 1: Fundamentals - Mental models and architecture
 2. Module 2: Methodology - Prompting, grounding, workflow design
 3. Module 3: Practical Techniques - Onboarding, planning, testing, reviewing, debugging
 
@@ -79,4 +79,4 @@ This isn't marketing. It's validation. If these techniques can produce productio
 
 ---
 
-**Ready to start?** Begin with [Understanding the Tools](/docs/understanding-the-tools/lesson-1-intro).
+**Ready to start?** Begin with [Lesson 1: LLMs Demystified](/docs/fundamentals/lesson-1-how-llms-work).

website/docs/methodology/lesson-5-grounding.md

@@ -9,7 +9,7 @@ import GroundingComparison from '@site/src/components/VisualElements/GroundingCo
 
 You ask your agent to fix the authentication bug. It confidently generates a solution using JWT verification patterns... that don't exist in your codebase. You use sessions, not JWTs. The agent just hallucinated a plausible implementation based on common patterns from its training data.
 
-Here's the fundamental issue: **The agent doesn't know your codebase exists.** It doesn't know your architecture, your patterns, or your constraints. As covered in [Lesson 2](/docs/understanding-the-tools/lesson-2-understanding-agents), the context window is the agent's entire world—everything else doesn't exist. Without explicit grounding in your actual code and current documentation, agents generate statistically plausible solutions that may be completely wrong for your system.
+Here's the fundamental issue: **The agent doesn't know your codebase exists.** It doesn't know your architecture, your patterns, or your constraints. As covered in [Lesson 2: Agents Demystified](/docs/fundamentals/lesson-2-how-agents-work), the context window is the agent's entire world—everything else doesn't exist. Without explicit grounding in your actual code and current documentation, agents generate statistically plausible solutions that may be completely wrong for your system.
 
 **Grounding is how you inject reality into the context window.** You retrieve relevant external information—your codebase patterns, current docs, best practices—and feed it to the agent before generation. This lesson covers the engineering techniques that anchor agents in your actual system instead of hypothetical ones.
 

website/docs/practical-techniques/lesson-8-tests-as-guardrails.md

@@ -42,7 +42,7 @@ When tests become the optimization target, agents optimize for passing tests rat
 
 :::
 
-Apply the same planning and execution methodology from [Lesson 7](./lesson-7-planning-execution.md) to each step—writing code, writing tests, and triaging failures. Each follows the same pattern: research requirements, plan approach, execute, verify. The critical difference: use **fresh contexts** for each step. This leverages the stateless nature from [Lessons 1](../understanding-the-tools/lesson-1-intro.md) and [2](../understanding-the-tools/lesson-2-understanding-agents.md)—the agent doesn't carry assumptions or defend prior decisions between contexts.
+Apply the same planning and execution methodology from [Lesson 7](./lesson-7-planning-execution.md) to each step—writing code, writing tests, and triaging failures. Each follows the same pattern: research requirements, plan approach, execute, verify. The critical difference: use **fresh contexts** for each step. This leverages the stateless nature from [Lesson 1: LLMs Demystified](../fundamentals/lesson-1-how-llms-work.md) and [Lesson 2: Agents Demystified](../fundamentals/lesson-2-how-agents-work.md)—the agent doesn't carry assumptions or defend prior decisions between contexts.
 
 ## The three-context workflow: