TM Second Brain Nedir? İnsanlar ve Yapay Zeka Ajanları İçin Kalıcı Hafıza Rehberi

Sınıflandırma: Proje Dokümantasyonu ve Kapsamlı Rehber · Çalışma Maliyeti: $0.00 (Tamamen Çevrimdışı) · Lisans: MIT

ChatGPT, Claude veya yapay zeka kodlama araçlarıyla her gün çalışıyorsanız, en can sıkıcı sorunla mutlaka karşılaşmışsınızdır: dijital hafıza kaybı. Dün bir saat boyunca markanızın tonunu, Telegram müşterilerinizin itirazlarını veya veritabanı kurallarınızı anlattınız; bugün yeni bir sohbet açtığınızda asistan sizi ilk kez görüyormuş gibi davranıyor.

TM Second Brain (`tm-second-brain`), bu sıfırlanma döngüsünü kalıcı olarak bitirmek için geliştirildi. Taghi Molavi tarafından tasarlanan bu sistem; açık kaynaklı, çok dilli ve araçtan bağımsız bir İkinci Beyin (Second Brain) ve Kalıcı Hafıza katmanıdır. Hem günlük kullanıcıların ve işletme ekiplerinin hem de çoklu ajan (multi-agent) kullanan mühendislik ekiplerinin macOS, Linux ve Windows üzerinde $0.00 maliyetle ve internetsiz çalışabilen tek bir Markdown tabanlı hafızaya bağlanmasını sağlar.

Yönetici Özeti (Özetle Ne Sağlar?)

* Temel Sorun: Yapay zeka araçları oturumlar arasında bağlamı unutur, farklı projelerin kurallarını birbirine karıştırır ve değişen bilgileri iz bırakmadan sessizce silip üzerine yazar. * Çözüm: Tüm kalıcı bilgiyi kendi bilgisayarınızdaki sade Markdown + YAML frontmatter dosyalarında saklamak; sıfır harici bağımlılıkla (yalnızca Python 3.10+ standart kütüphanesi), API anahtarı olmadan ve $0.00 varsayılan maliyetle çalıştırmak. * Kimler İçin Uygun? Obsidian'da düzenli bir bilgi kasası kurmak isteyen yazarlar, pazarlama ve satış kanallarını yöneten ekipler ile Claude Code, OpenAI Codex, Gemini CLI, OpenCode, Goose, Antigravity ve Hermes kullanan yazılım mühendisleri. * Resmi Depo: GitHub'da tmolavi/tm-second-brain

Herkes İçin Sade Terimler Sözlüğü

Teknik detaylara geçmeden önce, mimaride ve görselde geçen kavramların günlük hayatta ne anlama geldiğine bakalım:

Mevcut Yapay Zeka Hafızaları Neden Yetersiz Kalıyor?

Günümüzde çoğu ekip aynı anda birden fazla araç kullanıyor: bilgisayarda bir IDE asistanı, terminalde bir CLI ajanı ve müşteri kanallarında otomasyon botları. Ortak ve izole bir hafıza katmanı olmadığında dört büyük sorun ortaya çıkar:

1. Parçalanmış Bağlam: Dün Claude Code'a öğrettiğiniz kuralı bugün Codex veya masaüstü asistanınız bilmez.
2. Projelerin Birbirine Karışması: B2B açılış sayfası için belirlenen marka tonu, kişisel notlara veya başka bir kod tabanına sızar.
3. Sessiz Üzerine Yazma (Silent Overwrite): Bir fiyat veya teknik karar değiştiğinde basit hafıza sistemleri eski bilgiyi siler; eski kararın *neden* alındığı kaybolur.
4. Bulut Bağımlılığı ve Abonelik Maliyeti: Üçüncü taraf hafıza servisleri hem aylık ücret ister hem de şirket bilginizi kendi sunucularında tutar.

tm-second-brain, tek gerçek kaynak olarak kendi diskinizdeki Markdown dosyalarını koruyarak bu dört sorunu ortadan kaldırır.

Farklı Kanallar ve Kullanım Senaryoları İçin Gerçek Örnekler

1. Satış, Pazarlama ve Müşteri Kanalları (Web Sitesi, Telegram, Instagram, CRM)

