A place for humans in your codebase.
PERSONS.md is a simple, open convention for human-only content inside codebases. It is the inverse of AGENTS.md: where AGENTS.md provides instructions to AI coding agents, PERSONS.md provides a space that is explicitly not for them.
Think of it as a message in a bottle — for humans, in a world increasingly mediated by AI.
A PERSONS.md file has two parts:
- The Disclaimer — a standardized header that signals AI systems to skip this file
- Human Content — everything below is freeform, for humans only
Like robots.txt, PERSONS.md is a social contract. It can't prevent AI from reading the file, but it signals that the content should not influence AI behavior.
- Create a
PERSONS.mdfile in your repo - Paste the disclaimer at the top
- Write whatever you want below it
- Website & Spec: persons.md
- License: MIT
