🛠 OKF превращает AGENTS.md из длинной инструкции в карту знаний

Вместо одного AGENTS.md на 500 строк автор Habr собрал для OpenCode компактное ядро примерно на 60 строк и больше 25 тематических файлов: про архитектуру, тесты, безопасность и релизы. Агент обращается к ним по мере необходимости, а не загружает всю документацию в контекст сразу.

Так устроен Open Knowledge Format: Markdown-файлы с YAML-метаданными, которые читают и человек, и модель. AGENTS.md здесь — маршрутизатор по базе знаний, а не энциклопедия; для хранения достаточно файловой системы или Git, без сборки и отдельного сервиса. Такой шаблон описан в статье на Habr.

В версии OKF v0.2, представленной 24 июля 2026 года после анонса формата 12 июня, появились поля для происхождения, проверки и актуальности знаний. Они не устраняют галлюцинации, но дают агенту дополнительные сигналы о том, насколько источнику можно доверять.

Для российских команд, использующих OpenCode с разными моделями, ценность подхода — в переносимой структуре: знания о проекте не привязаны к одному поставщику API. Но набор файлов сам себя не поддерживает: устаревшие инструкции останутся в контексте и будут уверенно вести агента не туда.

Я бы внедрял такие метаданные вместе с процессом проверки и обновления документов: поле «проверено» без ответственного и даты — просто ещё один текст для модели. Главный выигрыш OKF не в том, что агент становится умнее, а в том, что команде проще заметить, откуда он взял ответ.

#OKF #OpenCode #ИИагенты #контекст #разработка