Archcore MCP

Archcore CLI — AI 코딩 에이전트를 위한 Git-네이티브 컨텍스트

Archcore가 github.com/archcore-ai/archcore로 이전했습니다. 이 저장소는 보관되었습니다. CLI는 이제 해당 저장소의 cli/ 아래에 플러그인과 함께 있으며, v0.10.1부터 모든 릴리스는 archcore-ai/archcore/releases에 게시됩니다. macOS, Linux, WSL에서는 curl -fsSL https://archcore.ai/install.sh | bash로, Windows에서는 irm https://archcore.ai/install.ps1 | iex로 설치하거나 업데이트하세요. 이 저장소에서 설치된 바이너리(v0.8.7 이하)는 더 이상 자체 업데이트되지 않습니다. 새 채널로 이동하려면 설치 프로그램을 한 번 실행하세요. 이슈: archcore-ai/archcore/issues.

Archcore는 AI 코딩 에이전트를 위한 git-네이티브 컨텍스트 레이어입니다.

CLI는 사양, 아키텍처 결정, 규칙, 계획, 프로젝트 지식을 .archcore/에 유지하며, 코드와 함께 버전 관리되고, MCP 및 세션 훅을 통해 코딩 에이전트에 관련 컨텍스트를 제공합니다.

CLI와 로컬 stdio MCP 서버로 제공되므로, MCP 호환 코딩 에이전트는 표준 도구를 통해 프로젝트 컨텍스트를 읽고 쓸 수 있습니다. Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code, Cline에서 지속적인 프로젝트 컨텍스트로 사용하세요.

작동 모습

그 컨텍스트는 .archcore/ — Git에 버전 관리되는 타이핑된 Markdown 문서 — 에서 왔으며, MCP 도구와 세션 훅을 통해 모든 에이전트에 제공됩니다.

무엇이 달라지나

❌ Archcore 없이

모든 세션이 제로에서 시작합니다. 에이전트는:

• 아키텍처를 추측하고 규칙을 어깁니다
• 이미 존재하는 로직을 중복합니다
• 팀이 이미 내린 결정을 다시 논쟁합니다
• 모든 채팅에서 같은 컨텍스트를 다시 설명해야 합니다

✅ Archcore와 함께

결정, 규칙, 규칙이 구조화된 컨텍스트로 Git에 저장됩니다. 에이전트는:

• 세션 시작 시 적용 가능한 결정과 규칙을 로드합니다
• 아키텍처가 지정한 위치에 코드를 배치합니다
• 저장소에 이미 있는 ADR, 사양, 규칙을 존중합니다
• 새 결정을 지속적인 컨텍스트로 기록합니다 — PR에서 검토 가능하고, 에이전트 간 이식 가능합니다

에이전트는 추측을 멈추고 시스템을 따르기 시작합니다.

60초 만에 시작하기

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

archcore init는 .archcore/를 스캐폴딩하고, 코딩 에이전트를 감지하며, 훅과 MCP를 자동으로 연결합니다.

그런 다음 에이전트를 열고 말하세요:

"우리는 PostgreSQL을 기본 저장소로 사용합니다. 이 결정을 기록하세요."

완료 — 이제 .archcore/에 구조화된 ADR이 있으며, 모든 미래 세션, 모든 에이전트에서 볼 수 있습니다.

Windows에서: irm https://archcore.ai/install.ps1 | iex. WSL의 경우, go install, 소스에서 빌드하는 경우는 아래 설치 방법 또는 전체 설치 가이드를 참조하세요.

에이전트와 함께 작동

CLI 자체가 로컬 stdio MCP 서버입니다 — 모든 MCP 호환 에이전트를 위한 하나의 통합 표면. 훅은 에이전트가 지원하는 곳에서 세션 시작 컨텍스트를 추가합니다.

archcore init는 감지된 에이전트를 자동으로 구성합니다. 수동으로 연결하려면:

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

작동 방식

1. 초기화 — archcore init가 .archcore/를 생성하고 에이전트 통합을 설치합니다.
2. 캡처 — 결정, 규칙, 계획, 가이드는 YAML frontmatter가 있는 타이핑된 Markdown 문서로 저장됩니다.
3. 재사용 — 에이전트는 작업 중 MCP 도구를 통해 문서를 읽고, 생성하고, 업데이트하고, 연결합니다. 훅은 세션 시작 시 컨텍스트를 로드합니다.
4. Git에 유지 — 코드처럼 컨텍스트 변경을 검토하고, 시간이 지나며 발전시키고, 도구 간 이식 가능하게 유지합니다.

.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

구조는 자유 형식입니다 — 도메인, 기능, 팀별로 구성하세요. 문서의 유형은 파일 이름(slug.type.md)에 있습니다: 23가지 유형이 세 계층에 걸쳐 있습니다 — 지식(ADR, 규칙, 사양, 가이드), 비전(PRD, 계획, 아이디어, 요구사항 트랙), 경험(인시던트 패턴, 반복 작업). 이 저장소 자체의 .archcore/가 작동 예시입니다.

에이전트에게 물어보세요

"인증 모듈을 건드리기 전에, 여기에 적용되는 결정과 규칙은 무엇인가요?"

에이전트가 한 줄도 편집하기 전에 해당 영역과 관련된 ADR과 규칙을 로드합니다.

"우리 규칙이 있습니다: 항상 fmt.Errorf와 %w로 오류를 감싸세요. 이것을 규칙으로 만드세요."

명령형 지침, 근거, 좋은/나쁜 예시가 있는 backend/error-wrapping.rule.md를 생성합니다.

"지난주에 연결 풀 고갈 인시던트가 있었습니다. 반복하지 않도록 문서화하세요."

근본 원인 분석과 예방 단계가 있는 incidents/connection-pool-exhaustion.cpat.md를 생성합니다.

비교

대상 아님 — 채팅 메모리, 프롬프트 라이브러리, 일회성 사양-코드 생성기. Archcore는 코딩 에이전트를 위한 저장소 진실 레이어이지, 방법론 키트가 아닙니다.

참조

포함된 것: 23가지 문서 유형, 7가지 관계 유형, 10가지 MCP 도구, 4개 에이전트용 훅 통합 및 8개용 MCP 통합.

---
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

생태계

• Archcore 플러그인 — Claude Code 또는 Cursor를 사용 중이신가요? 플러그인은 CLI와 함께 작동합니다: 동일한 엔진, 스킬, 의도 명령 및 가드레일. 하나의 제품, 두 개의 진입점 — CLI만으로도 다른 모든 에이전트를 지원합니다.
• docs.archcore.ai — 전체 문서.
• 이 저장소의 .archcore/ — 살아있는 예제: CLI는 자체 컨텍스트 레이어로 구축되었습니다.

개발

Go 1.25+ 필요.

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

링크 및 라이선스

• 문서: docs.archcore.ai
• 웹사이트: archcore.ai
• 플러그인 (Claude Code, Cursor): github.com/archcore-ai/plugin
• 이슈: github.com/archcore-ai/cli/issues
• 라이선스: Apache 2.0