Skip to content

Commit cc19b6c

Browse files
committed
Update lesson-7-planning-execution.md
1 parent c3e91d8 commit cc19b6c

File tree

1 file changed

+21
-4
lines changed

1 file changed

+21
-4
lines changed

website/docs/practical-techniques/lesson-7-planning-execution.md

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,14 @@ Review the "why" behind the plan, not just the "what." If the agent says "Implem
117117

118118
**Example:** Agent proposes caching user sessions in Redis with 24-hour TTL. Good plan—but did it check your existing session implementation? Did it consider GDPR compliance for session data? Did it account for cache invalidation when users change passwords?
119119

120-
If grounding was shallow, stop and add context before execution. "Before implementing, research our existing session management, check for compliance requirements in COMPLIANCE.md, and propose cache invalidation strategy for security-critical events. Use ArguSeek, validate the approach against current security best practices."
120+
If grounding was shallow, stop and add context before execution:
121+
122+
```markdown
123+
Before implementing, research our existing session management,
124+
check for compliance requirements in COMPLIANCE.md, and propose cache
125+
invalidation strategy for security-critical events.
126+
Use ArguSeek, validate the approach against current security best practices.
127+
```
121128

122129
### Glance Over Suggested Changes
123130

@@ -133,7 +140,12 @@ This is high-level architectural fit, not line-by-line code review (validation c
133140

134141
**Example:** Agent plans to add email validation by creating a new validation library in `src/lib/validators/`. But you already have Zod schemas in `src/validation/`. This is a grounding failure—the agent generated a plausible solution from training patterns instead of discovering your existing validation approach.
135142

136-
Stop and correct: "We use Zod for validation—check `src/validation/userSchema.ts` and follow that pattern instead of creating a new library."
143+
Stop and correct:
144+
145+
```markdown
146+
We use Zod for validation—check `src/validation/userSchema.ts` and follow that
147+
pattern instead of creating a new library.
148+
```
137149

138150
**Why this matters:** Catching grounding failures at the planning stage is faster than rewriting generated code. If the plan reveals shallow grounding, add constraints and force deeper research before execution.
139151

@@ -181,7 +193,12 @@ git worktree add ../project-bugfix bugfix/login-error
181193

182194
Modern terminal options worth exploring: [**Ghostty**](https://ghostty.org) (fast, GPU-accelerated, native), [**Kitty**](https://sw.kovidgoyal.net/kitty/) (GPU-based, extensive graphics support), [**WezTerm**](https://wezterm.org) (Lua-configured, cross-platform), and [**Alacritty**](https://alacritty.org) (minimalist, OpenGL-accelerated). Each offers different customization approaches—compare based on your workflow needs.
183195

184-
**Use ArguSeek to learn terminal customization.** Research best practices for your chosen terminal, especially around session management, keybindings for rapid context switching, notification configuration, and visual indicators for different agent contexts. Example prompt: "Use ArguSeek to research Kitty terminal customization for managing multiple development sessions with different contexts and long-running processes."
196+
**Use ArguSeek to learn terminal customization.** Research best practices for your chosen terminal, especially around session management, keybindings for rapid context switching, notification configuration, and visual indicators for different agent contexts. Example prompt:
197+
198+
```markdown
199+
Use ArguSeek to research Kitty terminal customization for managing multiple
200+
development sessions with different contexts and long-running processes.
201+
```
185202

186203
### Modern CLI Tools for Efficient Workflows
187204

@@ -217,7 +234,7 @@ The agent will research worktree workflows, propose a clean directory layout, an
217234

218235
### Mix CLI and UI Tools: Use What Works
219236

220-
Don't be dogmatic about terminal-only or GUI-only workflows. IDEs remain the best tools for code navigation, symbol search, and refactoring. CLI excels at quick edits, git operations, and managing parallel sessions.
237+
Don't be dogmatic about terminal-only or GUI-only workflows. IDEs remain the best tools for code navigation, symbol search, and viewing large files. CLI excels at quick edits, git operations, and managing parallel sessions.
221238

222239
**Use the best tool for each task:**
223240

0 commit comments

Comments
 (0)