Claude Code + Obsidian düz jurnal (flat log) olmadan

Niyə bir böyük nəticələr faylı artıq işləmir

Köhnə yanaşma pis deyildi - sadəcə bir fayl üçün həddindən artıq böyüdü.

Claude Code-u quranda onun konfiqurasiyasında cəmi bir qayda var idi: kodda edilən hər dəyişiklikdən sonra atılan addımları, nəyin dəyişdiyini, bunun faydasını və səbəbini RESULTS.md faylına yazmaq. İlk bir neçə gün bu əla işləyirdi. Bir faylı açırdım və agentin nə etdiyini, həm də bunu niyə etdiyini bir baxışda görürdüm.

Amma fayl böyüməyə davam etdi. Cəmi bir həftədən sonra artıq 407 sətir idi: səkkiz real düzəliş üçün on bir qeyd - və onların dördü eyni düzəliş haqqında idi:

• ## F1 — Bütün kommersiya məzmununun serverdə render edilməsi · Status: qismən
• ## F1 (yenilənmiş) — HƏQİQİ məhsul interfeysinin serverdə render edilməsi · Status: tamamlandı, bir reqressiya aşkarlandı
• ## F1 (son versiya) — Bütün kateqoriya kartları DOM-da mövcuddur · Status: tamamlandı, bir boşluq aşkarlandı
• ## F1 (tamamlandı) — Limitsiz müddətlər əlaqələndirildi, planların 100% əhatəsi · Status: tamamlandı

Əslində nəyin yayımlandığını anlamaq üçün dörd qeydin hamısını oxumalı və sonuncunun doğru olduğuna inanmalı olursan. Fayl "nə baş verdi?" sualına çox yaxşı cavab verirdi, amma bazar ertəsi səhəri ən vacib olan sualı cavabsız qoyurdu: "hazırda haradayıq?"

Agent heç nəyi səhv etmirdi. Mən ona hər şeyi bir fayla əlavə etməsini demişdim, o da bunu edirdi. Yalnız əlavələr qəbul edən faylın edə biləcəyi yeganə şey böyüməkdir.

Fayl uzandıqca daha səssiz bir problem ortaya çıxdı: hər dəyişiklikdən əvvəl bütün faylı yenidən oxumaq bahalı oldu, agent də bunu etməyi dayandırdı. Nəticədə yeni qeydlər bəzən köhnələri ilə ziddiyyət təşkil etməyə başladı.

Yenidən oxumaq üçün həddindən artıq uzun olan jurnal yavaş-yavaş həqiqəti əks etdirməyi dayandırır.

Şəkli böyüt

Hər düzəliş üçün bir qeyd: həqiqətən işləyən şablon

Hər düzəliş üçün bir qeyd: işləyən şablon

Həll yolu yeni alət deyil, şablon oldu.

Aşağıdakıların hamısı layihənin CLAUDE.md faylındakı qısa bir paraqrafdan ibarətdir. O, agentə iki növ qeyd saxlamağı tapşırır:

• Goals/{Goal Name}.md - hər məqsəd üçün bir "ümumi baxış" qeydi: nə hazırlayırıq, qaydalar, status cədvəli, indiyə qədərki nəticələr və açıq qalan suallar.
• {Goal Name}/{Item}.md - hər düzəliş və ya qərar üçün bir kiçik qeyd.

Hər kiçik qeyd eyni dörd hissədən ibarətdir:

1. Dəyişdirildi - hansı fayllar dəyişdirildi.
2. Nə dəyişdi - iki-dörd sadə cümlə.
3. Faydası - bunun nəyi mümkün etdiyini sadə dillə izah edir.
4. Yoxlanıldı - hansı komandaların icra edildiyi və onların nə göstərdiyi.

Şəkli böyüt

Qeydləri dürüst saxlayan hissə məhz “Yoxlanıldı” bölməsidir. Bu hissə agenti planlaşdırdığı yox, həqiqətən icra etdiyi komandaları yazmağa məcbur edir. Qeydlərimdən birində o, bunu özü əlavə etmişdi: “lokal backend bütün planlar üçün price: 1 qaytarır, buna görə qiymətlər yalnız preview mühitində yoxlana bilər - lokalda yalnız struktur təsdiqlənir.” Obsidian-dan əvvəl belə bir detal söhbət pəncərəsində qalır və cümə axşamına qədər artıq itib gedirdi.

