Перейти к содержанию

Контекстные файлы KODA.md и AGENTS.md

По своей сути это README для AI-агентов, которые хранятся в корне проекта в формате Markdown. Внутри может быть описан технический конспект о проекте и базовые правила для работы с ним. Некоторую информацию об этом можно также почитать на сайте https://agents.md

Файлы, которые Koda считывает автоматически, добавляя их содержимое в контекст сессии:

  • KODA.md (приоритет)
  • AGENTS.md
  • agents.md
  • AGENT.md

Это позволяет экономить на запросах: агенту не придётся изучать проект заново в каждой новой сессии и тратить запросы на вызовы инструментов чтения директории, файлов и т. п.

Как создать

Автоматически

В режиме агента отправить команду /kodamd.

Если файл KODA.md уже существует, он будет обновлён.

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

Подсказка

Итоговый файл рекомендуется проверить самостоятельно и скорректировать при необходимости.

Вручную

Конечно, такой файл можно написать и самостоятельно. Это позволит

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

  • имя файла KODA.md или AGENTS.md;
  • содержимое в формате markdown, поскольку он позволяет легко структурировать документ и использовать простое форматирование текста.

Такой файл понимает любая модель и она будет следовать тем правилам, которые описаны внутри.

Подсказка

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

Другие файлы, безусловно влияющие на контекст

.gitignore

Это файл, в котором задаются маски путей и имён файлов для игнорирования git. Такой файл обычно есть в любом проекте.

Эти правила позволяют защитить репозиторий от лишних данных: например, логов, паролей, баз данных, служебных/отладочных файлов и скомпилированных исполняемых файлов.

Koda учитывает содержимое .gitignore. Агент следует правилам, которые описаны там, и не читает запрещённые файлы.

.kodaignore

Это дополнительный файл правил игнорирования, который определяет те файлы и пути, которые агенту не следует изучать.

Он может дополнять правила .gitignore.

.kodarules

Может использоваться для постоянной установки системного промпта, который описан внутри.