Archcore MCP Server

официальный

Локальный MCP-сервер stdio, который позволяет AI-агентам кодирования читать и поддерживать структурированную архитектуру, правила и решения непосредственно из вашего репозитория.

GitHub

Документация

Archcore CLI

Ваш ИИ-агент перестает гадать и начинает следовать вашей архитектуре.

Git доставляет ваш код. CI/CD доставляет вашу поставку. Archcore доставляет ваше понимание.

Archcore хранит ваши решения, правила и соглашения в Git — так что ваш ИИ-агент следует им автоматически. Работает с Claude Code, Cursor, Copilot, Gemini CLI, Codex, OpenCode, Roo Code и Cline.

Archcore поставляется как CLI и локальный stdio MCP-сервер — любой MCP-совместимый агент для кодинга может читать и записывать контекст вашего репозитория через стандартные инструменты, в то время как плагин Claude Code / Cursor добавляет слой рабочих процессов более высокого уровня.

Используете Claude Code или Cursor? Сочетайте CLI с Archcore Plugin — тот же движок, плюс навыки, команды намерений и ограждения «из коробки». Оставаться только с CLI тоже отлично — он работает со всеми остальными агентами.

За 60 секунд

curl -fsSL https://archcore.ai/install.sh | bash
cd your-project && archcore init

Затем откройте вашего ИИ-агента и скажите:

"Мы используем PostgreSQL для основного хранилища. Зафиксируй это решение."

Готово. Теперь в .archcore/ есть структурированная ADR, которую каждый будущий сеанс — в любом агенте — может прочитать.

На Windows? Используйте PowerShell: irm https://archcore.ai/install.ps1 | iex. Для WSL, go install и других вариантов смотрите Способы установки или полное руководство по установке.

Спросите у вашего ИИ что-то вроде

Как только в вашем репозитории появится несколько документов, ваш агент сможет их использовать. Попробуйте:

"Прежде чем я прикоснусь к модулю аутентификации, какие ADR и правила здесь применимы?"

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

"Добавь новый обработчик API и следуй соглашениям этого репозитория."

Агент находит подходящее правило (например, «обработчики находятся в src/api/handlers/») и размещает код там, где, согласно вашей архитектуре, он должен быть.

"Какое у нас правило обработки ошибок?"

Агент читает error-wrapping.rule.md прямо из .archcore/, вместо того чтобы гадать по нескольким примерам в кодовой базе.

Попробуйте сначала это

Эти запросы фиксируют новый контекст — решения, правила, планы, инциденты. Каждый создает структурированный документ, который агент (или любой член команды) может позже переиспользовать.

Новый репозиторий? archcore init создает .archcore/. MCP-сервер также работает в пустом репозитории и предоставляет инструмент init_project, так что агент может выполнить начальную настройку за вас.

"Мы решили использовать PostgreSQL вместо MongoDB для нашей основной базы данных. Зафиксируй это решение."

Создает infrastructure/use-postgres.adr.md с контекстом, решением, рассмотренными альтернативами и последствиями.

"У нас есть командное соглашение: всегда оборачивать ошибки с контекстом, используя fmt.Errorf и %w. Сделай это правилом."

Создает backend/error-wrapping.rule.md с императивным руководством, обоснованием и примерами хорошего/плохого кода.

"На прошлой неделе у нас был инцидент с исчерпанием пула соединений, потому что неиспользуемые соединения не перерабатывались. Задокументируй это, чтобы мы не повторили."

Создает incidents/connection-pool-exhaustion.cpat.md с анализом первопричины и шагами по предотвращению.

"Мне нужен PRD для функции пользовательских уведомлений — push, email-дайджесты и оповещения в приложении."

Создает notifications/user-notifications.prd.md с целями, пользовательскими историями, требованиями и метриками успеха.

"Создай план реализации для PRD уведомлений и свяжи их вместе."

Создает notifications/notifications-implementation.plan.md, затем связывает его с PRD через отношение implements.

