Archcore MCP

Archcore CLI – Git-nativer Kontext für KI-Codierungsagenten

Archcore ist eine git-native Kontextebene für KI-Codierungsagenten.

Die CLI hält Spezifikationen, Architekturentscheidungen, Regeln, Pläne und Projektwissen in .archcore/, versioniert mit deinem Code, und liefert den relevanten Kontext über MCP und Session-Hooks an Codierungsagenten.

Sie wird als CLI und lokaler stdio-MCP-Server ausgeliefert, sodass jeder MCP-kompatible Codierungsagent über Standardwerkzeuge auf deinen Projektkontext zugreifen und ihn schreiben kann. Nutze sie für persistenten Projektkontext über Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code und Cline hinweg.

Sieh es in Aktion

Dieser Kontext stammt aus .archcore/ – typisierten Markdown-Dokumenten, die in Git versioniert und über MCP-Tools und Session-Hooks jedem Agenten bereitgestellt werden.

Was sich ändert

❌ Ohne Archcore

Jede Session beginnt bei null. Der Agent:

• rät deine Architektur und bricht deine Konventionen
• dupliziert Logik, die bereits existiert
• verhandelt Entscheidungen neu, die dein Team bereits getroffen hat
• braucht in jedem Chat dieselbe Kontexterklärung erneut

✅ Mit Archcore

Deine Entscheidungen, Regeln und Konventionen leben in Git als strukturierter Kontext. Der Agent:

• lädt die relevanten Entscheidungen und Regeln zu Session-Beginn
• platziert Code dort, wo deine Architektur ihn vorsieht
• respektiert die ADRs, Spezifikationen und Regeln, die bereits im Repository liegen
• hält neue Entscheidungen als dauerhaften Kontext fest – überprüfbar in PRs, portabel über Agenten hinweg

Der Agent hört auf zu raten und beginnt, dem System zu folgen.

Loslegen in 60 Sekunden

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

archcore init richtet .archcore/ ein, erkennt deine Codierungsagenten und verdrahtet Hooks und MCP für sie.

Öffne dann deinen Agenten und sage:

„Wir verwenden PostgreSQL für den primären Speicher. Halte diese Entscheidung fest.“

Fertig – es gibt nun einen strukturierten ADR in .archcore/, den jede zukünftige Session in jedem Agenten sehen wird.

Unter Windows: irm https://archcore.ai/install.ps1 | iex. Für WSL siehe go install und für das Erstellen aus dem Quellcode die Installationsmethoden unten oder die vollständige Installationsanleitung.

Funktioniert mit deinem Agenten

Die CLI ist selbst ein lokaler stdio-MCP-Server – eine Integrationsoberfläche für jeden MCP-kompatiblen Agenten. Hooks fügen Kontext zu Session-Beginn hinzu, wo der Agent sie unterstützt.

archcore init konfiguriert erkannte Agenten automatisch. So verdrahtest du einen von Hand:

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

So funktioniert es

1. Initialisieren – archcore init erstellt .archcore/ und installiert Agenten-Integrationen.
2. Erfassen – Entscheidungen, Regeln, Pläne und Anleitungen werden als typisierte Markdown-Dokumente mit YAML-Frontmatter gespeichert.
3. Wiederverwenden – Agenten lesen, erstellen, aktualisieren und verknüpfen Dokumente über MCP-Tools, während sie arbeiten; Hooks laden Kontext zu Session-Beginn.
4. In Git halten – Kontextänderungen wie Code überprüfen, über die Zeit weiterentwickeln und über Tools hinweg portabel halten.

.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

Die Struktur ist frei gestaltbar – organisiere nach Domain, Feature oder Team. Der Typ eines Dokuments steckt in seinem Dateinamen (slug.type.md): 19 Typen in drei Ebenen – Wissen (ADRs, Regeln, Spezifikationen, Anleitungen), Vision (PRDs, Pläne, Ideen, Anforderungs-Tracks) und Erfahrung (Incident-Muster, wiederkehrende Aufgaben). Das eigene .archcore/ dieses Repositories ist ein funktionierendes Beispiel.

Frag deinen Agenten

„Bevor ich das Auth-Modul anfasse: Welche Entscheidungen und Regeln gelten hier?“

Lädt die ADRs und Regeln, die mit diesem Bereich verknüpft sind, bevor der Agent auch nur eine Zeile ändert.

„Wir haben eine Konvention: Fehler immer mit fmt.Errorf und %w umschließen. Mach das zu einer Regel.“

Erstellt backend/error-wrapping.rule.md mit imperativer Anleitung, Begründung sowie guten und schlechten Beispielen.

„Letzte Woche hatten wir einen Vorfall mit Connection-Pool-Erschöpfung. Dokumentiere ihn, damit wir ihn nicht wiederholen.“

Erstellt incidents/connection-pool-exhaustion.cpat.md mit Root-Cause-Analyse und Präventionsschritten.

Der Vergleich

Nicht für – Chat-Memory, eine Prompt-Bibliothek oder einen einmaligen Spezifikation-zu-Code-Generator. Archcore ist eine Repository-Truth-Schicht für Codierungsagenten, kein Methodik-Kit.

Referenz

Was in der Box steckt: 19 Dokumenttypen, 4 Beziehungstypen, 10 MCP-Tools, Hook-Integrationen für 4 Agenten und MCP-Integrationen für 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

Ökosystem

• Archcore Plugin — Verwendest du Claude Code oder Cursor? Das Plugin ergänzt die CLI: dieselbe Engine, plus Skills, Absichtsbefehle und Guardrails. Ein Produkt, zwei Einstiegspunkte — die CLI allein deckt jeden anderen Agenten ab.
• docs.archcore.ai — vollständige Dokumentation.
• .archcore/ in diesem Repository — ein lebendiges Beispiel: Die CLI ist mit ihrer eigenen Kontextebene erstellt.

Entwicklung

Erfordert Go 1.25+.

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

Links & Lizenz

• Dokumentation: docs.archcore.ai
• Website: archcore.ai
• Plugin (Claude Code, Cursor): github.com/archcore-ai/archcore-plugin
• Issues: github.com/archcore-ai/cli/issues
• Lizenz: Apache 2.0