Archcore MCP

Archcore CLI — Konteks Git-Native untuk Agen Pengodean AI

Archcore pindah ke github.com/archcore-ai/archcore. Repositori ini diarsipkan. CLI sekarang berada di bawah cli/ di repositori tersebut, di samping plugin, dan setiap rilis dari v0.10.1 ke atas dipublikasikan di archcore-ai/archcore/releases. Instal atau perbarui dengan curl -fsSL https://archcore.ai/install.sh | bash di macOS, Linux, dan WSL, atau irm https://archcore.ai/install.ps1 | iex di Windows. Biner yang diinstal dari repositori ini (v0.8.7 atau lebih lama) tidak lagi memperbarui diri sendiri; jalankan penginstal sekali untuk pindah ke saluran baru. Masalah: archcore-ai/archcore/issues.

Archcore adalah lapisan konteks git-native untuk agen pengodean AI.

CLI menyimpan spesifikasi, keputusan arsitektur, aturan, rencana, dan pengetahuan proyek di .archcore/, dengan versi yang selaras dengan kode Anda, dan menyajikan konteks yang relevan kepada agen pengodean melalui MCP dan hook sesi.

CLI ini dikirim sebagai CLI dan server MCP stdio lokal, sehingga agen pengodean apa pun yang kompatibel dengan MCP dapat membaca dan menulis konteks proyek Anda melalui alat standar. Gunakan untuk konteks proyek yang persisten di Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code, dan Cline.

Lihat cara kerjanya

Konteks itu berasal dari .archcore/ — dokumen Markdown yang diketik dengan versi di Git, disajikan ke agen mana pun melalui alat MCP dan hook sesi.

Apa yang berubah

❌ Tanpa Archcore

Setiap sesi dimulai dari nol. Agen:

• menebak arsitektur Anda dan melanggar konvensi Anda
• menduplikasi logika yang sudah ada
• memperdebatkan kembali keputusan yang sudah dibuat tim Anda
• perlu konteks yang sama dijelaskan ulang di setiap obrolan

✅ Dengan Archcore

Keputusan, aturan, dan konvensi Anda tersimpan di Git sebagai konteks terstruktur. Agen:

• memuat keputusan dan aturan yang berlaku di awal sesi
• menempatkan kode sesuai dengan arsitektur Anda
• menghormati ADR, spesifikasi, dan aturan yang sudah ada di repositori
• mencatat keputusan baru sebagai konteks yang tahan lama — dapat ditinjau di PR, portabel di berbagai agen

Agen berhenti menebak dan mulai mengikuti sistem.

Mulai dalam 60 detik

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

archcore init menyiapkan .archcore/, mendeteksi agen pengodean Anda, dan menghubungkan hook serta MCP untuk mereka.

Lalu buka agen Anda dan katakan:

"Kami menggunakan PostgreSQL untuk penyimpanan utama. Catat keputusan ini."

Selesai — sekarang ada ADR terstruktur di .archcore/ yang akan dilihat oleh setiap sesi mendatang, di agen mana pun.

Di Windows: irm https://archcore.ai/install.ps1 | iex. Untuk WSL, go install, dan membangun dari sumber, lihat Metode instalasi di bawah atau panduan instalasi lengkap.

Bekerja dengan agen Anda

CLI itu sendiri adalah server MCP stdio lokal — satu permukaan integrasi untuk setiap agen yang kompatibel dengan MCP. Hook menambahkan konteks awal sesi jika agen mendukungnya.

archcore init mengonfigurasi agen yang terdeteksi secara otomatis. Untuk menghubungkan secara manual:

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

Cara kerjanya

1. Inisialisasi — archcore init membuat .archcore/ dan menginstal integrasi agen.
2. Tangkap — keputusan, aturan, rencana, dan panduan disimpan sebagai dokumen Markdown yang diketik dengan frontmatter YAML.
3. Gunakan kembali — agen membaca, membuat, memperbarui, dan menautkan dokumen melalui alat MCP saat bekerja; hook memuat konteks di awal sesi.
4. Simpan di Git — tinjau perubahan konteks seperti kode, kembangkan seiring waktu, jaga portabilitas di berbagai alat.

.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

Strukturnya bebas — atur berdasarkan domain, fitur, atau tim. Jenis dokumen ada di nama filenya (slug.type.md): 23 jenis di tiga lapisan — pengetahuan (ADR, aturan, spesifikasi, panduan), visi (PRD, rencana, ide, jalur persyaratan), dan pengalaman (pola insiden, tugas berulang). .archcore/ repositori ini sendiri adalah contoh yang berfungsi.

Tanyakan pada agen Anda

"Sebelum saya menyentuh modul auth, keputusan dan aturan apa yang berlaku di sini?"

Memuat ADR dan aturan yang terkait dengan area itu sebelum agen mengedit satu baris pun.

"Kami punya konvensi: selalu bungkus error dengan fmt.Errorf dan %w. Jadikan ini aturan."

Membuat backend/error-wrapping.rule.md dengan panduan imperatif, alasan, dan contoh baik/buruk.

"Minggu lalu kami mengalami insiden kehabisan koneksi pool. Dokumentasikan agar tidak terulang."

Membuat incidents/connection-pool-exhaustion.cpat.md dengan analisis akar masalah dan langkah pencegahan.

Perbandingan

Bukan untuk — memori obrolan, pustaka prompt, atau generator spesifikasi-ke-kode sekali jalan. Archcore adalah lapisan kebenaran repositori untuk agen pengodean, bukan kit metodologi.

Referensi

Yang disertakan: 23 jenis dokumen, 7 jenis relasi, 10 alat MCP, integrasi hook untuk 4 agen dan integrasi MCP untuk 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

Ekosistem

• Plugin Archcore — menggunakan Claude Code atau Cursor? Plugin ini berpasangan dengan CLI: mesin yang sama, plus keterampilan, perintah niat, dan pagar pengaman. Satu produk, dua titik masuk — CLI saja mencakup semua agen lainnya.
• docs.archcore.ai — dokumentasi lengkap.
• .archcore/ di repositori ini — contoh langsung: CLI dibangun dengan lapisan konteksnya sendiri.

Pengembangan

Membutuhkan Go 1.25+.

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

Tautan & lisensi

• Dokumentasi: docs.archcore.ai
• Situs web: archcore.ai
• Plugin (Claude Code, Cursor): github.com/archcore-ai/plugin
• Masalah: github.com/archcore-ai/cli/issues
• Lisensi: Apache 2.0