🛡️Satisfaction guaranteed

← Back to blog
tutorialMarch 4, 2026

Agentic Engineering Patterns: Simon Willison's Guide to Mastering AI Agents

Simon Willison compiles best practices for working with Claude Code, Codex and other coding agents. An essential guide for 2026.

The Era of Coding Agents

Simon Willison, creator of Datasette and respected figure in the Python community, has just published a comprehensive guide on "Agentic Engineering Patterns" — engineering patterns for working effectively with coding agents like Claude Code and OpenAI Codex.

Fundamental Principles

Code Has Become Cheap

Willison's first principle is provocative: writing code is now cheap. The mental effort of structuring a solution remains valuable, but implementation itself can be delegated to agents. This fundamentally changes how we should approach projects.

Hoard Things You Know How to Do

The second principle is more subtle: document your patterns. Agents are more effective when they have access to code examples you've validated. Create a library of snippets, workflows, solutions to recurring problems.

Testing Patterns

Red/Green TDD

Willison recommends writing failing tests first, then letting the agent make them pass. It's classic TDD, but optimized for agents: they excel at producing code that satisfies explicit constraints.

First Run the Tests

Before requesting modifications, run existing tests. The agent needs context about the current code state to propose coherent changes.

Understanding Code

Linear Walkthroughs

Ask the agent to explain code line by line. It's an excellent way to understand an unfamiliar codebase without spending hours on it.

Interactive Explanations

Go further: ask for contextual explanations while navigating code. The agent as a reading co-pilot, not just a writing one.

The Pragmatic Approach

What distinguishes Willison's guide is its pragmatism. No miracle promises, no "AI will replace developers." Just concrete techniques for being more effective with available tools.

The complete guide is available on simonwillison.net and deserves careful reading for anyone using coding agents daily.

agenticclaude codecodexsimon willisonpatternsagents iadéveloppement

Want to automate your operations?

Let's discuss your project in 15 minutes.

Book a call