Решение проблем

Симптом	Что проверить
`agentboard` не найден	Перезапустите PowerShell после Scoop. При установке из ZIP используйте полный путь к `agentboard.exe`.
Веб-страница показывает старый интерфейс после сборки	Остановите запущенный сервер Ctrl+C. Выполните `./scripts/build.ps1`, запустите новый бинарник. Vite должен собраться до Go, потому что интерфейс встроен в EXE. Обновите страницу Ctrl+F5.
Порт 7337 занят	Возможно, AgentBoard уже работает. Откройте `http://127.0.0.1:7337` или завершите старый процесс. Для другого порта используйте `--addr`.
Проект не найден	В нужной папке выполните `agentboard init`. Затем `agentboard open` из неё или `agentboard open C:\путь\к\проекту`.
Воркер не видит задачи	Задача должна быть назначена именно этому воркеру и находиться в `Features`, `In progress`, `Testing` или `Verification`. `Backlog`, `Complete` и пользовательские колонки AI не видит.
MCP server check есть, а клиент не подключён	Проверка сервера не проверяет настройки внешнего клиента. Перезапустите клиент, проверьте его конфигурационный файл, путь к `agentboard.exe`, `--project`, `--worker` и общий `--db`. Попросите вызвать `get_my_board`.
Воркер Offline	Клиент мог завершиться или ещё не запускал MCP. После 90 секунд без heartbeat сессия считается отключённой.
Файл JSON не импортируется	Проверьте `version: 1`, обязательный `title`, существующие `Slug` воркеров и имена свойств. JSON не допускает комментарии и завершающие запятые.
Не удаётся пересобрать `agentboard.exe`	Windows не может заменить запущенный EXE. Остановите сервер Ctrl+C и повторите сборку.
Задачи пропали после обновления	Проверьте, что `--db` не указывает на другой файл и вы вошли под тем же пользователем Windows. База по умолчанию находится в `%AppData%\AgentBoard`.

Если ошибка не описана, соберите точный текст сообщения, версии agentboard version и Windows, а также действия для повторения. Не публикуйте приватные данные проекта или содержимое базы в открытом issue.