## Lesson — Documenting a problem is insufficient for effective

**Tags:** documentation, dx, patterns

Documenting a problem is insufficient for effective guidance; every architectural lesson should include an explicit "Fix:" instruction. This transitions the documentation from a list of warnings to an actionable checklist that guides resolution.
