the anatomy of the perfect π¦π’π¨π.πΊπ± file for AI agents.
π¦π’π¨π.πΊπ± is the one file you write yourself for an AI agent.
it sits at the top of the system prompt, before memory, before skills, before tools. it defines who the agent is when it shows up.
an hour spent on it changes every conversation that follows. most other layers update themselves. this one is yours.
i just broke down what a π¦π’π¨π.πΊπ± file that actually works looks like.
here are the 8 sections that matter:
β identity (a one-line statement of who, not what)
β core truths (imperative principles, each with a one-line unpacking)
β worldview (opinionated takes by domain, sharp enough to predict)
β voice (concrete rules for how the agent talks, not adjectives)
β expertise (primary domain, fluent tools, where it defers)
β boundaries (explicit "won't" lines, no soft language)
β memory policy (what persists, what stays private)
β pet peeves (phrases and tones the agent never produces)
generally people write "be helpful and professional" and call it done.
that changes nothing. every model already tries to be helpful and professional by default.
the agents that compound have π¦π’π¨π.πΊπ± files with real opinions, hard limits, and a voice you can predict before you read the response.
a strong π¦π’π¨π.πΊπ± is 30 to 80 lines. specificity beats coverage.
bookmark this. the first agent you build will need it.
i wrote a full masterclass on Hermes Agent that walks through the π¦π’π¨π.πΊπ± layer, the three-tier memory system, the self-evolving skills loop, and how to run three specialized agents on your machine 24/7.
the article is quoted below.