harnsy

Как работает harnsy

Короткий интерактивный курс о том, как harnsy позволяет мультиагентной команде работать на вашей машине: что делает harnsy, кто есть кто, как общаются агенты и как запустить свою команду. Почти в каждом уроке есть что попробовать.

Модулей: 4Уроков: 17около 25 минут

  1. 1Что делает harnsy
  2. 2Кто есть кто: компания, проект, команда, роль
  3. 3Как говорят агенты: сообщения и передача дел
  4. 4Своя команда агентов

Не начатКак работает harnsy

Что делает harnsy

Вы уже пользуетесь кодовым агентом. harnsy позволяет нескольким из них работать одной командой на вашей машине, а решения остаются за вами.

1.1Проблема: вы работаете почтой

Вы уже пользуетесь Claude Code, Codex или OpenCode. Каждый хорош по отдельности. Трудности начинаются, когда агентов несколько. Один закончил то, что нужно другому, и вы переносите это руками. Вы становитесь почтой между собственными агентами. Время уходит на пересылку, а не на решения.

harnsy связывает эти инструменты. Он работает на вашей машине и доставляет сообщение прямо в работающую сессию. Агент читает его в том ходе, где уже находится.

Шаг за шагомОбе колонки идут вместе.

Без harnsyВаших шагов: 0

  1. kestrelbill-backend заканчивает эндпоинт экспорта.

С harnsyВаших шагов: 0

  1. kestrelbill-backend заканчивает эндпоинт экспорта.

Шагов, которые вы делаете сами: 0 без harnsy, 0 с harnsy.

Шаг 1 из 5

1.2Вы ведёте, агенты работают

В harnsy вы начальник и принимающий, а не участник команды. Вы говорите, что нужно. Лид разбивает это на работу для остальных. Они делают и проверяют друг друга. Вы вмешиваетесь, только когда что-то ждёт вас: ответ, разрешение, результат, который нужно принять или вернуть.

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

harnsy не обещает работу без человека. На трудных задачах агенты всё ещё уходят в сторону. Зато у вас есть процесс, в котором ваше время уходит на лида и на моменты, которые требуют вас.

Точки решений →

ОтветьтеЭто слова самого дашборда.

Ждёт вас1ждёт

kestrelbill-lead kestrelbill · Лид

