# Как агент читает модель

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

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

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

## Почему агентам нужен протокол

Агент, направленный на незнакомый репозиторий, сталкивается с теми же рисками, что и человек, только усиленными: он читает быстро, пропускает молча и отвечает уверенно. Ответ стандарта в том, что соответствующая ему модель *сама рассказывает, как её читать*, а первая обязанность агента - принять это предложение, а не импровизировать.

## Последовательность холодного старта

1. **Сначала `BOOTSTRAP.md`.** Как эта модель хочет быть прочитанной, местные соглашения, жёсткие запреты. Если у экосистемы есть свой файл входа (`CLAUDE.md`, `AGENTS.md`), читайте его после: он несёт рабочее состояние, а BOOTSTRAP несёт структуру.
2. **`manifest.yaml`.** Идентичность, упорядоченные бандлы, правила классификации, исключения. Теперь вы знаете, *чем является* каждый файл, ещё не открыв ни одного.
3. **`sources.yaml`.** Какие наборы данных мастерятся здесь, какие являются зеркалами, насколько свежи, кто побеждает в конфликтах. Читайте это *до содержимого*: иначе вы не отличите авторитетное знание от несвежей копии чьей-то вики.
4. **Обходите в объявленном порядке.** Бандлы, начиная с оснований, слои по порядку, README слоя перед записями. Порядок - это порядок зависимостей: определения приходят раньше использования.
5. **Запустите обходчик, если он есть** (`tools/mu-walk*`). Красный обход означает, что сломана собственная карта модели: сообщите об этом, прежде чем чему-либо доверять.

Вся последовательность - это три небольших файла и одна команда до всякого содержимого: дешёвая страховка от всех последующих ошибок.

## Ответ с пониманием авторитетности

Отвечая по модели, агент возводит утверждения к записям и сверяет набор данных каждой записи с реестром:

- **Мастерится моделью** → отвечайте прямо; это истина по объявлению.
- **Зеркало, свежее** → отвечайте, называя мастера: "по вики эксплуатации, выгрузка от 2026-07-30".
- **Зеркало, несвежее** → скажите об этом; лучше запустить повторную выгрузку, чем гадать.
- **`status: declared`** → это намерение, а не данные; никогда не подавайте это как факт.
- **`status: retired`** → замороженная история: "по состоянию на финальный экспорт", а не текущее состояние.

И одно различение, которое предотвращает тонкую бессмыслицу: выгрузка в `raw/` - это свидетельство того, *что сказал источник*; запись - это *собственное утверждение модели*. Они могут намеренно расходиться (модель вправе держать аннотированное отклонение); цитируйте соответственно.

## Что это даёт всем

Человеческая команда получает агентов, которые никогда не примут макет за спецификацию, а экспорт мёртвого трекера - за живой бэклог. Агент получает нечто более редкое: возможность *доказать*, что его чтение было полным - проверка покрытия называет каждый файл, который он не прочитал, и почему.

## Главное

- Холодный старт: BOOTSTRAP → манифест → sources → упорядоченный обход → обходчик; и только потом содержимое.
- Каждый ответ несёт контекст авторитетности: мастерится, зеркалится (насколько свежо), объявлено или списано.
- Свидетельства (`raw/`) и утверждения (записи) - это разные речевые акты; не смешивайте их.

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

- [Руководство по операциям агента](/spec/#07-guides/Agent-Operations.md) (нормативная версия этого урока)
- [Обход модели (ARCH-017)](/spec/#02-architecture/Model-Traversal-and-Layout.md)

Дальше: [Правила записи](02-writing.md)