Если что-то из этого вам откликается, то и весь остальной Archcore — это то же самое, только структурированное.

Что меняется после установки

Без Archcore агент:

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

С Archcore те же запросы производят код, который:

размещается там, где, согласно вашей архитектуре, он должен быть
учитывает ADR, спецификации и правила, уже находящиеся в Git
следует командным соглашениям, автоматически загружаемым при старте сеанса
отражает новые решения как будущие ограждения, а не кладбище markdown

ИИ должен следовать вашей системе, а не угадывать её.

Используйте Archcore, когда

Ваш агент пишет код, но не так, как ожидается в этом репозитории
Ваш CLAUDE.md / .cursorrules / AGENTS.md продолжает расти и расползаться
Вы работаете с 2+ агентами или 2+ инструментами (Claude Code + Cursor + Copilot)
Вы хотите, чтобы решения, правила и спецификации были в Git — а не в истории чата

Не для — памяти чата, библиотеки запросов или одноразового генератора «спецификация-в-код». Archcore — это слой истины репозитория для агентов кодинга, а не набор методологий.

Почему не просто файлы инструкций?

CLAUDE.md, AGENTS.md и инструкции репозитория — полезные отправные точки, но они ломаются, когда вашей команде нужно:

больше одного плоского файла памяти
структурированные типы документов — ADR, правила, планы, инциденты
переиспользуемый контекст в нескольких ИИ-инструментах
версионированное проектное знание, которое растет вместе с кодовой базой
отношения между документами (план, который реализует PRD, RFC, который расширяет ADR)
выводы из инцидентов и повторяющиеся рабочие процессы, которые агенты могут подхватить позже

Файлы инструкций говорят агенту что вы хотите. Archcore говорит агенту как работает ваша система — чтобы агент мог следовать вашей системе, а не угадывать её.

Поддерживаемые агенты

Archcore CLI сам является локальным stdio MCP-сервером — это общая поверхность интеграции для каждого MCP-совместимого агента в таблице ниже. Хуки добавляют проактивный контекст начала сеанса там, где агент их поддерживает.

Агент	Хуки	MCP
Claude Code	да	да
Cursor	да	да
Gemini CLI	да	да
GitHub Copilot	да	да
OpenCode	—	да
Codex CLI	—	да
Roo Code	—	да
Cline	—	вручную

Как это работает

Инициализируйте ваш репозиторий archcore init создает .archcore/ и устанавливает интеграции для поддерживаемых агентов.
Фиксируйте долговременный контекст Храните архитектурные решения, правила, планы, продуктовую документацию и выводы из инцидентов как структурированные Markdown-файлы.
Позвольте агентам переиспользовать его Хуки и MCP позволяют вашим агентам кодинга читать существующий контекст и создавать или обновлять документы во время реальной работы.
Храните это в Git Проверяйте изменения контекста как код, развивайте их со временем и сохраняйте переносимость между инструментами.

Ментальная модель

Archcore CLI — это компилятор контекста — он превращает разрозненные документы в структурированный, машиночитаемый контекст. MCP и хуки — это среда выполнения — поверхность, которую агенты используют для потребления этого контекста во время реальной работы. Archcore Plugin для Claude Code и Cursor — это среда выполнения более высокого уровня, построенная поверх.

implicit repo knowledge  →  structured context  →  AI-readable system

Что находится в `.archcore/`

.archcore/
├── settings.json
├── .sync-state.json
├── auth/
│   ├── jwt-strategy.adr.md
│   └── auth-redesign.prd.md
├── backend/
│   └── error-wrapping.rule.md
├── incidents/
│   └── connection-pool-exhaustion.cpat.md
└── notifications/
    └── notifications-implementation.plan.md

Структура свободная — организуйте документы по домену, функции, команде или как угодно, что подходит вашему репозиторию. Категории виртуальны и выводятся из типа документа в имени файла (slug.type.md).

Используйте .archcore/ для:

