Archcore MCP

Archcore CLI — Ngữ cảnh Git-Gốc cho Tác nhân Mã hóa AI

Archcore đã chuyển đến github.com/archcore-ai/archcore. Kho lưu trữ này đã được lưu trữ. CLI hiện nằm trong cli/ trong kho lưu trữ đó, bên cạnh plugin, và mọi bản phát hành từ v0.10.1 trở đi được xuất bản tại archcore-ai/archcore/releases. Cài đặt hoặc cập nhật bằng curl -fsSL https://archcore.ai/install.sh | bash trên macOS, Linux và WSL, hoặc irm https://archcore.ai/install.ps1 | iex trên Windows. Một tệp nhị phân được cài đặt từ kho lưu trữ này (v0.8.7 hoặc sớm hơn) không còn tự cập nhật; chạy trình cài đặt một lần để chuyển sang kênh mới. Vấn đề: archcore-ai/archcore/issues.

Archcore là một lớp ngữ cảnh git-gốc cho các tác nhân mã hóa AI.

CLI lưu giữ các đặc tả, quyết định kiến trúc, quy tắc, kế hoạch và kiến thức dự án trong .archcore/, được quản lý phiên bản cùng với mã của bạn, và phục vụ ngữ cảnh liên quan cho các tác nhân mã hóa thông qua MCP và các hook phiên.

Nó được phân phối dưới dạng CLI và một máy chủ MCP stdio cục bộ, vì vậy bất kỳ tác nhân mã hóa tương thích MCP nào cũng có thể đọc và ghi ngữ cảnh dự án của bạn thông qua các công cụ tiêu chuẩn. Sử dụng nó cho ngữ cảnh dự án bền vững trên Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code và Cline.

Xem nó hoạt động

Ngữ cảnh đó đến từ .archcore/ — các tài liệu Markdown có kiểu được quản lý phiên bản trong Git, được phục vụ cho bất kỳ tác nhân nào thông qua các công cụ MCP và hook phiên.

Điều gì thay đổi

❌ Không có Archcore

Mỗi phiên bắt đầu từ con số không. Tác nhân:

• đoán kiến trúc của bạn và phá vỡ các quy ước của bạn
• lặp lại logic đã tồn tại
• tranh luận lại các quyết định mà nhóm của bạn đã đưa ra
• cần được giải thích lại cùng một ngữ cảnh trong mỗi cuộc trò chuyện

✅ Với Archcore

Các quyết định, quy tắc và quy ước của bạn nằm trong Git dưới dạng ngữ cảnh có cấu trúc. Tác nhân:

• tải các quyết định và quy tắc áp dụng khi bắt đầu phiên
• đặt mã vào nơi kiến trúc của bạn quy định
• tôn trọng các ADR, đặc tả và quy tắc đã có trong kho lưu trữ
• ghi lại các quyết định mới dưới dạng ngữ cảnh bền vững — có thể xem xét trong PR, di động giữa các tác nhân

Tác nhân ngừng đoán và bắt đầu tuân theo hệ thống.

Bắt đầu trong 60 giây

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

archcore init tạo khung .archcore/, phát hiện các tác nhân mã hóa của bạn, và thiết lập hook và MCP cho chúng.

Sau đó mở tác nhân của bạn và nói:

"Chúng tôi đang sử dụng PostgreSQL cho lưu trữ chính. Ghi lại quyết định này."

Xong — giờ đã có một ADR có cấu trúc trong .archcore/ mà mọi phiên tương lai, trong bất kỳ tác nhân nào, sẽ thấy.

Trên Windows: irm https://archcore.ai/install.ps1 | iex. Đối với WSL, go install, và xây dựng từ mã nguồn, xem Phương pháp cài đặt bên dưới hoặc hướng dẫn cài đặt đầy đủ.

Hoạt động với tác nhân của bạn

CLI tự nó là một máy chủ MCP stdio cục bộ — một bề mặt tích hợp cho mọi tác nhân tương thích MCP. Hook thêm ngữ cảnh khi bắt đầu phiên ở nơi tác nhân hỗ trợ.

archcore init cấu hình các tác nhân được phát hiện tự động. Để thiết lập thủ công:

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ách hoạt động

1. Khởi tạo — archcore init tạo .archcore/ và cài đặt các tích hợp tác nhân.
2. Ghi lại — các quyết định, quy tắc, kế hoạch và hướng dẫn được lưu dưới dạng tài liệu Markdown có kiểu với frontmatter YAML.
3. Tái sử dụng — các tác nhân đọc, tạo, cập nhật và liên kết tài liệu thông qua các công cụ MCP trong khi làm việc; hook tải ngữ cảnh khi bắt đầu phiên.
4. Giữ trong Git — xem xét các thay đổi ngữ cảnh như mã, phát triển chúng theo thời gian, giữ chúng di động giữa các công cụ.

.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

Cấu trúc là tự do — tổ chức theo miền, tính năng hoặc nhóm. Loại tài liệu nằm trong tên tệp của nó (slug.type.md): 23 loại trên ba lớp — kiến thức (ADR, quy tắc, đặc tả, hướng dẫn), tầm nhìn (PRD, kế hoạch, ý tưởng, theo dõi yêu cầu) và kinh nghiệm (mẫu sự cố, tác vụ lặp lại). .archcore/ của chính kho lưu trữ này là một ví dụ hoạt động.

Hỏi tác nhân của bạn

"Trước khi tôi chạm vào mô-đun xác thực, những quyết định và quy tắc nào áp dụng ở đây?"

Tải các ADR và quy tắc liên quan đến khu vực đó trước khi tác nhân chỉnh sửa một dòng nào.

"Chúng tôi có một quy ước: luôn bọc lỗi bằng fmt.Errorf và %w. Biến điều này thành một quy tắc."

Tạo backend/error-wrapping.rule.md với hướng dẫn mệnh lệnh, lý do và các ví dụ tốt/xấu.

"Tuần trước chúng tôi đã có một sự cố cạn kiệt nhóm kết nối. Ghi lại nó để chúng tôi không lặp lại."

Tạo incidents/connection-pool-exhaustion.cpat.md với phân tích nguyên nhân gốc và các bước phòng ngừa.

So sánh

Không dành cho — bộ nhớ trò chuyện, thư viện lời nhắc, hoặc trình tạo đặc tả-thành-mã một lần. Archcore là một lớp chân lý kho lưu trữ cho các tác nhân mã hóa, không phải một bộ công cụ phương pháp.

Tham khảo

Những gì có trong hộp: 23 loại tài liệu, 7 loại quan hệ, 10 công cụ MCP, tích hợp hook cho 4 tác nhân và tích hợp MCP cho 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

Hệ sinh thái

• Archcore Plugin — đang sử dụng Claude Code hoặc Cursor? Plugin kết hợp với CLI: cùng công cụ, cộng thêm kỹ năng, lệnh ý định và lan can. Một sản phẩm, hai điểm vào — CLI riêng của nó bao phủ mọi tác nhân khác.
• docs.archcore.ai — tài liệu đầy đủ.
• .archcore/ trong kho này — một ví dụ sống: CLI được xây dựng với lớp ngữ cảnh riêng của nó.

Phát triển

Yêu cầu Go 1.25+.

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

Liên kết & giấy phép

• Tài liệu: docs.archcore.ai
• Trang web: archcore.ai
• Plugin (Claude Code, Cursor): github.com/archcore-ai/plugin
• Vấn đề: github.com/archcore-ai/cli/issues
• Giấy phép: Apache 2.0