qi-layer
qi-layer
How to write the colocated pair, AGENTS.md and .context/CONTEXT.md, in
any tree agents work in: code, a KB, docs, a work directory.
/creative-writing-skills:knowledge-layers says what belongs in which place; /creative-writing-skills:qi-maintenance keeps
the pair true as the tree changes.
Writing AGENTS.md
AGENTS.md is loaded automatically: the root one into every session, a
nested one when an agent works in its directory, on harnesses that load
nested files. Codex loads only the files from the root down to where it
started, so the root tells agents to read an area's AGENTS.md before
changing that area. Write instructions there, not in a CLAUDE.md: Claude reads
AGENTS.md only when no CLAUDE.md sits in the directory or above it. Every line costs every
agent that works there, every time, so it holds only the most important
information: what must an agent understand before working here? Write it
like a prompt, as short as the directory allows, rarely past 200 lines.
Write a nested file as the local additions an agent needs on entry.