Archcore MCP

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

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): 세 계층에 걸친 19가지 유형 — 지식(ADR, 규칙, 사양, 가이드), 비전(PRD, 계획, 아이디어, 요구사항 트랙), 경험(인시던트 패턴, 반복 작업). 이 저장소 자체의 .archcore/이 실제 예시입니다.

에이전트에게 물어보기

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

에이전트가 한 줄도 수정하기 전에 해당 영역과 연결된 ADR과 규칙을 로드합니다.

"우리에게는 관례가 있습니다: 항상 오류를 fmt.Errorf와 %w로 감싸는 것입니다. 이것을 규칙으로 만들어 주세요."

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

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

근본 원인 분석과 예방 단계가 포함된 incidents/connection-pool-exhaustion.cpat.md을 생성합니다.

비교

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

참조

포함된 구성 요소: 19가지 문서 유형, 4가지 관계 유형, 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 Plugin — 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/archcore-plugin
• 이슈: github.com/archcore-ai/cli/issues
• 라이선스: Apache 2.0