Archcore MCP

Archcore CLI — Git-нативный контекст для ИИ-агентов программирования

Archcore переехал на github.com/archcore-ai/archcore. Этот репозиторий заархивирован. CLI теперь находится в cli/ в этом репозитории, рядом с плагином, и каждый релиз начиная с v0.10.1 публикуется на archcore-ai/archcore/releases. Установите или обновите с помощью curl -fsSL https://archcore.ai/install.sh | bash на macOS, Linux и WSL, или irm https://archcore.ai/install.ps1 | iex на Windows. Бинарный файл, установленный из этого репозитория (v0.8.7 или более ранняя версия), больше не обновляется автоматически; запустите установщик один раз, чтобы перейти на новый канал. Вопросы: archcore-ai/archcore/issues.

Archcore — это git-нативный контекстный слой для ИИ-агентов программирования.

CLI хранит спецификации, архитектурные решения, правила, планы и знания о проекте в .archcore/, версионируемые вместе с вашим кодом, и предоставляет релевантный контекст агентам программирования через MCP и хуки сессий.

Он поставляется как CLI и локальный stdio MCP-сервер, поэтому любой MCP-совместимый агент программирования может читать и записывать контекст вашего проекта через стандартные инструменты. Используйте его для постоянного контекста проекта в Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code и Cline.

Посмотрите, как это работает

Этот контекст пришёл из .archcore/ — типизированных Markdown-документов, версионируемых в Git, предоставляемых любому агенту через MCP-инструменты и хуки сессий.

Что меняется

❌ Без Archcore

Каждая сессия начинается с нуля. Агент:

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

✅ С Archcore

Ваши решения, правила и соглашения живут в Git как структурированный контекст. Агент:

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

Агент перестаёт угадывать и начинает следовать системе.

Начало работы за 60 секунд

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

archcore init создаёт .archcore/, обнаруживает ваших агентов программирования и настраивает для них хуки и MCP.

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

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

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

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

Работает с вашим агентом

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

archcore init автоматически настраивает обнаруженных агентов. Чтобы подключить вручную:

archcore mcp install --agent cursor      # write MCP config for a specific agent
archcore hooks install                   # install session-start hooks for detected agents
claude mcp add --transport stdio archcore -- archcore mcp   # or add the server manually

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

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

.archcore/
├── settings.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): 23 типа в трёх слоях — знания (ADR, правила, спецификации, руководства), видение (PRD, планы, идеи, треки требований) и опыт (паттерны инцидентов, повторяющиеся задачи). Собственный .archcore/ этого репозитория — рабочий пример.

Спросите своего агента

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

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

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

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

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

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

Сравнение

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

Справочник

Что входит в комплект: 23 типа документов, 7 типов связей, 10 MCP-инструментов, интеграции хуков для 4 агентов и MCP-интеграции для 8.

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

## Context

...

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

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

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

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

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

Экосистема

• Плагин Archcore — используете Claude Code или Cursor? Плагин работает в паре с CLI: тот же движок, плюс навыки, интент-команды и защитные механизмы. Один продукт, две точки входа — CLI сам по себе покрывает всех остальных агентов.
• docs.archcore.ai — полная документация.
• .archcore/ в этом репозитории — живой пример: CLI построен на собственном контекстном слое.

Разработка

Требуется Go 1.25+.

go build -o archcore .   # build
go test ./...            # run all tests

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

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