Агенты считывают ваш код и файлы инструкций из репозитория. Контекст объединяет эти файлы памяти с примечаниями к проекту, сгенерированным контекстом и ссылками.
Чтобы узнать, почему именно здесь это размещено, прочитайте Контекст проекта в разделе «Концепции». На этой странице рассказано о том, как им управлять.
Файлы памяти репозитория
Открыть Настройки → Знания → Контекст и посмотрите в разделе Источники репозитория. Coroid считывает эти файлы из подключенного репозитория:
AGENTS.mdв корне репозитория: общие инструкции для агентовCLAUDE.mdв корне репозитория: инструкции для ClaudeGEMINI.mdв корне репозитория: инструкции для Gemini.cursor/rules: правила проекта Cursor, либо каталог.mdcфайлов правил (включая вложенные папки) или один устаревший файл
Их часто называют файлами памяти. Их содержимое включается в контекст проекта агента перед началом работы. Названия не ограничивают их использование конкретной моделью: включенные источники комбинируются для агентов Coroid.
Существующие файлы отображаются с Редактировать действием, примерным количеством токенов и переключателем, определяющим, будут ли агенты их получать. Источники включены по умолчанию, если вы явно их не отключите. Если несколько файлов дублируют или противоречат друг другу, оставьте включенными те источники, которым должны следовать агенты, а остальные отключите.
При сохранении изменений в проекте с подключенным репозиторием GitHub или GitLab открывается pull request с этими изменениями, на новой ветке, созданной на основе базовой ветки проекта pull request. Coroid не совершает коммитов в вашу ветку по умолчанию, а агенты считывают новую версию после объединения pull request. Если репозиторий проекта хостится в Coroid, коммит создается там. Редактор сообщит об этом перед сохранением.
Coroid считывает правила Cursor так, как их применяет сам Cursor:
| Правило | Что получают агенты |
|---|---|
alwaysApply: true | Все правило целиком |
globs набор | Все правило целиком вместе с файлами, к которым оно применяется |
Только description | Путь и описание правила, чтобы агент мог его прочитать, когда это актуально |
| Ничего из этого | Ничего: Cursor применяет его только при упоминании. |
Обычный .md файл в .cursor/rules игнорируется, так как Cursor его тоже игнорирует. Правила в
этой директории редактируются в репозитории, поэтому для этой строки нет Редактировать действия.
Создать означает, что файл отсутствует в рабочей копии репозитория Coroid. Если чтение завершается ошибкой, на странице предлагается Повторить; сбой доступа не означает, что файл отсутствует. Убедитесь, что файл закоммичен в ветку подключенного репозитория. Для выполнения задачи агент считывает ее рабочую копию, поэтому изменения в файлах инструкций в этой ветке применяются к задаче.
Включенные файлы памяти могут импортировать Markdown-файлы репозитория с помощью @path, например
@AGENTS.md в CLAUDE.md или @docs/conventions.md. Пути разрешаются относительно файла, содержащего ссылку. Coroid обрабатывает вложенные импорты, останавливает циклы и включает каждый файл и каждое идентичное тело инструкции только один раз. Импорты в примерах кода и адресах электронной почты не обрабатываются. Ссылки вне репозитория не загружаются, а импорты не могут обойти явно отключенный источник репозитория.
Автоматически обнаруживаются только указанные источники. Вложенный AGENTS.md можно
включить через @ импорт; область его действия не определяется автоматически.
Контексты приложений
В разделе Контексты приложений, инструкции и ссылки хранятся в Coroid. Ручные примечания и сгенерированный контекст проекта можно включать или отключать независимо от файлов репозитория. Используйте эти записи для информации, которая не относится к Git.
Добавление контекста
Выберите Добавить контекст и добавьте запись. Каждая запись имеет заголовок и текст, их можно позже отредактировать или удалить.
Хорошие записи — короткие, конкретные и долговечные. Решения по архитектуре, стилевые нормы, контракты API, границы ответственности и явные запреты — всё это подходит. Описание процесса онбординга и всё, что уже очевидно из репозитория, — нет.
Сохраняйте записи отдельно и давайте им понятные названия
Одна запись на тему, с заголовком, отражающим её содержание. «Нормы обработки ошибок» и «Замороженные модули» легко найти; одна запись под названием «Примечания», содержащая оба пункта, — нет.
Это важно, потому что контекст загружается выборочно в зависимости от текущей задачи — см. Постепенное развитие навыков. Хорошо разделенные записи позволяют загружать нужную именно для задачи запись.
Ссылки
Помимо текстовых записей можно прикреплять ссылки и документы — ссылки на материалы, размещённые в других местах. Используйте их, когда актуальная версия документа хранится в wiki или инструменте для проектирования, и вам не нужно создавать дубликат, который быстро устареет.
Контекст задачи
Контекст Проекта распространяется на все его элементы. Если какой-то материал относится к конкретной задаче — заявке, отчёту клиента или чертежу — прикрепляйте его именно к этой задаче. Запись, относящаяся только к одной задаче, помещённая в общий контекст Проекта, станет мешающим фактором для всех последующих задач.
Сохранение актуальности
Устаревший контекст хуже, чем его отсутствие, так как агенты считают его достоверным. При изменении стандартов обновляйте соответствующую запись в том же коммите, что и код.
Проверка существующего контекста
Иногда читайте свой контекст как новичок: записи накапливаются, и информация, добавленная год назад во время завершения миграции, теперь может вводить в заблуждение.