nw-collapse-detectionlisted
Install: claude install-skill nWave-ai/nWave
# Collapse Detection
Documentation collapse = types merge inappropriately, serving no audience well.
## Anti-Patterns
### Tutorial Creep
Description: Tutorial explains "why" extensively | Detection: explanation >20% | Fix: extract to separate doc, link back
### How-to Bloat
Description: How-to teaches basics first | Detection: teaching fundamentals before steps | Fix: link to tutorial, assume baseline
### Reference Narrative
Description: Reference includes conversational prose | Detection: prose paragraphs in entries | Fix: move to explanation doc, keep factual
### Explanation Task Drift
Description: Explanation ends with "do this" steps | Detection: step-by-step in explanation | Fix: move steps to how-to, link
### Hybrid Horror
Description: Single doc tries all four types | Detection: 3+ quadrants in one doc | Fix: split with clear boundaries
## Detection Rules
Flag collapse when:
- >20% content from adjacent quadrant | Two user needs served simultaneously | Ambiguous user journey stage
- "Why" in tutorials | Task steps in explanations | Teaching in how-tos | Narrative in references
## Bad Examples for Calibration
### Tutorial with Task Focus
```markdown
# Getting Started
If you need to deploy to production, follow these steps...
```
**Problem**: Assumes user knows what "deploy to production" means. A tutorial should assume nothing.
### How-to Teaching Basics
```markdown
# How to Configure Authentication
First, let's understand what authentication is. Authenticat