Дашборд

Запуск

У чекауті harness-demo запусти:

pnpm dashboard

Потім відкрий http://127.0.0.1:4777. Дашборд слухає лише 127.0.0.1. Його кнопки пишуть ті самі файли, що й CLI, тож обидва можна використовувати паралельно. Що роблять Start, Pause, Resume і Stop — на сторінці Керування циклом.

Проєкти

Перший екран показує всі проєкти, які знає harness. Проєкт — це локальний git-репозиторій, у якому працює цикл.

1234

1. 1Те саме з термінала: harness projects add і harness example.
2. 2Один проєкт: його задачі, скільки з них чекає на тебе, і юніт у роботі (T-001 у qa).
3. 3Open board веде на дошку проєкту. Remove просить підтвердження.
4. 4Add a project приймає будь-який локальний git-репозиторій. Цикл створює в ньому .harness/ і нічого більше не чіпає, доки ти не подаси задачу.

Екран Projects дашборда: проєкт bookmarks і форма Add a project.

Дошка

У кожного проєкту своя дошка. Колонка — це статус задачі, картка — задача. New task відкриває чернетку на два рядки.

123456

1. 1Заголовок рахує задачі, які чекають на тебе, і пише, чому чекає кожна. Чернетки мають окреме речення, бо цикл на них запускає лише Submit.
2. 2Тринадцять колонок у п'яти групах: Define, Plan, Build, Review, Finish. Порожня колонка згортається у вузьку смужку.
3. 3Картка показує свій трек етапів. Коли картка чекає на тебе, на ній одна дія: Submit, Answer, Approve, Review або Reopen.
4. 4Спінер позначає картку, над якою юніт працює просто зараз. Такий знак має щонайбільше одна картка.
5. 5Картка в parked називає контракт, який її зупинив: тут файл README.md змінено поза scope задачі.
6. 6Док Live: supervisor із Pause і Stop, юніт у роботі, що буде далі, і останні юніти.

Дошка проєкту bookmarks під час qa-юніта, праворуч док Live.

Задача: інтерв'ю

Клік по картці відкриває її шухляду. Задача в needs-input відкривається на вкладці Interview, з питаннями, які поставив агент.

1234567

1. 1Відкрита задача лишається обведеною на дошці.
2. 2Хто і коли спитав: writer, на етапі spec, у юніті 5.
3. 3Файл задачі у вкладках. Interview з'являється, лише коли в задачі є питання.
4. 4У кожного питання є варіанти з літерами. Рекомендований стоїть першим, разом із причиною.
5. 5До кожної відповіді можна додати нотатку для агента.
6. 6Одна кнопка записує всі відповіді у файл задачі.
7. 7Твоя чернетка лишається внизу шухляди.

Шухляда задачі T-003 із двома питаннями writer і варіантами з літерами.

Задача: прототип

Задача з kind: ui перед збіркою зупиняється в prototype, і шухляда відкривається на вкладці Prototype.

123456

1. 1T-001 — UI-задача, тож перед збіркою вона зупиняється в Prototype. Картка показує раунд і просить Review.
2. 2Вкладка Prototype з'являється в UI-задач.
3. 3Accept переводить задачу в ready.
4. 4Або напиши, що змінити в наступному раунді. Шухляда показує, скільки раундів лишилось.
5. 5Картинка раунду з теки артефактів задачі. Із застосунком designer знімає запущений маршрут як prototype.png у 1440×900; без нього малює prototype.svg — вайрфрейм 1440 px зі справжнім текстом, розкладкою й кольорами сторінки. Тут її намалював fake agent.
6. 6Твоя чернетка, щоб звірити картинку із запитом.

Шухляда задачі T-001 на вкладці Prototype: Accept, поле коментаря і картинка раунду.

Задача: доставлена

З увімкненим deliver.pr задача в done отримує ще один крок runner: пуш і pull request. Дошка показує обидва боки цього кроку.

1234

1. 1T-002 у done. З увімкненим deliver.pr на картці написано PR next, а сірий спінер показує, що цикл візьме її наступною.
2. 2T-001 доставлено. Картка веде на свій pull request, PR #1.
3. 3Шухляда повторює: Pull request #1, мердж — за тобою. Це посилання дав fake gh, а не справжній репозиторій.
4. 4Трек етапів засвічений до кінця: delivered — останній статус.

Дошка з доставленою T-001 і готовою T-002, і шухляда T-001 з посиланням на pull request.

Live

Live trace показує, що робить юніт, поки він працює, і що зробив кожен попередній.

123456

1. 1Кожен юніт, який запустив цикл, найновіші зверху. Верхній працює зараз.
2. 2Юніт 8 закінчився жорсткою зупинкою, і T-004 пішла в parked.
3. 3Юніт у роботі: його задача, етап, скільки він триває і яких спеціалістів може викликати.
4. 4Доріжка координатора: він передав роботу qa.
5. 5Доріжка спеціаліста: кожен виклик інструмента з часом і назвою файлу. Аргументи інструментів і повідомлення не показуються ніколи.
6. 6Лог supervisor, найновіші зверху: старти, коди виходу, переходи статусів і коміти.

Екран Live trace: список юнітів, qa-юніт у роботі з агентами і лог supervisor.

Stats

Stats підсумовує usage, про який звітував кожен юніт, за етапами й задачами. Вартість — це ціна в еквіваленті API, яку повідомляє claude -p: вхід через підписку не тарифікується за токени, натомість діють ліміти використання. harness stats друкує ті самі таблиці в терміналі.

123456

1. 1Підсумки: юніти, вартість в еквіваленті API, токени, час агентів і відхилені виклики інструментів. Вартість — це ціна, яку повідомляє claude -p; вхід через підписку не тарифікується за токени.
2. 2Юніт, агент якого не надрукував usage, рахується як невідомий, а не як нуль.
3. 3За етапами: координатор, скільки задач запарковано, і смужка вартості.
4. 4За задачами, з поточним статусом.
5. 5Вердикти, які надрукували координатори: qa PASS, judge CONFIRMED.
6. 6Виклики інструментів, які відхилив режим дозволів. Часті вказують на пропущений запис в agent.allowedTools.

Екран Stats: підсумки, вартість за етапами й задачами, вердикти і відмови дозволів.

Agents

Agents показує, хто працює на кожному етапі і як юніт запускає Claude Code, тож налаштування можна перевірити до запуску.

1234567

1. 1Один координатор на етап, кожен — це claude -p на своїй моделі. Judge працює на opus.
2. 2Спеціалісти, яких кожен юніт отримує через --agents. Крапка позначає етап, що його пропонує.
3. 3Підсумок перевірок, які не дають запустити юніт.
4. 4Перевірки: модель judge відрізняється від моделей implementer і tester, і кожен агент несе актуальні standing rules.
5. 5Як юніт запускає Claude Code. Ця помаранчева картка з'являється лише тому, що AGENT_CMD вказує на fake agent; у справжньому проєкті тут звичайна команда claude. Зі справжнім claude тут є ще рядок Billing: як тарифікується запуск.
6. 6Delivery і Telegram, тут обидва вимкнені. Для delivery потрібен deliver.pr, для Telegram — TELEGRAM_BOT_TOKEN і TELEGRAM_CHAT_ID.
7. 7Режим дозволів, джерела налаштувань і дозволені інструменти. Комітів і пушів тут немає навмисно: цикл комітить лише після того, як пройдуть контракти.

Екран Agents: координатори етапів, матриця спеціалістів, перевірки і виклик.