Archcore MCP

Archcore CLI — Konteks Git-Natif untuk Agen Pengodean AI

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

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

Produk ini hadir 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 dan memiliki versi di Git, disajikan ke agen mana pun melalui alat MCP dan session hooks.

Apa yang berubah

❌ Tanpa Archcore

Setiap sesi dimulai dari nol. Agen:

• menebak arsitektur Anda dan melanggar konvensi Anda
• menduplikasi logika yang sudah ada
• memperdebatkan ulang 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 tempat yang ditentukan 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 semua 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 memasang hooks 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 ini sendiri adalah server MCP stdio lokal — satu permukaan integrasi untuk setiap agen yang kompatibel dengan MCP. Hooks menambahkan konteks awal sesi jika agen mendukungnya.

archcore init mengonfigurasi agen yang terdeteksi secara otomatis. Untuk memasang 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 memasang integrasi agen.
2. Tangkap — keputusan, aturan, rencana, dan panduan disimpan sebagai dokumen Markdown yang diketik dengan YAML frontmatter.
3. Gunakan kembali — agen membaca, membuat, memperbarui, dan menautkan dokumen melalui alat MCP saat bekerja; hooks memuat konteks di awal sesi.
4. Simpan di Git — tinjau perubahan konteks seperti kode, kembangkan seiring waktu, jaga portabilitasnya di semua 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): 19 jenis di tiga lapisan — pengetahuan (ADR, aturan, spesifikasi, panduan), visi (PRD, rencana, ide, jalur kebutuhan), 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 tersebut sebelum agen mengubah 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, serta 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 tersedia di dalam paket: 19 jenis dokumen, 4 jenis relasi, 10 alat MCP, integrasi hooks 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

• Archcore Plugin — menggunakan Claude Code atau Cursor? Plugin ini berpasangan dengan CLI: mesin yang sama, ditambah skills, perintah intent, dan guardrails. Satu produk, dua titik masuk — CLI saja sudah mencakup semua 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
• Masalah: github.com/archcore-ai/cli/issues
• Lisensi: Apache 2.0