Harness Assistant Desktop

Desktop-помощник для проектирования, ведения и проверки AI-agent harness по материалам курса Learn Harness Engineering.

Tauri 2 · React 18 · Vite · Tailwind · Rust

## Что это Harness Assistant - локальное desktop-приложение, которое помогает собрать рабочую систему вокруг AI-агента: не просто промпт, а полный harness с intake, декомпозицией, feature-list, verify-командами, handoff и анти-ошибками. Приложение сделано как практический dashboard по русской версии курса [Learn Harness Engineering](https://walkinglabs.github.io/learn-harness-engineering/ru/). Курс объясняет, почему даже сильные агенты ломаются без внешней системы контроля, и предлагает инженерный подход: repo как source of truth, WIP=1, прогресс-файлы, stop conditions, верификацию и clean handoff между сессиями. ## Для чего Harness Assistant полезен, когда нужно: - быстро оформить требования к задаче для AI-агента; - не дать агенту уйти в scope creep; - держать одну активную фичу вместо хаоса из параллельных задач; - заранее прописать verify pipeline; - получить стартовый комплект harness-файлов; - подготовить handoff для следующей сессии; - объяснить команде, что именно должен проверить агент перед словом "готово". ## Что внутри приложения - `Intake` - описание проекта, команд запуска, тестов и ограничений. - `Scaffold` - генерация базовых harness-файлов. - `Features` - управление списком фич и статусами. - `Verify` - фиксация команд проверки и ожидаемых сигналов. - `Handoff` - чистый выход из сессии с понятным состоянием. - Multi-agent режим - роли `Planner`, `Implementer`, `Verifier`. - Каталог анти-паттернов из лекций L02-L12. - Светлая и тёмная тема с сохранением в `localStorage`. ## Сгенерированные harness-файлы Приложение помогает подготовить: - `AGENTS.md` - `docs/harness/progress.md` - `docs/harness/feature-list.json` - `docs/harness/verify.md` - `docs/harness/session-handoff.md` - `docs/harness/tools.md` - `docs/harness/anti-patterns.md` ## Готовая установка на Windows Если тебе нужно просто установить приложение, скачай ZIP-пакет: ```text release\HarnessAssistant-Windows-0.1.0-x64.zip ``` Распакуй ZIP и запусти основной установщик: ```text release\HarnessAssistant-Setup-0.1.0-x64.exe ``` Запасной MSI-вариант: ```text release\HarnessAssistant-0.1.0-x64.msi ``` Если при открытии `.exe` или `.msi` видны странные символы, файл открыт как текст. Нужно скачать ZIP, распаковать его и запускать установщик двойным кликом из Проводника Windows. Проверочные суммы: ```text release\SHA256SUMS.txt ``` ## Windows 10: запуск из исходников Целевая система: Windows 10 `10.0.19045` x64. Установить один раз: ```powershell winget install CoreyButler.NVMforWindows winget install Rustlang.Rustup winget install NSIS.NSIS winget install Microsoft.VisualStudio.2022.BuildTools ``` В Visual Studio Build Tools включить: - `Desktop development with C++` - `MSVC v143` - `Windows 10 SDK` или `Windows 11 SDK` WebView2 Runtime обычно уже есть на Windows 10. Если его нет: ```text https://developer.microsoft.com/en-us/microsoft-edge/webview2/ ``` Node должен быть LTS `20` или `22`. Рекомендуется `22`: ```powershell nvm install 22 nvm use 22 node --version ``` Bootstrap: ```powershell cd D:\harness-assistant-desktop npm install npm run setup:rust npm run check:env ``` Dev режим: ```powershell npm run tauri:dev ``` Release сборка Windows: ```powershell npm run build npm run tauri:build:windows ``` Ожидаемые Windows-артефакты: ```text src-tauri\target\release\bundle\msi\Harness Assistant_0.1.0_x64_en-US.msi src-tauri\target\release\bundle\nsis\Harness Assistant_0.1.0_x64-setup.exe ``` ## MacBook / macOS: запуск из исходников Готовый `.dmg` нужно собирать на macOS. С Windows нативный macOS installer корректно не собирается. Установить один раз: ```bash xcode-select --install /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" brew install node@22 rustup-init rustup-init rustup default stable ``` Открыть новый терминал и проверить: ```bash node --version npm --version rustc --version cargo --version ``` Bootstrap: ```bash cd harness-assistant-desktop npm install npm run check:env ``` Dev режим: ```bash npm run tauri:dev ``` Release сборка macOS: ```bash npm run build npm run tauri:build:mac ``` Ожидаемые macOS-артефакты: ```text src-tauri/target/release/bundle/macos/Harness Assistant.app src-tauri/target/release/bundle/dmg/Harness Assistant_0.1.0_*.dmg ``` ## Команды проекта ```bash npm run check:env npm run setup:rust npm run dev npm run build npm run tauri:dev npm run tauri:build:windows npm run tauri:build:mac npm run tauri:icon ``` `tauri:dev` и `tauri:build:*` сначала запускают preflight. Если нет `cargo`, `rustc`, WebView2, MSVC или NSIS на Windows, команда остановится с понятной ошибкой. ## Иконки Исходник логотипа: ```text assets\icon-1024.png ``` Сгенерировать полный набор Tauri-иконок: ```bash npm run tauri:icon ``` Результат: ```text src-tauri/icons/ ``` ## Структура ```text harness-assistant-desktop/ ├── assets/ │ └── icon-1024.png ├── release/ │ ├── HarnessAssistant-Setup-0.1.0-x64.exe │ ├── HarnessAssistant-0.1.0-x64.msi │ └── SHA256SUMS.txt ├── scripts/ │ ├── check-env.mjs │ ├── ensure-icon-source.mjs │ ├── run-tauri.mjs │ ├── setup-rust-msvc.mjs │ └── tauri-preflight.mjs ├── src/ ├── src-tauri/ │ ├── Cargo.lock │ ├── Cargo.toml │ ├── icons/ │ └── tauri.conf.json ├── .nvmrc ├── package-lock.json └── package.json ``` ## Troubleshooting ### `cargo metadata` error Причина: rustup установлен, но нет активного Rust toolchain. ```powershell npm run setup:rust rustc --version cargo --version ``` ### WebView2 missing на Windows Установить Microsoft Edge WebView2 Evergreen Runtime: ```text https://developer.microsoft.com/en-us/microsoft-edge/webview2/ ``` Проверить: ```powershell npm run check:env ``` ### MSVC toolchain missing на Windows Открыть Visual Studio Build Tools Installer и включить `Desktop development with C++`. Проверить: ```powershell npm run check:env ``` ### Node version mismatch Node `25` не используется для dev/release-сборок этого проекта. Перейти на LTS: ```powershell nvm install 22 nvm use 22 npm install ``` ### NSIS missing на Windows Нужен для `.exe` installer: ```powershell winget install NSIS.NSIS npm run check:env ``` ### Xcode Command Line Tools missing на macOS ```bash xcode-select --install npm run check:env ``` ## Credits Идея и терминология harness engineering основаны на учебных материалах [Walking Labs - Learn Harness Engineering](https://walkinglabs.github.io/learn-harness-engineering/ru/). Это не официальный релиз Walking Labs, а desktop-помощник, собранный поверх идей курса для локальной работы.

harness-assistant-desktop

Описание

Языки