Add a local task control dashboard

.agent-policy.yaml

@@ -47,6 +47,12 @@ projects:
         - "fix/"
         - "issue/"
         - "tast/"
+        - "chore/"
+        - "docs/"
+        - "refactor/"
+        - "test/"
+        - "release/"
+        - "perf/"
       low:
         commit: true
         push: true

.agent-repositories.yaml

@@ -10,6 +10,12 @@ repositories:
       - "fix/"
       - "issue/"
       - "tast/"
+      - "chore/"
+      - "docs/"
+      - "refactor/"
+      - "test/"
+      - "release/"
+      - "perf/"
     protected_paths:
       - ".env"
       - ".env.*"

.agent/project.yaml

@@ -0,0 +1,9 @@
+version: 1
+project:
+  id: agents
+  profile: agent_workspace
+  repository: .
+  base_branch: main
+  branch_prefix: feat/
+runtime:
+  provider: codex-cli

README.md

@@ -0,0 +1,81 @@
+# AI Harness
+
+Система для автономного выполнения задач в Git-проектах через команду `agent`.
+
+## Установка
+
+Скачайте репозиторий как ZIP, распакуйте его и в Terminal перейдите в распакованную папку:
+
+```sh
+cd ~/Downloads/agents-main
+./install.sh
+```
+
+Установщик сам проверит Python, установит изолированный менеджер приложения без `sudo` и добавит команду `agent`. Если Terminal попросит открыть новое окно, сделайте это один раз.
+
+Альтернатива без ручного скачивания архива:
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/mdvcode/agents/main/install.sh | sh
+```
+
+## Первый запуск
+
+Перейдите в свой проект и выполните:
+
+```sh
+cd /путь/к/проекту
+agent init
+agent doctor --full
+```
+
+`agent init` добавляет локальную конфигурацию и инструкции проекта. Если команда сообщает, что `.agent/project.yaml` и `AGENTS.md` исключены из Git, это нормально: оставьте их локальными и **не** используйте `git add -f`. Если они не исключены и появились как новые файлы, перед первой задачей либо сохраните их в Git, либо добавьте одобренные проектом правила игнорирования. Для запуска задачи рабочая папка должна быть без незакоммиченных изменений.
+
+Запустите задачу и следите за ней:
+
+```sh
+agent task "Опиши, что нужно сделать"
+agent watch
+```
+
+Или откройте локальный интерфейс, где можно запускать задачи, видеть прогресс, отвечать системе, одобрять решения и останавливать выполнение:
+
+```sh
+agent dashboard
+```
+
+Страница откроется автоматически. Пока интерфейс используется, оставьте это окно Terminal открытым; `Ctrl+C` закрывает только дашборд, worker продолжает работать отдельно.
+
+Если нужно работать в уже открытой ветке:
+
+```sh
+agent task --current-branch "Опиши, что нужно сделать"
+```
+
+Если системе понадобится ответ, `agent watch` напечатает точную команду `agent answer`. Если потребуется осознанное одобрение риска, она отдельно напечатает `agent approve`.
+
+## Обновление
+
+```sh
+agent update
+```
+
+Команда скачивает обновление, переустанавливает приложение и перезапускает фоновый сервис. Локальные изменения в папке исходников не затираются: обновление остановится и объяснит, что нужно сохранить или отложить.
+
+Если старая версия отвечает `invalid choice: 'update'`, один раз повторно запустите установщик из свежей распакованной папки или выполните:
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/mdvcode/agents/main/install.sh | sh
+hash -r
+agent update --help
+```
+
+После этого последующие обновления выполняются обычной командой `agent update`.
+
+После обновления можно проверить всё одной командой:
+
+```sh
+agent doctor --full
+```
+
+Подробная инструкция: [docs/operator-runbook.md](docs/operator-runbook.md).