Advanced Claude Code techniques: context loading, mermaid diagrams, stop hooks, and more | John Lindquist

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: How to use mermaid diagrams to preload context into Claude Code for faster, more accurate coding assistanceCreating custom hooks in Claude Code to automatically check for TypeScript errors and commit working codeBuilding efficient command-line aliases and tools to streamline your AI workflowsTechniques for using AI to generate documentation that works for both humans and machinesHow to leverage AI for code investigation and orientation when tackling unfamiliar codebasesStrategies for resetting AI conversations when they go off track— Brought to you by: WorkOS https://workos.com/?utm_source=lennys_howiai&utm_medium=podcast&utm_campaign=q22025—Make your app enterprise-ready today Tines https://tines.com/howiai—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 https://egghead.io/ Newsletter: https://egghead.io/newsletters/ai-dev-essentials LinkedIn: linkedin.com/in/john-lindquist-84230766 http://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 [email protected].

Speaker names marked ? are inferred from speaking time and the show’s known hosts — they are not voice-verified.

• 0:00Claire Vo?

  There are people out there definitely like me that really want to know the advanced techniques that can leverage the most powerful parts of these AI-powered coding tools. Where do you want us to get started that you think many people don't think about in terms of how they can use these tools?

• 0:15Speaker 01

  Context and diagrams is a great place to start. They're definitely the best way to get AI to do what you want. So they have what are called mermaid diagrams. This is a way of visualizing database operations. And it's a way of essentially compressing your application down into very small lines of text that show how your application works. Now, for a human to read this, this is a big challenge. But an AI can consume this easily. I could even just say, please explain the authentication flow. And because it already has it in the context, it's not going to have to do a bunch of file reads and codebase exploration to figure this out. It's going to come up with the results much quicker.

• 0:53Claire Vo?

  If I gave you infinite junior to mid-career talent, who is always available, who would do the work you would do if you had unlimited amount of time and no meetings, what would you do when a ticket came in? Like, what would you do?

• 1:10Claire Vo?

  Welcome back to How I AI. I'm Claire Vowell, product leader and AI obsessive, here on a mission to help you build better with these new tools. Today, we have John Lindquist at egghead.io, who is a super user of AI-powered engineering tools like Cursor and Claude Code. Now, I love all you non-technical folks out there, but this is an episode for the senior software engineers who really want to understand how they can use the power features of some of these AI engineering tools to really both optimize the quality of code that they're generating, but also become more efficient as they use their IDE, terminal, and AI assistants to write, check, and deploy code.

• 1:55Claire Vo?

  This is a great episode for any of our advanced users out there, VPs of engineering, CTO, pay attention, send this to your staff engineers. Let's get to it. This episode is brought to you by WorkOS. AI has already changed how we work. Tools are helping teams write better code, analyze customer data, and even handle support tickets automatically. But there's a catch. These tools only work well when they have deep access to company systems. Your copilot needs to see your entire codebase. Your chatbot needs to search across internal docs. And for enterprise buyers, that raises serious security concerns. That's why these apps face intense IT scrutiny from day one. To pass, they need secure authentication,

• 2:39Claire Vo?

  access controls, audit logs, the whole suite of enterprise features. Building all that from scratch? It's a massive lift. That's where WorkOS comes in. WorkOS gives you drop-in APIs for enterprise features so your app can become enterprise-ready and scale up market faster. Think of it like Stripe for enterprise features. OpenAI, Perplexity, and Cursor are already using WorkOS to move faster and meet enterprise demands. Join them and hundreds of other industry leaders at workos.com. Start building today. John, welcome to How I AI. I have to put some context here,

• 3:20Claire Vo?

  which is we have done quite a bit of coding with Cursor, vibe coding episodes, but a lot of what our audience has asked for is early maturity, less technical introductions to these tools. But there are people out there, definitely like me and definitely like folks that follow you, that really do know how to write great software and want to, as people say, "Of course, I'm a 9X engineer, but how do I become a 10X engineer?" With some of these tools, want to know really the advanced techniques that can leverage the most powerful parts of these AI-powered coding tools and get you really high-quality software. So I'm really excited about what you're going to show us today. And so where do you want us to get started

• 4:05Claire Vo?

  that you think many people don't think about in terms of how they can use these tools?

• 4:09Speaker 01

  Yeah, I think context and diagrams is a great place to start for us. They're definitely the... Best way to get AI to do what you want. So and we'll be using Claude code throughout.

• 4:21Claire Vo?

  Oh, great. Okay. And so, yeah, we've, we've gotten a lot of kind of markdown files in how AI, but not a lot of diagrams. So why don't you walk us through how you use those, those assets to help you code better?

• 4:38Speaker 01

  Yeah, so these diagrams are all generated from, I can share a prompt with however you want to share with the audience, that can walk through code base and generate diagrams based on user actions or user interactions, the events, the channels, whatever happens in your code to help the AI understand the flow and how the pieces are connected. I think Windsurf recently came out with something called code maps, a similar concept,

• 5:05Speaker 01

  essentially preloading valuable context so that you have to remember that every time an AI starts, it has no memory, no idea of what's going on in your application. And people try and set up lots of rules and all this stuff around it. But they usually don't include a lot of how does my application work? And how do the pieces fit? And so you get a lot of really bad edits because it doesn't understand if it modifies A, how does that impact B?