архитектурных решений
правил и соглашений кодинга
планов реализации
требований к продукту
инцидентов и посмертных анализов
переиспользуемых знаний о рабочих процессах

Смотрите сам репозиторий Archcore CLI для рабочего примера: .archcore/ в этом репозитории

Что поставляется в комплекте

18 типов документов по направлениям: видение, знание и опыт
4 типа отношений — related, implements, extends, depends_on
10 инструментов MCP — list_documents, get_document, create_document, update_document, remove_document, search_documents, init_project, плюс управление отношениями (add_relation, remove_relation, list_relations)
5 многодокументных запросов — отслеживание каскадов, вызываемых как слеш-команды из MCP-совместимых агентов
Интеграции хуков для 4 агентов (Claude Code, Cursor, Gemini CLI, GitHub Copilot) и интеграции MCP для 8

Типы документов

Archcore организует контекст в 3 слоя знаний: Видение, Знание и Опыт.

Видение

Тип	Полное название	Описание
`prd`	Документ требований к продукту	Цели, пользовательские истории, критерии приемки и метрики успеха
`idea`	Идея	Легковесная фиксация продуктовой или технической идеи для будущего изучения
`plan`	План	Поэтапный список задач с критериями приемки и зависимостями

Archcore также поддерживает два дополнительных трека требований для команд, которым нужно структурированное исследование или формальная декомпозиция:

Трек источников (MRD → BRD → URD) — фиксирует, откуда берутся требования:

Тип	Полное название	Описание
`mrd`	Документ рыночных требований	Рыночный ландшафт, TAM/SAM/SOM, конкурентный анализ и рыночные нужды
`brd`	Документ бизнес-требований	Бизнес-цели, заинтересованные стороны, ROI и бизнес-правила
`urd`	Документ пользовательских требований	Персонажи пользователей, пути, требования к удобству и критерии приемки

Трек ISO/IEC/IEEE 29148:2018 (BRS → StRS → SyRS → SRS) — фиксирует, как требования декомпозируются:

Тип	Полное название	Описание
`brs`	Спецификация бизнес-требований	Миссия, цели, задачи и бизнес-операционная концепция
`strs`	Спецификация требований заинтересованных сторон	Потребности заинтересованных сторон, операционная концепция и пользовательские требования
`syrs`	Спецификация системных требований	Системные функции, интерфейсы, производительность и проектные ограничения
`srs`	Спецификация требований к ПО	Функции ПО, внешние интерфейсы и детальные поведенческие спецификации

Используйте PRD для большинства проектов. Добавляйте трек источников, когда нужно структурированное исследование требований. Добавляйте ISO 29148, когда нужна формальная прослеживаемость для регулируемых или сложных мультикомандных систем. Смешивайте свободно — некоторые функции могут использовать PRD, в то время как другие используют полный каскад.

Знание

Тип	Полное название	Описание
`adr`	Запись архитектурного решения	Фиксирует окончательное техническое решение с контекстом, альтернативами и последствиями
`rfc`	Запрос комментариев	Предлагает значительное изменение, открытое для обзора и обратной связи команды
`rule`	Правило	Стандарт кодинга или процесса с императивным руководством и примерами
`guide`	Руководство	Пошаговые инструкции для выполнения конкретной задачи
`doc`	Документ	Справочная документация, реестры и описательные материалы
`spec`	Спецификация	Канонический нормативный контракт для системы, компонента, интерфейса или протокола

Опыт

Тип	Полное название	Описание
`task-type`	Тип задачи	Многоразовый чек-лист и рабочий процесс для повторяющейся задачи
`cpat`	Шаблон изменения кода	Анализ первопричины ошибки или инцидента с шагами по предотвращению

Каждый документ — это Markdown-файл с YAML-фронтматтером:

---
title: "Use PostgreSQL for Primary Storage"
status: draft
tags: [database, infrastructure]
---

## Context

...

