Один файл — одна тема. >600 строк или >3 крупные темы → дроби.
Папка сервиса (escrow/wallet/bridge) имеет свой README.md; внутри — flows/, decisions/ (ADR), problems/, diagrams/. Общие/сквозные флоу — в корневом flows/.
Не дублируй определения: всё в glossary.md (когда появится) или ссылайся на первоисточник.
Решения фиксируй как мини‑ADR (Context/Decision/Consequences), не переписывай длинными абзацами.
Ссылки вместо копипаста: код, RFC/ADR, регуляторные PDF.
Диаграммы только в текстовых форматах (Mermaid/PlantUML) рядом с MD; картинки без исходников запрещены.
Статус в шапке: draft/accepted/deprecated/superseded; помечай владельца.
В конце каждого файла — блок Next (до 5 пунктов) или чек‑лист; пустым не оставлять.
Убирай воду: факты, решения, риски, next steps. Истории и рассуждения — в main/ или в отдельный черновик.
Обновил код/арх/процесс → оставь ссылку в релевантном файле (не копируй текст).