knowledge-layers
Installation
SKILL.md
Knowledge Layers
Load /qi-layer when writing or editing AGENTS.md or .context/ files: it
owns the craft (four principles, contents guidelines, what doesn't belong).
Load /information-hierarchy if not already loaded for disclosure tiers.
Load /llm-writing if not already loaded.
The Five Layers
| Layer | What it holds | When to use it |
|---|---|---|
AGENTS.md |
Intent and mental model for a directory | First thing agents read on entry; what to understand before working here |
.context/ |
Contracts, architecture, rationale (CONTEXT.md); deferred work (TODO, FUTURE) |
Reference depth and tracked deferrals, co-located with the code they describe |
| KB | Cross-cutting decisions, domain concepts, patterns | Spans directories; outlives sessions; no single directory owns it |
docs/ |
User-facing documentation | Different audience, different update cadence |
| Work directory | Temporary design decisions and scratch | Not colocated with durable content; scoped to an active work item |