Skip to content
How to ThinkIn the Age of AI

Question

What does it mean that document your agents?

beginner

Quick Answer

Written agent descriptions can be reviewed refined and shared.

Example: You have a morning routine agent: when the alarm goes off, you make coffee, check your calendar, and plan your top three priorities. This agent has run reliably for two years — but it lives entirely in your head. One stressful week, you skip the planning step. Then you skip it again. Within a month, the agent has silently degraded and you don't notice until you're regularly arriving at work reactive instead of prepared. Had you written it down — trigger, conditions, actions — the degradation would be visible in the gap between the document and your behavior.

Try this: Pick one agent you already run — a decision rule, a recurring process, a behavioral protocol. Write it down in this format: (1) Name, (2) Trigger — what activates it, (3) Conditions — when it applies and when it doesn't, (4) Actions — the specific steps, in order, (5) Success criteria — how you know it worked. Time yourself. If it takes more than ten minutes, the agent is probably too broad (see Agent scope should be narrow). If you can't articulate the trigger or conditions, you've discovered the agent was vaguer than you thought.

Learn more in these lessons

Go beyond the answer

This topic is part of Your Personal AI Operating System — a guided sequence of 16 lessons.

After completing this path you will run a four-layer personal AI operating system: a persistent context layer (the AI knows your role, standards, and current work), a skill library (your repeated tasks specified once, invoked by name), scheduled routines (recurring work that runs without prompting), and a verification layer (specific, testable, documented agents you actually trust). You own the architecture; the tools become interchangeable.

Start the path →