Skip to content

Commit b16e9da

Browse files
ofriwclaude
andcommitted
Integrate ThreeContextWorkflow component into lesson 8
- Add component import and usage in lesson-8 documentation - Register component in RevealSlideshow registry - Add presentation style overrides for large visual component - Update presentation manifest with revised slide content and count 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 516e8b7 commit b16e9da

File tree

5 files changed

+213
-165
lines changed

5 files changed

+213
-165
lines changed

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

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ sidebar_label: 'Lesson 8: Tests as Guardrails'
44
title: 'Lesson 8: Tests as Guardrails'
55
---
66

7+
import ThreeContextWorkflow from '@site/src/components/VisualElements/ThreeContextWorkflow';
8+
79
AI agents can refactor half your codebase in minutes. They'll rename functions, restructure modules, and update dozens of files—all while you grab coffee. This velocity is powerful, but dangerous. Small logic errors compound fast when changes happen at scale.
810

911
Tests are your constraint system. They define operational boundaries agents cannot cross. More importantly, they're living documentation that agents read to understand intent, edge cases, and the gotchas that tribal knowledge usually covers.
@@ -52,7 +54,9 @@ When tests become the optimization target, agents optimize for passing tests rat
5254

5355
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.
5456

55-
**The three-context workflow:**
57+
## The three-context workflow:
58+
59+
<ThreeContextWorkflow />
5660

5761
1. **Write code** in Context A—research existing patterns using [grounding from Lesson 5](../methodology/lesson-5-grounding.md), plan implementation, execute, verify correctness
5862
2. **Write tests** in fresh Context B—research requirements and edge cases, plan test coverage, execute (agent doesn't remember writing implementation, so tests derive independently from requirements), verify tests fail initially

website/src/components/PresentationMode/RevealSlideshow.module.css

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -310,6 +310,13 @@
310310
max-height: 100%;
311311
}
312312

313+
/* Override constraints for large visual components */
314+
.visualContainer > :global(.three-context-workflow) {
315+
max-width: none;
316+
max-height: none;
317+
min-width: 85%;
318+
}
319+
313320
.takeawayList {
314321
text-align: left;
315322
font-size: clamp(0.9rem, 1.8vw, 1.1em);

website/src/components/PresentationMode/RevealSlideshow.tsx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ import styles from './RevealSlideshow.module.css';
1818
import CapabilityMatrix from '../VisualElements/CapabilityMatrix';
1919
import UShapeAttentionCurve from '../VisualElements/UShapeAttentionCurve';
2020
import WorkflowCircle from '../VisualElements/WorkflowCircle';
21+
import ThreeContextWorkflow from '../VisualElements/ThreeContextWorkflow';
2122
import GroundingComparison from '../VisualElements/GroundingComparison';
2223
import ContextWindowMeter from '../VisualElements/ContextWindowMeter';
2324
import AbstractShapesVisualization from '../VisualElements/AbstractShapesVisualization';
@@ -85,6 +86,7 @@ const VISUAL_COMPONENTS = {
8586
CapabilityMatrix,
8687
UShapeAttentionCurve,
8788
WorkflowCircle,
89+
ThreeContextWorkflow,
8890
GroundingComparison,
8991
ContextWindowMeter,
9092
AbstractShapesVisualization,

website/static/presentations/manifest.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,10 @@
5050
},
5151
"practical-techniques/lesson-8-tests-as-guardrails.md": {
5252
"presentationUrl": "/presentations/practical-techniques/lesson-8-tests-as-guardrails.json",
53-
"slideCount": 11,
54-
"estimatedDuration": "40-50 minutes",
55-
"title": "Lesson 8: Tests as Guardrails",
56-
"generatedAt": "2025-11-09T06:39:21.041Z"
53+
"slideCount": 14,
54+
"estimatedDuration": "35-40 minutes",
55+
"title": "Tests as Guardrails",
56+
"generatedAt": "2025-11-10T17:57:08.835Z"
5757
},
5858
"practical-techniques/lesson-9-reviewing-code.md": {
5959
"presentationUrl": "/presentations/practical-techniques/lesson-9-reviewing-code.json",

0 commit comments

Comments
 (0)