Ecosystem Docs (dev-first)

Структура

• Папка сервиса (escrow/, wallet/, bridge/): свой README.md, а внутри — flows/, decisions/ (ADRы), problems/, diagrams/ (Mermaid/PlantUML). Всё локально к сервису.
• flows/ — общие/сквозные флоу (когда затрагиваются несколько сервисов).
• main/ — общие черновики, резюме ключевых решений.
• problems/ — расследования инцидентов, руткозы, «что пошло не так».

Основные правила

1. Определи цель заметки в первой строке.
2. Если фиксируется решение → мини‑ADR: Context → Decision → Consequences.
3. Диаграммы — только текстовые (Mermaid/PlantUML) рядом с MD.
4. Ссылки вместо копипасты (код, регуляторные документы, RFC/ADR).
5. В конце — 3–5 буллетов «что дальше» или чек‑лист.

Быстрый шаблон записи (копируй в новый файл)

Title: <кратко>
Status: draft
Owner: <ник>
Context: <1–3 предложения>
Decision / Notes: <факты, решения>
Links: <код/ADR/источники>
Next: <до 5 пунктов>