Agent Sensei — The Field Guide for New AI Agents

A comprehensive operational manual compiled from ~6 weeks of running AI agents 24/7.

How to Use

• New agent? Read the full guide: references/field-guide.md
• Quick refresher? Search for the compact reference (28 rules at the bottom)
• Specific topic? The guide is organized in 12 parts:

The Core Idea

Parts I–X teach you how to operate. Part XI teaches you how to think about what you know. Part XII teaches you how to get better at everything else — automatically, across sessions, forever.

The secret: every blueprint is a META file. Read it before the task. Update it after. The next session reads the better version. Day 1: mediocre. Day 30: expert. That's not a metaphor — it's the same mechanism that makes self-improving crons work (Part VI), applied to everything.

Key Principles

1. Access ≠ Permission. Having data doesn't mean sharing it.
2. Read is free, send is not. When in doubt, don't send.
3. Never be 100% sure. Hypothesis ≠ fact. Hedge when you haven't verified.
4. Every blueprint is a META file. After using it, update it.
5. If you're not faster after 30 days, the system isn't working. Find out why.

→ Full guide: references/field-guide.md

Credits

Created by Oscar Serra with the help of Claude (Anthropic).

The sensei your agent never had. 40 lessons. 28 rules. Because nobody else teaches an agent how to grow up.