
Почему диаграммы важны
- Хочешь разобраться с управлением потоком в своей кодовой базе
- Нужно проследить lineage данных от входа до выхода
- Онбордишь других или документируешь свою систему
Два аспекта, которые стоит учитывать
- Цель: ты отображаешь логику, поток данных, инфраструктуру или что-то ещё?
- Формат: нужно что-то быстрое (например, диаграмма Mermaid) или более формальное (например, UML)?
Как формулировать запросы
- Потоки выполнения: “Покажи, как запросы проходят от контроллера до базы данных.”
- Происхождение данных: “Проследи эту переменную от точки входа до конечного места.”
- Структура: “Дай компонентный обзор этого сервиса.”
Работа с Mermaid
flowchart
для логики и последовательностейsequenceDiagram
для взаимодействийclassDiagram
для структуры объектовgraph TD
для простых направленных графов
- Открой вкладку Extensions
- Найди Mermaid
- Установи

Стратегия работы с диаграммами
- Выбери одну функцию, маршрут или процесс
- Попроси Cursor построить диаграмму этой части в Mermaid
- Когда будет несколько диаграмм, попроси его объединить их
Рекомендуемый подход
- Начни с детализированной низкоуровневой диаграммы
- Сверни её до среднего уровня
- Повторяй, пока не достигнешь нужной степени абстракции
- Попроси Cursor объединить их в одну диаграмму или карту системы
Выводы
- Используй диаграммы, чтобы понимать поток, логику и данные
- Начни с небольших подсказок и постепенно развивай диаграмму
- Mermaid — самый удобный формат для работы в Cursor
- Начинай с низкого уровня и поднимайся к абстракции, как в модели C4
- Cursor поможет легко генерировать, улучшать и комбинировать диаграммы