Archcore MCP

Archcore CLI — Contexto nativo de Git para agentes de codificación de IA

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

La CLI mantiene especificaciones, decisiones de arquitectura, reglas, planes y conocimiento del proyecto en .archcore/, versionados 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 CLI y como servidor MCP stdio local, de modo 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 proviene 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 empieza desde cero. El agente:

• adivina tu arquitectura y rompe tus convenciones
• duplica lógica que ya existe
• vuelve a cuestionar decisiones que tu equipo ya tomó
• necesita que le vuelvan a explicar 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 corresponde
• 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.

Empieza en 60 segundos

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

archcore init inicializa .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 más abajo o la guía de instalación completa.

Funciona con tu agente

La CLI es en sí misma un servidor MCP stdio local: 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 los soporta.

archcore init configura automáticamente los agentes detectados. Para configurar 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. Inicializar — archcore init crea .archcore/ e instala las integraciones de agentes.
2. Capturar — las decisiones, reglas, planes y guías se almacenan como documentos Markdown tipados con frontmatter YAML.
3. Reutilizar — los agentes leen, crean, actualizan y enlazan documentos mediante herramientas MCP mientras trabajan; los hooks cargan contexto al inicio de la sesión.
4. Mantenerlo en Git — revisa los cambios de contexto como código, hazlos evolucionar con el tiempo y 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 libre: organízala por dominio, funcionalidad o equipo. El tipo de un documento vive en su nombre de archivo (slug.type.md): 19 tipos en tres capas: conocimiento (ADR, reglas, especificaciones, guías), visión (PRD, planes, ideas, tracks de requisitos) y experiencia (patrones de incidentes, tareas recurrentes). El propio .archcore/ de este repositorio es un ejemplo funcional.

Pregunta a tu agente

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

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

"Tenemos una convención: envolver siempre 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 que no se repita."

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: 19 tipos de documento, 4 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

• Archcore Plugin — ¿Usas Claude Code o Cursor? El plugin se combina con la CLI: el mismo motor, más habilidades, comandos de intención y protecciones. 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 está construida 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/archcore-plugin
• Problemas: github.com/archcore-ai/cli/issues
• Licencia: Apache 2.0