# Documentation and ADRs

> Record decisions so the next engineer and agent can follow

**Subcategory:** Authoring  
**License:** MIT  
**Source:** https://github.com/addyosmani/agent-skills/blob/main/skills/documentation-and-adrs/SKILL.md

---

## When it is useful

Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.

## The Catch

Record the decision. Agents write ADRs nobody asked for.