- The new engineering work includes improving the environment in which agents operate. Without trust-building tools and processes, engineers can get trapped micromanaging agents and have little time to improve their setup.
26:1426:29 - Poteto's internal Dune framework for Electron apps uses strict lint rules and conventional structure. Each feature has a dedicated directory, so agents have a clear place to put code and fewer opportunities to invent inconsistent patterns.
30:0130:30 - This structure followed a concrete failure: early Grokbot versions accumulated eight "god files," each at least 10,000 lines long. Splitting features into directories made the code easier to navigate and constrain.
31:0131:32 - When agents repeatedly make the same mistake, inspect the environment. Convert recurring errors into lint rules, types, conventions, or other guardrails so the codebase makes the bad path difficult or impossible.
31:3231:57 - Poteto compares constraints in code to TypeScript narrowing: both reduce the set of possible states and clarify what the code can be. The result is less decision-making for both the human and the agent.
29:1829:4531:01
Chapter notes
4. Shape the codebase to make good changes easier
Matt Pocock · 1:05:36 · English