• 5:35Speaker 01

  So we want to preload a lot of that. We can do that using diagrams. So for example, one of these diagrams will have, I call it their markdown files with diagrams in them. So they have what are called Mermaid diagrams. And Mermaid is a standard format for rendering diagrams inside of Markdown. So this is a, a way of visualizing database operations. And if you're to zoom, zoom in and look at how if a record exists, then do this and that, yes, no. And it's a, a way of essentially compressing your application down into very small lines of text that show how your application works. Now, for a human to read this, this is a big challenge.

• 6:19Speaker 01

  We need to open up this big visual and it turns into like, looks like an image. But an AI can consume this easily. And it's like a very compressed, very robust way of explaining an application. So we can feed these into our application at the startup time. And for the more advanced, or the larger projects you get on, the more diagrams you'll have, and you can kind of pick and choose which ones to load. I'm going to load them all in, and I'm just going to open a terminal up in the editor area. So the way I'm going to do this, if you look at Claude and we look at its options,

• 7:00Speaker 01

  you'll see a bunch of options. The one we're going to focus on is called "Append System Prompt." So in there, before we load in any sort of user prompt or anything, we're actually going to say Claude "Append System Prompt," and then you can drop in some text. And we're going to drop in a command. This command can read in from our memory, from AI slash diagrams. And then this is going to read through, this is called a glob pattern, read through all of the markdown files, essentially force them into Claude once I do this.

• 7:43Speaker 01

  So this is reading all the files, all the markdown files, and this is, Cat will kind of concatenate them all together into a single text stream.

• 7:53Claire Vo?

  Yeah, one thing I want to call out for folks that are watching this, that, or are listening and maybe not watching, is two things. It seems like, you know, in your standard repos, you're creating a memory directory where you're going to structure some of the context and files you might want any of these AI tools to use. And I think everybody's like, "Oh yeah, I've created my agent's markdown file or my Claude one." And I think you can actually structure your context for these tools a lot more purposely. And so I think this is a really good example of this. The other thing that I think a lot of people are quite lazy about is they haven't explored the surface area of all the system commands available in Claude code.

• 8:36Claire Vo?

  And so by using that help command, you can actually see things that, not just chatting with Claude code you can do, but you can actually inject into how Claude operates. And "Append System Prompt" is one of those ones that I think people probably underuse.

• 8:51Speaker 01

  Yeah, absolutely. It's one I use constantly. Great points there. So when I let this run, you'll notice that there's, it's now prompting the user to do something. And we don't have to try and reference all the files, which you don't really do with at. We don't have to try and tell it, you know, what we're going to work on. I could even just say, like, I use dictation all the time. Please explain the authentication flow.

• 9:23Speaker 01

  And because it already has it in the context, it's not going to have to do a bunch of file reads and code base exploration to figure this out. It's going to come up the results much quicker. This does come at the cost of a lot more context, a lot more tokens being used upfront, but the work that you do, the time that you spend on these tasks is more valuable than that to me. So you'll notice that there were no file reads in this. There were no,

• 9:56Speaker 01

  it did not search the code base. It didn't do any of that stuff. It just simply had all that in context. And now I could take this and look through it, start creating plans, a swapword of plan mode to how we want to update and change authentication. So this saves, again, the trade off here is the cost of many tokens upfront. But the value is you get a lot faster and a lot more valuable output. As the tasks complete much faster, the tasks are much more reliable because it understands what's going on in the code base.

• 10:31Claire Vo?

  Two things I think people should think about with this flow. One is, I've said this in a couple of episodes, and we'll call it out again in yours, is I think that with LLM starting to become more of a part of how we do work and feed context and understand things like documentation or business context. This is the era of the file type. And I think so many people think about Markdown and JSON files. As effective ways to inject context into LLMs. I see a lot of course markdown files. I think more people now write markdown than they have in many, many years. And then a lot of, we've had some episodes on using JSON, for example, to put realistic

• 11:15Claire Vo?

  or semi-realistic data into prototypes. But we're having more and more episodes where people are discovering specific file types that have a specific context structure that are really useful for a use case. In this one, you have Mermaid diagrams, which again are hard to parse as a human. And even if they turn into graphics, are still hard to parse as a human. Like, I looked at that big diagram and my eyes crossed and I said, I don't want to, I don't want to read this. But to a machine, it's very effective. We've also, in some episodes, talked about image and multimedia file formats that not only contain image data, but contain metadata that you can use.

• 11:56Claire Vo?

  And so I think this is an interesting moment where we can all use different file types in a more extensive way than our kind of human brains could, because the machines are so good at using the different components, structures, or syntax of those files. So I think that's pretty interesting. And I think Mermaid diagrams are one of those examples of something that can be used really well.

• 12:16Speaker 01

  Yeah, absolutely. There's a lot of research being done into how they can compress all of this information down into like a single image. So if I could take all of the diagram files and somehow come up with an image format that would store everything in there, could, would the trade-off on tokens be there? And would the trade-off on understanding be there as well? It's a, we'll see if there's more file types that emerge. And I'm huge on video and using videos. Jim and I being the best model for uploading video and understanding. And recently built a tool that can take one of my six-hour workshops and process the entire thing and take out notes and examples and thoughts and frequently asked questions.

• 13:00Speaker 01

  So each time I teach a workshop, I can iterate on it and I don't have to go like, search through the video some other way. It's-

• 13:07Claire Vo?

  You and I will have to trade notes because I did a very similar thing with our episodes, which is it takes a video of our episode, it pulls out all the learnings, all the code snippets.

