.%20--%3e%3csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%201610%20300'%3e%3cdefs%3e%3clinearGradient%20id='kb'%20x1='0'%20y1='0'%20x2='0'%20y2='300'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%2373c6e5'/%3e%3cstop%20offset='.25'%20stop-color='%2352b5dc'/%3e%3cstop%20offset='.5'%20stop-color='%233a9fc8'/%3e%3cstop%20offset='.75'%20stop-color='%232b82ae'/%3e%3cstop%20offset='1'%20stop-color='%231a6490'/%3e%3c/linearGradient%3e%3c/defs%3e%3cg%20fill='url(%23kb)'%20fill-rule='evenodd'%3e%3cpath%20d='M0%20300V0H86V136H160V0H246V164H166V219H246V300H160V219H86V300Z'/%3e%3cpath%20d='M401%2083H321V0H567V83H487V219H567V300H321V219H401Z'/%3e%3cpath%20d='M642%20300V0H728V83H808V136H882V0H968V300H882V219H802V164H728V300Z'/%3e%3cpath%20d='M1043%20300V0H1289V164H1209V219H1289V300H1203V219H1129V300ZM1129%2083V136H1203V83Z'/%3e%3cpath%20d='M1364%20300V83H1444V0H1610V300H1524V219H1450V300ZM1450%2083V136H1524V83Z'/%3e%3c/g%3e%3c/svg%3e)
Truth Machine / Kit
Front Door
One canonical AGENTS.md that gives any capable newcomer, human or AI, the repository's identity, boundaries, and rules in one read.
Read as MarkdownTier: 0 · Normative weight: ergonomics; supports TM-DEC-006
Requires: nothing
Problem it removes
Every new session — a collaborator, a replacement AI Peer, yourself after a
month away — reconstructs the repository’s purpose, boundaries, and working
rules from scattered files, and reconstructs them differently each time.
TM-DEC-006 requires that correctness never depend on a particular model’s
memory or conversation history; a front door is what makes a durable
workspace self-sufficient in practice.
Mechanism
One AGENTS.md at the repository root carries: a two-sentence identity, a
numbered Start here reading order (status first), the authority
boundary, a repository map, the load-bearing structural rules, the
verification command, and — when subtrees need local rules — a table of
nested AGENTS.md files, each inheriting the root and overriding only its
subtree.
AGENTS.md is an open format launched by OpenAI in August 2025 and donated
to the Linux Foundation’s Agentic AI Foundation in December 2025, with
native support in Codex, Cursor, Gemini CLI, GitHub Copilot coding agent,
VS Code, Devin, and roughly twenty other tools. Claude Code is not among
them: it reads CLAUDE.md. The compatible shape is a CLAUDE.md stub
whose body is a pointer sentence plus the import line @AGENTS.md, so one
canonical file serves both audiences.
Cost
Authoring: an hour of honest writing. Per change: touch it only when a boundary or rule actually changes. Per session: negative — it is the file that makes every session cheaper.
Do not adopt when
The repository is a scratchpad or archive nobody will enter cold. A front door that is not maintained misleads more than silence.
Evidence
Observed in every maintained Kinra repository. The nested-guidance tiering
was recorded as a decision in the flow repository
(assessed report), and the
CLAUDE.md → @AGENTS.md stub is the pattern kinra-site itself uses.
Template
templates/front-door/AGENTS.md
Related patterns
Status Document is the first thing the front door points at. Authority Boundary is usually a section of this file before it earns its own mechanism.