Skip to content
← Все документы спецификации

Протокол агента

Версия 1.0. Этот протокол определяет, как ИИ-агент разработки MUST вести себя при работе с Deep Work Plan. Ключевые слова MUST, SHOULD и MAY следуют RFC 2119.

Онбординг

Перед созданием или выполнением плана агент MUST пройти онбординг в репозитории. Онбординг основан на рассуждениях, а не на скрипте: агент читает структуру, документацию и конфигурацию репозитория, чтобы построить ментальную модель.

Агент SHOULD определить:

  • Архетип репозитория (отдельный против оркестратора).
  • Команды сборки, тестирования и линтинга.
  • Существующие соглашения по стилю, структуре и именованию.
  • Доступные навыки и агентов.

Планирование

При создании плана агент MUST:

  • Разложить цель на последовательные, пригодные для ревью задачи.
  • Написать каждую задачу по анатомии из девяти разделов.
  • Завершить двумя обязательными финальными задачами.
  • Задать уточняющие вопросы, когда цель неоднозначна.

Выполнение

Во время выполнения агент MUST:

  • Прочитать весь план перед началом.
  • Выполнять задачи по порядку, если зависимости не позволяют иначе.
  • Обновлять PROGRESS.md после каждой задачи.
  • Точно отмечать статус задачи.
  • Останавливаться и спрашивать при блокировке, а не догадываться.

Доработка

При доработке агент MUST сохранить завершённую работу, обновить таблицу задач и зафиксировать, что изменилось.

Возобновление

При возобновлении агент MUST восстановить состояние из PROGRESS.md и файлов задач, прежде чем продолжать.

Коммуникация

Агенты SHOULD отчитываться кратко. Отчёты о статусе MUST различать завершённую, выполняемую и ожидающую работу.

Безопасность

Агенты MUST NOT фиксировать секреты в коммитах, MUST держать .dwp/ игнорируемым git-ом и SHOULD спрашивать перед разрушительными операциями. Онбординг MUST быть недеструктивным: агент MUST обнаруживать существующие файлы и согласовывать их, а не перезаписывать, и MUST получать явное одобрение перед заменой или удалением чего-либо, что уже есть у пользователя.

Методология построена на принципе Markdown-first: она не выполняет сетевых вызовов и не передаёт никакой телеметрии, а агент MUST NOT выгружать исходный код или секреты. Перед установкой навыка агент SHOULD обращаться с полученным содержимым онбординга как с ненадёжными входными данными, подтверждать его происхождение из официальных источников и проверять выпуск по опубликованным контрольным суммам.