• 13:17Claire Vo?

  Screenshots where the guest and I look cute and put it into a blog post. So I agree on that. You know, the second question I had for you, though, is going back to these diagram files in this memory directory. Where in your development process do you find that you generate those files? So for me, I actually have a GitHub action that generates files almost exactly like you have with documentation and diagrams for new features of a specific scope. And so I do it when a pull request is closed and then I go back and update our diagrams. I'm curious where this falls in your, where documentation like this falls into your workflow.

• 13:58Speaker 01

  Yeah, usually I think pull request is a good paradigm there. As soon as you have something working where you want it to be working and then you can say, okay, now this is working as expected, please diagram it. I think for a lot of the projects, we already have pre-existing code bases that don't have diagrams. And so that's when the major use case is taking existing stuff and diagraming all of that so that our AI development is accelerated, I guess is the buzzword. But yeah, if you're starting from scratch, you definitely just want to spike things out, get it working. Don't worry about diagrams upfront. Just use a plan mode, build something, and once it's working, then diagram it out.

• 14:42Speaker 01

  And then even with the diagrams, they're great to help walk you through, like, why did I just build? Like, I didn't look at any of this code. Show me diagrams of what the code is doing. And then if the diagrams look kind of wonky, you can just say, there's tools in there that people are working on where you can like drag around pieces of the diagram to say, well, I don't want this to navigate there. I don't want this to do that. There's going to be so many tools in the next few years that emerge from all of this.

• 15:10Claire Vo?

  Yeah, and then I will give folks just a couple other use cases of generating Mermaid diagrams from code that are not just about improving the efficiency of using something like Claude code. I use a lot of diagram generating out of our repo to answer very complex security and data flow requirements from our customers. This is a, it's a workflow that is actually like pretty expensive if you ask an engineer to do it, which is I have a specific customer A, they need a very specific data flow diagram of this part of our application so they can understand the third-party parts of it. Again, also if you're going through SOC 2 compliance or any compliance, like these are, these are assets that historically

• 15:51Claire Vo?

  have just been so tedious to create efficiently and effectively, and now you can kind of generate them on demand. My last question for you on this diagram flow is, do you find that you have the AI write, or you would write documentation any differently than you would for a human audience? Or do you feel like there's enough overlap that the content format, et cetera, can be pretty consistent between the two?

• 16:17Speaker 01

  I would say it could be pretty consistent. I think they serve as a nice bridge between kind of human and AI. Definitely think, I know people generate documents, like you'll write code and then generate documentation around it using AI for both steps, which is just wild. But yeah, I think the markdown is kind of the language of the future for a lot of this text. And then there, you can do images and everything inside of markdown files as well. So they can kind of, and the front matter metadata, you'll, you see Claude using that extensively for their skills and commands.

• 16:55Claire Vo?

  Yep.

• 16:56Speaker 01

  And everything. So, and Anthropic is pretty good at pioneering all this stuff. So if they're using markdown, then.

• 17:04Claire Vo?

  Everybody else can.

• 17:05Speaker 01

  Yeah.

• 17:05Claire Vo?

  Yeah. Again, for people who want to like pull the thread a little further, what, what I do is we generate a lot of AI code. Then on pull requests, we generate AI documentation internally for engineers and for AI, obviously, to use this context. And then we take that code and we generate markdown customer-facing support documents. Again, that really benefit from these workflows because then you say, click button A, move to section B, save this. And so you can really pull the thread on documentation from one asset. And I think you're showing a place where it's really useful from the engineering perspective, but it can start to become customer-facing in all sorts of interesting things.

• 17:45Speaker 01

  Yeah, and you could summarize the documents for customers. You could have it build little interactive demos. I mean, there's, the sky's the limit, like however much you want to support the customers there is, if this is enough, then, then great. If it's not, then it's an AI prompt away from something pretty, I guess.

• 18:04Claire Vo?

  This episode is brought to you by Tines, the intelligent workflow platform powering the world's most important work. Business moves faster than the systems meant to support it. Teams are stuck with repetitive tasks, scattered tools, and hard-to-reach data. AI has huge promise, but struggles when everything underneath is fragmented. Tines fixes that. It unifies your tools, data, and processes in one secure, flexible platform, blending agentic AI, automation, and human-led intervention. Teams get their time back, workflows run smarter, and AI actually delivers real value. Customers now automate over 1.5 billion actions every week.

• 18:48Claire Vo?

  Tines is trusted by companies like Canva, Coinbase, Databricks, GitLab, Mars, and Reddit. Try Tines at tines.com/howai AI. Great. So you showed us how to just pull all of these documents into a system prompt. You get much more performant use of something like Claude code. And this seems like a command that you're using over and over again. And that's something you and I talked about before we started recording, which is how to alias and make more efficient your use of different commands. So should we, should we pop over to that or anything else you want to show on diagrams?

• 19:27Speaker 01

  That's, that's great. Let's do that. So there are a lot of, with, on Mac, it's ZSH is the default shell. On Windows, it'd be PowerShell, so this will look very different.

• 19:41Speaker 01

  But depending on what tools you use the most, you can easily set up aliases for things like setting the default model for, for Claude, or setting like if you want to do something completely dangerously. So that, once you open a new terminal, if you just type X, now anything I type has bypass permissions enabled. Or if I type H, this will be Haiku, it'll be much faster, but not quite as smart. Or if I type, in this scenario, CDI, this will do that diagram loading.

• 20:15Speaker 01

  Where, once you have these systems in place, these commands in place, then you can just, kind of capture them in the smallest, like, because I use these a lot, I keep them in very short shortcuts.

