Regenerated presentations and excluded with/without grounding component from presentations

Author: ofriw

scripts/generate-presentation.js

@@ -923,8 +923,8 @@ async function generatePresentation(filePath, manifest, config) {
   console.log(`\n📄 Generating presentation: ${relativePath}`);
 
   try {
-    // Parse content
-    const content = parseMarkdownContent(filePath);
+    // Parse content in presentation mode
+    const content = parseMarkdownContent(filePath, 'presentation');
 
     if (content.length < 100) {
       console.log(`  ⚠️  Skipping - content too short`);

scripts/lib/markdown-parser.js

@@ -120,9 +120,10 @@ export function extractCodeSummary(code, language) {
 /**
  * Parse MDX/MD file and extract clean text content
  * @param {string} filePath - Path to MDX/MD file
+ * @param {string} mode - Rendering mode: 'doc' (default) or 'presentation'
  * @returns {string} Cleaned text content with code blocks described
  */
-export function parseMarkdownContent(filePath) {
+export function parseMarkdownContent(filePath, mode = 'doc') {
   const content = readFileSync(filePath, 'utf-8');
 
   // Remove frontmatter
@@ -132,6 +133,21 @@ export function parseMarkdownContent(filePath) {
   // Replace with clear markers so LLM can detect them
   cleaned = cleaned.replace(/<([A-Z][a-zA-Z]*)\s*\/>/g, '[VISUAL_COMPONENT: $1]');
 
+  // Process conditional blocks based on mode
+  if (mode === 'presentation') {
+    // Strip doc-only blocks
+    cleaned = cleaned.replace(/<!--\s*doc-only-start\s*-->[\s\S]*?<!--\s*doc-only-end\s*-->/g, '');
+    // Preserve presentation-only blocks (but remove markers)
+    cleaned = cleaned.replace(/<!--\s*presentation-only-start\s*-->\n?/g, '');
+    cleaned = cleaned.replace(/\n?<!--\s*presentation-only-end\s*-->/g, '');
+  } else {
+    // Strip presentation-only blocks
+    cleaned = cleaned.replace(/<!--\s*presentation-only-start\s*-->[\s\S]*?<!--\s*presentation-only-end\s*-->/g, '');
+    // Preserve doc-only blocks (but remove markers)
+    cleaned = cleaned.replace(/<!--\s*doc-only-start\s*-->\n?/g, '');
+    cleaned = cleaned.replace(/\n?<!--\s*doc-only-end\s*-->/g, '');
+  }
+
   // Remove remaining HTML tags (lowercase = HTML elements)
   cleaned = cleaned.replace(/<[^>]+>/g, '');
 

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

@@ -13,7 +13,28 @@ Here's the fundamental issue: **The agent doesn't know your codebase exists.** I
 
 **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.
 
+<!-- doc-only-start -->
 <GroundingComparison />
+<!-- doc-only-end -->
+
+<!-- presentation-only-start -->
+
+**Without Grounding:**
+
+- Works from generic training patterns frozen at Jan 2025
+- Guesses your architecture and libraries
+- Hallucinates plausible implementations that don't match your codebase
+- Misses current security vulnerabilities and API changes
+- Confidently wrong solutions built from statistical patterns
+
+**With Grounding:**
+
+- Works from your actual codebase (ChunkHound retrieves real code)
+- Uses current documentation (ArguSeek fetches latest API docs)
+- Aware of recent security advisories and breaking changes
+- Follows your existing patterns and architecture
+- Solutions that integrate cleanly with your system
+<!-- presentation-only-end -->
 
 ## The Discovery Problem: Agentic Search
 

website/static/presentations/intro.json

@@ -2,78 +2,78 @@
   "intro.md": {
     "presentationUrl": "/presentations/intro.json",
     "slideCount": 11,
-    "estimatedDuration": "35-45 minutes",
-    "title": "Operator Training: AI Coding Assistants in Production",
-    "generatedAt": "2025-11-09T10:34:22.957Z"
+    "estimatedDuration": "25-35 minutes",
+    "title": "Introduction: Operating AI Coding Agents",
+    "generatedAt": "2025-11-10T17:45:41.295Z"
   },
   "methodology/lesson-3-high-level-methodology.md": {
     "presentationUrl": "/presentations/methodology/lesson-3-high-level-methodology.json",
-    "slideCount": 12,
-    "estimatedDuration": "45-60 minutes",
+    "slideCount": 11,
+    "estimatedDuration": "40-50 minutes",
     "title": "Lesson 3: High-Level Methodology",
-    "generatedAt": "2025-11-10T15:59:19.399Z"
+    "generatedAt": "2025-11-10T17:46:43.772Z"
   },
   "methodology/lesson-4-prompting-101.md": {
     "presentationUrl": "/presentations/methodology/lesson-4-prompting-101.json",
-    "slideCount": 12,
-    "estimatedDuration": "40-50 minutes",
+    "slideCount": 11,
+    "estimatedDuration": "35-45 minutes",
     "title": "Lesson 4: Prompting 101",
-    "generatedAt": "2025-11-10T08:30:24.339Z"
+    "generatedAt": "2025-11-10T17:47:50.750Z"
   },
   "methodology/lesson-5-grounding.md": {
     "presentationUrl": "/presentations/methodology/lesson-5-grounding.json",
     "slideCount": 12,
     "estimatedDuration": "40-50 minutes",
-    "title": "Lesson 5: Grounding - Keeping AI Agents Tethered to Reality",
-    "generatedAt": "2025-11-09T06:35:22.963Z"
+    "title": "Grounding: Injecting Reality Into Agents",
+    "generatedAt": "2025-11-10T18:01:50.781Z"
   },
   "practical-techniques/lesson-10-debugging.md": {
     "presentationUrl": "/presentations/practical-techniques/lesson-10-debugging.json",
-    "slideCount": 11,
+    "slideCount": 13,
     "estimatedDuration": "35-45 minutes",
-    "title": "Debugging with AI Agents",
-    "generatedAt": "2025-11-10T11:19:45.844Z"
+    "title": "Lesson 10: Debugging with AI Agents",
+    "generatedAt": "2025-11-10T17:50:14.774Z"
   },
   "practical-techniques/lesson-6-project-onboarding.md": {
     "presentationUrl": "/presentations/practical-techniques/lesson-6-project-onboarding.json",
     "slideCount": 11,
     "estimatedDuration": "35-45 minutes",
-    "title": "Lesson 6: Project Onboarding - Context Files & AI Memory",
-    "generatedAt": "2025-11-09T06:37:14.278Z"
+    "title": "Lesson 6: Project Onboarding",
+    "generatedAt": "2025-11-10T17:51:58.268Z"
   },
   "practical-techniques/lesson-7-planning-execution.md": {
     "presentationUrl": "/presentations/practical-techniques/lesson-7-planning-execution.json",
-    "slideCount": 12,
-    "estimatedDuration": "45-60 minutes",
-    "title": "Planning & Execution: Grounding Agents in Your Codebase",
-    "generatedAt": "2025-11-09T06:38:15.228Z"
+    "slideCount": 14,
+    "estimatedDuration": "35-40 minutes",
+    "title": "Lesson 7: Planning & Execution",
+    "generatedAt": "2025-11-10T17:53:03.438Z"
   },
   "practical-techniques/lesson-8-tests-as-guardrails.md": {
     "presentationUrl": "/presentations/practical-techniques/lesson-8-tests-as-guardrails.json",
-    "slideCount": 11,
+    "slideCount": 12,
     "estimatedDuration": "40-50 minutes",
-    "title": "Lesson 8: Tests as Guardrails",
-    "generatedAt": "2025-11-09T06:39:21.041Z"
+    "title": "Tests as Guardrails",
+    "generatedAt": "2025-11-10T17:54:23.212Z"
   },
   "practical-techniques/lesson-9-reviewing-code.md": {
     "presentationUrl": "/presentations/practical-techniques/lesson-9-reviewing-code.json",
     "slideCount": 12,
-    "estimatedDuration": "35-45 minutes",
+    "estimatedDuration": "45-60 minutes",
     "title": "Lesson 9: Reviewing Code",
-    "generatedAt": "2025-11-10T12:26:26.417Z"
+    "generatedAt": "2025-11-10T17:55:34.768Z"
   },
   "understanding-the-tools/lesson-1-intro.md": {
     "presentationUrl": "/presentations/understanding-the-tools/lesson-1-intro.json",
-    "slideCount": 11,
+    "slideCount": 12,
     "estimatedDuration": "40-50 minutes",
-    "title": "Understanding the Tools: Lesson 1 - Introduction to AI Agents",
-    "generatedAt": "2025-11-09T11:14:16.616Z"
+    "title": "Lesson 1: Introduction - Understanding AI Agents",
+    "generatedAt": "2025-11-10T17:56:38.823Z"
   },
   "understanding-the-tools/lesson-2-understanding-agents.md": {
     "presentationUrl": "/presentations/understanding-the-tools/lesson-2-understanding-agents.json",
-    "slideCount": 12,
-    "estimatedDuration": "35-45 minutes",
+    "slideCount": 11,
+    "estimatedDuration": "35-50 minutes",
     "title": "Understanding Agents",
-    "generatedAt": "2025-11-10T14:57:50.229Z"
+    "generatedAt": "2025-11-10T17:58:00.131Z"
   }
 }