Archcore: git-нативный контекстный слой для AI-агентов

Archcore — это git-нативный контекстный слой для AI-кодинг-агентов. Вместо того чтобы каждый раз переобъяснять агенту архитектуру, соглашения и принятые решения, вы храните их как типизированные Markdown-документы в .archcore/ — и агенты автоматически подгружают нужный контекст в начале сессии через MCP. Работает с Claude Code, Cursor, Copilot, Gemini CLI, OpenCode, Codex CLI, Roo Code и Cline.

Проблема

Без структурированного контекста каждая сессия AI-агента начинается с нуля: он угадывает архитектуру, нарушает соглашения, дублирует существующую логику и требует переобъяснять одни и те же решения в каждом чате. Плоские инструкции вроде CLAUDE.md быстро превращаются в одну раздутую стену текста — без типов, без связей, без жизненного цикла.

Archcore решает эту проблему: решения, правила и конвенции живут в Git как структурированный контекст — тот же PR-ревью, та же портативность между инструментами.

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

1. Инициализация — archcore init создаёт .archcore/, детектит установленных AI-агентов и прописывает для них хуки и MCP-конфигурацию
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 типов документов

Archcore поставляется с 19 типами документов в трёх слоях:

Знания (Knowledge)

• ADR (Architecture Decision Record) — принятое техническое решение с контекстом, альтернативами и последствиями
• RFC (Request for Comments) — предложение значительного изменения для командного обсуждения
• Rule — стандарт кодирования или процесса с императивными инструкциями и примерами
• Guide — пошаговая инструкция для выполнения конкретной задачи
• Doc — справочная документация, реестры, описательный материал
• Spec — нормативный контракт поведения для границы или подсистемы

Видение (Vision)

• PRD (Product Requirements Document) — цели, пользовательские истории, критерии приёмки, метрики успеха
• Idea — лёгкая фиксация продуктовой или технической идеи
• Plan — поэтапный список задач с критериями приёмки и зависимостями
• RnD (Research) — ограниченное по времени исследование, отвечающее на блокирующий вопрос

Дополнительно: источники требований (MRD → BRD → URD) и трек ISO/IEC/IEEE 29148:2018 (BRS → StRS → SyRS → SRS) для команд, которым нужна формальная прослеживаемость.

Опыт (Experience)

• Task Type — переиспользуемый чеклист и воркфлоу для повторяющейся задачи
• CPAT (Code Change Pattern) — root-cause анализ бага или инцидента с шагами предотвращения

Каждый документ — Markdown с YAML frontmatter'ом:

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

Статусы: draft, accepted, rejected.

MCP-инструменты и промпты

10 MCP-инструментов: init_project, list_documents, get_document, search_documents, create_document, update_document, remove_document, add_relation, remove_relation, list_relations. Сервер работает даже в пустом репозитории — агенты могут инициализировать .archcore/ самостоятельно.

5 мульти-документных промптов оркестрируют целые каскады:

• product_track — idea → PRD → plan (лёгкий фичевый флоу)
• architecture_track — ADR → spec → plan (технический дизайн и реализация)
• standard_track — ADR → rule → guide (кодификация командного стандарта)
• sources_track — MRD → BRD → URD (открытие рынка/бизнеса/пользователей)
• iso_track — BRS → StRS → SyRS → SRS (формальный каскад ISO 29148)

4 типа связей между документами: related (общая ассоциация), implements (источник реализует цель), extends (источник расширяет цель), depends_on (источник зависит от цели).

Примеры использования

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

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

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

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

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

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

Совместимость с агентами

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

Быстрый старт

# Установка (macOS/Linux)
curl -fsSL https://archcore.ai/install.sh | bash

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

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

# Инициализация в проекте
cd your-project && archcore init

После archcore init откройте агента и скажите: «Мы используем PostgreSQL для основного хранилища. Зафиксируй это решение.» — и в .archcore/ появится структурированный ADR, который увидят все будущие сессии в любом агенте.

Команды

archcore update проверяет GitHub Releases, скачивает новую версию, сверяет SHA-256 и атомарно заменяет бинарник.

Проект написан на Go (1.25+), лицензия Apache 2.0. Поддерживаются macOS, Linux и Windows (amd64/arm64).