---
name: documentation
description: "Generate/update README/API/architecture docs from the actual implementation rather than inventing behavior."
---

# Documentation Skill

Generate/update README/API/architecture docs from the actual implementation rather than inventing behavior.

## Principles

### Source of Truth
- Read code first
- Document what exists
- Don't speculate on behavior

### Types
- README: project overview, setup, usage
- API: public interfaces, parameters, returns
- Architecture: module boundaries, data flow

### Maintenance
- Update with code changes
- Delete stale documentation
- Link to code references