• 20:31Claire Vo?

  Yeah, and I can imagine you could, you could do something like this for project-specific context, so you could do like CC dash, whatever project you're working on, you could pull in the diagrams for just that initiative. So if you're going back over and over again into specific things that need specific context, this would be just a cheap shortcut to, to get you into the mode of, for example, Claude code that you want.

• 20:55Speaker 01

  Yeah, absolutely.

• 20:56Claire Vo?

  And you showed a lot of Claude examples here. Are there any other ones that you think are really, really useful for folks or creative uses of this you think we should think about?

• 21:05Speaker 01

  So I tend to build any idea I come up with. So for example, this is one I'm working on called Sketch. And this feeds into the Gemini, Gemini CLI. So like, what type of website do I want, do I want to build? Let's do a store for selling Christmas decorations.

• 21:33Speaker 01

  And then let's make the homepage of that. Let's make it creative and artistic for a desktop website. We'll do the GitHub Lite theme for it. No reference image. Let's do five images and go ahead and generate it. And this is the sort of thing where kind of beyond beyond the simple alias, if you if you've never dived into creating what's called a CLI, you can tell an AI like, listen, I want to use like this is a wrapper around Gemini, where it will execute Gemini with specific prompts. So you have to remember that you have these tools on your desktop, which can do incredible things, but you can also script them.

• 22:18Speaker 01

  And this is a scripted way of generating images based on all of these, all these topics with these concepts with preloaded prompts. And yeah, I can say if I want to add another feature like you just go in there and say, please tweak the prompts or please add this feature, please do this. And then instead of constantly thinking of, oh, what was that prompt again? Or was that idea I had? You can have these little CLI's and these little projects that are just for you. Because you just like build the tools that you need now. And this is just spitting out these. My mom lives with me and she's setting up Christmas decorations upstairs. This is why I'm thinking about this.

• 23:01Claire Vo?

  Oh, what's that?

• 23:03Speaker 01

  Yeah, this is Gemini generating based on the prompt we fed in, based on the color scheme. This is GitHub Lite Christmas store color theme. And I told it to generate five variations of it. And then it could take one of these images and drop it into one of the drop it into one of the AIs and say, let's start building out this website. Let's break this into sections and go from there. And this is kind of like my ideation inspiration sort of thing that I use.

• 23:30Claire Vo?

  One reason I want to make sure people are paying attention to this use case, which is essentially you've exposed a command line interface to do a couple, you know, script a couple workflows around calling Nano Banana and some of the Gemini models to to do some things. And there are two benefits, I think, to this that are really important. One is Building command line tools has been so opaque and just kind of not fun for so many people for so long. I've built lots of them and how easy it is to build a really nice command line tool is such a treat for anybody who's ever had to build them

• 24:12Claire Vo?

  and make them look good. Everybody has these cool ASCII-only logos in their in their command line tools, which have been very tedious to make before. So I think one thing is these tools are just a lot easier to build. Two, from a product builder perspective, the reason why I like this move to these command line tools is the constrained UI space of the terminal. Actually make sure you don't get distracted in building UI around something as simple as this, right? You just had like five questions you had to answer, a couple multi-select, you could tab through those with your keyboard. If you were creating like a little whizzy wig walkthrough web editor thing here, I mean, one, I would have gotten really distracted about how it looks.

• 24:55Claire Vo?

  Two, you'd have to type into, you know, you'd have to run local host and type into your your your web browser. And so I actually like the constrained UI space for speed of prototyping on some of these ideas. Because you just don't get distracted by anything but the essential kind of toolkit. And then you can get a really cool thing out the other end.

• 25:18Speaker 01

  My only problem is I've built more tools than I can remember and sometimes I have to think, where was that thing?

• 25:25Claire Vo?

  Yeah, I I also like what you how you started this this little segment, which is you said you just build every idea you have. I think that is totally the move. While you have an idea, kick off something, get it built, build yourself a little throwaway repo. You know, eventually the AI can crawl it and remind you everything that you built before, but this is pretty cool.

• 25:49Speaker 01

  And that's that's why I love dictation because all you have to do is start up a new terminal in a new folder and just kind of brain dump in there and then it'll try something. And once you have something, even if it's wrong, you can iterate on it.

• 26:05Claire Vo?

  Yeah.

• 26:05Speaker 01

  If you have nothing, you can't iterate on nothing. And I think that's the magic of even for people who hate AI tools. Like a sheet of paper full of things that are wrong is much better than a blank than than nothing, because even if it's wrong, you you recognize it's wrong and it helps you think of what's right and what you want to build.

• 26:28Claire Vo?

  Yeah, I say this a lot. It's easier to edit than author. So let's get the authoring out of the way. And then even if you completely revise the whole thing, it's a much easier starting starting point to work with something.

• 26:40Speaker 01

  Yep.

• 26:40Claire Vo?

  Okay, so I think we're gonna close out and spend a little bit of time on your workflow for when you're doing more complex coding projects or features, how you keep those really high quality using some advanced techniques in, I think, in Claude Code and Cursor.

• 26:58Speaker 01

  So when we're gonna, excuse me, when working on a project, often when the AI is generating code, it'll often build out mistakes. And so even it will say it's done, you're like, wait a second, there were a ton of mistakes there. Why did you stop just to fix it until the mistakes are done? So for example, let's say it wrote out this code and there was this error in here. And this error is something you'd usually catch with tools such as TypeScript, or maybe it's formatting, or linting, or any sort of complexity tools, that there are code quality tools that you run before before you think the work is done. So you would run

