Agents, the folder is the agent

Agent is the most overused word in AI right now. Most people imagine a black-box autonomous robot. That misunderstanding is expensive. It makes people scared of agents (too magical), disappointed by them (not magical enough), or sold things that are not really agents.

Once you see that an agent is a folder, the fear and mystique go away. You can read it. Edit it. Copy it. Hand one to a teammate. Build a new one in fifteen minutes.

What is actually in the folder

An agent is not a magical entity. It is a folder on your computer that contains six kinds of file. The LLM is the same Claude everyone else uses. The folder is what makes Claude behave like a specialist.

• Role definition
  A markdown file (often called AGENT.md or named after the agent) that tells the LLM who it is, what it does, what to avoid, and what tone to use. The shortest version of a job description.
• Skills
  Reusable prompts the agent invokes for specific tasks. Slash commands. Short, named playbooks. The verbs of the agent.
• Context
  The files the agent reads before it starts. The product plan for the developer. The QA plan for QA. The design system for anyone who writes UI. Anything the agent should know before the first line of work.
• Routines
  What the agent does on a schedule or a trigger, without being asked. Every morning: read what shipped and propose the day. Every commit: run the tests. Every new lead: score it. A routine is a skill plus a trigger.
• Guardrails
  What it may never do without you. Never email a customer. Never delete a row. Never push to main. Written down in the folder, so the rule survives the session and the model.
• Definition of Done
  How the agent knows it is finished. A checklist it can test, with evidence. Without it, an agent either stops too early or never stops. With it, it stops, reports, and waits.

Why the folder framing matters

Once you see that an agent is a folder, the fear and the mystique both go away. You can read it. Edit it. Copy it. Hand one to a teammate. Make a new one in fifteen minutes by copying an existing one and changing the role.

The opposite framing, the magic-black-box framing, is what makes people scared of agents, disappointed in them, or sold things that are not really agents at all. If you cannot open the folder, you do not own the agent.

How to configure one

Start from an agent that exists. Copy its folder. Rewrite the role in three sentences. List the skills it needs and delete the ones it does not. Point its context at the files for this job. Give it one routine, one guardrail, and a Definition of Done it can test. Run it on a small prompt. Read the output. Edit the folder. Run it again.

Every agent you will ever build is that loop. The folder is the agent; the loop is how you raise it.

You have seen, with your own eyes, that the agent is the folder. Same model, different folder, different specialist. The black-box mystique is gone for good.