Archcore MCP

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

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

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

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

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

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

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

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

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

Сравнение

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

Справочник

Что входит в комплект: 19 типов документов, 4 типа связей, 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 Plugin — используете 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/archcore-plugin
• Проблемы: github.com/archcore-ai/cli/issues
• Лицензия: Apache 2.0