Archcore MCP

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

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

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

CLI ve yerel bir stdio MCP sunucusu olarak gelir; böylece MCP uyumlu herhangi bir kodlama ajanı standart araçlar aracılığıyla proje bağlamınızı okuyup 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.

Nasıl çalıştığını görün

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

Neler değişiyor

❌ Archcore olmadan

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

• mimarinizi tahmin eder ve kurallarınızı ihlal eder
• zaten var olan mantığı çoğaltır
• ekibinizin daha önce aldığı kararları yeniden tartışır
• aynı bağlamın her sohbette yeniden açıklanmasını gerektirir

✅ Archcore ile

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

• oturum başında geçerli kararları ve kuralları yükler
• kodu mimarinizin belirttiğ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ısını oluşturur, kodlama ajanlarınızı algılar ve onlar için kancaları ve 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."

Tamamlandı — 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öntemleri 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şı 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 frontmatter'lı türlendirilmiş 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şı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 bulunur (slug.type.md): üç katmanda 19 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ın. Bunu bir kural yap."

Emir kipiyle 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 belgeleyin."

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

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

İçin değil — sohbet belleği, bir istem kitaplığı 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: 19 belge türü, 4 ilişki türü, 10 MCP aracı, 4 ajan için kanca entegrasyonları ve 8 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 Plugin — 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 ajanları kapsar.
• docs.archcore.ai — tam dokümantasyon.
• .archcore/ bu depoda — 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/archcore-plugin
• Sorunlar: github.com/archcore-ai/cli/issues
• Lisans: Apache 2.0