30 items
26. Design for Observability Before You Design for Capability
The most capable agentic system you can't observe is worth less than a less capable one you can see inside.
27. Evals Are Your Test Suite
Every serious software project has tests.
28. The Tool Is the Interface
When you give an agent a tool, you're not just extending its capabilities — you're defining the boundary between what the agent decides and what the world does.
29. Idempotency Matters More in Agentic Systems Than Anywhere Else
Idempotency — the property that calling something multiple times produces the same result as calling it once — is a good practice in any distributed system.
30. Don't Let Your Agent Touch Production Until It's Bored You in Staging
There's a moment in every agentic project where the system is working well enough in testing that the temptation to deploy becomes almost irresistible.
31. Small Agents Beat Big Agents
The instinct when building agentic systems is to make the agent capable of everything.
32. Orchestration Is Just Plumbing — Treat It That Way
Orchestration frameworks have a way of becoming the center of attention in agentic systems.
33. State Is the Hardest Problem in Agentic Programming
Every hard problem in distributed systems eventually reduces to state.
34. The Retry Loop Is Where Systems Go to Die
Retry logic is necessary.
35. Your Agent Needs a Kill Switch
Every agentic system that operates with any degree of autonomy needs a way to stop it immediately — not gracefully, not after the current task completes, but now.
36. Log Everything Your Agent Was Thinking, Not Just What It Did
Action logs are necessary but not sufficient.
37. Timeouts Are Not Optional
Every external call your agent makes — to a model API, to a tool, to a database, to a third-party service — needs a timeout.
38. Cost Is an Architectural Constraint
Token costs have a way of surprising teams that didn't plan for them.
39. Context Windows Are Budgets — Spend Them Wisely
A context window isn't infinite space — it's a budget.
40. The Best Agents Have a Narrow Personality
A general-purpose agent sounds like the goal.
26. Conçois pour l'observability avant de concevoir pour la capacité
Le système agentique le plus capable que tu ne peux pas observer vaut moins qu'un système moins capable dans lequel tu peux voir.
27. Les evals sont ta suite de tests
Tout projet logiciel sérieux a des tests.
28. Le tool est l'interface
Quand tu donnes un tool à un agent, tu ne fais pas qu'étendre ses capacités — tu définis la frontière entre ce que l'agent décide et ce que le monde fait.
29. L'idempotency compte plus dans les systèmes agentiques que partout ailleurs
L'idempotency — la propriété selon laquelle appeler quelque chose plusieurs fois produit le même résultat que l'appeler une seule fois — est une bonne pratique dans tout système distribué.
30. Ne laissez pas votre agent toucher la production avant qu'il ne vous ait ennuyé en staging
Dans chaque projet agentic, il arrive un moment où le système fonctionne assez bien en test pour que la tentation de déployer devienne presque irrésistible.
31. Les petits agents battent les gros agents
L'instinct quand on construit des systèmes agentic, c'est de rendre l'agent capable de tout.
32. L'orchestration n'est que de la plomberie — traitez-la ainsi
Les frameworks d'orchestration ont tendance à devenir le centre de l'attention dans les systèmes agentic.
33. Le state est le problème le plus difficile en programmation agentic
Tout problème difficile dans les systèmes distribués se réduit finalement au state.
34. La boucle de retry est là où les systèmes vont mourir
La logique de retry est nécessaire.
35. Votre agent a besoin d'un kill switch
Tout système agentic qui opère avec un quelconque degré d'autonomie a besoin d'un moyen de l'arrêter immédiatement — pas gracieusement, pas après la tâche courante, mais maintenant.
36. Enregistre tout ce que ton agent pensait, pas seulement ce qu'il a fait
Les action logs sont nécessaires mais pas suffisants.
37. Les timeouts ne sont pas optionnels
Chaque appel externe que fait ton agent — à une API de modèle, à un tool, à une base de données, à un service tiers — a besoin d'un timeout.
38. Le coût est une contrainte architecturale
Les coûts de tokens ont tendance à surprendre les équipes qui ne les ont pas planifiés.
39. Les context windows sont des budgets — dépense-les judicieusement
Une context window n'est pas un espace infini — c'est un budget.
40. Les meilleurs agents ont une personnalité étroite
Un agent généraliste, ça sonne comme l'objectif.