Допустимые статусы: draft, accepted и rejected. Теги необязательны и имеют свободную форму — используйте их для обозначения сквозных тем (security, golang, frontend).

Связи документов

Документы можно связывать направленными отношениями с другими документами:

related — общая ассоциация
implements — источник реализует то, что указано в цели
extends — источник строится на основе цели
depends_on — источнику требуется цель для продолжения

Связи хранятся в .sync-state.json и управляются автоматически ИИ-агентом через инструменты MCP.

Интеграция с ИИ-агентом

Archcore интегрируется с ИИ-агентами для кодинга тремя способами:

Хуки внедряют контекст при старте сессии, так что агент знает о ваших документах .archcore/ с первого сообщения.
Инструменты MCP дают агенту возможность перечислять, искать, читать, создавать, обновлять и связывать документы в реальном времени. MCP-сервер также работает в пустом репозитории и предоставляет инструмент init_project, так что агенты могут самостоятельно развернуть .archcore/.
Подсказки MCP — это готовые многодокументные рабочие процессы, которые вы запускаете из своего агента как слеш-команды.

Подсказки

Подсказки организуют полные каскады документов за один вызов — агент создает и связывает каждый документ в цепочке за вас. Большинство MCP-совместимых агентов отображают их как слеш-команды (например, /architecture_track); точный префикс зависит от клиента.

Подсказка	Что делает
`product_track`	идея → PRD → план (облегченный поток работы с фичей)
`architecture_track`	ADR → спецификация → план (технический дизайн + реализация)
`standard_track`	ADR → правило → руководство (кодификация командного стандарта)
`sources_track`	MRD → BRD → URD (исследование рынка / бизнеса / пользователей)
`iso_track`	BRS → StRS → SyRS → SRS (формальный каскад ISO 29148)

Пример. В вашем агенте выполните /product_track feature="user notifications". Агент создаст черновик идеи, выведет из нее PRD, построит план реализации и автоматически свяжет их.

Локальный MCP-сервер

Archcore не требует хостинга. CLI запускает локальный stdio MCP-сервер:

archcore mcp

По умолчанию archcore mcp обслуживает документы из текущей директории. Передайте --project /path/to/repo (или установите ARCHCORE_PROJECT_ROOT), чтобы указать другое расположение — полезно, когда сервер запускается из директории, не являющейся вашим рабочим пространством (например, при интеграции с редактором).

Подключите его к Claude Code:

claude mcp add --transport stdio archcore -- archcore mcp

Или установите автоматически для поддерживаемого агента:

archcore mcp install --agent cursor

Установка интеграций

# Auto-detect agents in your project and install everything
archcore hooks install

# Or target a specific agent
archcore mcp install --agent opencode
archcore hooks install --agent cursor

Команды

Команда	Описание
`archcore init`	Интерактивная инициализация директории `.archcore/`
`archcore doctor`	Проверка настройки archcore и исправление проблем
`archcore status`	Проверка структуры .archcore/ и состояния документов
`archcore config`	Просмотр или изменение настроек
`archcore hooks install`	Установка хуков для обнаруженных ИИ-агентов
`archcore update`	Обновление Archcore до последней версии
`archcore mcp`	Запуск MCP stdio-сервера
`archcore mcp install`	Установка MCP-конфигурации для обнаруженных агентов

Обновление

archcore update

Команда проверяет GitHub Releases на наличие более новой версии, загружает её, проверяет контрольную сумму SHA-256 и атомарно заменяет текущий бинарный файл.

Способы установки

macOS / Linux

curl -fsSL https://archcore.ai/install.sh | bash

Windows

irm https://archcore.ai/install.ps1 | iex

Устанавливает archcore.exe в %LOCALAPPDATA%\Programs\archcore и добавляет его в пользовательский PATH. После установки откройте новое окно PowerShell, чтобы изменения PATH вступили в силу.

Windows (WSL)

Установите WSL, затем выполните внутри него:

curl -fsSL https://archcore.ai/install.sh | bash

Установка через Go