• 27:43Speaker 01

  something like Bun type check, and you would see that it has this error, but your Claude Code and the other agents don't know that this error exists. What Claude has and what Cursor, Cursor and a few others have is the concept of hooks. And what this can do is, so inside of Claude, let's go here, you can set up what are called hooks. And I'm going to set what's called a stop hook. And hit Add New Hook. And just it shows you a bunch of examples. I'm accepting responsibility for all of this.

• 28:26Speaker 01

  A bunch of warnings because it can run scripts that aren't checked by the AI. And I'm going to say the command for now is just echo, which does nothing. And I'm going to add it to my project local settings. And now we have this echo hook. And this is defined in this settings local dot JSON file. And this is for, uh, this is a local file for me. If you want it to be with your team, it would be settings dot JSON, settings dot local. That JSON is just for you. What we're going to do is instead of running this command, we're going to run a custom Claude, Claude hook,

• 29:11Speaker 01

  which I've defined inside of Claude Hooks. And I called it index, index dot TS. You could call it stop or whatever. So from this script, which is in this directory, I need to run this install for this package because I don't have it installed right now. So I'm going to bun install and propic. And this is there for Claude agent SDK. Now in the SDK, they have what are called hook inputs and other types you can use. So that when you're dealing with hooks, you have a lot more information. So like on this input, you have all of this information around what the input name is. And then what the session ID is and the current working directory, permission mode and all that.

• 29:55Speaker 01

  And you can use that to customize your hook. But we're going to, but what we are going to focus on is we're going to see step one. Were there files changed when we stopped? And a stop is once Claude has kind of finished its conversation and it's now waiting for you to do something. So we're going to check, are there files changed? And we're going to, if there's files changed, we're going to say, okay, then let's go ahead and run that bun type check. And if there is a type check, then we can say back to Claude, we can say, hey, there were TypeScript errors. This is the report and then send them back the output that we showed in the terminal

• 30:38Speaker 01

  before and it'll continue. Otherwise, if there were files changed, then we can tell Claude to please, there's a prompt way down here that says, please commit essentially. The files don't commit anything sensitive and go ahead and commit it. So we set up this workflow of, once a conversation is finished, check to see if any files have changed. If they have, you check to see if there's any TypeScript errors, which could be a type check or build errors or any sort of other code quality guards you have in place. And if there are none, then go ahead and commit. And this saves you a lot of the overhead in your mind of, here's all this extra stuff I have to do once something's done.

• 31:21Claire Vo?

  Yeah. And what I want to call out for folks that are maybe listening and not seeing this code here is it's really, what's nice about this is it's a combination of commands that you would run in the terminal to just generate errors and see them yourselves. But then you can feed those back into Claude code in a more natural language way and give natural language instructions on what to fix or again, default to some command that's different, which is this GitHub commit command. And so I like this combination of kind of like structured commands in the terminal,

• 32:00Claire Vo?

  combined with natural language calls back into Claude to then kind of put the bow on the end of any work that this AI system does. Is that kind of how you think about it?

• 32:10Speaker 01

  Yeah, exactly. The gotchas you have to think about here are when you're, when you're communicating from a hook back to Claude, you're essentially using console log, which is one of the first things any Java developer learns, and you're sending back a JSON object. So it's going to find that first console log, whatever it gets back, that's what it's going to see as its, as its input, its standard input. So you have to be careful if you're running commands like this. You tell this one, please be quiet, because if it's not quiet, then it would log back to the console and maybe interfere with something.

• 32:53Speaker 01

  Or if you want other logs or you're debugging this script, just use console error or any other way of showing logs. Otherwise, console log turns into this feeding instructions back to the agent. So it's one of those gotchas that everyone falls into when building this out. And just to demo it real quick, I'll just turn on Claude.

• 33:17Speaker 01

  And I'll say, well, actually, for this to work correctly, let's make sure we have everything staged and set up so that when it does the git check,

• 33:31Speaker 01

  let's just generate a message. So yeah, let's, uh, please create a foo.txt file on the root of the project. And we'll go ahead and accept this. And you'll see that it says, "Stop hook returned a blocking error." And that error returned is, "Please fix the TypeScript errors." And here's our prompt right here with this block. And it says, "I'll fix the TypeScript errors." So this is when it would have stopped. It would have stopped right here, but we hit the stop hook. Now it sees these errors, so it's going to go ahead and read that. It says, "Oh, I found the mismatch quote. I fixed it." And now, behind the scenes, there's a Claude running, which should it commit that fix.

• 34:16Speaker 01

  You make this a bit smaller, show our graph here. And you'll see, this is the fix that it made was correct the quote syntax. This is what the little haiku did in the background. So the stop hook ran twice. It ran once where it found the error and had files changed. And then the second time, there were no more errors, and so it ran the commit. And so that saved us all of that work of both passes. And now we have a completed task that has been error-checked, fixed, and then commit.

• 34:50Speaker 01

  And conditionally inscripted in a way where this will be different for every single project, based on your requirements, based on your codebase. So this is definitely something that you have to like, think through and set up yourself. It definitely saves so much time where you don't have to go back in and say, well, please fix this, or please run this command, or please do this. When you know, part of your workflow is always, like, if these things should always run, you might as well run them automatically.

