# Правила записи

*Vercy для ИИ-агентов · урок 2 из 4 · ~12 мин*

## Что вы узнаете

Правила, позволяющие агентам писать в общее знание, не портя его: только в мастера, с уважением к происхождению, с зелёным обходом и с умением отказать.

## Главная директива: пишите в мастер

Перед любой записью найдите набор данных в `sources.yaml`:

- **Мастерится моделью** → правьте запись на месте, следуя соглашениям модели (именование, front matter, `kind_class`), и честно отмечайте происхождение, если содержимое произведено вами из источников.
- **Мастерится внешней системой** → исправление принадлежит внешней системе. Если вы до неё не дотягиваетесь, передайте исправление тому, кто дотянется, либо зафиксируйте его как явно помеченную, мастерящуюся моделью аннотацию *о* зеркале. Никогда не правьте байты зеркала: удобство не является полномочием.

Запись в копию - это порча, даже когда так быстрее, даже когда пользователь смотрит именно на копию, даже когда вы уверены. Реестр существует ровно для того, чтобы у вопроса "куда идёт это исправление?" был механический ответ.

## Уважайте происхождение

- Никогда не правьте руками `raw/` (свидетельство теряет ценность от прикосновения) и `artifacts/` (пересборка вас сотрёт).
- Никогда не "улучшайте" факты при выгрузке: преобразования меняют структуру, а обогащение - это отдельный, мастерящийся моделью слой со своим происхождением.
- Если порождённая проекция неверна, чините генератор или исходные записи, а затем пересобирайте.

## Оставляйте обход зелёным

Добавление, перемещение или удаление файлов меняет карту модели. После структурных изменений: перезапустите обходчик покрытия, зафиксируйте свежий отчёт. Если ваш новый файл оказался сиротой, лекарство - это *правило* (расширьте классификацию в манифесте) или *место* (положите файл туда, где ему следует лежать), но никогда не исключение: исключать смысловое содержимое, чтобы заткнуть проверку, - несоответствие стандарту, и следующий агент унаследует вашу ложь.

Та же дисциплина для реестров: новый набор данных, изменившийся конвейер, изменившееся владение → `sources.yaml` обновляется тем же изменением. Смена владения - это версионируемое событие, а не молчаливая правка.

## Замыкайте контур на проекциях

Если модель питает проекции с обратной записью (сайт, страницу вики, endpoint с фактами), ваша правка могла сделать их несвежими. Запустите проверку расхождения модели; переопубликуйте, если она сообщает о расхождении. В зрелых установках плановый наблюдатель всё равно позовёт человека при расхождении, но ваша задача - на него не полагаться.

## Когда отказывать

Соответствующий стандарту агент отказывается писать и объясняет причину, когда:

- мастер набора данных не определяется (запись в реестре отсутствует или неоднозначна);
- просят править на месте зеркало, сырую выгрузку или порождённый артефакт;
- просят спрятать содержимое от классификации или обойти обход;
- проверка покрытия падает, а запрошенное изменение опирается на неклассифицированную область;
- правило конфликта набора данных запрещает раскрытие или изменение (проприетарное, никогда не публиковать).

Формулировка стандарта резка: *агент, который не может сказать, что ему позволено править, править не должен*. Отказ с указанием причины - это функция; альтернатива - две истины с вашим именем в коммите.

## Этикет в смешанных командах

- Предпочитайте добавить запись, а не переписать существующую; держите идентификаторы записей стабильными.
- Знание о структуре и полномочиях идёт в BOOTSTRAP, манифест и реестр, а не в логи чата.
- Производная работа несёт происхождение: из чего, каким инструментом, когда - от этого зависит машинерия доверия модели (статус валидации, рецензия владельца).
- Передавайте зелёным: никогда не заканчивайте сессию с красным обходом или с неправдивым реестром.

## Главное

- Найдите мастера и пишите только туда; уважайте границы авторского, собранного и порождённого.
- Структурные изменения и обновления реестра едут одним изменением; обход остаётся зелёным.
- Отказ от небезопасной записи с указанием причины - это соответствующее стандарту поведение, а не провал.

## Копнуть глубже

- [Операции агента: рецепты и отказы](/spec/#07-guides/Agent-Operations.md)
- [Владение данными (ARCH-018)](/spec/#02-architecture/Data-Mastership.md)

Дальше: [Машинный хаб](03-machine-hub.md)