🤖 Ajanlar için - makine okunabilir

Sen bir kodlama ajanısın.
Bu da kalıcı belleğin.

Engram sana 11 MCP aracıyla kalıcı bellek verir. Öğrendiklerini kaydet, doğru bağlamı yükle, repolar arasında bilgi taşı, kullanılan bilgiyi raporla ve oturum sonunda öğrenme döngüsünü kapat.

Hızlı Kurulum

# 1. API anahtarıyla terminalde bunu bir kez çalıştır
npx -y engram-tools@latest --setup engram_...

# 2. Claude, Codex, Cursor, Gemini veya Antigravity, Windsurf veya VS Code’u yeniden başlat

# 3. Bunları terminal komutu değil, ajan talimatı olarak yaz
Proje, repo, rol, pazar, teknoloji yığını ve görev bilgisiyle engram_start çağır.
Yaklaşım seçmeden önce mutlaka engram_recall çağır; başka repo’da çözülmüş olabilir diyorsan engram_cross_pollinate kullan.
Context compact olduysa, oturum özetlendiyse veya kaldığın yer belirsizse devam etmeden önce engram_rehydrate çağır. Anlamlı aşamalarda veya işi devretmeden önce engram_reflect ile kontrol noktası oluştur.

Aracın için kurulum

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"],
      "env": {
        "ENGRAM_API_KEY": "engram_..."
      }
    }
  }
}

Ajan erişimi

Ajan Engram satın alabilir mi?

Evet, e-posta ve ödeme adımlarını yönetebilen bir ajan aynı ödeme akışından geçebilir, çalışma alanı oluşturur ve API anahtarını kullanır. Değilse bir insan sahip kayıt olur, takım arkadaşlarını davet eder ve her ajana ayrı üye anahtarı verir.

Fiyatlandırmayı aç İnsan kurulum akışı

// Her aracı ne zaman kullanmalı

engram_start → Her yeni oturumdaki ilk çağrı. Proje, repo, rol, pazar, teknoloji yığını ve mevcut görevle çağır; kurulum bilgisini, private belleği, public bilgiyi ve uygun rehberleri tek başlangıç haritasında toplar.

engram_rehydrate → Context compact olduysa, oturum özetlendiyse, kaldığın yer belirsizse veya konuşma geçmişi eksildiyse kullan. Son kontrol noktasını, kararları, açık işleri, dikkat noktalarını ve son öğrenimleri geri getirir.

engram_smarter → Oturum içinde görev değiştirirken veya eski task’ın kafasında kaldığını hissedersen kullan. Daha hafif bir refocus çağrısıdır; yeni dosya, yeni hata veya yeni ürün alanı için belleği tazeler.

engram_cross_pollinate → Benzer işi başka repo çözmüş olabilir: mobile Safari paneli, localization, deploy, auth, billing, import, scraper, kalite kapısı. Yeniden kurmadan önce diğer repolardan taşınabilir dersleri getir.

engram_store → Kalıcı değeri olan bir şey keşfettiğinde kaydet: repo kuralı, canlı sistem dikkat noktası, tekrar kullanılacak çözüm, mimari karar veya test/deploy alışkanlığı. Tek seferlik log gürültüsü, secret veya müşteri verisi kaydetme.

engram_recall → Plan, mimari seçim, bilinmeyen hata, auth/billing/deploy/data/UX gibi riskli bir karar öncesinde çağır. Sadece takılınca değil, yaklaşım seçmeden önce kullan; takım bu maliyeti daha önce ödemiş olabilir.

engram_report_outcome → Hatırlanan bilgi yardımcı olduysa ya da yanlış bağlama geldiyse bildir. Bu senin agent feedback protokolün; sıralama böyle gelişir ve sonraki ajan daha iyi sonuç alır.

engram_reflect → Anlamlı aşama bitince, görev değiştirirken, birkaç bellek kullandıktan sonra veya işi devretmeden önce checkpoint oluştur. Zamanlayıcı değildir; context compact veya handoff sonrası devam etmeyi kolaylaştıran defter notudur.

engram_get_context → engram_get_context sadece ileri seviye hata ayıklama durumlarında, odaklı repo bilgi dökümü gerektiğinde kullanılır. Normal oturumlarda engram_start veya engram_smarter kullanılır.

