Archcore MCP

Archcore CLI — Contexte natif Git pour agents de codage IA

Archcore est une couche de contexte native Git pour les agents de codage IA.

Le CLI conserve les specs, les décisions d'architecture, les règles, les plans et les connaissances du projet dans .archcore/, versionnés avec votre code, et fournit le contexte pertinent aux agents de codage via MCP et les hooks de session.

Il est fourni sous forme de CLI et de serveur MCP stdio local, de sorte que tout agent de codage compatible MCP peut lire et écrire le contexte de votre projet via des outils standard. Utilisez-le pour un contexte de projet persistant avec Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code et Cline.

Le voir en action

Ce contexte provient de .archcore/ — des documents Markdown typés versionnés dans Git, servis à tout agent via les outils MCP et les hooks de session.

Ce qui change

❌ Sans Archcore

Chaque session part de zéro. L'agent :

• devine votre architecture et enfreint vos conventions
• duplique une logique qui existe déjà
• re-remet en cause des décisions que votre équipe a déjà prises
• a besoin que le même contexte soit réexpliqué à chaque conversation

✅ Avec Archcore

Vos décisions, règles et conventions vivent dans Git sous forme de contexte structuré. L'agent :

• charge les décisions et règles applicables au début de la session
• place le code là où votre architecture dit qu'il doit être
• respecte les ADR, specs et règles déjà présents dans le dépôt
• enregistre les nouvelles décisions comme contexte durable — révisables dans les PR, portables entre agents

L'agent cesse de deviner et commence à suivre le système.

Commencer en 60 secondes

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

archcore init initialise .archcore/, détecte vos agents de codage et configure les hooks et MCP pour eux.

Ouvrez ensuite votre agent et dites :

"Nous utilisons PostgreSQL pour le stockage principal. Enregistre cette décision."

Voilà — il existe désormais un ADR structuré dans .archcore/ que chaque future session, dans n'importe quel agent, verra.

Sur Windows : irm https://archcore.ai/install.ps1 | iex. Pour WSL, go install, et la compilation depuis les sources, voir Méthodes d'installation ci-dessous ou le guide d'installation complet.

Fonctionne avec votre agent

Le CLI est lui-même un serveur MCP stdio local — une seule surface d'intégration pour tout agent compatible MCP. Les hooks ajoutent le contexte de début de session là où l'agent les prend en charge.

archcore init configure automatiquement les agents détectés. Pour en configurer un manuellement :

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

Comment ça fonctionne

1. Initialiser — archcore init crée .archcore/ et installe les intégrations d'agents.
2. Capturer — les décisions, règles, plans et guides sont stockés sous forme de documents Markdown typés avec un frontmatter YAML.
3. Réutiliser — les agents lisent, créent, mettent à jour et lient des documents via les outils MCP pendant qu'ils travaillent ; les hooks chargent le contexte au début de la session.
4. Garder dans Git — révisez les changements de contexte comme du code, faites-les évoluer dans le temps, gardez-les portables entre outils.

.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

La structure est libre — organisez par domaine, fonctionnalité ou équipe. Le type d'un document réside dans son nom de fichier (slug.type.md) : 19 types répartis sur trois couches — connaissance (ADR, règles, specs, guides), vision (PRD, plans, idées, pistes d'exigences) et expérience (schémas d'incidents, tâches récurrentes). Le .archcore/ de ce dépôt est un exemple fonctionnel.

Demandez à votre agent

"Avant de toucher au module d'authentification, quelles décisions et règles s'appliquent ici ?"

Charge les ADR et règles liés à ce domaine avant que l'agent ne modifie une seule ligne.

"Nous avons une convention : toujours envelopper les erreurs avec fmt.Errorf et %w. Fais-en une règle."

Crée backend/error-wrapping.rule.md avec des directives impératives, la justification et des exemples bons/mauvais.

"La semaine dernière, nous avons eu un incident d'épuisement du pool de connexions. Documente-le pour ne pas le répéter."

Crée incidents/connection-pool-exhaustion.cpat.md avec l'analyse des causes racines et les étapes de prévention.

Comparaison

Pas fait pour — la mémoire de chat, une bibliothèque de prompts, ou un générateur ponctuel spec-vers-code. Archcore est une couche de vérité de dépôt pour les agents de codage, pas un kit méthodologique.

Référence

Ce qui est inclus : 19 types de documents, 4 types de relations, 10 outils MCP, intégrations de hooks pour 4 agents et intégrations MCP pour 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

Écosystème

• Plugin Archcore — vous utilisez Claude Code ou Cursor ? Le plugin s'associe au CLI : même moteur, plus des compétences, des commandes d'intention et des garde-fous. Un seul produit, deux points d'entrée — le CLI seul couvre tous les autres agents.
• docs.archcore.ai — documentation complète.
• .archcore/ dans ce dépôt — un exemple vivant : le CLI est construit avec sa propre couche de contexte.

Développement

Nécessite Go 1.25+.

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

Liens et licence

• Documentation : docs.archcore.ai
• Site web : archcore.ai
• Plugin (Claude Code, Cursor) : github.com/archcore-ai/archcore-plugin
• Problèmes : github.com/archcore-ai/cli/issues
• Licence : Apache 2.0