Archcore MCP

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

Archcore mudou para github.com/archcore-ai/archcore. Este repositório está arquivado. O CLI agora vive em cli/ nesse repositório, ao lado do plugin, e cada versão a partir da v0.10.1 é publicada em archcore-ai/archcore/releases. Instale ou atualize com curl -fsSL https://archcore.ai/install.sh | bash no macOS, Linux e WSL, ou irm https://archcore.ai/install.ps1 | iex no Windows. Um binário instalado deste repositório (v0.8.7 ou anterior) não se atualiza mais automaticamente; execute o instalador uma vez para migrar para o novo canal. Problemas: archcore-ai/archcore/issues.

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

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

Ele é distribuído como um CLI e um servidor MCP stdio local, 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 em Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code e Cline.

Veja como funciona

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

O que muda

❌ Sem Archcore

Cada 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 cada chat

✅ Com Archcore

Suas decisões, regras e convenções vivem em 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 começa 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 .archcore/, detecta seus agentes de codificação e configura hooks e MCP para eles.

Depois abra seu agente e diga:

"Estamos usando PostgreSQL para armazenamento primário. Registre essa decisão."

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

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

Funciona com seu agente

O CLI é em si um servidor MCP stdio local — uma única superfície de integração para todo agente compatível com MCP. Hooks adicionam contexto no início da sessão onde o agente suporta.

archcore init configura agentes detectados automaticamente. Para configurar 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 integrações com agentes.
2. Capture — decisões, regras, planos e guias são armazenados como documentos Markdown tipados com frontmatter YAML.
3. Reutilize — agentes leem, criam, atualizam e vinculam documentos por meio de ferramentas MCP enquanto trabalham; hooks carregam 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, 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, funcionalidade ou time. O tipo de um documento está no nome do arquivo (slug.type.md): 23 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 envolver 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 pool de conexões. 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. Archcore é uma camada de verdade do repositório para agentes de codificação, não um kit de metodologia.

Referência

O que vem incluso: 23 tipos de documento, 7 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

• Plugin Archcore — usando Claude Code ou Cursor? O plugin se integra à CLI: mesmo mecanismo, além de habilidades, comandos de intenção e proteções. 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/plugin
• Problemas: github.com/archcore-ai/cli/issues
• Licença: Apache 2.0