Definition of Done

Documentation is part of the change, not a later phase. Do these steps as you finish a change. You don't need permission to do them, but you must say what you did.

0. Learn the repo's conventions first

Look at what exists before writing anything:

• CHANGELOG.md: follow its format. If there isn't one, ask before creating it.
• docs/: which files describe the area you touched?
• Diagrams: mermaid files in docs/, openspec/diagram/, architecture/ or similar.
• ADRs: docs/adr/, docs/decisions/, adr/. Reuse the repo's template if it has one, otherwise use references/adr-template.md.
• Repo instructions (AGENTS.md, CLAUDE.md, CONTRIBUTING.md) win over this skill.

Don't introduce structure the repo doesn't use (a docs/ tree, an ADR folder) without asking.