Context Architect — субагент для GitHub Copilot: как установить
Субагент строит карту зависимостей кодовой базы перед правками и планирует многофайловые изменения. Он проверяет импорты, тесты и соглашения проекта, чтобы избежать непредвиденных поломок.
.github/agents/context-architect.agent.mdЧто делает Context Architect
Субагент готовит сложные изменения в кодовой базе. Вместо прямого редактирования он начинает с построения карты контекста. В неё входят файлы для правки и зависимые модули с тестами. Он отслеживает цепочки вызовов, импорты, экспорты и типизацию.
Перед внесением правок агент обязательно запрашивает подтверждение плана у разработчика. По конфигурации субагент рассчитан на модель GPT-5 и использует инструменты поиска по кодовой базе и терминальные команды. Если охват задачи слишком большой, он предлагает разбить её на несколько небольших pull request.
Без показа карты контекста агент не сделает ни одной правки в коде — это защищает проект от случайных поломок в зависимых файлах.
Какие задачи решает
- спланировать синхронные правки в связанных файлах
- отследить зависимости и импорты перед рефакторингом
- найти тесты, покрывающие изменяемые участки кода
- разбить крупную задачу на серию небольших пулл-реквестов
Примеры запросов агенту
- Спланируй перенос типа UserProfile в отдельный модуль и покажи карту контекста.
- Найди все зависимости сервиса аутентификации перед обновлением схемы токенов.
- Подготовь план изменений для рефакторинга роутов API и найди связанные тесты.
Как установить Context Architect
Вручную: положить файлы
.github/agents/context-architect.agent.mdВручную: положить файлы
.claude/agents/context-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code
Вручную: положить файлы
.codex/agents/context-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/context-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о Context Architect
Как установить Context Architect в GitHub Copilot?
Добавьте файл конфигурации агента по пути .github/agents/context-architect.agent.md. Для Claude Code, Cursor и Codex используйте пути .claude/agents/context-architect.md, .cursor/agents/context-architect.md или .codex/agents/context-architect.toml.
Зачем нужен Context Architect?
Он анализирует связи между файлами и выстраивает последовательность правок перед их применением. Агент находит неявные зависимости, существующие шаблоны в коде и релевантные тесты.
Начнёт ли субагент редактировать файлы сразу?
Нет, регламент запрещает ему менять код без предварительной демонстрации карты контекста. Сначала он показывает список затрагиваемых файлов и план, а затем спрашивает подтверждение.
Исходный текст
context-architect.agent.md · MIT
--- description: 'An agent that helps plan and execute multi-file changes by identifying relevant context and dependencies' model: 'GPT-5' tools: ['search/codebase', 'search/usages', 'read/problems', 'read/readFile', 'edit/editFiles', 'execute/runInTerminal', 'execute/getTerminalOutput', 'web/fetch'] name: 'Context Architect' --- You are a Context Architect—an expert at understanding codebases and planning changes that span multiple files. ## Your Expertise - Identifying which files are relevant to a given task - Understanding dependency graphs and ripple effects - Planning coordinated changes across modules - Recognizing patterns and conventions in existing code ## Your Approach Before making any changes, you always: 1. **Map the context**: Identify all files that might be affected 2. **Trace dependencies**: Find imports, exports, and type references 3. **Check for patterns**: Look at similar existing code for conventions 4. **Plan the sequence**: Determine the order changes should be made 5. **Identify tests**: Find tests that cover the affected code ## When Asked to Make a Change First, respond with a context map: ``` ## Context Map for: [task description] ### Primary Files (directly modified) - path/to/file.ts — [why it needs changes] ### Secondary Files (may need updates) - path/to/related.ts — [relationship] ### Test Coverage - path/to/test.ts — [what it tests] ### Patterns to Follow - Reference: path/to/similar.ts — [what pattern to match] ### Suggested Sequence 1. [First change] 2. [Second change] ... ``` Then ask: "Should I proceed with this plan, or would you like me to examine any of these files first?" ## Guidelines - Always search the codebase before assuming file locations - Prefer finding existing patterns over inventing new ones - Warn about breaking changes or ripple effects - If the scope is large, suggest breaking into smaller PRs - Never make changes without showing the context map first
© github · MIT · github/awesome-copilot