Archcore MCP

Archcore CLI — บริบทแบบ Git-Native สำหรับ AI Coding Agents

Archcore ย้ายไปที่ github.com/archcore-ai/archcore Repository นี้ถูกเก็บถาวรแล้ว CLI ตอนนี้อยู่ภายใต้ cli/ ใน repository นั้น ถัดจาก plugin และทุก release ตั้งแต่ v0.10.1 เป็นต้นไปจะเผยแพร่ที่ archcore-ai/archcore/releases ติดตั้งหรืออัปเดตด้วย curl -fsSL https://archcore.ai/install.sh | bash บน macOS, Linux และ WSL หรือ irm https://archcore.ai/install.ps1 | iex บน Windows ไบนารีที่ติดตั้งจาก repository นี้ (v0.8.7 หรือเก่ากว่า) จะไม่ self-update อีกต่อไป ให้รัน installer หนึ่งครั้งเพื่อย้ายไปยังช่องทางใหม่ ปัญหา: archcore-ai/archcore/issues

Archcore คือชั้นบริบทแบบ git-native สำหรับ AI coding agents

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

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

ดูการทำงาน

บริบทนั้นมาจาก .archcore/ — เอกสาร Markdown ที่มีประเภทซึ่ง version ใน Git ส่งให้ agent ใดก็ได้ผ่าน MCP tools และ session hooks

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

❌ ไม่มี Archcore

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

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

✅ มี Archcore

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

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

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

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

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

archcore init สร้าง .archcore/, ตรวจหา coding agents ของคุณ และตั้งค่า hooks และ MCP ให้พวกมัน

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

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

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

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

ทำงานร่วมกับ agent ของคุณ

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

archcore init กำหนดค่า agent ที่ตรวจพบโดยอัตโนมัติ หากต้องการตั้งค่าด้วยตนเอง:

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. Initialize — archcore init สร้าง .archcore/ และติดตั้ง agent integrations
2. Capture — การตัดสินใจ กฎ แผน และคำแนะนำถูกเก็บเป็นเอกสาร Markdown ที่มีประเภทพร้อม YAML frontmatter
3. Reuse — agents อ่าน สร้าง อัปเดต และเชื่อมโยงเอกสารผ่าน 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): 23 ประเภทในสามชั้น — ความรู้ (ADRs, rules, specs, guides), วิสัยทัศน์ (PRDs, plans, ideas, requirements tracks) และประสบการณ์ (incident patterns, recurring tasks) .archcore/ ของ repo นี้เองเป็นตัวอย่างที่ใช้งานได้จริง

ถาม agent ของคุณ

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

โหลด ADR และกฎที่เกี่ยวข้องกับพื้นที่นั้นก่อนที่ agent จะแก้ไขแม้แต่บรรทัดเดียว

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

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

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

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

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

ไม่เหมาะสำหรับ — หน่วยความจำแชท, คลัง prompt หรือเครื่องมือสร้าง spec-to-code แบบครั้งเดียว Archcore คือชั้นความจริงของ repo สำหรับ coding agents ไม่ใช่ชุดวิธีการ

ข้อมูลอ้างอิง

สิ่งที่มาพร้อมในกล่อง: เอกสาร 23 ประเภท, ความสัมพันธ์ 7 ประเภท, MCP tools 10 รายการ, hook integrations สำหรับ 4 agents และ MCP integrations สำหรับ 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/ ในพื้นที่เก็บข้อมูลนี้ — ตัวอย่างที่มีชีวิต: 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