Daha bir qayda var: qeydlər yalnız kod üçün deyil, qərarlar üçün də yazılır. Qeydlərimdən biri ümumiyyətlə heç bir kod dəyişikliyi yaratmayan bir qərarı sənədləşdirir - təxminən 20 min generasiya olunmuş səhifənin axtarış sistemləri üçün açıq saxlanılması. Bir neçə ay sonra “niyə belə qərar verdik?” sualı “hansı fayllar dəyişdi?” sualından daha vacib olacaq və bunun cavabını yalnız qeyd verə biləcək.

Hər qeyd keçidlərlə tamamlanır - məqsəd qeydinə, həmçinin əvvəlki və növbəti düzəlişə. Elə həmin bir sətir fayllar qovluğunu izləyə biləcəyiniz bir xəritəyə çevirir.

Claude Code-u Obsidian-a beş dəqiqəyə qoşun

Bir plagin quraşdırın, bir açarı kopyalayın və bir komanda icra edin.

Əgər MCP termini sizin üçün yenidirsə, bu sadəcə Obsidian kimi alətlərin Claude Code ilə əlaqə qurmasının standart üsuludur. Bağlantını bir dəfə qurursunuz və sonra onu bütün layihələrdə istifadə edə bilirsiniz.

1. Obsidian-da Community plugins bölməsini açın və Adam Coddington tərəfindən hazırlanmış Local REST API with MCP plaginini quraşdırın. MCP dəstəyi 24 iyul 2026-cı ildə yayımlanan 5.0.0 versiyasında əlavə edilib; mən Obsidian 1.12.7 ilə birlikdə 5.0.2 versiyasından istifadə edirəm.
   • Local REST API with MCP: https://github.com/coddingtonbear/obsidian-local-rest-api
   • MCP: https://modelcontextprotocol.io
2. Settings → Local REST API bölməsini açın və API açarını kopyalayın.
3. Serveri Claude Code-ə əlavə edin:

claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ \ --header "Authorization: Bearer YOUR_API_KEY" \ --scope user

Sonra hər şeyin düzgün işlədiyini yoxlayın: claude mcp list serveri və onun vəziyyətini göstərməlidir, sessiya daxilində /mcp yazdıqda isə alətlərin siyahısını görəcəksiniz. Siyahıda vault_read, vault_write, vault_patch və search_query kimi adlara malik 16 alət olmalıdır.

Şəkli böyüt

Adətən bu beş dəqiqənin böyük hissəsini bir şey aparır: sertifikat. 27124 portu öz-özünə imzalanmış HTTPS sertifikatından istifadə edir və sərt təhlükəsizlik qaydaları tətbiq edən klientlər onu heç bir xəta mesajı göstərmədən rədd edir:

curl https://127.0.0.1:27124/ # heç nə qaytarmır - sertifikat rədd edilir curl -k https://127.0.0.1:27124/ # {"status":"OK","service":"Obsidian Local REST API", ...}