engram_proof → Ürün ve yönetim kullanımı: bellek sayıları, aktivasyon, kullanım ve ölçüm kanıtını gösterir. Günlük kodlama akışının parçası değildir.

Ajan feedback protokolü

İnsan formu doldurma. Bellek döngüsünü eğit.

Bir bellek işe yaradıysa, bayatsa veya yanlış bağlama geldiyse bunu araçlarla bildir. Bu sinyal genel feedback mesajından daha değerli; çünkü sonraki sıralamayı doğrudan iyileştirir.

01Hatırlanan bir bilgiyi kullandıktan sonra engram_report_outcome çağır; işe yaradıysa true, yaramadıysa false gönder.

02Birden fazla bellek işi şekillendirdiyse engram_reflect ile milestone checkpoint oluştur.

03Başka repo aynı pattern’i çözmüş olabilir diyorsan planlamadan önce engram_cross_pollinate çağır.

Oturumlar Arası Öğrenme

Oturum 1'de zor bir hatayı düzeltiyorsun. Oturum 2'de aynı hata kalıbı farklı bir dosyada ortaya çıkıyor. Düzeltmeyi anında hatırlıyorsun.

Takım Bilgi Transferi

Önyüzdeki bir Cursor ajanı API'nin snake_case beklediğini keşfeder. Arka uçtaki Claude Code ajanı bunu kimse söylemeden öğrenir.

Kural Uygulaması

Kod yazmadan önce proje kurallarını hatırlıyorsun. "Doğrulama için Joi değil Zod kullanın." Takım standardını otomatik olarak uyguluyorsun.

Engram ile ilk oturum

İlk kez bağlandığında ajan tarafında ne olacağını netleştiriyoruz.

Terminal çalıştırabiliyorsan API anahtarıyla setup komutunu kendin çalıştır. Çalıştıramıyorsan insan sahibinden Engram’ı MCP ayarlarına eklemesini ve sana ayrı üye anahtarı vermesini iste.

Başlangıç ve bellek araçlarını görürsün: engram_start, engram_rehydrate, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context ve engram_setup.

Önce proje, repo, rol, pazar, teknoloji yığını ve görev bilgisiyle engram_start çağır.

Engram en ilgili ekip bilgisini ve uygun rehberleri tek çağrıda yükler.

Normal çalış, ama yaklaşım seçmeden önce mutlaka engram_recall çağır. Benzer işi başka repo çözmüş olabilir; o durumda engram_cross_pollinate çağır.

engram_reflect bir zamanlayıcı değildir; anlamlı bir aşama bitince, görev değiştirirken, birkaç bellek kaydı kullanıldıktan sonra veya işi devretmeden önce kontrol noktası oluşturur.

API referansı

11 MCP aracı için eksiksiz dokümantasyon.

engram_start

Her oturumu tek çağrıda başlatır. Kurulum bilgisini, ilgili bellekleri ve uygun rehberleri yükler.

{
  "agent_tool": "codex",
  "project": "English.cash",
  "repo": "english.cash",
  "role": "full-stack product engineer",
  "market": "English learning",
  "task": "fix guest practice so it uses the same API path as paid practice",
  "stack": ["Next.js", "TypeScript", "PostgreSQL", "LLM router"]
}

engram_rehydrate

Context compact, kısa özet, resume veya eksik konuşma geçmişinden sonra çalışma haritasını geri getirir.

{
  "agent_tool": "codex",
  "project": "Engram",
  "repo": "engram",
  "task": "continue mobile Safari chat fix after context compaction",
  "reason": "chat was compacted and only a short summary remains",
  "depth": "standard",
  "limit": 12
}

engram_smarter

Görev değiştirirken o göreve özel bellekleri ve rehberleri yükler.

{
  "context": "Next.js 16 mobile Safari chat widget overflows when keyboard opens",
  "repo": "engram",
  "file": "web/src/components/ChatWidget.tsx",
  "include_skills": true
}

engram_cross_pollinate

Workspace içindeki diğer repolardan tekrar kullanılabilir dersleri bulur.

{
  "target_repo": "skillbridge-monorepo",
  "context": "Add team invite flow with owner/admin permissions and email delivery",
  "source_repos": ["engram", "evimibul"],
  "include_public": true,
  "limit": 5
}

engram_store

Öğrenilmiş convention, pattern, gotcha veya solution kaydeder.

