04 Environment.ru

Из завершённой сессии — в окружение специалиста

Специализация — не смена тона внутри текущего окна. Это артефакт: каталог, который рантайм регистрирует как workspace (или сохранённый агент) и в котором уже лежат правила, карточка домена, критерий приёмки, разобранные примеры и хранилище прошлых работ для одного класса задач.

Стройте его, когда тот же класс работы уже случался и случится снова. Не для разовой задачи: окружение дороже обычного ответа на первом круге и окупается со второго (Зачем).

Пять шагов

#	Шаг	Выход	Проверяемое условие
1	Материал	что просили, что пробовали, что проверили и где сломалось	каждый заявленный факт из этой сессии, индекса сессий или файла — ничего по памяти
2	Карточки	карточка задачи и карточка домена (M1, M2)	нет полей-заглушек; практик и факты «надо проверить» конкретны
3	Окружение	сам каталог	каждый файл существует; experience.py check проходит; ни один существующий файл не перезаписан
4	Регистрация	рантайм о нём знает	сделано через API либо назван один точный ручной шаг с путём для передачи
5	Передача	первый промпт для нового окна	в нём названы карточка, критерий приёмки и первая задача

Устройство

<workspace>/
  AGENTS.md                    правила для этого класса работы (что проверять, чего не делать)
  DOMAIN-CARD.md               практик, словарь, факты «надо проверить», определение готовности
  .dsh/skills/<topic>/SKILL.md сама процедура — видна в палитре только внутри этого workspace
  examples/                    1-3 разобранных случая: вход, что сделано, что отклонено и почему
  memory/                      хранилище опыта (tasks, recipes, artifacts, failures)
  README.md                    зачем это окружение и его версия

Каждый файл отвечает на один вопрос: правила («чего мне нельзя»), карточка («кто я и что значит готово»), навык («как это делается»), примеры («как выглядит правильный результат»), хранилище («что уже было сделано»). Отсутствующий файл — дыра, которую следующая сессия закроет догадкой.

Карточка домена

Девять полей. Качество решают два: надо проверить и определение готовности.

DOMAIN CARD
Subject:            <из карточки задачи, одна именная группа>
Practitioner:       <название роли, которая делает эту работу профессионально>
Core vocabulary:    5-9 терминов специалиста, по одной строке
Skill set:          3-6 возможностей, которые эта работа действительно требует
Must verify:        те 3-5 фактов, которые специалист не станет утверждать без проверки
Sources of truth:   где лежит авторитетный ответ
Typical failure:    как эта работа обычно идёт не так
Definition of done: критерий приёмки, сформулированный так, что ревьюер может его проверить
Anti-patterns:      что здесь делает новичок, а старший специалист — нет

Два правила, которые держат её честной:

• выводить, а не шаблонизировать — набор навыков идёт из темы, а не из каталога профессий; две документационные работы могут требовать разных навыков;
• «надо проверить» сильнее «надо знать» — специалиста отличает не память, а знание того, какие три факта нельзя утверждать по памяти.

Критерий приёмки, который может проверить ревьюер

Плохо: «отчёт работает». Хорошо, в той форме, которую просит набор:

Домен	Критерий приёмки
PHP-эндпоинт	ответ несёт новое поле для одного известного id, а прежняя форма ответа не изменилась
Служба Windows	служба перезапускается чисто, новая IPC-команда есть в реестре, контрактный тест обновлён
Документация	каждая ссылка разрешается, у каждой картинки есть alt-текст, история изменений проходит разбор по стандарту

Если так сформулировать не получается, класс работы ещё не понят достаточно для специализации — вернитесь к шагу 1.

Регистрация: шаг, который решает, существует ли окружение

Рантайм	Что может модель	Что обязан человек
AutoClaw2	записать каталог навыка и файл команды	перезагрузить, чтобы снимок ресурсов пересобрался
HARNESS	создать весь каталог со всеми файлами	один клик: добавить каталог как workspace
SagaAI или другой рантайм	зависит от того, есть ли API регистрации	сказать об этом, а не делать вид, что окружение живое

Каталог — не workspace, пока рантайм о нём не знает. Передача незарегистрированного каталога — это режим отказа 17 в списке режимов отказа, и проверка 12 ворот существует именно для него.

Промпт передачи

Последний артефакт построения окружения — первое сообщение следующей сессии:

Работай в workspace <путь> (зарегистрирован как "<название>").
Правила: AGENTS.md. Критерий приёмки: DOMAIN-CARD.md, раздел "Definition of done".
Первая задача: <одно предложение>.
До планирования выполни: python tools/experience.py search "<слова задачи>".
В конце сообщи строку ворот.

Без него следующая сессия снова начнёт с запроса, а окружение останется мёртвым грузом.

Версионируйте

Запишите версию и дату внутрь окружения (в README.md и в карточке). Окружение без версии нельзя проверить аудитом, и его правила расходятся незаметно — ровно тот дефект, который линтер ловит на собственных страницах этого репозитория.

Проверка стоимости

Новый домен должен стоить одну карточку, один файл примеров, одну строку критерия приёмки. Если добавление специальности требует правки промпта, настроек рантайма и ещё трёх страниц — дизайн потёк, и исправлять нужно дизайн, а не специальность.

Дальше: Хранилище опыта — то хранилище, которое это окружение ведёт.