• 35:16Claire Vo?

  And something I have to say is, I get so much pushback from software engineers saying, "These tools don't really make me faster, the quality isn't as good." And I think if you make the investment, as you've shown us, in, okay, well, what things would it do to make the quality better? Or what things would it do that you can automate that would make you a little bit faster? And you put that effort in, to understanding all the things that these tools can do for you, either programmatically, or through prompting. I think you can actually see a lot of those efficiencies. And then I want to call out something that you said, which is you have this local settings, but you can create settings that are shared across your team for anybody that's working

• 36:01Claire Vo?

  in the repo. And that's for our engineering leaders out there, or larger engineering teams, to really think about. If you haven't created these hooks for key repos or key projects, where everybody is benefiting from this, when they're using something like Claude code, then you're missing out on some of the scaled leverage, I think, of these tools. And so I love to put somebody in charge, in an engineering organization, of figuring how stuff like this can work inside your codebase, and then scaling it out, either through training, or through configuration, into all the other engineers, so that everybody's getting this baseline quality and this baseline efficiency.

• 36:38Speaker 01

  Yeah.

• 36:40Claire Vo?

  Amazing. Well, okay, other than, you know, type script errors, just prattle off a couple other use cases. You deleted a bunch of stuff from this hook. So what are the things you think that people should bake into a stop hook like this for Claude code?

• 36:55Speaker 01

  Definitely formatting. There's kind of the mindset we've always had before of, like, pre-commit hooks, or pre-push hooks, things that operate on the CI. And these are a lot of things that can be fixed before those are even run. So whether it's, there's a lot of tools around with linting. It could constrain the length of files. There's things like circular dependencies where I could check the imports to make sure that files don't reference each other. There's code complexity. There's tools that say, does this code look like any other code in the codebase? Where this could be extracted into a function or something because it was like duplicate code throughout the codebase.

• 37:39Speaker 01

  And there's all sorts of analytics and tools you could run.

• 37:45Speaker 01

  Some of them probably not as often as others because it's more expensive and you just have to make those decisions based on, you know, the size of your team, the size of your application. But there's, just put into an AI prompt of ChatGPT or any of them to say, what are all, make a long list of developer tools people run on pre-push or on pre-commit and you'll see a huge list of them that you could pick and choose from.

• 38:15Claire Vo?

  Well, and I'm going to take a tiny detour for our very patient, non-technical audience members that have maybe listened to this, which is these post-tool call hooks or post-stop hooks in Claude can also be used when you're working on non-code. So we have so many people using Claude code to write documents, to do all sorts of things. And so you could just think about, what do I want automated after this tool is called? Or what do I want automated after Claude finishes writing my, my document? And you could think about ways to use something like this, not even for code quality review, just for a post kind of task completion check. So I think just the general framework's really useful.

• 38:58Claire Vo?

  It's obviously highly applicable to software development, but I think people can think of other creative use cases for this as well.

• 39:05Speaker 01

  Yeah, absolutely. The diagramming stuff, create an image of what we just did and send it to my mom to show her I'm working hard, like. Anything you want, right? It's, it's, the sky's the limit.

• 39:19Claire Vo?

  Okay, so just to wrap up, these have been super useful use cases. I want to call them out. One is using documentation and diagramming, specifically Mermaid diagrams, to preload as a system prompt in your Claude code instance so that you don't have to waste the time of doing context discovery and you can really make sure that that context is preloaded. It's a little more expensive on the token side, but a lot faster. And these diagrams are much more easily read by machines than by humans. So it's a good format to get things in. We looked at aliasing some of your favorite Claude code instances and settings so that you can pop into your live dangerously mode.

• 40:04Claire Vo?

  You can pop into your you have all my diagrams mode. You can just pop into those with one, you know, one, one or two letters, which I like. We got a little side preview that we didn't call out, but just how casually you use voice and transcription to enter in and out of these tools. What I like about the way you use AI is you were just like highly efficient. You're like, the minimum number of things I could type, the better. And you're pretty fluent in switching between voice and typing. So we saw, we saw a little of that. You encouraged us to create in particular little command line tools to build one-off ideas or tools. Yours was a website design generator using Nano Banana.

• 40:48Claire Vo?

  And then you showed us how to use Claude hooks, and in particular, a stop hook to do some quality and other checks on code written by these AI tools and automate some of the processes that you might do as a software engineer that you want our little AI software engineers to do instead. Just that in, I'm looking 40 minutes. We did it pretty fast.

• 41:13Speaker 01

  Nice.

• 41:14Claire Vo?

  This is great. Okay, well, I'm going to ask you a couple lightning round questions and then we will get you back to your very efficient AI coding. My first question, again, you're like me. We love Cursor, we love Claude, we love VS Code. We have all of them open. You know, I think everybody's, I think there's interface wars happening right now. Are people gonna love these terminal UIs and command line tools like Claude Code? Do people want the IDE? I noticed that you're on Cursor 2.0, so you have the Agents view, which is very simple and abstracts away some of the code. And you're in the editor view. I'm gonna give you two wars. I want your quick opinion right now, we won't hold you to it, of what you think wins.

• 41:57Claire Vo?

  For, I would say, real software engineers, you know, writing real code out there. The friends that I talk to.

• 42:07Claire Vo?

  You know, terminal UI, IDE or both? And then, do you have any hypotheses on? I think in particular, in the VS Fork world, VS Code Fork world, are there any votes or, you know, what do you think? How do you think people can compete in the IDE world?

