Documentation

What to update

• openspec/specs/ for behavior
• README for usage
• TSDoc for exported functions/classes

Rule

Document the "why" for non-obvious decisions.