Доска (Exalidraw)

Доска — визуальный редактор для схем, пользовательских сценариев, архитектуры и быстрых набросков. Доски сохраняются как обычные файлы рабочего пространства, поэтому их можно открывать вручную, передавать агенту и хранить рядом с материалами проекта.

Что можно создавать

• схемы процессов и пользовательские пути;
• архитектуру системы;
• карты идей;
• связи между экранами или сервисами;
• планы, заметки и аннотации;
• свободные рисунки.

Используйте стандартные инструменты Excalidraw: фигуры, стрелки, текст, линии, выделение и масштабирование.

Как начать

На главной странице Доски доступны три варианта:

1. Новая доска — создаёт пустой холст.
2. Шаблоны — создают стартовую схему процесса, архитектуру системы или карту идей.
3. Мои доски — показывают .excalidraw-файлы из доступных папок текущего рабочего пространства.

Новая доска по умолчанию сохраняется в /home/user/diagrams, но существующий .excalidraw-файл может находиться и в другой папке проекта.

Работа вместе с агентом

Откройте нужную доску, напишите задачу в чат и при необходимости разрешите прикрепить контекст Доски. Promto сам передаст агенту путь к открытому файлу и технические правила формата Excalidraw.

В обычном запросе достаточно описать:

• для чего нужна схема;
• кто будет её смотреть;
• какие блоки, шаги или участники обязательны;
• какие связи нужно показать;
• насколько подробным должен быть результат.

Вам не нужно перечислять внутренние поля JSON, команды проверки или служебные пути. Они относятся к работе агента, а не к постановке задачи.

Сохранение

Открытая доска автоматически сохраняется с небольшой задержкой после изменения. Статус в правом нижнем углу показывает:

• Сохраняем… — запись ещё выполняется;
• Сохранено — последняя версия записана;
• Ошибка сохранения — изменения не удалось записать.

При ошибке сохранения не продолжайте большой объём работы до восстановления записи.

Как сделать схему понятной

1. Сформулируйте один вопрос, на который должна отвечать схема.
2. Расположите основной путь последовательно: например, слева направо.
3. Используйте короткие подписи и ограниченный набор цветов.
4. Подписывайте неоднозначные стрелки и развилки.
5. Разделяйте текущее состояние и планируемый вариант.
6. Добавляйте легенду только тогда, когда обозначения нельзя понять без неё.

Ограничения

• Для работы с Доской нужен активный рабочий стол.
• В редакторе одновременно открыта одна доска, но в рабочем пространстве можно хранить несколько .excalidraw-файлов.
• Автосохранение не заменяет Git, экспорт или резервную копию критически важной схемы.
• Проверка структуры файла не подтверждает, что элементы визуально расположены удачно — итоговую схему нужно открыть и посмотреть.

Если доска не открывается

1. Проверьте, что рабочий стол активен.
2. Перейдите в Мои доски и нажмите Обновить.
3. Если показана ошибка чтения или сохранения, запишите её текст.
4. Найдите нужный .excalidraw-файл через приложение Файлы и убедитесь, что он существует.

Инструкции и CLI для агента

Отдельной focused-инструкции и отдельного CLI для Доски нет. Команд promto-board и promto board не существует.

Когда контекст Доски прикреплён к чату, Promto автоматически сообщает основному агенту:

• точный путь открытого .excalidraw-файла;
• правила чтения и изменения структурного JSON Excalidraw;
• требование сохранить существующие элементы и их стабильные идентификаторы;
• способ проверить элементы, связи и уникальность идентификаторов;
• UI-маркер OpenExcalidraw: <абсолютный путь>, который открывает результат в Доске.

Агент работает с файлом встроенными файловыми tools read, write и edit. Для технической проверки он может использовать стандартные CLI jq и rg, но это не инструменты управления живым холстом. Для Доски не запускаются dev-сервер и Preview.

Терминальный агент может найти файлы командой rg --files -g '*.excalidraw' /home/user и проверить JSON через jq, но результат всё равно нужно открыть в приложении Доска (Exalidraw).

Готовый промпт для агента

Создай в Доске (Excalidraw) новую схему «<название>».

Цель схемы: <какой вопрос она должна объяснить>.
Аудитория: <кто будет её смотреть>.
Обязательные блоки: <перечислите основные элементы>.
Связи и порядок: <опишите главный путь, развилки или зависимости>.

Расположи основной сценарий слева направо, используй короткие подписи и не больше трёх смысловых цветов. Не изменяй другие доски. Если информации недостаточно, сначала задай не больше трёх конкретных вопросов. Когда схема будет готова, открой её в Доске и кратко перечисли созданные блоки и связи.