Birden fazla kanalda içerik üreten ve müşteri sorularını yanıtlayan bir marka düşünün: * Senaryo: Web siteniz teknik doğruluk gerektirir, Telegram kanalı hızlı ve güncel kampanya yanıtları ister, Instagram ise samimi bir marka dili bekler. * TM Second Brain ile: Her proje sıkı biçimde izole edilir (scope: project). Marka kuralları, sık sorulan müşteri soruları ve itiraz yanıtları tek kasada tutulur. Fiyat veya garanti şartı değiştiğinde correct komutu eski notu superseded (geçersiz kılınmış) olarak işaretler ve yeni active kaydı gerekçesiyle .tm-brain/corrections.jsonl dosyasına ekler. Böylece hiçbir kanal eski bilgi paylaşmaz. * Bu yapıyı Dijital İkiz ve Otonom İş Akışları ile birleştirmek, müşteri iletişimini ölçülebilir bir dönüşüm sistemine çevirir.

2. Kişisel Bilgi Yönetimi ve İçerik Üretimi (Günlük Kullanıcılar)

* Senaryo: Kitap notları, makale fikirleri ve günlük düşünceler klasörler arasında kayboluyor. * TM Second Brain ile: init --template personal-knowledge komutu, Obsidian uyumlu PARA klasör yapısını (00_Inbox – 04_Archive) ve Daily Notes/ dizinini hazırlar. private: true etiketi taşıyan veya 02_Areas/Personal/ altındaki notlar yapay zeka ajanlarına ve dışa aktarımlara tamamen kapatılır.

3. İş Operasyonları ve Yönetim Ekipleri

* Senaryo: Ekipler geçen ay bir tedarikçinin neden değiştirildiğini veya toplantıda alınan kararların gerekçesini unutur. * TM Second Brain ile: business-project şablonu; 3 Yıllıktan Haftalığa Hedef Kademesi, Projects/, Meetings/, Decisions/ ve Home.base tablo görünümünü oluşturur. Arama yaptığınızda expand komutu ilgili toplantı ve karar zincirini saniyeler içinde çıkarır.

4. Çoklu Ajan Yazılım Mühendisliği ve Dağıtık Düğümler

* Senaryo: Yukarıdaki mimari görselde görüldüğü gibi, bir mühendislik ekibi aynı anda Mac Hermes (yerel masaüstü), Antigravity (mühendislik ortamı), Finland Hermes (uzak sunucu) ve Main Hermes & Hamzad Core üzerinde çalışabilir. * TM Second Brain ile: developer-agent şablonu brain/ (North Star, Key Decisions, Patterns, Gotchas), Skills/ ve Knowledge Graph.canvas dosyalarını kurar. OpenAI Codex, Claude Code, Gemini CLI, OpenCode, Goose ve Antigravity ajanları tm-brain mcp veya install-adapter üzerinden bağlanır; ortam sınırları sayesinde yerel Mac hafızası üretim sunucularıyla asla karışmaz.

Teknik Mimari ve Mühendislik Garantileri

Üretim ortamı için tm-second-brain'i değerlendiren mühendisler adına sistem üç temiz katmandan oluşur:

Katman 1: Kanonik Kasa Depolaması

* Her kalıcı kayıt YAML frontmatter içeren bir Markdown dosyasıdır (mem_<YYYYMMDD>_<hash>). * Yaşam döngüsü durumları: draft → active → superseded → archived. * Değiştirilemez denetim kayıtları agent-log/YYYY-MM.md ve .tm-brain/corrections.jsonl içinde tutulur. * SQLite FTS5 önbelleği (.tm-brain/index.db) tamamen yeniden oluşturulabilir bir dizindir.

Katman 2: Saf Python Çekirdeği (tm_second_brain)

Yalnızca Python 3.10+ standart kütüphanesi ile yazılmıştır (dependencies = []); macOS, Linux ve Windows'ta birebir aynı şekilde çalışır: * Kademeli Hibrit Erişim (`RetrievalBackend`): * Tier 0 (Varsayılan — $0.00): Deterministik Python BM25 + SQLite FTS5 + wikilink grafik genişletme (expand) + güncellik/güven ağırlıklandırması. * Tier 1 (İsteğe Bağlı Yerel — $0.00): @tobilu/qmd veya yerel Ollama (nomic-embed-text, llama3.2, qwen2.5) adaptörleri. * Tier 2 & Tier 3 (İsteğe Bağlı Bulut): Yalnızca kullanıcı açıkça etkinleştirirse Gemini Free Tier, Groq veya ücretli sağlayıcılar (gizli notlar asla gönderilmez). * Çakışma Tespiti ve Düzeltme Geçmişi: Yazma öncesi aynı kapsamdaki aktif kayıtları kontrol eder; düzeltmeler üzerine yazmak yerine supersedes / superseded_by bağlantısı kurar. * SHA-256 Doğrulamalı Yedekleme: Sağlama toplamı doğrulamalı .tar.gz yedekleri ve geri yükleme öncesi otomatik anlık görüntü alır. * İnsan Onaylı Öğrenme: Tekrarlanan düzeltmeler L1 Draft önerisi üretir; SKILL.md veya AGENTS.md güncellemesi için açık L2 Kullanıcı Onayı gerekir.

