knowledge-layers

Installation
SKILL.md

Knowledge Layers

Knowledge lives next to what it describes. Load /creative-writing-skills:qi-layer before writing AGENTS.md or .context/.

Three Places

Place What goes there Reader
Beside the code (AGENTS.md, .context/) Knowledge about this directory, and its deferred work in .context/TODO (must-do) and FUTURE (nice-to-have); /creative-writing-skills:qi-layer says which file An agent about to work in the directory
KB Why the project is the way it is, where no one directory owns the reason; domain concepts; facts about the outside world A future agent or the owner, without this work's context
Work directory Anything not settled yet: plans, options, open questions, scratch Agents on this work item

Colocate first. Knowledge about one subsystem goes in its AGENTS.md or .context/, even when it reads like a concept: a doc far from what it describes isn't updated when that thing changes. The KB holds what would survive a rewrite of any one implementation. Deferred work that spans directories or needs outside visibility goes to the issue tracker.

Installs
441
GitHub Stars
598
First Seen
Jul 5, 2026