go install github.com/archcore-ai/cli@latest

Из исходников

git clone https://github.com/archcore-ai/cli.git
cd cli
go build -o archcore .

Поддерживаемые платформы: macOS, Linux, Windows — amd64 и arm64.

Информацию о переменных окружения (ARCHCORE_VERSION, ARCHCORE_INSTALL_DIR, GITHUB_TOKEN) и устранении неполадок с PATH см. в полном руководстве по установке на docs.archcore.ai.

Конфигурация

Настройки хранятся в .archcore/settings.json и создаются во время archcore init.

Поле	Описание	Значения
`sync`	Режим синхронизации. Облачный и локальный серверный режимы появятся в ближайшее время.	`none` (только локально), `cloud`, `on-prem`
`language`	Язык документации. Помогает агенту генерировать документацию на нужном языке.	Строка, по умолчанию `en`

archcore config                              # show all settings
archcore config get <key>                    # get a specific value
archcore config set <key> <value>            # set a value

Разработка

Предварительные требования

Go 1.24+

Сборка и тестирование

# Build
go build -o archcore .

# Run all tests
go test ./...

# Run a specific package
go test ./cmd/

# Run a single test
go test ./cmd/ -run TestConfigCmd

Структура проекта

├── cmd/              # Cobra commands (init, doctor, config, status, hooks, mcp, ...)
├── internal/
│   ├── agents/       # Supported AI agents with hooks/MCP capabilities
│   ├── api/          # HTTP client for archcore server
│   ├── config/       # Settings management and directory init
│   ├── display/      # Terminal output formatting (lipgloss)
│   ├── update/       # Self-update logic (version check, download, verify, replace)
│   ├── mcp/          # MCP stdio server, tools, and prompts
│   └── sync/         # Sync logic
├── templates/        # Document type templates
├── install.sh        # Install script
└── .goreleaser.yaml  # Release configuration

Похож ли Archcore на BMAD / Spec Kit / Memory Bank?

Нет — они решают разные задачи. Краткая карта:

Инструмент	Категория	Что это	Чем отличается Archcore
BMAD	Методология	Агентная методология SDLC — 12+ ролей, 34+ рабочих процесса	Archcore хранит артефакты; BMAD предписывает процесс
Spec Kit	Методология	Рабочий процесс на основе спецификаций: `specify → plan → tasks → implement`, одноразовый	Spec Kit — это одноразовая передача; Archcore поддерживает живой граф, который развивается вместе с кодовой базой
Agent OS	Методология	Извлечение стандартов кодовой базы + разработка на основе спецификаций	Наиболее близкое позиционирование. Archcore добавляет типизированные документы, проверенные связи и опциональный каскад ISO
claude-mem / Mem0	Память	Автоматический захват памяти сессии, кросс-агентное вспоминание	Инструменты памяти запоминают что вы делали; Archcore хранит как построена система и какие решения приняты
Cline Memory Bank	Документация	Markdown-файлы с фиксированной схемой (`projectbrief`, `activeContext`, `systemPatterns`…)	Тот же дух, меньше формальностей. Archcore добавляет типизированные связи, валидацию MCP и многошаговые каскады
CLAUDE.md / .cursorrules	Инструкции	Один плоский файл, который агент читает при старте сессии	Archcore заменяет растущий файл инструкций типизированными, связанными, запрашиваемыми документами

Выбирайте инструмент методологии для предписанного потока разработки. Выбирайте инструмент памяти для непрерывности сессии. Выбирайте Archcore, когда вам нужна типизированная, запрашиваемая проектная истина — решения, правила и архитектура этого репозитория — которую ваш агент по кодингу учитывает при каждом запросе.

Ссылки и лицензия

Документация: docs.archcore.ai
Веб-сайт: archcore.ai
Плагин (Claude Code, Cursor): github.com/archcore-ai/archcore-plugin
Задачи: github.com/archcore-ai/cli/issues
Лицензия: Apache 2.0