Archcore MCP

Archcore CLI — Contexto Nativo de Git para Agentes de Codificação com IA

O Archcore é uma camada de contexto nativa de Git para agentes de codificação com IA.

A CLI mantém especificações, decisões de arquitetura, regras, planos e conhecimento do projeto em .archcore/, versionados junto com seu código, e serve o contexto relevante aos agentes de codificação por meio de MCP e session hooks.

Ele é distribuído como uma CLI e um servidor MCP local via stdio, para que qualquer agente de codificação compatível com MCP possa ler e escrever o contexto do seu projeto por meio de ferramentas padrão. Use-o para contexto persistente de projeto no Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code e Cline.

Veja funcionando

Esse contexto veio de .archcore/ — documentos Markdown tipados versionados em Git, servidos a qualquer agente por meio de ferramentas MCP e session hooks.

O que muda

❌ Sem o Archcore

Toda sessão começa do zero. O agente:

• adivinha sua arquitetura e quebra suas convenções
• duplica lógica que já existe
• reabre decisões que seu time já tomou
• precisa que o mesmo contexto seja reexplicado em todo chat

✅ Com o Archcore

Suas decisões, regras e convenções vivem no Git como contexto estruturado. O agente:

• carrega as decisões e regras aplicáveis no início da sessão
• coloca o código onde sua arquitetura determina
• respeita os ADRs, especificações e regras já presentes no repositório
• registra novas decisões como contexto durável — revisável em PRs, portável entre agentes

O agente para de adivinhar e passa a seguir o sistema.

Comece em 60 segundos

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

archcore init cria a estrutura de .archcore/, detecta seus agentes de codificação e configura hooks e MCP para eles.

Em seguida, abra seu agente e diga:

"Estamos usando PostgreSQL para armazenamento principal. Registre esta decisão."

Pronto — agora existe um ADR estruturado em .archcore/ que toda sessão futura, em qualquer agente, poderá ver.

No Windows: irm https://archcore.ai/install.ps1 | iex. Para WSL, go install e compilação a partir do código-fonte, consulte Métodos de instalação abaixo ou o guia de instalação completo.

Funciona com seu agente

A CLI é, por si só, um servidor MCP local via stdio — uma única superfície de integração para todo agente compatível com MCP. Os hooks adicionam contexto no início da sessão onde o agente os suporta.

archcore init configura os agentes detectados automaticamente. Para conectar um 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

Como funciona

1. Inicialize — archcore init cria .archcore/ e instala as integrações de agente.
2. Capture — decisões, regras, planos e guias são armazenados como documentos Markdown tipados com frontmatter YAML.
3. Reutilize — os agentes leem, criam, atualizam e vinculam documentos por meio de ferramentas MCP enquanto trabalham; os hooks carregam o contexto no início da sessão.
4. Mantenha no Git — revise mudanças de contexto como código, evolua-as ao longo do tempo e mantenha-as portáveis entre ferramentas.

.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

A estrutura é livre — organize por domínio, recurso ou time. O tipo de um documento está no nome do arquivo (slug.type.md): 19 tipos em três camadas — conhecimento (ADRs, regras, especificações, guias), visão (PRDs, planos, ideias, trilhas de requisitos) e experiência (padrões de incidentes, tarefas recorrentes). O próprio .archcore/ deste repositório é um exemplo funcional.

Pergunte ao seu agente

"Antes de tocar no módulo de autenticação, quais decisões e regras se aplicam aqui?"

Carrega os ADRs e regras vinculados àquela área antes de o agente editar uma única linha.

"Temos uma convenção: sempre encapsular erros com fmt.Errorf e %w. Transforme isso em uma regra."

Cria backend/error-wrapping.rule.md com orientação imperativa, justificativa e exemplos bons/ruins.

"Na semana passada tivemos um incidente de esgotamento do connection pool. Documente para não repetirmos."

Cria incidents/connection-pool-exhaustion.cpat.md com análise de causa raiz e etapas de prevenção.

Como se compara

Não é para — memória de chat, biblioteca de prompts ou gerador pontual de especificação-para-código. O Archcore é uma camada de verdade do repositório para agentes de codificação, não um kit de metodologia.

Referência

O que acompanha o pacote: 19 tipos de documento, 4 tipos de relação, 10 ferramentas MCP, integrações de hook para 4 agentes e integrações 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

Ecossistema

• Archcore Plugin — usando Claude Code ou Cursor? O plugin se integra à CLI: mesmo mecanismo, além de skills, comandos de intenção e guardrails. Um produto, dois pontos de entrada — a CLI sozinha cobre todos os outros agentes.
• docs.archcore.ai — documentação completa.
• .archcore/ neste repositório — um exemplo vivo: a CLI é construída com sua própria camada de contexto.

Desenvolvimento

Requer Go 1.25+.

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

Links e licença

• Documentação: docs.archcore.ai
• Site: archcore.ai
• Plugin (Claude Code, Cursor): github.com/archcore-ai/archcore-plugin
• Issues: github.com/archcore-ai/cli/issues
• Licença: Apache 2.0