Archcore MCP

Archcore CLI — Yapay Zeka Kodlama Ajanları için Git-Native Bağlam

Archcore, github.com/archcore-ai/archcore adresine taşındı. Bu depo arşivlendi. CLI artık eklentinin yanında, o depoda cli/ altında yaşıyor ve v0.10.1'den itibaren her sürüm archcore-ai/archcore/releases adresinde yayınlanıyor. macOS, Linux ve WSL üzerinde curl -fsSL https://archcore.ai/install.sh | bash ile veya Windows üzerinde irm https://archcore.ai/install.ps1 | iex ile kurun veya güncelleyin. Bu depodan kurulan bir ikili dosya (v0.8.7 veya daha eski) artık kendini güncellemez; yeni kanala geçmek için yükleyiciyi bir kez çalıştırın. Sorunlar: archcore-ai/archcore/issues.

Archcore, yapay zeka kodlama ajanları için git-native bir bağlam katmanıdır.

CLI; spesifikasyonları, mimari kararları, kuralları, planları ve proje bilgisini .archcore/ içinde, kodunuzla birlikte sürümleyerek saklar ve ilgili bağlamı MCP ve oturum kancaları aracılığıyla kodlama ajanlarına sunar.

Bir CLI ve yerel stdio MCP sunucusu olarak gelir; böylece MCP uyumlu herhangi bir kodlama ajanı, standart araçlar aracılığıyla proje bağlamınızı okuyabilir ve yazabilir. Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code ve Cline genelinde kalıcı proje bağlamı için kullanın.

Çalışırken görün

Bu bağlam, .archcore/ — Git'te sürümlenen, MCP araçları ve oturum kancaları aracılığıyla herhangi bir ajana sunulan yazılmış Markdown belgeleri — kaynağından geldi.

Neler değişiyor

❌ Archcore olmadan

Her oturum sıfırdan başlar. Ajan:

• mimarinizi tahmin eder ve kurallarınızı bozar
• zaten var olan mantığı çoğaltır
• ekibinizin daha önce verdiği kararları yeniden tartışır
• her sohbette aynı bağlamın yeniden açıklanmasına ihtiyaç duyar

✅ Archcore ile

Kararlarınız, kurallarınız ve gelenekleriniz Git'te yapılandırılmış bağlam olarak yaşar. Ajan:

• oturum başlangıcında geçerli kararları ve kuralları yükler
• kodu mimarinizin söylediği yere koyar
• depoda zaten bulunan ADR'lere, spesifikasyonlara ve kurallara saygı gösterir
• yeni kararları kalıcı bağlam olarak kaydeder — PR'larda incelenebilir, ajanlar arasında taşınabilir

Ajan tahmin etmeyi bırakır ve sistemi takip etmeye başlar.

60 saniyede başlayın

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

archcore init, .archcore/ yapılandırır, kodlama ajanlarınızı algılar ve onlar için kancalar ile MCP'yi bağlar.

Ardından ajanınızı açın ve şunu söyleyin:

"Birincil depolama için PostgreSQL kullanıyoruz. Bu kararı kaydet."

Tamam — artık .archcore/ içinde, her gelecek oturumun herhangi bir ajanda göreceği yapılandırılmış bir ADR var.

Windows'ta: irm https://archcore.ai/install.ps1 | iex. WSL için, go install ve kaynaktan derleme için aşağıdaki Kurulum yöntemlerine veya tam kurulum kılavuzuna bakın.

Ajanınızla çalışır

CLI'nin kendisi yerel bir stdio MCP sunucusudur — MCP uyumlu her ajan için tek bir entegrasyon yüzeyi. Kancalar, ajanın desteklediği yerlerde oturum başlangıç bağlamı ekler.

archcore init, algılanan ajanları otomatik olarak yapılandırır. Birini elle bağlamak için:

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

Nasıl çalışır

1. Başlat — archcore init, .archcore/ oluşturur ve ajan entegrasyonlarını kurar.
2. Yakala — kararlar, kurallar, planlar ve kılavuzlar, YAML ön yüzü olan yazılmış Markdown belgeleri olarak saklanır.
3. Yeniden kullan — ajanlar çalışırken MCP araçları aracılığıyla belgeleri okur, oluşturur, günceller ve bağlar; kancalar oturum başlangıcında bağlamı yükler.
4. Git'te tut — bağlam değişikliklerini kod gibi inceleyin, zamanla geliştirin, araçlar arasında taşınabilir tutun.

.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

Yapı serbest biçimlidir — alana, özelliğe veya ekibe göre düzenleyin. Bir belgenin türü dosya adında yaşar (slug.type.md): üç katmanda 23 tür — bilgi (ADR'ler, kurallar, spesifikasyonlar, kılavuzlar), vizyon (PRD'ler, planlar, fikirler, gereksinim izleri) ve deneyim (olay desenleri, yinelenen görevler). Bu deponun kendi .archcore/ çalışan bir örnektir.

Ajanınıza sorun

"Auth modülüne dokunmadan önce, burada hangi kararlar ve kurallar geçerli?"

Ajan tek bir satırı düzenlemeden önce o alana bağlı ADR'leri ve kuralları yükler.

"Bir kuralımız var: hataları her zaman fmt.Errorf ve %w ile sar. Bunu bir kural yap."

Emir kipi yönlendirme, gerekçe ve iyi/kötü örneklerle backend/error-wrapping.rule.md oluşturur.

"Geçen hafta bir bağlantı havuzu tükenmesi olayı yaşadık. Tekrarlamayalım diye belgele."

Kök neden analizi ve önleme adımlarıyla incidents/connection-pool-exhaustion.cpat.md oluşturur.

Nasıl karşılaştırılır

Şunlar için değil — sohbet belleği, bir komut kütüphanesi veya tek seferlik spesifikasyondan koda üretici. Archcore, kodlama ajanları için bir depo gerçeklik katmanıdır, bir metodoloji kiti değil.

Referans

Kutuda ne var: 23 belge türü, 7 ilişki türü, 10 MCP aracı, 4 ajan için kanca entegrasyonları ve 8 ajan için MCP entegrasyonları.

---
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 Eklentisi — Claude Code veya Cursor mu kullanıyorsunuz? Eklenti CLI ile eşleşir: aynı motor, artı beceriler, niyet komutları ve güvenlik önlemleri. Tek ürün, iki giriş noktası — CLI tek başına diğer tüm aracıları kapsar.
• docs.archcore.ai — tam dokümantasyon.
• Bu depodaki .archcore/ — canlı bir örnek: CLI, kendi bağlam katmanıyla oluşturulmuştur.

Geliştirme

Go 1.25+ gerektirir.

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

Bağlantılar ve lisans

• Dokümantasyon: docs.archcore.ai
• Web sitesi: archcore.ai
• Eklenti (Claude Code, Cursor): github.com/archcore-ai/plugin
• Sorunlar: github.com/archcore-ai/cli/issues
• Lisans: Apache 2.0