Archcore MCP

Archcore CLI — Bối cảnh gốc Git dành cho tác nhân mã hóa AI

Archcore là lớp bối cảnh gốc Git dành cho tác nhân mã hóa AI.

CLI giữ spec, 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ụ bối cảnh liên quan cho các tác nhân mã hóa thông qua MCP và session hooks.

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 nào tương thích MCP đều có thể đọc và ghi bối cảnh dự án của bạn thông qua các công cụ tiêu chuẩn. Sử dụng nó để duy trì bối cảnh dự án xuyên suốt trên Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code và Cline.

Xem nó hoạt động

Bối 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 qua các công cụ MCP và session hooks.

Điều gì thay đổi

❌ Không có Archcore

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

• đ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 bạn đã đưa ra
• cần được giải thích lại cùng một bối 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 bối cảnh có cấu trúc. Tác nhân sẽ:

• tải các quyết định và quy tắc áp dụng khi bắt đầu phiên
• đặt mã đúng nơi kiến trúc của bạn quy định
• tôn trọng các ADR, spec và quy tắc đã có trong kho lưu trữ
• ghi lại các quyết định mới dưới dạng bối 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 khởi tạo .archcore/, phát hiện các tác nhân mã hóa của bạn, và thiết lập hooks 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 làm việc tương lai, trên bất kỳ tác nhân nào, sẽ thấy.

Trên Windows: irm https://archcore.ai/install.ps1 | iex. Với WSL, go install, và xây dựng từ mã nguồn, xem Các 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

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

archcore init cấu hình tự động các tác nhân được phát hiện. Để 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 YAML frontmatter.
3. Tái sử dụng — tác nhân đọc, tạo, cập nhật và liên kết tài liệu qua các công cụ MCP trong khi làm việc; hooks tải bối cảnh khi bắt đầu phiên.
4. Giữ trong Git — xem xét các thay đổi bối 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 domain, tính năng hoặc nhóm. Loại tài liệu nằm trong tên tệp (slug.type.md): 19 loại trên ba lớp — kiến thức (ADR, quy tắc, spec, hướng dẫn), tầm nhìn (PRD, kế hoạch, ý tưởng, tuyến 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 module auth, những quyết định và quy tắc nào áp dụng ở đây?"

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

"Chúng tôi có 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 gặp sự cố cạn kiệt connection-pool. Ghi lại để chúng ta 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 prompt, hoặc trình tạo spec-thành-mã một lần. Archcore là lớp chân lý kho lưu trữ cho tác nhân mã hóa, không phải bộ công cụ phương pháp.

Tham khảo

Có trong gói: 19 loại tài liệu, 4 loại quan hệ, 10 công cụ MCP, tích hợp hooks 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 dùng Claude Code hoặc Cursor? Plugin kết hợp với CLI: cùng một engine, thêm skills, lệnh intent, và guardrails. Một sản phẩm, hai điểm truy cập — CLI riêng của nó bao phủ mọi agent khác.
• docs.archcore.ai — tài liệu đầy đủ.
• .archcore/ trong repo này — một ví dụ sống: CLI được xây dựng với lớp context của chính 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/archcore-plugin
• Vấn đề (Issues): github.com/archcore-ai/cli/issues
• Giấy phép: Apache 2.0