Должна ли «выгрузка всех счетов ZIP-архивом» (#429) быть на всех тарифах или только на платных?

1.3Знакомьтесь: харнесы

Харнес — инструмент, в котором работает агент: Claude Code, Codex или OpenCode. harnsy соединяет инструменты, которые у вас уже есть. Он их не заменяет. Он использует только тот способ приёма сообщений, который инструмент сам предлагает. Разрешения остаются теми, что у самого инструмента.

Выберите харнес

harnsy пишет сообщение во входящие работающей сессии, как ход пользователя, а не как набранные клавиши.

Вы продолжаете пользоваться им, как раньше.

Ни один способ не набирает текст в терминале. Если доставка не удалась, harnsy об этом сообщает. Повторять набором он не будет.

1.4Ключевые слова

Карточки говорят то же, что модули. Возвращайтесь сюда, когда слово непонятно.

СловарьСлов: 13

Кто есть кто: компания, проект, команда, роль

Части harnsy: компания, проект, команда, роль, лид, агент, задача и дашборд, где вы всё это видите.

2.1Компания, проект, команда, роль

Компания — вся картина целиком. В ней хранятся шаблоны ролей. Проект — папка, в которой вы работаете. Команда принадлежит одному проекту. Роль — должность в команде: с задачей, целями и результатом.

Роли остаются. Агенты садятся на роли. Когда агента меняют, роль остаётся.

Поэтому работу несут инструкции, их версии и письменные записки о передаче дел, а не память одной сессии. Отсюда мысль «компания остаётся, агенты меняются».

Постоянные роли →

Открывайте по одному уровню

КомпанияKestrelbill

Вся картина целиком. Хранит шаблоны ролей, которыми может пользоваться каждый проект.

Уровней: 1 из 4

Компания: Вся картина целиком. Хранит шаблоны ролей, которыми может пользоваться каждый проект.

2.2Лид и агенты

У каждой команды вверху лид. Он раздаёт работу и следит, кто простаивает или застрял. Вас он спрашивает только о том, что не может решить сам.

Агенты занимают роли ниже. У роли какое-то время может быть несколько держателей: преемник держит роль рядом со старым, пока не закончится передача дел.

Лиду сообщают, когда:

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

Проверять по таймеру лиду не нужно.

Выберите рольВыберите роль, чтобы увидеть её работу.

Лидв сети
Задача
Разбивает ваши просьбы на задачи, раздаёт их, держит команду в движении, спрашивает вас о том, что не может решить сам.
Держит
kestrelbill-lead
Харнес
Claude Code
Контекст занят
41%

2.3Задачи: работа

Работа ведётся задачами. Задача принадлежит роли, а не сессии. Преемник находит её там, где остановился прежний держатель.

Задача идёт: Новые → Взяты → В работе → На проверке → Готово. Она может быть и в «Блок», пока ждёт (вас или чего-то внешнего до даты), или «Отменены». Само ничего не двигается: двигает кто-то.

Сдавая задачу, агент пишет итог и доказательства. Результат оценивает тот, кто просил: принять или вернуть с заметкой.

Управление задачами →

Подвиньте задачу

#412Частичные платежи в JPY округляются до 0,01Новая
Ещё возможно:
Кто двигает
Лид пишет её по вашей просьбе и выбирает роль.
Что пишет
Что, зачем и критерии.

2.4Дашборд, трей, колокольчик

Дашборд не нужно смотреть весь день. Он сам зовёт вас: уведомление в трее, колокольчик, ожидание или сбой. Вы действуете и возвращаетесь к работе.

Он работает на вашей машине по адресу 127.0.0.1:7788 и отвечает только на вашей машине.

Цвет везде значит одно. Янтарный: ждёт человека. Зелёный: работает. Красный: сбой или нет держателя. Синий: действие. Рядом с каждым цветом есть слово или форма.

Уведомления и настройки →

Прочтите цветаВыберите строку.

Агентыkestrelbill

Янтарный, зелёный, красный, синий: у каждого одно значение, везде в дашборде.

Проверьте себя

  1. Строка агента янтарная. Что ему нужно?

Отвечено: 0 из 1

Как говорят агенты: сообщения и передача дел

Три канала, три задачи: сообщения, задачи и передача дел.

3.1Три канала, три задачи

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

Сообщение что-то говорит. Задача что-то доводит до конца. Передача дел не даёт работе оборваться между сессиями.

Сравните

СообщениеЗадачаПередача дел
Что этоКороткое слово одному агентуРабота с владельцем, состоянием и результатомЗаписка следующему держателю роли
Кто пишетЛюбой агент другому по имениКто просит; лид передаёт её ролиАгент, у которого контекст почти заполнен
Сколько живётОдин ход разговораПока её не примут или не отменятПока преемник не подтвердит
Что показывает доставкуok значит передано харнесу. Не прочитано, не сделано.Состояние на доске и доказательства при сдачеПреемник подтверждает, что прочитал записку

3.2Приходит сообщение

Агент отправляет сообщение другому по имени. harnsy передаёт его харнесу, в котором работает получатель, его собственным способом. Получатель отвечает ответом, привязанным к первому сообщению. Разговор остаётся одним разговором.

Всё на шине записывается. Кто с кем говорил, видно во вкладке «Сообщения» и на графе «Связи».

Агенты общаются напрямую →

Шаг за шагом

kestrelbill-leadharnsykestrelbill-backend
  1. 1Лид отправляет сообщение kestrelbill-backend по имени.
  2. 2harnsy передаёт его харнесу, в котором работает бэкенд (Codex).
  3. 3Текст попадает в работающую сессию бэкенда, в этом же ходе.
  4. 4Бэкенд отвечает; ответ привязан к первому сообщению.
  5. 5Обмен записан: вкладка «Сообщения» и граф «Связи».

kestrelbill-backend · сессия

› codex · ~/kestrelbill · kestrelbill-backend

Прогоняю тесты для #418, воркер повторов…

Лид отправляет сообщение kestrelbill-backend по имени.

Шаг 1 из 5

3.3Главное различие

Соедините каждый канал со строкой, которая его описывает.

СопоставьтеВыберите канал, затем строку, которая ему подходит.

В парах: 0 из 3

3.4Когда что использовать

Нужен результат, который кто-то должен оценить: заведите задачу. Это вопрос или факт: отправьте сообщение. Агент, у которого знание, скоро уйдёт: пишите передачу дел.

Выберите канал

  1. Спросить тестировщика, зелёная ли сборка.

  2. Добавить тесты API оплаты к пятнице; лид примет.

  3. У дизайнера контекст у порога, идёт преемник.

  4. Проверяющий нашёл ошибку в готовой задаче.

Отвечено: 0 из 4

3.5Передача дел: компания остаётся, агенты меняются

Каждый шаг агента заново отправляет весь его контекст, а у контекста есть конец. У каждой роли свой порог передачи. Когда держатель его достигает, об этом узнаёт лид.

Работа продолжается, потому что следующий агент идёт по записке. Это не бесконечная память. Памяти в harnsy сегодня нет.

Передача дел →

Шаг за шагом

Разработчик бэкендапорог 70%
kestrelbill-backend52%
  1. kestrelbill-backend работает. Каждый шаг заново отправляет весь контекст.
  2. Контекст достигает порога роли (70%). Лиду сообщают.
  3. Держатель перестаёт брать новую работу.
  4. Он пишет записку: цель, что за ним, открытые нити, решения и почему, дальнейшие шаги.
  5. Он сообщает лиду, где записка.
  6. Лид открывает замену на той же роли.
  7. Замена читает записку и подтверждает.
  8. Старый агент остаётся консультантом, пока лид его не освободит.

kestrelbill-backend работает. Каждый шаг заново отправляет весь контекст.

Этап 1 из 8

Своя команда агентов

От нуля до первой команды, что в документе роли и как вы отвечаете и принимаете работу.

4.1От нуля до первой команды

Шесть шагов: от установки harnsy до первого слова лиду. Команду с вами собирает агент-инициатор; без вашего «да» он ничего не сохраняет.

harnsy без ключа: 1 проект, 10 работающих агентов, других машин нет. Восстановление, которое вышло бы за 10, ничего не откроет.

Пройдите шаги

Что нужно заранее · 0 из 3

harnsy их не ставит и в аккаунты не входит.

  1. Установка

    Вставьте это в своего агента. Он сначала покажет план, потом установит.

    Установи harnsy по инструкции: https://harnsy.dev/llms.txt
  2. Ответы установщика

    Запустите его в отдельном терминале. Он задаст несколько вопросов «да/нет». Каждое изменение ваших настроек показывается до того, как оно сделано, и можно ответить «нет».

    harnsy install
  3. Откройте дашборд

    По адресу 127.0.0.1:7788. Он пуст и предлагает «Соберите первую команду».

    Соберите первую командуЗапустить инициатора

  4. Запустите инициатора

    Нажмите «Запустить инициатора», укажите папку проекта, нажмите «Открыть инициатора». Он откроется вкладкой в «Терминалах». Он спрашивает про вашу компанию, папку, цели и роли и без вашего «да» ничего не сохраняет. Лид в списке есть всегда.

    Открыть инициатора

    не закрывайте Не закрывайте эту вкладку. Здесь инициатор задаёт вам вопросы.

    инициатор · ~/kestrelbill

    Как называется компания и что она делает?

    Kestrelbill. Выставление счетов для фрилансеров.

    Прочитал папку: бэкенд на Go, фронтенд на Vue, тесты в CI. Нашёл должности:

    1. Лид
    2. Разработчик бэкенда
    3. Разработчик фронтенда
    4. Проверяющий
    5. Тестировщик

    Сохранить компанию, проект и эти пять ролей? (да / нет)

  5. Посадите лида

    Скопируйте ссылку-приглашение, откройте свежего агента в папке проекта и вставьте её. Этот агент становится лидом и занимает остальные места.

    ссылка-приглашениеhttp://127.0.0.1:7788/i/4kq2-7f3a
  6. Скажите лиду, что нужно

    Задачи вы не заводите сами. Лид превращает ваши слова в задачи и раздаёт их. Отвечайте, когда он спрашивает.

4.2Что в документе роли

Документ роли агент читает при старте. В нём задача, цели, результат, что прочитать первым, кто лид, порог передачи и что делала эта должность раньше.

Шаблон компании даёт основу. Проект добавляет свой текст сверху. Правка сохраняется новой версией, и держатель узнаёт, что его обязанности изменились.

Прочтите документНаведите на блок, чтобы увидеть, зачем он здесь.

Или переведите фокус клавиатуры на блок.

Разработчик бэкендаv3kestrelbill

4.3Разрешения и приёмка

harnsy не переопределяет разрешения харнеса. Когда агент просит разрешения что-то выполнить или задаёт вам вопрос, колокольчик показывает это с кнопками. Вы отвечаете там же, не открывая терминал агента. Янтарный значит «ждёт вас».

Когда задача доходит до «На проверке», её оценивает тот, кто просил. Для ваших просьб это вы, на карточке задачи.

Колокольчик

Задачи / kestrelbill

Ждут вас2сначала старые

kestrelbill-reviewkestrelbill · Проверяющий

Просит разрешения на Bash

Команда

go test ./billing/... -run TestRecurring -count=20

kestrelbill-leadkestrelbill · Лид

Включать архивные счета в CSV-экспорт?

Проверьте себя

  1. Кто может одобрить разрешение, о котором просит агент?

Отвечено: 0 из 1

4.4Итоговая проверка

Один вопрос. Он проверяет, умеете ли вы читать дашборд.

Итоговая проверка

  1. Роль в дашборде красная и подписана «Место свободно: агент ушёл.» Что случилось?

Отвечено: 0 из 1

Картина ясна

Установите harnsy и посадите свою первую команду: последний модуль проведёт вас по шагам.

Установить harnsy
site-3fлид · Claude Codeна связитолько смотреть
❯ Распланируй #42 с командой.

Жду разбор от analyst-7a…

от analyst-7a через harnsy❯ #42 разобрана: три критерия приёмки, включая повтор через 24 ч.

Передаю #42 разработчику site-9a.

❯