OKF: знания проекта рядом с кодом

Храните правила, решения и инструкции в Markdown, чтобы команда и AI-агенты могли найти ответ и открыть его источник.

Например, сервис повторяет неудачную доставку 24 часа, затем подключает оператора. Запишите правило, свяжите его с требованиями и дайте агенту найти ответ. Когда срок изменится, обновите источник и заметку в том же рабочем процессе.

Открыть учебный пример · Попробовать локально

Когда пригодится

• Перед изменением сервиса: найти ограничение и проверить его источник.
• При передаче проекта: объяснить решение вместе с материалами, на которых оно основано.
• После изменения требований: найти и пересмотреть связанные заметки.

Что входит в OKF

Open Knowledge Format описывает Markdown-файлы с метаданными и ссылками на источники. Набор знаний — папка таких файлов с корневым index.md.

Этот репозиторий даёт Go-библиотеки, команду okf, сервер okf-mcp, инструкции для агентов и автономный HTML-просмотрщик. Можно начать с файлов и просмотра, затем подключить агента.

Что проверить самому

Проверка OKF находит ошибки структуры и ссылок. Содержание сверяйте с указанным источником: наличие sources не означает, что утверждение проверено. verified добавляйте только после реально выполненной проверки. Версия документа 0.2 и версия программы — отдельные значения.

Следующий шаг

1. Создать и найти первое правило.
2. Установить навык агента и подключить MCP.
3. Работать с файлами и командами.
4. Обновлять знания после изменений.

Точные поля, ограничения и интерфейсы собраны в справочнике. Пример архитектуры этого репозитория доступен отдельно на английском языке.