Archcore MCP

Archcore CLI — บริบทแบบ Git-Native สำหรับเอเจนต์เขียนโค้ด AI

Archcore คือชั้นบริบทแบบ git-native สำหรับเอเจนต์เขียนโค้ด AI

CLI เก็บสเปก การตัดสินใจด้านสถาปัตยกรรม กฎ แผน และความรู้ของโปรเจกต์ไว้ใน .archcore/ โดยเวอร์ชันร่วมกับโค้ดของคุณ และส่งบริบทที่เกี่ยวข้องให้เอเจนต์เขียนโค้ดผ่าน MCP และ session hooks

มันมาพร้อมกับ CLI และ MCP server แบบ stdio ในเครื่อง ดังนั้นเอเจนต์เขียนโค้ดที่รองรับ MCP ทุกตัวสามารถอ่านและเขียนบริบทของโปรเจกต์คุณผ่านเครื่องมือมาตรฐาน ใช้สำหรับบริบทโปรเจกต์แบบถาวรข้าม Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code และ Cline

ดูการทำงาน

บริบทนั้นมาจาก .archcore/ — เอกสาร Markdown แบบมีชนิดที่เวอร์ชันใน Git ส่งให้เอเจนต์ใดก็ได้ผ่าน MCP tools และ session hooks

สิ่งที่เปลี่ยนแปลง

❌ ไม่มี Archcore

ทุกเซสชันเริ่มจากศูนย์ เอเจนต์จะ:

• เดาสถาปัตยกรรมของคุณและทำลายธรรมเนียมปฏิบัติของคุณ
• ทำซ้ำลอจิกที่มีอยู่แล้ว
• นำการตัดสินใจที่ทีมของคุณทำไปแล้วกลับมาถกเถียงใหม่
• ต้องการให้อธิบายบริบทเดียวกันซ้ำในทุกแชท

✅ มี Archcore

การตัดสินใจ กฎ และธรรมเนียมปฏิบัติของคุณอยู่ใน Git เป็นบริบทที่มีโครงสร้าง เอเจนต์จะ:

• โหลดการตัดสินใจและกฎที่เกี่ยวข้องตอนเริ่มเซสชัน
• วางโค้ดตามที่สถาปัตยกรรมของคุณกำหนด
• เคารพ ADR สเปก และกฎที่มีอยู่ใน repo
• บันทึกการตัดสินใจใหม่เป็นบริบทที่คงทน — ตรวจสอบได้ใน PR พกพาได้ข้ามเอเจนต์

เอเจนต์หยุดเดาและเริ่มทำตามระบบ

เริ่มต้นภายใน 60 วินาที

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

archcore init สร้างโครง .archcore/ ตรวจจับเอเจนต์เขียนโค้ดของคุณ และตั้งค่า hooks และ MCP ให้พวกมัน

จากนั้นเปิดเอเจนต์ของคุณแล้วพูดว่า:

"เรากำลังใช้ PostgreSQL สำหรับที่จัดเก็บหลัก บันทึกการตัดสินใจนี้"

เสร็จแล้ว — ตอนนี้มี ADR ที่มีโครงสร้างใน .archcore/ ซึ่งทุกเซสชันในอนาคต ในเอเจนต์ใดก็ได้ จะเห็น

บน Windows: irm https://archcore.ai/install.ps1 | iex. สำหรับ WSL go install และการ build จากซอร์ส ดู วิธีติดตั้ง ด้านล่างหรือ คู่มือติดตั้งฉบับเต็ม

ทำงานร่วมกับเอเจนต์ของคุณ

CLI ตัวมันเองเป็น MCP server แบบ stdio ในเครื่อง — พื้นผิวการผสานเดียวสำหรับเอเจนต์ที่รองรับ MCP ทุกตัว Hooks เพิ่มบริบทตอนเริ่มเซสชันในที่ที่เอเจนต์รองรับ

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. บันทึก — การตัดสินใจ กฎ แผน และคำแนะนำถูกจัดเก็บเป็นเอกสาร Markdown แบบมีชนิดพร้อม YAML frontmatter
3. นำกลับมาใช้ — เอเจนต์อ่าน สร้าง อัปเดต และเชื่อมโยงเอกสารผ่าน MCP tools ขณะทำงาน hooks โหลดบริบทตอนเริ่มเซสชัน
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/ ของ repo นี้เองเป็นตัวอย่างที่ใช้งานได้จริง

ถามเอเจนต์ของคุณ

"ก่อนฉันแตะโมดูล auth มีการตัดสินใจและกฎอะไรที่ใช้ที่นี่บ้าง?"

โหลด ADR และกฎที่ผูกกับพื้นที่นั้นก่อนที่เอเจนต์จะแก้โค้ดแม้แต่บรรทัดเดียว

"เรามีธรรมเนียม: ห่อ errors ด้วย fmt.Errorf และ %w เสมอ ทำให้เป็นกฎ"

สร้าง backend/error-wrapping.rule.md พร้อมคำแนะนำเชิงบังคับ เหตุผล และตัวอย่างที่ดี/ไม่ดี

"สัปดาห์ที่แล้วเรามีเหตุการณ์ connection-pool หมด เอกสารไว้เพื่อไม่ให้เกิดซ้ำ"

สร้าง incidents/connection-pool-exhaustion.cpat.md พร้อมการวิเคราะห์สาเหตุต้นตอและขั้นตอนการป้องกัน

การเปรียบเทียบ

ไม่เหมาะสำหรับ — หน่วยความจำแชท ไลบรารีพรอมพ์ หรือตัวสร้างสเปกเป็นโค้ดแบบครั้งเดียว Archcore คือชั้นความจริงของ repo สำหรับเอเจนต์เขียนโค้ด ไม่ใช่ชุดวิธีการ

เอกสารอ้างอิง

สิ่งที่มาพร้อมในกล่อง: เอกสาร 19 ชนิด, ความสัมพันธ์ 4 ชนิด, เครื่องมือ MCP 10 ตัว, การผสาน hooks สำหรับ 4 เอเจนต์ และการผสาน MCP สำหรับ 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

ระบบนิเวศ

• Archcore Plugin — ใช้ Claude Code หรือ Cursor อยู่หรือเปล่า? ปลั๊กอินทำงานคู่กับ CLI: เอนจินเดียวกัน พร้อมด้วยสกิล คำสั่งเจตนา และการ์ดเรล ผลิตภัณฑ์เดียว สองจุดเข้า — CLI เพียงอย่างเดียวครอบคลุมเอเจนต์อื่นทั้งหมด
• docs.archcore.ai — เอกสารฉบับเต็ม
• .archcore/ ใน repo นี้ — ตัวอย่างที่มีชีวิต: 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