Я запускаю этот промпт и дальше агент читает правила из AGENTS.md и использует как agentic memory:
Внедри в текущий репозиторий минимальную базу инженерных знаний в Google Open Knowledge Format (OKF v0.2). Правила её использования закрепи в корневом AGENTS.md.
Спецификация:
https://github.com/GoogleCloudPlatform/open-knowledge-format/blob/main/SPEC.md
1. Исследуй проект
Прочитай инструкции для агентов, README, ADR, документацию, конфигурацию сборки и CI. Найди существующий корпус знаний и устройство harness, включая xpowers, если он используется.
Сохрани действующие инструкции. Если подходящий корпус уже существует, развивай его вместо создания параллельного.
2. Создай knowledge/
Начни с index.md и 3–5 содержательных документов по реально исследованному проекту: архитектура, контракты, инварианты, проверка изменений, диагностика.
Возможные категории: architecture/, decisions/, contracts/, runbooks/, incidents/. Создавай только нужные; пустые разделы и заглушки не нужны.
Соблюдай OKF:
* В корневом index.md укажи okf_version: "0.2", добавь ссылки и краткие описания документов.
* В каждом обычном Markdown-документе используй YAML frontmatter с непустым type; добавь title, description и status.
* index.md и log.md оформляй по специальным правилам спецификации.
* Связывай документы относительными Markdown-ссылками.
* Указывай реальные источники в sources; для GitHub по возможности используй ссылки с commit SHA.
* generated и stale_after добавляй по необходимости.
* verified заполняй только после фактической проверки, указывая реального проверяющего и время.
Не дублируй большие README и ADR — ссылайся на них.
3. Проверяй основания
Утверждения о текущем поведении сверяй с кодом, тестами и конфигурацией. Причины решений ищи в ADR и истории.
Не придумывай мотивы авторов, результаты тестов, даты и подтверждения. Различай наблюдаемое поведение, требования и предположения. Противоречия фиксируй явно; непроверенное оставляй черновиком.
4. Добавь правила в AGENTS.md
Обнови корневой AGENTS.md, сохранив существующие инструкции; если файла нет — создай. Добавь отдельный раздел «Использование базы знаний» с конкретными правилами:
Перед существенной задачей:
* Прочитать knowledge/index.md.
* Выбрать относящиеся к задаче документы; при необходимости искать по knowledge/ через rg и переходить по ссылкам.
* Не загружать весь корпус без необходимости.
* Проверять status, stale_after и основания verified. Просроченные сведения перепроверять, deprecated учитывать как историю.
Во время работы:
* Сверять критичные утверждения с текущими источниками.
* При расхождении знаний и кода установить, что устарело или нарушено; не выбирать версию автоматически.
* Отделять подтверждённые факты от гипотез.
Перед завершением задачи:
* Оценить, появились ли устойчивые знания: решение, инвариант, ограничение, причина ошибки или проверенная процедура.
* Обновить существующий документ либо создать новый со ссылками на основания.
* При изменении поведения обновить связанные знания в том же PR.
* Поддерживать индекс и внутренние ссылки.
* После существенной правки пересмотреть прежние verified; неподтверждённые сведения оставить черновиком.
* Не сохранять рутинный пересказ сессии и дубликаты.
* В отчёте указать обновлённые документы либо отметить, что обновление знаний не требовалось.
Инструкции harness держи вне OKF bundle. Если другие агенты используют отдельные файлы инструкций, добавь в них ссылку на эти правила без копирования всего раздела.
5. Проверь и заверши
Проверь YAML, обязательные поля, структуру индекса, внутренние ссылки, основания ключевых утверждений и согласованность AGENTS.md с созданным корпусом.
Используй существующие проверки документации. Не добавляй тяжёлую инфраструктуру и не меняй продуктовый код ради этой задачи.
В конце сообщи, какие файлы изменены, что проверено и какие вопросы остались. Выполни работу до конкретных изменений в репозитории, не ограничивайся планом.
