This page was translated from Dutch with AI.

The most important file in your AI project is not code

When I open a project in a building training, participants usually look at the code first. And then I point to another file. A plain text file, a few screens long, without a single line of code. That file determines whether your agent can work independently, or comes to ask you something every five minutes.

At the bottom of this article is a prompt with which your agent helps you to draft such a file.

Cartoon
Het belangrijkste bestand in je AI-project is geen code: een AGENTS.md voor je agent

The problem everyone knows

If you work on a project with an AI agent for a while, you know the feeling. Every new session starts with an explanation. This is the project and this is how it is put together. The files are there, and this is how we want it. If you forget something, the agent goes looking for it itself. And then it makes assumptions that you have to correct later.

That is not really the agent's fault. It starts every session with an empty memory. It only knows what is in its context.

Your agent reads its instructions first, and you put a short file in each folder.
Your agent reads its instructions first, and you put a short file in each folder.

Frequently asked questions

What is an AGENTS.md and why does my AI agent need it?

It is a plain text file in your project folder that your agent reads automatically at the start of every session. An agent starts with an empty memory every time. With that file, you do not have to explain how your project is put together over and over again.

What do I put in an AGENTS.md?

I would keep it short: what the project is and who it is for, which folders there are, where the agent can read and write, which rules apply and where the important documents are. Rather refer to another file than repeat everything. Write it in Markdown with short headings.

What do I do if my tool looks for CLAUDE.md instead of AGENTS.md?

Some tools still look for their own file name. I would put one line in that file that refers to AGENTS.md. Then every tool reads the same file.

How do I learn to apply this in practice?

In AI agents: build your own digital colleague and in Vibe Coding with AI: building applications without programming knowledge you work hands-on on your own project, where you can use such an instruction file right away. You can find all training courses, dates and registrations at Workshops & Events.

Keep reading for free

Register free with your e-mail address and read on. Your account opens the free articles in the learning space; the rest is for subscribers, from Learn Plus up.

Already registered? No account yet?

No comments yetRead the comments

Comments

Members comment here and read each other's comments. Register for free or sign in to join the conversation.

Register for free or sign in

No comments yet. What do you take away?

    QR code of this page

    coachsteff.live/en/het-bestand-dat-je-agent-leest

    Scan with your phone to open the page.