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