# 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)
