Archcore MCP

Archcore CLI

Archcore adalah lapisan konteks berbasis git untuk agen pengkodean AI.

Ini dikirimkan sebagai CLI dan server MCP stdio lokal, sehingga agen pengkodean yang kompatibel dengan MCP dapat membaca dan menulis konteks repo Anda melalui alat standar. Bekerja di Claude Code, Cursor, GitHub Copilot, Gemini CLI, Codex CLI, OpenCode, Roo Code, dan Cline.

Lihat cara kerjanya

Konteks itu berasal dari .archcore/ — dokumen Markdown yang diketik dan diversikan 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
• membutuhkan konteks yang sama untuk dijelaskan ulang di setiap obrolan

✅ Dengan Archcore

Keputusan, aturan, dan konvensi Anda berada 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 repo
• mencatat keputusan baru sebagai konteks yang tahan lama — dapat ditinjau di PR, portabel di seluruh 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 pengkodean Anda, dan menghubungkan hook serta MCP untuk mereka.

Kemudian 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 di mana agen mendukungnya.

archcore init mengonfigurasi agen yang terdeteksi secara otomatis. Untuk menghubungkan satu 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 mereka bekerja; hook memuat konteks di awal sesi.
4. Simpan di Git — tinjau perubahan konteks seperti kode, kembangkan seiring waktu, jaga agar tetap portabel di seluruh 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 terletak di nama filenya (slug.type.md): 19 jenis di tiga lapisan — pengetahuan (ADR, aturan, spesifikasi, panduan), visi (PRD, rencana, ide, jalur persyaratan), dan pengalaman (pola insiden, tugas berulang). .archcore/ repo 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 memiliki 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 kumpulan koneksi. Dokumentasikan agar kami tidak mengulanginya."

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

Untuk alur yang lebih besar, prompt MCP mengorkestrasi seluruh rangkaian dokumen — /product_track feature="user notifications" menyusun ide, menurunkan PRD, membangun rencana implementasi, dan menautkannya bersama.

Bagaimana perbandingannya

Bukan untuk — memori obrolan, pustaka prompt, atau generator spesifikasi-ke-kode satu kali. Archcore adalah lapisan kebenaran repo untuk agen pengkodean, bukan kit metodologi.

Referensi

Apa yang disertakan: 19 jenis dokumen, 4 jenis relasi, 10 alat MCP, 5 prompt multi-dokumen, 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 intent, dan pagar pembatas. Satu produk, dua titik masuk — CLI sendiri mencakup setiap agen lainnya.
• docs.archcore.ai — dokumentasi lengkap.
• .archcore/ di repo ini — contoh hidup: 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/archcore-plugin
• Isu: github.com/archcore-ai/cli/issues
• Lisensi: Apache 2.0