Задача: добавить карточку инструмента в Нейро каталог. Следуй AGENTS.md. Не коммить. После правки скажи URL для проверки.
Harness — каркас вокруг модели
Соберите окружение, в котором агент не угадывает, а следует закону проекта.
Простыми словами
Что это
Harness (сбруя) — это каркас вокруг модели: правила, сценарии, автоматика до/после действия и границы прав.
Промпт говорит «что сделать сейчас». Harness отвечает «как у нас принято всегда» — и не даёт сломать проект одной фразой.
В Cursor / ProektMap harness живёт в AGENTS.md, .cursor/rules, skills, hooks и структуре папок.
Движок и тормоза
Что ведёт действие и что его ловит
Запрос человека → совпадение skill → правило в AGENTS → план → инструмент / сабагент
Хук после правки → линтер / validate → аудитор → запрет (например, prisma force-reset)
Пример: «Добавь решение» → skill resheniya-author. Создана страница → чеклист ловит: нет в SITE_TREE → стоп или автофикс.
| Часть | Роль |
|---|---|
| Инструкции (AGENTS.md, rules) | Закон проекта: что всегда / никогда |
| Skills | Готовые сценарии: «когда задача X — делай так» |
| Сабагенты | Специалисты: один копает, другой пишет, третий проверяет |
| Хуки | Автоматика до/после действия: формат, тест, запрет |
| Права | Что можно трогать: файлы, сеть, git, secrets |
| Папка проекта | Карта мира: код, доки, скиллы, запретные зоны |
| Инструменты | Руки агента: Read, Shell, Browser… |
| Память / граф (graphify) | Не гадать — спросить карту связей |
Перед практикой
Чеклист окружения
- Есть AGENTS.md или эквивалент «закона»Всегда / никогда без двусмысленности
- Папка .cursor/rules и skills на местеСценарии под повторяющиеся задачи
- Права: .env и force-reset закрытыСекреты и разрушительные команды
- Понятная структура папокsrc/, docs/, scripts/ — агент не блуждает
- Хук или чеклист после ключевой правкиsitemap, lint, build — что-то ловит
- Один skill под вашу частую миссиюХотя бы черновик с полями и DoD
Скопируйте в Cursor
Примеры промптов
Артефакт модуля
Definition of Done
Сдали модуль, если есть: Рабочий каркас: закон + 1 skill + права + папка (можно черновик в docs/)
- Есть краткий AGENTS (или rules) с «всегда / никогда»
- Описан один skill под вашу задачу
- Список прав: что агенту можно и нельзя
- Чеклист «что ловит» после правки (хотя бы вручную)
Связи экосистемы