Bunun iki sadə həlli var: sertifikata etibar edin (plagin onu https://127.0.0.1:27124/obsidian-local-rest-api.crt ünvanında təqdim edir) və ya plagin ayarlarında adi HTTP serverini aktivləşdirərək http://127.0.0.1:27123/mcp/ ünvanından istifadə edin.

Və nasazlığı araşdırmağa başlamazdan əvvəl bir şeyi unutmayın: server birbaşa Obsidian-ın daxilində işləyir. Obsidian bağlanarsa, bağlantı da kəsilir.

Bir dəfə qurun, bütün layihələrdə istifadə edin

Bunu yalnız bir dəfə qurursunuz. Bundan sonra bütün layihələr bu bağlantıdan avtomatik istifadə edə bilir.

Claude Code bağlantını üç fərqli səviyyədə yadda saxlaya bilir və seçilən səviyyə onun harada istifadə olunacağını müəyyən edir:

• local (standart seçim) - yalnız cari layihə üçün; ~/.claude.json faylında saxlanılır.
• project - yalnız cari layihə üçün, lakin Git vasitəsilə komanda ilə paylaşılır; repozitoriyanın daxilində yerləşən .mcp.json faylında saxlanılır.
• user - bütün layihələriniz üçün; ~/.claude.json faylında saxlanılır.

Burada --scope user ən düzgün seçimdir və bunun iki sadə səbəbi var. Obsidian vault-u layihəyə yox, sizə məxsusdur. Üstəlik, API açarı paroldur. Layihə səviyyəsindən istifadə etsəniz, həmin parol repozitoriyada saxlanılacaq və hamı tərəfindən görünə biləcək.

{ "mcpServers": { "obsidian": { "type": "http", "url": "https://127.0.0.1:27124/mcp/", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Bu blok yalnız bir dəfə ~/.claude.json faylına yazılır və həmin kompüterdəki bütün layihələr tərəfindən avtomatik istifadə olunur. Hər yeni layihə üçün görüləcək yeganə iş həmin layihənin CLAUDE.md faylına qısa bir paraqraf əlavə etməkdir: qeydlərin harada saxlanılacağını göstərmək və ikinci bölmədəki şablondan istifadə etmək. Hər məqsəd qeydinə repo: sətri əlavə etsəniz (məndə repo: roamify-web yazılıb), bir Obsidian vault-u bir neçə layihəni qarışdırmadan saxlaya bilər.

Bilməyə dəyər kiçik bir detal da var: eyni server iki fərqli səviyyədə təyin olunubsa, üstünlük sırası belədir - local, sonra project, daha sonra isə user. Yalnız ən yüksək prioritetə malik olan təyin istifadə olunur.

Nə əldə edirsiniz

Eyni səkkiz düzəliş artıq doqquz kiçik qeyddə saxlanılır - birlikdə götürüldükdə onların həcmi köhnə faylın yarısından da azdır və oxumaq qat-qat rahatdır.

Ən böyük dəyişiklik çox sadədir: yeniləmələr artıq köhnə mətnin üstünə əlavə olunmur, onu əvəz edir. F1 düzəlişi done statuslu bir qeyd kimi mövcuddur; əvvəlki üç köhnə versiya artıq yoxdur, çünki agent aşağıya yeni mətn əlavə etmək əvəzinə mövcud qeydi redaktə edir.

Və nəhayət, bazar ertəsi səhəri üçün nəzərdə tutulmuş bir səhifə yarandı. Məqsəd qeydi bütün layihəni bir ekranda göstərir: hər düzəlişin statusu, indiyə qədərki nəticələr və açıq qalan suallar. Köhnə jurnal bunu heç vaxt edə bilməzdi - onun ən üst hissəsi belə artıq üç həftə köhnə olurdu.

Şəkli böyüt

Sadə desək, əldə etdikləriniz bunlardır:

• Cari vəziyyəti hər zaman bilirsiniz - hər düzəliş üçün daim yenilənən bir qeyd var.
• Lazım olan məlumatı tez tapırsınız - hər qeydin adı və keçidi var, uzun faylları vərəqləməyə ehtiyac qalmır.
• Qeydlərə etibar edə bilirsiniz - hər qeyd həqiqətən icra olunan və yoxlanılan addımları göstərir.
• Qurulumu bir dəfə edirsiniz - bundan sonra bütün layihələrdə işləyir.

Başlamazdan əvvəl bilməli olduğunuz dörd kiçik məqam:

• CLAUDE.md faylındakı şablon paraqrafı olmadan agent hər sessiyada yeni qeyd formatı uyduracaq - sistemin əsas sirri məhz həmin şablondur.
• Yeniləmələr üçün agentdən vault_patch istifadə etməsini istəyin; vault_write qeydi tamamilə əvəz edir. Vault-u Git-də saxlamaq sadə və ucuz təhlükəsizlik tədbiridir.
• Ara-sıra Verified bölməsini yoxlayın - model build-i işə salmadan da "build passes" yaza bilər.
• Obsidian-ın qraf görünüşü gözəl vizuallaşdırmadır, amma əsas alət deyil; əsl dəyər qeydlərin içindəki keçidlərdədir.

Əslində bunların heç biri Obsidian haqqında deyil - əlaqələndirilmiş qeydləri dəstəkləyən istənilən alət eyni işi görə bilər. Ən vacib dəyişiklik alətdən də kiçik idi: agentdən jurnal aparmağı istəməyi dayandırdım və məlumatı sistemli şəkildə qeydə almağı istəməyə başladım.