Как документировать архитектуру?

Начни с C4 модели: Context (система в окружении), Container (сервисы, БД, очереди), Component (внутренности сервиса), Code (классы/пакеты). Не рисуй всё сразу — для большинства хватит Container diagram. Инструменты: Mermaid (в markdown), draw.io, Excalidraw. Храни рядом с кодом — иначе устареет. Обновляй при значительных изменениях. README в корне — как запустить, архитектура верхнего уровня. ADR — почему так решили. Swagger/OpenAPI — API документация. Лучшая документация — самодокументирующийся код + минимум диаграмм.