Archcore MCP

Archcore CLI — Contexto Nativo de Git para Agentes de Codificación con IA

Archcore se mudó a github.com/archcore-ai/archcore. Este repositorio está archivado. El CLI ahora vive bajo cli/ en ese repositorio, junto al plugin, y cada versión desde v0.10.1 en adelante se publica en archcore-ai/archcore/releases. Instala o actualiza con curl -fsSL https://archcore.ai/install.sh | bash en macOS, Linux y WSL, o irm https://archcore.ai/install.ps1 | iex en Windows. Un binario instalado desde este repositorio (v0.8.7 o anterior) ya no se autoactualiza; ejecuta el instalador una vez para moverte al nuevo canal. Problemas: archcore-ai/archcore/issues.

Archcore es una capa de contexto nativa de Git para agentes de codificación con IA.

El CLI mantiene especificaciones, decisiones de arquitectura, reglas, planes y conocimiento del proyecto en .archcore/, versionado con tu código, y sirve el contexto relevante a los agentes de codificación a través de MCP y hooks de sesión.

Se distribuye como un CLI y un servidor MCP local stdio, por lo que cualquier agente de codificación compatible con MCP puede leer y escribir el contexto de tu proyecto mediante herramientas estándar. Úsalo para contexto de proyecto persistente en Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code y Cline.

Míralo funcionar

Ese contexto provino de .archcore/ — documentos Markdown tipados versionados en Git, servidos a cualquier agente mediante herramientas MCP y hooks de sesión.

Qué cambia

❌ Sin Archcore

Cada sesión comienza desde cero. El agente:

• adivina tu arquitectura y rompe tus convenciones
• duplica lógica que ya existe
• vuelve a litigar decisiones que tu equipo ya tomó
• necesita que le reexpliquen el mismo contexto en cada chat

✅ Con Archcore

Tus decisiones, reglas y convenciones viven en Git como contexto estructurado. El agente:

• carga las decisiones y reglas aplicables al inicio de la sesión
• coloca el código donde tu arquitectura dice que debe estar
• respeta los ADR, especificaciones y reglas ya presentes en el repositorio
• registra nuevas decisiones como contexto duradero — revisable en PRs, portable entre agentes

El agente deja de adivinar y empieza a seguir el sistema.

Comienza en 60 segundos

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

archcore init crea la estructura de .archcore/, detecta tus agentes de codificación y configura hooks y MCP para ellos.

Luego abre tu agente y di:

"Estamos usando PostgreSQL para el almacenamiento principal. Registra esta decisión."

Listo — ahora hay un ADR estructurado en .archcore/ que toda sesión futura, en cualquier agente, verá.

En Windows: irm https://archcore.ai/install.ps1 | iex. Para WSL, go install, y compilar desde el código fuente, consulta Métodos de instalación abajo o la guía de instalación completa.

Funciona con tu agente

El CLI es en sí mismo un servidor MCP local stdio — una única superficie de integración para cada agente compatible con MCP. Los hooks añaden contexto de inicio de sesión donde el agente lo soporta.

archcore init configura los agentes detectados automáticamente. Para conectar uno manualmente:

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

Cómo funciona

1. Inicializa — archcore init crea .archcore/ e instala las integraciones de agente.
2. Captura — las decisiones, reglas, planes y guías se almacenan como documentos Markdown tipados con frontmatter YAML.
3. Reutiliza — los agentes leen, crean, actualizan y enlazan documentos mediante herramientas MCP mientras trabajan; los hooks cargan contexto al inicio de la sesión.
4. Mantenlo en Git — revisa los cambios de contexto como código, hazlos evolucionar con el tiempo, mantenlos portables entre herramientas.

.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 estructura es de forma libre — organízala por dominio, funcionalidad o equipo. El tipo de un documento vive en su nombre de archivo (slug.type.md): 23 tipos en tres capas — conocimiento (ADRs, reglas, especificaciones, guías), visión (PRDs, planes, ideas, tracks de requisitos) y experiencia (patrones de incidentes, tareas recurrentes). El propio .archcore/ de este repositorio es un ejemplo funcional.

Pregúntale a tu agente

"Antes de tocar el módulo de autenticación, ¿qué decisiones y reglas aplican aquí?"

Carga los ADRs y reglas vinculados a esa área antes de que el agente edite una sola línea.

"Tenemos una convención: siempre envolver los errores con fmt.Errorf y %w. Convierte esto en una regla."

Crea backend/error-wrapping.rule.md con guía imperativa, justificación y ejemplos buenos/malos.

"La semana pasada tuvimos un incidente de agotamiento del pool de conexiones. Documéntalo para no repetirlo."

Crea incidents/connection-pool-exhaustion.cpat.md con análisis de causa raíz y pasos de prevención.

Cómo se compara

No es para — memoria de chat, una biblioteca de prompts o un generador de especificación a código de una sola vez. Archcore es una capa de verdad del repositorio para agentes de codificación, no un kit de metodología.

Referencia

Lo que incluye: 23 tipos de documento, 7 tipos de relación, 10 herramientas MCP, integraciones de hooks para 4 agentes e integraciones MCP para 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

Ecosistema

• Plugin de Archcore — ¿Usas Claude Code o Cursor? El plugin se combina con la CLI: mismo motor, más habilidades, comandos de intención y salvaguardas. Un producto, dos puntos de entrada: la CLI por sí sola cubre cualquier otro agente.
• docs.archcore.ai — documentación completa.
• .archcore/ en este repositorio — un ejemplo vivo: la CLI se construye con su propia capa de contexto.

Desarrollo

Requiere Go 1.25+.

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

Enlaces y licencia

• Documentación: docs.archcore.ai
• Sitio web: archcore.ai
• Plugin (Claude Code, Cursor): github.com/archcore-ai/plugin
• Problemas: github.com/archcore-ai/cli/issues
• Licencia: Apache 2.0