qi-layer

Installation
SKILL.md

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.

Installs
441
GitHub Stars
598
First Seen
Jul 5, 2026