{
  "type": "SOLUTION",
  "content": "Mobile Safari chat panels should not autofocus inputs. Size the fixed panel from visualViewport, use 16px input text, and assert bounds after typing.",
  "tags": ["ios", "safari", "mobile", "chat-widget"],
  "repo": "engram",
  "agent_tool": "codex",
  "context": {
    "file": "web/src/components/ChatWidget.tsx",
    "platform": "ios-safari"
  }
}

engram_recall

Semantic query ile ilgili memory’leri repo, type veya tag filtreleriyle getirir.

{
  "query": "Stripe checkout succeeded but workspace plan still free after webhook",
  "repo": "engram",
  "type": "SOLUTION",
  "limit": 3
}

engram_report_outcome

Hatırlanan memory’nin başarıya mı hataya mı yol açtığını raporlar. Gelecek ranking’i iyileştirir.

{
  "memory_id": "cmqstripeplan123",
  "success": true,
  "detail": "The recalled webhook transaction pattern fixed the dashboard plan mismatch in production."
}

engram_reflect

Session sonunda loop’u kapatır: kullanılan memory’leri raporlar, kalıcı öğrenimleri kaydeder.

{
  "repo": "engram",
  "task": "Fix mobile Safari chat overflow and close behavior",
  "summary": "Chat panel now sizes from visualViewport, avoids mobile autofocus, uses 16px input text, and close restores the launcher.",
  "used_memories": [
    {
      "memory_id": "cmqioschat123",
      "success": true,
      "detail": "The iOS visualViewport gotcha pointed to the correct fix."
    }
  ],
  "learnings": [{
    "type": "SOLUTION",
    "content": "For mobile fixed panels, compute bounds from visualViewport and verify after focusing an input; CSS dvh alone may not catch layout viewport offset.",
    "tags": ["mobile", "safari", "visualViewport"]
  }]
}

engram_get_context

Bir repo için ilgili memory’leri tek çağrıda getirir. Repo değiştirirken kullan.

{
  "repo": "engram",
  "task": "Polish localized documentation without breaking rendered pages"
}

engram_skill

Migration, review, deploy ve debugging gibi kompleks işler için tam skill rehberi yükler.

{
  "skill": "security-audit"
}

engram_proof

Ürün kanıtlarını gösterir: bellek sayısı, öğrenme döngüsü, kullanım, aktivasyon ve benchmark özeti.

engram_proof()

engram_setup

Workspace bilgisi, mevcut tool’lar ve best-practice guidance döndürür.

{
  "agent_tool": "claude-code"
}

Bellek Türleri

CONVENTION

Kodlama standartları ve takım kuralları

"Always use Prisma migrations"

PATTERN

Tekrarlayan yaklaşımlar ve şablonlar

"API routes use cached() wrapper"

GOTCHA

Bozulan veya şaşırtan şeyler

"Neon requires SSL in production"

SOLUTION

İşe yarayan düzeltmeler

"Fix: add pooler to connection string"

ARCHITECTURE

Sistem tasarım kararları

"Search uses Haversine + bbox"

DEPENDENCY

Kütüphane bilgileri ve sürümler

"Prisma 7 needs adapter pattern"

// Makine okunabilir uç nokta

GET https://engram.tools/api/v1/capabilities

Desteklenen araçlar, bellek türleri, hız sınırları ve fiyatlandırma içeren JSON döndürür; programatik tüketim için tasarlanmıştır.

Sen bir kodlama ajanısın.
Bu da kalıcı belleğin.

Aracın için kurulum

Ajan Engram satın alabilir mi?

// Her aracı ne zaman kullanmalı

İnsan formu doldurma. Bellek döngüsünü eğit.

Oturumlar Arası Öğrenme

Takım Bilgi Transferi

Kural Uygulaması

Engram ile ilk oturum

API referansı

Bellek Türleri

Engram’ı birlikte geliştirelim

Neyi geliştirelim?

Sen bir kodlama ajanısın.Bu da kalıcı belleğin.

Aracın için kurulum

Ajan Engram satın alabilir mi?

// Her aracı ne zaman kullanmalı

İnsan formu doldurma. Bellek döngüsünü eğit.

Oturumlar Arası Öğrenme

Takım Bilgi Transferi

Kural Uygulaması

Engram ile ilk oturum

API referansı

Bellek Türleri

Engram’ı birlikte geliştirelim

Neyi geliştirelim?

Sen bir kodlama ajanısın.
Bu da kalıcı belleğin.