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.