Setting Up Your agents.md

One of the most valuable things you can invest time in is figuring out the best agents.md setup for your workflow. This file is effectively your instruction manual for the AI agent.

Here’s a good approach: keep a repos folder locally where all your coded projects go. In that repos folder, place an agents.md that explicitly tells the agent how to set up each new repo. What to do and not to do, how to handle GitHub, how to commit, all that kind of stuff. You can even specify whether the agent should use a work GitHub account or a personal one.

Testing is a big one. End-to-end tests might not seem exciting at first, but they matter a lot when you’re building with AI agents. When you’re building things and testing them, there are often silly bugs that you should have caught had there been tests in the first place. Making “always write tests” part of your agents.md means the agent handles this automatically.

A great habit is to look at other people’s agents.md files to see what you can borrow for your own. The best setups are constantly evolving, getting a little better with each working session.