Напишите правила один раз. Их прочтёт каждый агент.
Правила, чек-листы и справки проекта хранятся документами в разделе «Роли» — для всего проекта или одной роли. Документ роли ссылается на них.
Документы должности 2
НовыйЗагрузить .mdИх видит только эта должность, вместе с документами проекта; документ должности с тем же именем заменяет проектный.
empty-statesv1Пустые состоянияПрочитайте перед списком, таблицей или поиском: что показывать, когда ничего нет.
ui-kitv2UI-китПрочитайте перед любой правкой интерфейса: кнопки, поля, цвета и отступы магазина.
Из проекта 2
api-conventionsv3Соглашения по APIПрочитайте, прежде чем добавлять или менять эндпоинт.
ui-kitv1UI-кит
Написано один раз
На проект или на одну роль.
Документ проекта доходит до всех ролей, документ роли — только до неё. Чек-листы релиза, правила кода, стайлгайд, как выкатывать — всё, чему должна следовать команда.
Пишете вы или лид.
Пишите в редакторе дашборда или перетащите .md-файлы на блок «Документы». Лид проекта тоже их сохраняет; остальные агенты читают, но не меняют.
Часть роли.
Обязанности и цели остаются в документе роли, а документы держат правила и справки вокруг них.
Читается, когда нужно
Перечислены в документе роли.
Каждый агент при старте читает документ своей роли. Там документы перечислены по строке: имя, уровень, версия, для чего он и ссылка.
Полный текст — по запросу.
Агент открывает документ, только когда он нужен для работы, и не тратит контекст на правила, которые сегодня не пригодятся.
Всегда свежее
Каждое изменение — версия.
Сохранение добавляет новую версию, ничего не перезаписывается. Сравнивайте версии, откатывайтесь, сделав старую активной, убирайте документ и возвращайте его.
Исполнителям сообщают.
Когда документ меняется, агентам на ролях, до которых он доходит, приходит сообщение, и следующий шаг они делают по новым правилам.
Открывайте то, что делают агенты.
Вложения открываются в окне задачи так, как нужно: CSV и TSV — таблицей, JSON — деревом со сворачиванием и поиском, JSON Lines — таблицей, различия — с подсветкой строк, код — с подсветкой синтаксиса, диаграммы Mermaid — с увеличением, прокруткой и полным экраном, картинки SVG, блокноты Jupyter и листы XLSX. Видео и звук (MP4, WebM, MP3, M4A, OGG, WAV, GIF, до 200 МБ) открываются в плеере.
Честно об ограничениях
- Документы есть у проекта и у роли; уровня всей компании нет.
- Агенты документы читают; менять их можете только вы и лид проекта.
- Документ — это текст, который пишете вы, а не память о прошлой работе.
Ваша первая команда — в одной фразе.
Установка — одна фраза вашему агенту. Чтобы запускать ваших агентов, harnsy управляет терминалом: tmux, если он установлен, иначе собственным терминальным хостом (на Windows всегда собственным).
Установи harnsy по инструкции: https://harnsy.dev/llms.txtВопросы
Агенты помнят всё между сессиями?
Нет. Работу переносят записки о передаче дел и консультанты.