• 42:26Speaker 01

  Yeah, so I think you need both. I think you need an IDE. And there are so many use cases for the CLIs. The reason being that the CLIs have a lot of configuration and a lot of settings, where, as you saw with aliases, I could launch a version of Claude that loaded up a specific set of MCPs or a specific set of prompts and preload a bunch of things. And do that in a single terminal command and be very quick and fast with that. And then set it off in the background and just have it running.

• 43:01Speaker 01

  Currently, inside of a Cursor or inside of any of these IDEs, there's usually a lot of, okay, open the UI, navigate to this and then navigate that, then switch over to this, then switch over to that. And they try and streamline as much as possible with slash commands and whatnot. But it's just not quite the same. But if you have an IDE and you're reading through the files and you're selecting lines and you want to modify certain bits, like focused work, there's so many use cases for IDEs where there's a recent Claude tool where it has a IDE integration, where I can check the diagnostics from the IDE.

• 43:45Speaker 01

  And you'll see that with VS Code as well, like the extensions you put into an IDE can be fed back into the agent. So there's a whole robust extensions ecosystem from IDEs because people build on top of these things their own workflows. And I don't think we've quite reached, like we build our own CLIs from AI. I don't see a lot of people building their own cursor extensions or VS Code extensions, which is very possible. And you could feed those errors and warnings and company rules and everything in very complex ways back into the agents. So that will happen as well.

• 44:22Speaker 01

  And I think for one IDE to stand out above the other, they have to separate themselves, like curse is doing with their agent mode. They have to make something unique and user-friendly that once, like people are not going to give you a bunch of time to convince them. You're going to have to open the agent and you're going to have to like see that click on browser mode and it's going to have to launch your dev server and you're going to have to click on the element and say, I want this to look with more pink or purple or whatever. And then, and then they want that to just work.

• 45:01Speaker 01

  We'll see any sort of friction or frustration from any AI tool anybody puts out there is is just instant dismissal from so many people. Like there's just, the bar for quality is so high. In the AI landscape, because everyone can build anything that you have to focus on the UX. You have to make that experience better than everyone else. And that's where you can see Curse are making the bold moves of like, okay, let's go full on agents. Like, you have to make those leaps.

• 45:35Claire Vo?

  Yeah, I agree. And, you know, just talking about this skepticism and high bar. What I love about this episode that we recorded today is it's really most relevant for software engineers with more experience who are shipping high quality code and who want to write production level code more efficiently using some of these tools. It's, this is not, you know, I hope you all hung out and listened to it, but it's not for our vibe coders and our non-technical folks. And so what would you tell kind of senior principal software engineers, engineering leaders? I get asked this a lot about how do I sell the value proposition of these tools into very skeptical organizations?

• 46:19Claire Vo?

  And what are, as a more advanced software engineer, the things that have just changed your life in the last year? You should never go back to doing it this way. Kind of how do you, how do you make that pitch?

• 46:31Speaker 01

  The first thing that jumps to mind is any time an issue is opened, like you can set up streamlined workflows that someone opens an issue and you can have Claude automatically tackle it. You can set up triggers for linear GitHub, whatever, that once something happens, you can get that first pass to see, okay, can we at least find this without doing any work? Can we at least get that initial review in there of what's going on? So that once we jump into the task, I mean, for my entire career. Someone throws an issue at you, you spend the first, you know, probably day or two orienting yourself to like,

• 47:16Speaker 01

  "Okay, I didn't write this code. This is legacy from some..." Let's do get blame. Let's do all this stuff. Like, all of that busy drudgery that you're going through to even get started on the issue.

• 47:28Speaker 01

  It can wipe out so much of that. It can find who touched the files, who did this. Like, if you have a diagram set up, what are the risks, the impacts? Are there potential security things? Are there... Like, it's so great at surfacing the "you don't know, you don't know" sort of scenarios, where you hire so many contractors, you hire so many people who are new to these things, and then you throw them into these tasks, and they just don't know. Like, they haven't spent time with the codebase. And then you ask them to fix these things. They just have zero idea what sort of impact their change is gonna have. The AIs can surface a lot of that, and they can just be like, "Okay, we need to be super careful.

• 48:10Speaker 01

  This is, you know, in production, and this is gonna cost us money if this goes wrong." Just tell me everything I need to look at. Like, find every single debug path. Find every single...

• 48:24Speaker 01

  Every... Why has this file changed over the course of history? Like, write a summary of everybody who's touched this file, so I can know why this function is the way it is. Like, there's just so much work that is just not writing code.

• 48:38Speaker 01

  And all the exploration work is just so much easier to just say, like, "Everything I just said over the past, you know, 30 seconds is a prompt, which I could have just dictated, right?"

• 48:51Speaker 01

  And you just have to walk up to your computer and say, "I have this issue." Like, "Guide me through all this stuff." And it's just...

• 49:01Speaker 01

  It blows my mind that people be hesitant for those sorts of tools. I understand if they're like, okay, maybe some of the code isn't perfect. We still have to do code reviews. We still have to like check for quality. We still have to run our tools to validate things. But if you're not using it to do to like inspect and investigate and write orientation and all that stuff, then like you're really missing out like in the enterprise space.

• 49:29Claire Vo?

  Yeah. And on the other end, if you're not using it to document, so the next time somebody has to do that investigation, you have a little bit of an easier time. You're also missing out. So I do think on that, that front of the backend. And what I often tell people is a good way to think about how to design your AI workflows is do not think in a task level orientation, like I'm going to write code. I say, think about if I gave you infinite junior to mid-career talent, who is always available, who would do the work you would do if you had unlimited amount of time and no meetings. What would you do when a ticket came in? Like, what would you do? And you'd say, well, I'd go trace who wrote the code.

