arch — плагин для GitHub Copilot: что делает и как установить
Создаёт архитектурную документацию по локальному коду и формирует поэтапный план модернизации легаси-проекта.
copilot plugin install arch@awesome-copilotЧто делает arch
Плагин добавляет в GitHub Copilot навык arch:doc-and-modernize для разбора локально склонированного репозитория. В режиме документации он изучает файлы на диске и формирует единый отчёт об архитектуре системы. Каждое утверждение в документе привязано к конкретному файлу и номеру строки. Непроверенные факты инструмент помечает отдельно, а противоречия в коде пытается разрешить.
Второй режим предназначен для обновления устаревшей кодовой базы. Если актуального описания архитектуры ещё нет, плагин сначала автоматически запускает режим документирования. После этого он составляет план перехода, архитектурные решения (ADR) по выбору технологий и пошаговый график внедрения.
Инструмент работает по принципу local-first и обращается к внешним API только в крайнем случае. Его стоит ставить ради онбординга и подготовки к рефакторингу. Без локальной копии репозитория запустить его не получится.
Какие задачи решает
- составить архитектурную карту системы по локальным файлам
- подтвердить факты о проекте ссылками на конкретные строки кода
- подготовить план модернизации устаревшей кодовой базы с ADR
- описать сложные подсистемы для онбординга новых инженеров
Примеры запросов агенту
- Изучи локальный репозиторий и составь архитектурный документ со ссылками на код
- Сделай поэтапный план модернизации проекта и подготовь ADR по стеку
- Запусти arch:doc-and-modernize для онбординга в legacy-проект
Как установить arch
Команда из источника
copilot plugin install arch@awesome-copilotИз того же набора554
Весь набор →Похожие
Вопросы о arch
Как установить arch в GitHub Copilot?
Выполните команду copilot plugin install arch@awesome-copilot в терминале.
Что делает навык arch:doc-and-modernize?
Он объединяет два сценария: формирует архитектурное описание репозитория со ссылками на строки кода и составляет план модернизации с рекомендациями по стеку.
Что произойдет, если запустить модернизацию без готовой документации?
Плагин сначала автоматически создаст актуальный архитектурный документ через режим документации, а затем перейдет к плану миграции.
Исходный текст
arch · MIT
# Arch Plugin Architecture and modernization toolkit for locally-cloned repositories. It produces a single, cited architecture document from the code on disk, and generates a phased modernization plan that automatically runs Documentation mode first when no architecture document exists yet. ## Installation ```bash copilot plugin install arch@awesome-copilot ``` ## What's Included ### Skills - **`doc-and-modernize`** — Two complementary workflows for a locally-cloned repository, in one skill (installed via this plugin it surfaces as `arch:doc-and-modernize`): - **Documentation mode** — Produce one comprehensive, verifiable architecture document for a repository you already have checked out locally. Works local-first (prefers the local checkout, treating remote/API lookups as a flagged last resort), cites every claim to a file + line, flags unverified facts, resolves contradictions, and deep-dives the most complex subsystems. Ideal for onboarding docs and system-design maps. - **Modernization mode** — Generate a phased modernization plan for a legacy codebase. If a current architecture document exists it builds on it; otherwise it first runs the Documentation mode workflow to produce one, then continues to the plan. Produces per-feature migration docs, tech-stack recommendations with ADRs, and an adaptive, safety-laddered phased implementation plan. ## Source This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot). ## License MIT
© Awesome Copilot Community · MIT · github/awesome-copilot
