Why diagrams and context matter

John Lindquist is the co-founder of egghead.io and an expert in leveraging AI tools for professional software development. In this episode, John shares advanced techniques for using AI coding tools like Claude Code and Cursor that go far beyond basic prompting. He demonstrates how senior engineers can use mermaid diagrams for context loading, create custom hooks for automated code quality checks, and build efficient command-line tools that streamline AI workflows.

What you’ll learn:

1. How to use mermaid diagrams to preload context into Claude Code for faster, more accurate coding assistance
2. Creating custom hooks in Claude Code to automatically check for TypeScript errors and commit working code
3. Building efficient command-line aliases and tools to streamline your AI workflows
4. Techniques for using AI to generate documentation that works for both humans and machines
5. How to leverage AI for code investigation and orientation when tackling unfamiliar codebases
6. Strategies for resetting AI conversations when they go off track

—

Brought to you by:

WorkOS—Make your app enterprise-ready today

Tines—Start building intelligent workflows today

—

In this episode, we cover:

(00:00) Introduction to John Lindquist

(03:15) Using context and diagrams to provide context to AI tools

(05:38) Demo: Mermaid diagrams

(06:48) Preloading context with system prompts in Claude Code

(10:30) The rise of specialized file formats for AI consumption

(13:23) Mermaid diagram use cases

(19:01) Demo: Creating aliases for common AI commands

(21:05) Building custom command-line tools for AI workflows

(26:39) Demo: Setting up stop hooks for automated code quality checks

(35:16) Investing in quality outputs

(36:40) Additional use cases for hooks beyond code quality

(39:19) Quick review

(41:14) Terminal UI vs. IDE

(45:35) Selling AI to skeptical teams

(51:57) Prompting reset tricks

—

Tools referenced:

• Claude Code: https://claude.ai/

• Cursor: https://cursor.sh/

• Gemini: https://gemini.google.com/

—

Other references:

• Zsh: https://www.zsh.org/

• GitHub: https://github.com/

• TypeScript: https://www.typescriptlang.org/

• Bun: https://bun.sh/

• Claude hooks: https://code.claude.com/docs/en/hooks

—

Where to find John Lindquist:

Website: https://egghead.io

Newsletter: https://egghead.io/newsletters/ai-dev-essentials

LinkedIn: linkedin.com/in/john-lindquist-84230766

X: https://x.com/johnlindquist

—

Where to find Claire Vo:

ChatPRD: https://www.chatprd.ai/

Website: https://clairevo.com/

LinkedIn: https://www.linkedin.com/in/clairevo/

X: https://x.com/clairevo

—

Production and marketing by https://penname.co/. For inquiries about sponsoring the podcast, email jordan@penname.co.