22 lines
794 B
Markdown
22 lines
794 B
Markdown
|
# Progressive Disclosure References
|
||
|
|
|
||
|
|
How to organize knowledge so the AI reads only what it needs.
|
||
|
|
|
||
|
|
## What's here
|
||
|
|
|
||
|
|
| File | Purpose | When to read |
|
||
|
|
|------|---------|--------------|
|
||
|
|
| `reference-md-pattern.md` | How to write effective reference.md files | When creating a new references directory |
|
||
|
|
| `splitting-knowledge.md` | When and how to split knowledge docs | When a doc is getting too long, or deciding structure upfront |
|
||
|
|
|
||
|
|
## When to use this module
|
||
|
|
|
||
|
|
- You're creating reference.md files for a new skill
|
||
|
|
- You're deciding whether to split a knowledge doc
|
||
|
|
- A knowledge doc has grown past ~150 lines and needs restructuring
|
||
|
|
|
||
|
|
## Model guidance
|
||
|
|
|
||
|
|
- Writing reference.md files: cheap model (it's templated)
|
||
|
|
- Deciding *whether* to split: stronger model (requires judgment about cohesion)
|