Katman 3: Adaptörler ve Ekosistem

* Obsidian: Üzerine yazma öncesi otomatik yedeklemeli güvenli .md okuma/yazma, .base ve .canvas desteği. * Birinci Sınıf TM Köprüleri: HamzadBridge, MainHermesAdapter ve HermesPersonalDesktopAdapter. * Kodlama Ajanları: codex, claude-code, gemini-cli, opencode, goose, antigravity için tek komutlu kurulum ve stdio MCP Sunucusu (tm-brain mcp).

60 Saniyede Hızlı Başlangıç

# 1. Başlangıç şablonuyla kasa oluşturun (mevcut dosyaların üzerine asla yazmaz)
python3 -m tm_second_brain.cli --vault ./my-vault init --template developer-agent

# 2. Çevrimdışı hafıza kaydedin ve arayın ($0.00)
python3 -m tm_second_brain.cli --vault ./my-vault remember \
  --title "WAL modunu kullan" --body "Eşzamanlı okuyucular için SQLite WAL açın." --project core
python3 -m tm_second_brain.cli --vault ./my-vault search "WAL" --project core

# 3. Ajan adaptörü kurun
python3 -m tm_second_brain.cli --vault ./my-vault install-adapter codex

# 4. SHA-256 doğrulamalı yedek alın
python3 -m tm_second_brain.cli --vault ./my-vault backup ./vault-backup.tar.gz

SSS

TM Second Brain kullanmak için yazılımcı olmam gerekir mi?

Hayır. İşletme sahipleri, yazarlar ve ekipler personal-knowledge veya business-project şablonlarını doğrudan Obsidian içinde düzenli bir akıllı defter gibi kullanabilir. CLI ve MCP özellikleri yapay zeka ajanlarını bağlamak isteyen ekipler içindir.

Aylık maliyeti veya API anahtarı ihtiyacı nedir?

Varsayılan olarak $0.00. Temel hafıza kaydı, BM25 + grafik arama, çakışma takibi, gizlilik maskeleme ve SHA-256 yedekleme tamamen yerel Python üzerinde, API anahtarı olmadan çalışır.

Bulut tabanlı hafıza araçlarından farkı nedir?

Bulut servisleri verilerinizi dış sunucularda tutar ve aramaları API faturalarına bağlar. tm-second-brain ise yerel Markdown dosyalarını ana kaynak kabul eder, çevrimdışı çalışır ve tam düzeltme geçmişini saklar.

Gizli notlarımı ve API anahtarlarımı nasıl korur?

private: true etiketi taşıyan veya private_paths içindeki notlar ajan erişiminden ve dışa aktarımlardan hariç tutulur. Yerleşik Secret Redaction mekanizması da API anahtarlarını ve token'ları otomatik maskeler.

Şirketim için marka hafızası ve GEO mimarisini nasıl kurabilirim?

Kalıcı marka hafızasını yapay zeka görünürlüğü (GEO) ve çok kanallı dönüşümle birleştirmek için proje incelemesi talep edebilir veya önce ücretsiz Molavi Web Intelligence Engine aracıyla sitenizi analiz edebilirsiniz.

İlgili Okumalar ve Sonraki Adımlar

* Resmi GitHub Deposu: tmolavi/tm-second-brain * Ajan Becerileri ve MCP: MCP Agent Skills Hub ile Ajan Becerilerini Düzenleme * Proje Keşif Standardı: Düzenleme Öncesi Ajan Proje Keşfi * Hizmetler ve Kanıtlar: Dijital İkiz ve Otonom İş Akışları · GEO Denetimi · Teknik Kanıtlar