Skip to content

Commit c2c2ba4

Browse files
committed
Update lesson-3-high-level-methodology.md
1 parent 390b4a1 commit c2c2ba4

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

website/docs/methodology/lesson-3-high-level-methodology.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -35,15 +35,15 @@ Before diving into the workflow, let's be explicit about the role shift. When wo
3535

3636
**Operator workflow:**
3737

38-
- Understand the system (mental model)
39-
- Research context and patterns
40-
- Plan the change architecturally
38+
- Map the system (modules, boundaries, data flow)
39+
- Research existing patterns and constraints
40+
- Plan the change at the architecture level
4141
- Direct the agent with precise context
42-
- Validate outcomes against requirements
42+
- Validate behavior against your mental model
4343

44-
Notice what's missing from the second list: writing implementation code, reading every line, debugging syntax errors. The agent handles those. Your cognitive load shifts entirely to architectural thinking—understanding how pieces fit together, what patterns to follow, what constraints matter, and what risks exist.
44+
Notice what's missing from the second list: writing implementation code, reading every line, debugging syntax errors. The agent handles those. Your cognitive load shifts entirely to system-level thinking—module boundaries and responsibilities, inputs and outputs, state management, and the contracts between components.
4545

46-
This doesn't mean you never read code. It means you read _selectively_. When an agent generates 50 files, you don't review them line by line. You review the architecture: Does it follow our patterns? Does it handle the security boundaries? Does it integrate correctly? You spot-check where your mental model says "this is risky" or "this is too complex."
46+
This doesn't mean you never read code. It means you read _selectively_. When an agent generates 50 files, you don't review them line by line. You review at the system level: Are module responsibilities correct? Do inputs and outputs match expectations? Is state managed where it should be? Do the integration points work? You spot-check where your mental model says "this is risky" or "this is too complex."
4747

4848
Here's the counterintuitive reality: **properly prompted AI-generated code is often easier to read than hand-written code**. LLMs follow patterns with mechanical precision across thousands of lines. When you provide quality patterns and clear constraints, they replicate them perfectly. You're not sacrificing quality by delegating to agents—you're achieving structural consistency at a scale individual craftsmanship can't match. Your job shifts from ensuring every implementation detail is correct to ensuring the patterns themselves are correct.
4949

0 commit comments

Comments
 (0)