• 50:13Claire Vo?

  I would go figure out the history. I would make myself a really good tech spec. I would call out the risks. I would publish this in a way that my team could review it. I would have a senior engineer look at it and give me some really hard feedback. All of that could just become a prompt. And then, you know, but so many people are just constrained by their time and cognitive capacity. And so they just go, well, I'm going to read the issue and bounce around in the code a little bit. And then I guess I'm going to start coding. And so you can kind of get to this model of optimal, not perfect, but like optimal workflow.

• 50:52Claire Vo?

  And then figure out how you can prompt or build workflows or hooks that would replicate that at least in an 80% way, which is a lot better than not doing it.

• 51:02Speaker 01

  And something as simple as the commit messages are so much better than they used to be because developers don't have to write them.

• 51:10Claire Vo?

  So much better.

• 51:11Speaker 01

  For people who are new to programming, commit messages used to be like second attempt or like please work or swear words like.

• 51:21Claire Vo?

  My favorite one is just like 17 Fs, like or like trying this, trying that, trying this other thing.

• 51:29Speaker 01

  Yeah. Now, please work PLZ.

• 51:32Claire Vo?

  Yes, of course.

• 51:33Speaker 01

  Yeah.

• 51:34Claire Vo?

  You know, if anybody wants to vibe code a product, I always thought that startups would want a printed book of all their first years commit messages with like calling out the really funny ones. So if somebody wants to vibe code a little GitHub API powered print business, I'm sure you could get a couple of startups to print those out. Okay, last question.

• 51:57Speaker 01

  Yeah.

• 51:57Claire Vo?

  This is probably challenging for you because you do a lot of dictation, so you're probably actually pretty polite to AI, given you would have to say frustrating things to it if you wanted to be mean, but when our little friend Claude is going off the rails or you're really not getting what you want, what is your prompting, reset, start over technique? Have you found any, any tricks that work particularly well?

• 52:23Speaker 01

  Yeah, it's, it's really the take the conversation exported, a lot of them have the export commands. Drop the conversation with some of the code files into the

• 52:37Speaker 01

  into ChatGPT Pro 5 or whatever it's called, or Gemini Deep Think, I believe is the and have it, have them do a second set of eyes on it. And then kind of start over rather than like if, if things go off the rails and you can't fix it in about maybe one prompt of like where you see what's going wrong. And just revert to the previous commit and kind of start over. Because there, there, there's always this underlying AI is trying to go somewhere and you want it to go over here. And you keep on telling it to to join on your path, but it still wants to like get somewhere else that you don't quite understand.

• 53:23Speaker 01

  And so starting over from ground zero and like revising your original prompt is better than like trying to steer it to where you are when you've like drifted so far away.

• 53:35Speaker 01

  And that has to do, it's so different with every model, it's so different with every prompt and all the context and project that it's like it can't give you like the here's instructions that work every time, but like starting over works every time. Tossing a second set of eyes on the entire conversation where that AI isn't.

• 53:55Speaker 01

  Isn't invested in that conversation. It's instead critiquing the conversation. Those are my, my two.

• 54:02Claire Vo?

  I think that second, um, that second workflow is so funny because I, I think as somebody who's been a manager and a leader so many times, sometimes I feel like I'm the reasoning model being brought in to mediate the, the misunderstanding between too smart, but misaligned, misaligned resources. And so it's really funny to hear the idea, okay, like I'm having a debate with my AI. Let's bring in like the third party. Let's mediate this conversation, have an objective set of eyes to see where we maybe are misunderstanding each other or going wrong and then reset and start, start over. So again, I think, you know, this is the moment for folks with a lot of organizational

• 54:43Claire Vo?

  and social skill thinking, um, to apply this to how you might design some of these flows, um, for, for AI, even though there are, um, beep boop machines that we're really using.

• 54:55Speaker 01

  Yeah. And, and I would say, kind of last thought on that is the recent planning modes that have been released with Claude Code and Cursor and all of them have eliminated a vast majority of that, of that drift. So they've been fantastic releases, which I strongly recommend for anything beyond like a small file change, planning is awesome.

• 55:15Claire Vo?

  Yeah, I love, I love those features too. Okay. Well, John, this has been great. Where can we find you and how can we be helpful?

• 55:22Speaker 01

  Yeah, I'm on egghead.io. That is, I have tons of courses on AI tooling. I teach workshops through egghead.io. I send a newsletter out every week called AI Dev Essentials. You can find me on X and other platforms as well, under my name. And that's it. I love to talk with anyone about all this stuff.

• 55:45Speaker 01

  My workshops are fun and we talk, go way deeper into this super advanced stuff. So, yeah.

• 55:51Claire Vo?

  Right. And then maybe some of us can shop your possibly to be created Christmas and holiday decorations site. So you let us know.

• 56:01Claire Vo?

  You let us know if that goes live. We'll drop into the show notes. Thank you so much for joining us and sharing your workflows.

• 56:07Speaker 01

  First, thanks, Clark.

• 56:10Claire Vo?

  Thanks so much for watching. If you enjoyed this show, please like and subscribe here on YouTube, or even better, leave us a comment with your thoughts. You can also find this podcast on Apple Podcasts, Spotify, or your favorite podcast app. Please consider leaving us a rating and review, which will help others find the show. You can see all our episodes and learn more about the show at howiaipod.com. See you next time.