truthmark 2.3.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,220 +1,194 @@
1
1
  # Truthmark
2
2
 
3
- **Ajanlarınız kod yazar. Truthmark, insanlara yönelik ve Git üzerinden incelenebilir belgeleri korur.**
3
+ **Ajanlarınız kod yazar. Truthmark, insanlara yönelik ve Git üzerinden incelenebilir belgeleri güncel tutar.**
4
4
 
5
- [🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
5
+ Truthmark, AI kodlama ajanlarının mevcut kod ve testlerden yeni ürün ve mühendislik belgeleri oluşturmasını, her kod değişikliğinden sonra bunları güncel tutmasını ve incelemeniz için sıradan Markdown farkları sunmasını sağlayan Git'e özgü akışlarını kurar.
6
6
 
7
- ![Truthmark afişi](../assets/truthmark-banner.png)
7
+ [![npm sürümü](https://img.shields.io/npm/v/truthmark?color=cb3837&label=npm)](https://www.npmjs.com/package/truthmark)
8
+ [![CI](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
9
+ [![Lisans: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
10
+ [![Node.js >=24](https://img.shields.io/badge/node-%3E%3D24-339933?logo=node.js&logoColor=white)](../../package.json)
8
11
 
9
- ## 🚀 Hızlı Başlangıç: beş dakikada yerelde çalıştırma
12
+ [Başlayın](#hızlı-başlangıç-ilk-truth-belgenizi-oluşturun) · [Web sitesi](https://merlinhu1.github.io/truthmark/) · [Kullanıcı kılavuzu](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
10
13
 
11
- Bunu Truthmark tarafından yönetilmesini istediğiniz Git deposunun içinde çalıştırın:
14
+ <details>
15
+ <summary>Bu README'yi 16 dilden birinde okuyun</summary>
12
16
 
13
- ```bash
14
- cd /path/to/your-repo
15
- npm install -g truthmark
16
- truthmark init
17
- truthmark check
18
- git diff
19
- ```
17
+ [🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
20
18
 
21
- Etkileşimli bir terminalde `truthmark init`, numaralı bir çoklu seçim gösterir. Sıfır veya daha fazla platform seçin ya da ana makineden bağımsız, yalnızca CLI kurulumu için `none` girin.
19
+ </details>
22
20
 
23
- Betikler ve CI için `--platform` seçeneğini tekrarlayın; `--json` hiçbir zaman istem göstermez:
21
+ ## İlk belgeleri oluşturun. Doğru kalmalarını sağlayın.
24
22
 
25
- ```bash
26
- truthmark init --platform codex --platform cursor
27
- truthmark init --json
28
- ```
23
+ Çoğu dokümantasyon aracı üretimden sonra durur. Truthmark, ajanlara doğrudan deponuzun içinde eksiksiz bir dokümantasyon yaşam döngüsü sunar:
29
24
 
30
- `--platform` olmadan ilk etkileşimsiz çalıştırmada kurulum ana makineden bağımsız kalır; sonraki çalıştırmalar `.truthmark/config.yml` içinde kayıtlı seçimi korur.
25
+ - **Çalışan yazılımdan yeni belgeler oluşturun.** Truth Document kodu ve testleri okur, ardından sınırları belirli ürün veya mühendislik belgeleri oluşturur.
26
+ - **Belgeleri otomatik olarak uyumlu tutun.** Truth Sync, işlevsel kod değişikliklerinden sonra ajan tesliminde çalışır ve iş tamamlanmadan önce depo gerçeğini günceller.
27
+ - **Belgeleri yeniden koda dönüştürün.** Truth Realize, temiz bir doc-first iş akışını korurken onaylanmış truth belgelerini uygular.
28
+ - **Kod tabanı büyürken sahipliği onarın.** Truth Structure, yeni veya aşırı yüklenmiş alanlar için sınırları belirli rotalar ve başlangıç belgeleri oluşturur.
29
+ - **Her şeyi Git'te inceleyin.** Kod, kararlar, sözleşmeler, mimari, operasyonlar ve davranış aynı dalla birlikte ilerler.
31
30
 
32
- Şimdi en yaygın benimseme yolunu deneyin: kod ve testlerden mevcut bir davranışı belgeleyin. AI kodlama ana makinenizde, kurulu iş akışına şunu isteyin:
31
+ Barındırılan bilgi tabanı yok. Özel ajan belleği yok. Sohbet geçmişine hapsolmuş dokümantasyon yok.
33
32
 
34
- ```text
35
- /truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
36
- ```
33
+ ## Hızlı başlangıç: ilk truth belgenizi oluşturun
37
34
 
38
- Bundan sonra kullanıcılar normalde Truth Sync'i doğrudan çağırmamalıdır. AI ana makineniz üzerinden kod yazmaya devam edin; kurulu depo yönergeleri, işlevsel kod değiştiğinde teslimden önce ajana ilgili testleri çalıştırmasını ve Truth Sync incelemesini yapmasını söyler. Siz ortaya çıkan kod farkını ve truth-belge farkını incelersiniz.
35
+ **Gereksinimler:** Node.js 24 veya daha yenisi, bir Git deposu ve ajan akışları için desteklenen bir AI kodlama ana bilgisayarı.
39
36
 
40
- Yalnızca CLI doğrulaması istiyorsanız `none` seçip `truthmark check` çalıştırın; platform seçmek için daha sonra `truthmark init` komutunu yeniden çalıştırabilirsiniz.
37
+ Aşağıdaki komutları Truthmark'ın yönetmesini istediğiniz deponun içinde çalıştırın:
41
38
 
42
- ## 💡 Sorun: AI dokümantasyon boşluğu
39
+ ```bash
40
+ cd /path/to/your-repo
41
+ npm install -g truthmark
42
+ truthmark init
43
+ ```
43
44
 
44
- AI kodlama ajanları hızlı kod yazma konusunda olağanüstüdür. Ancak bu hız tehlikeli yeni bir hata biçimi yaratır: **deponun anlattığı hikâye gerçeklikten uzaklaşır.**
45
+ `truthmark init`; Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor veya ana bilgisayardan bağımsız bir komut satırı arayüzü kurulumu seçmenizi sağlar.
45
46
 
46
- * Davranış, geçici sohbet geçmişlerinde kaybolur.
47
- * Mimari belgeleri hızla geride kalır.
48
- * Ürün kararları teslimden sonra kaybolur.
49
- * Kod inceleyenler, "neden"i anlamadan ham kod farklarını incelemek zorunda kalır.
50
- * Her yeni AI oturumu, deponuzun gerçeğini sıfırdan yeniden keşfetmeye zorlanır.
47
+ Şimdi yapılandırılmış ajanınızdan gerçek bir davranışı belgelemesini isteyin:
51
48
 
52
- ## 🎯 Çözüm: Truthmark
49
+ ```text
50
+ /truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
51
+ ```
53
52
 
54
- **Truthmark**, deponuza Git'e özgü bir akışı katmanı kurar. AI geliştirmesinde genellikle bozulan kısmı düzeltir: belgelerin kodla uyumlu kalmasına yardımcı olmak.
53
+ Truth Document, henüz yoksa sınırları belirli yeni bir truth belgesi oluşturur; varsa mevcut sahibini günceller ve gerektiğinde yönlendirmeyi yeniler. İşlevsel kodu değiştirmez.
55
54
 
56
- İnsanların ve AI ajanlarının belgeleri güncellemeyi hatırlamasını ummak yerine, Truthmark dokümantasyonu doğrudan deponuzun içinde sistematik ve incelenebilir bir alışkanlığa dönüştürür.
55
+ Sonucu inceleyin:
57
56
 
58
- ### ✨ Truthmark neden benzersizdir
57
+ ```bash
58
+ truthmark check
59
+ git status --short --untracked-files=all
60
+ git diff
61
+ ```
59
62
 
60
- Truthmark sıradan bir dokümantasyon aracı değildir. AI iş akışına derinlemesine entegredir:
63
+ Artık şunlara sahip olmalısınız:
61
64
 
62
- * **🚫 Tedarikçi kilidi yok:** Barındırılan hizmet yok, gizli veritabanı yok, işletilecek ek sunucu yok.
63
- * **🌳 %100 Git'e özgü:** Her şey deponuzda yaşar. Gerçek, dalınızla birlikte hareket eder.
64
- * **🤝 İnsanların sahip olduğu, ajanların izlediği sözleşme:** Bakımcılar depo sözleşmesine sahiptir; ajanlar kod yazarken kurulu talimatları izler.
65
- * **✅ Doğrulama yoluyla güven:** Davranışı değiştiren işlerde insan tarafından incelenebilir bir gerçeklik belgesi kararı veya farkı bulunduğu için AI çalışmasına güvenmek kolaylaşır.
65
+ ```text
66
+ docs/truthmark/engineering/behaviors/session-timeout.md
67
+ docs/truthmark/routes/areas/authentication.md
68
+ ```
66
69
 
67
- ## 🔄 Nasıl çalışır
70
+ Kesin yollar, deponuzun sahiplik yapısını izler. Yeni dosyalar `git status` içinde, izlenen dosyalardaki değişiklikler ise `git diff` içinde görünür.
68
71
 
69
- Bir AI ajanı kodunuzu değiştirdiğinde bitmiş sayılmaz. Truthmark, ajanların teslimden önce izlediği bir bitiş zamanı akışı koruması kurar:
72
+ Çağırma biçimi ana bilgisayara göre değişir. OpenCode `/skill truthmark-document`, Antigravity `@truthmark-document` kullanır; desteklenen diğer ana bilgisayarlar ise kendi yerel beceri veya eğik çizgi komutu yüzeylerini kullanır. Kesin komutlar için [platform tablosuna](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) bakın.
70
73
 
71
- 1. 💻 **Kod:** Ajan işlevsel kodu değiştirir.
72
- 2. 🧪 **Test:** İlgili testler çalıştırılır.
73
- 3. 🔍 **Kontrol:** Truthmark, kurulu bitiş incelemesinin parçası olarak eşlenen dokümantasyonu kontrol eder.
74
- 4. 📝 **Belgeleme:** Depo gerçeği değiştiğinde belgeler ajan tarafından güncellenir.
75
- 5. 👀 **İnceleme:** Bir insan *kod farkını* + *gerçeklik farkını* inceler.
74
+ Betikler ve sürekli entegrasyon için seçilen platformları açıkça iletin:
76
75
 
77
- ## 🛠 Truthmark ile nasıl etkileşirsiniz
76
+ ```bash
77
+ truthmark init --platform codex --platform cursor
78
+ truthmark init --json
79
+ ```
78
80
 
79
- Truthmark’ın depo yerelinde tek bir sözleşmesi ve onu kullanmanın iki yolu vardır.
81
+ Ana bilgisayardan bağımsız bir depo için etkileşimli olarak `none` seçin veya `truthmark init --clear-platforms` çalıştırın. Daha sonra `truthmark init` komutunu yeniden çalıştırarak ajan platformları ekleyebilirsiniz.
80
82
 
81
- ### İnsanlar sözleşmeyi kurar ve doğrular
83
+ Dala göre güncellik tanılaması için bir Git tabanı iletin:
82
84
 
83
- Bakımcılar ve CI, CLI kullanır:
85
+ ```bash
86
+ truthmark check --base <base-ref>
87
+ ```
84
88
 
85
- * `truthmark init` - yapılandırmayı oluşturur veya yeniler, sıfır ya da daha fazla platform seçtirir ve yönlendirmeyi, truth-doc iskelelerini ve seçilen AI ana makine talimatlarını kurar.
86
- * `truthmark check` - depo gerçeğini terminalden doğrular.
89
+ ## Truthmark nasıl çalışır
87
90
 
88
- ### Ajanlar kod yazarken sözleşmeyi izler
91
+ <picture>
92
+ <source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
93
+ <img src="../assets/truthmark-workflow.svg" alt="Truthmark nasıl çalışır" width="1440">
94
+ </picture>
89
95
 
90
- Truthmark, Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor gibi desteklenen AI kodlama ana makineleri için depo yerelinde talimatlar kurar.
96
+ Truthmark komut satırı arayüzü depo sözleşmesini kurar ve doğrular. Kodlama ajanınız, kurulu ve ana bilgisayara özgü akışları üzerinden kanıt incelemesini ve dokümantasyon çalışmasını gerçekleştirir.
91
97
 
92
- Normal döngü basittir:
98
+ Normal bir kod değişikliği tek ve basit bir döngü izler:
93
99
 
94
- 1. Ajanınızdan kod değişikliği isteyin veya mevcut bir davranışı belgelemesini isteyin.
95
- 2. Kurulu talimatlar ajana ne zaman test edeceğini, ne zaman truth dokümanlarını güncelleyeceğini ve ne zaman insan incelemesi için duracağını söyler.
96
- 3. Siz sıradan Git diff’lerini incelersiniz: kod ve varsa truth-doc değişiklikleri.
100
+ 1. Ajan işlevsel kodu değiştirir.
101
+ 2. İlgili testler çalıştırılır.
102
+ 3. Truth Sync, eşlenen belgeleri kontrol eder.
103
+ 4. Depo gerçeği değiştiğinde ajan belgeleri ve yönlendirmeyi oluşturur veya günceller.
104
+ 5. Kod farkını ve truth farkını birlikte incelersiniz.
97
105
 
98
- Kullanıcı tarafından başlatılan ajan istekleri bilinçli olarak azdır:
106
+ ## İş akışları
99
107
 
100
- * `/truthmark-document` - kod ve testlerden mevcut uygulanmış davranışı belgeler.
101
- * `/truthmark-realize` - mevcut truth dokümanlarından kod uygular.
102
- * `/truthmark-check` - depo gerçeğini denetler.
108
+ | İş akışı | Ne zaman kullanılır | Sonuç |
109
+ | -------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
110
+ | **Truth Document** | Mevcut kodun belgelenmesi gerekir | Kanıta dayalı ürün ve mühendislik belgeleri oluşturur veya günceller |
111
+ | **Truth Sync** | İşlevsel kod değişmiştir | Teslimden önce eşlenen belgeleri ve yönlendirmeyi uyumlu tutar |
112
+ | **Truth Structure** | Yeni bir alanın sahipliğe ihtiyacı vardır veya mevcut belgeler fazla geniştir | Sınırları belirli rotalar ve iskelet başlangıç belgeleri oluşturur |
113
+ | **Truth Realize** | Onaylanmış bir truth belgesi çalışan yazılıma dönüşmelidir | İşlevsel kodu dokümantasyondan günceller |
114
+ | **Truth Check** | Depo gerçeğinin denetlenmesi gerekir | Yönlendirme, sahiplik, kanıt ve dokümantasyon sorunlarını bildirir |
115
+ | **Truthmark Portal** | Ekip, göz atılabilir bir dokümantasyon sitesi ister | Markdown truth belgelerinden commit edilmiş statik bir HTML sunumu üretir |
103
116
 
104
- Truth Sync işe başlamanın olağan yolu değildir; işlevsel kod değişikliklerinden sonraki bitiş incelemesidir.
105
- Truth Structure günlük bir komut değildir; yalnızca çalışmayı engellediğinde yönlendirmeyi veya sahipliği onarır.
117
+ Truthmark bu akışlarını Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor için yerel depo yüzeyleri olarak kurar.
106
118
 
107
119
  ## Neler elde edersiniz
108
120
 
109
- | Yetenek | Ne yapar |
110
- | --- | --- |
111
- | Git'e özgü gerçeklik | Depo gerçeğini commit edilmiş Markdown ve yapılandırmada tutar. |
112
- | Dal kapsamlı dokümantasyon | Gerçek, özel bir oturumda yaşamak yerine dalla birlikte hareket eder. |
113
- | İnsan CLI'si | Bakımcılara kurulum, yenileme, doğrulama ve inceleme komutları sağlar. |
114
- | Kurulu ajan rehberliği | Kodlama ajanlarına ne zaman belge yazacağını, test edeceğini, gerçeği senkronize edeceğini, denetleyeceğini veya inceleme için duracağını söyler. |
115
- | Açık yönlendirme | Kod alanlarını kanonik gerçeklik belgelerine eşler. |
116
- | İncelenebilir teslimler | Hem kod hem de gerçeklik belgeleri için sıradan Git farkları üretir. |
117
- | Yerel-öncelikli çalışma | Barındırılan hizmet, daemon, veritabanı veya MCP sunucusu gerektirmez. |
118
- | Daha güvenli yazma sınırları | Kod-öncelikli, belge-öncelikli, salt-okunur ve yalnızca-belge iş akışlarını ayırır. |
119
- | Doğrulama | Yönlendirme, yetki, frontmatter, bağlantı, üretilmiş yüzey, dal kapsamı, güncellik ve kapsam sorunlarını raporlar. |
120
- | İsteğe bağlı Portal | Açıkça etkinleştirilip istendiğinde Markdown gerçeklik belgelerinden commit edilmiş statik bir HTML sunum sitesi üretir. |
121
-
122
- ## Görsel genel bakış
123
-
124
- ![Truthmark özellikleri](../assets/truthmark-features.png)
125
-
126
- **Özellikler:** Truthmark'ın ne kurduğu ve iş akışı yüzeyinin nasıl bölündüğü.
121
+ ### Gerçeklikten başlayan dokümantasyon
127
122
 
128
- ![Truthmark konumu](../assets/truthmark-position.png)
123
+ Truthmark; ürün yetenekleri, uygulama davranışı, uygulama programlama arayüzleri, mimari, iş akışları, operasyonlar ve testler için belgeler oluşturabilir. Kod ve testler kanıtı sağlar; sınırları belirli Markdown belgeleri sonucu kalıcılaştırır.
129
124
 
130
- **Konum:** Truthmark'ın istemlere, belleğe ve spesifikasyon iş akışlarına göre nerede yer aldığı.
125
+ ### Bir sonraki değişiklikten sağ çıkan dokümantasyon
131
126
 
132
- ![Truthmark senkronizasyon akışı](../assets/truthmark-syncflow.png)
127
+ Rotalar, kod alanlarını kanonik belgelere bağlar. Ajanlar davranışı değiştirdiğinde Truth Sync, ilgili gerçeğin nereye ait olduğunu bilir ve teslimi incelenebilir tutar.
133
128
 
134
- **Senkronizasyon akışı:** Truth Sync'in normal kod değişikliklerini teslimden önce nasıl kapattığı.
129
+ ### Ayrı kulvarlarda ürün ve mühendislik gerçeği
135
130
 
136
- ## Ekipler neden benimser
131
+ Ürün gerçeği; kullanıcıya dönük vaatleri, sınırları, kararları ve kabul kriterlerini kapsar. Mühendislik gerçeği; mevcut davranışı, sözleşmeleri, mimariyi, iş akışlarını, operasyonları ve test davranışını kapsar.
137
132
 
138
- Truthmark, AI ajanlarının kod üretebildiğini zaten bilen ekipler içindir.
133
+ ### Git'e özgü birliği
139
134
 
140
- Sıradaki sorun yönetişimdir.
135
+ Önemli olan her şey commit edilmiş depo dosyalarında yaşar. Gerçek dalla birlikte ilerler, sıradan pull request'lerle çalışır ve her bakımcı ile kodlama ajanına görünür kalır.
141
136
 
142
- Tören anlamında yönetişim değil. Basit bir soru olarak yönetişim:
137
+ ### Yerel öncelikli çalışma
143
138
 
144
- > Bu AI destekli değişiklikten sonra depo hâlâ gerçeği söylüyor mu?
145
-
146
- Truthmark, commit edilmiş dosyalar, açık yönlendirme ve incelenebilir farklarla ekiplerin buna yanıt vermesine yardımcı olur.
147
-
148
- Şunlara ihtiyaç duyduğunuzda yararlıdır:
149
-
150
- - daha az dokümantasyon kayması
151
- - daha iyi teslimler
152
- - dala özgü ürün gerçeği
153
- - kalıcı mimari ve API dokümantasyonu
154
- - belgeler ile kod arasında açık sahiplik
155
- - daha güvenli ajan yazma sınırları
156
- - gizli bellek yerine incelenebilir dokümantasyon
157
- - commit edilmiş depo dosyalarından çalışmaya devam eden AI iş akışları
139
+ Truthmark barındırılan hizmet, daemon, veritabanı, vektör deposu veya Model Context Protocol sunucusu gerektirmez. Depo kendi dokümantasyon iş akışını taşır.
158
140
 
159
141
  ## Truthmark nerede yer alır
160
142
 
161
- Truthmark istemlerin, belleğin, spesifikasyonların, testlerin veya kod incelemesinin yerini almaz.
162
-
163
- Bu akışlarına Git içinde kalıcı bir iniş alanı sağlar.
164
-
165
- | İhtiyaç | Daha uygun seçenek |
166
- | --- | --- |
167
- | Tek bir ajan oturumundan daha iyi çıktı | Daha iyi istem |
168
- | Kişisel veya oturum düzeyinde süreklilik | Bellek aracı |
169
- | Plan-öncelikli özellik çalışması | Spesifikasyon iş akışı |
170
- | Kodla birlikte taşınan dal kapsamlı gerçek | Truthmark |
171
- | Davranış doğruluğunu doğrulama | Testler ve inceleme |
172
- | AI destekli dokümantasyon değişikliklerini inceleme | Truthmark artı Git incelemesi |
173
-
174
- Truthmark'ın alanı tasarım gereği dardır:
143
+ | İhtiyaç | En iyi seçenek |
144
+ | ---------------------------------------------------- | ------------------------------ |
145
+ | Tek bir ajan oturumundan daha iyi çıktı | Daha iyi prompt |
146
+ | Kişisel veya oturum düzeyinde süreklilik | Bellek aracı |
147
+ | Plan öncelikli özellik çalışması | Spesifikasyon akışı |
148
+ | Kodla birlikte ilerleyen, dal kapsamlı dokümantasyon | **Truthmark** |
149
+ | Davranış doğruluğu | Testler ve kod incelemesi |
150
+ | İncelenebilir, AI destekli dokümantasyon | **Truthmark + Git incelemesi** |
175
151
 
176
- ```text
177
- make repository truth explicit
178
- route it to code
179
- etrafına ajan rehberliği kurmak
180
- keep the result reviewable in Git
181
- ```
182
-
183
- ## Daha derine inin
152
+ Truthmark, AI kodlama ajanlarını zaten kullanan ve depo gerçeğinin kod kadar hızlı güncellenmesini isteyen bakımcılar ile mühendislik ekipleri için tasarlanmıştır.
184
153
 
185
- README vitrin görevi görür: hızlı bağlam, hızlı başlangıç ve temel zihinsel model.
154
+ ## Desteklenen ana bilgisayarlar ve komut satırı
186
155
 
187
- Komut komut kullanım, yüzey karşılaştırmaları, desteklenen platform ayrıntıları, yapılandırma, yönlendirme, Portal ve örnekler için [Truthmark Kullanıcı Kılavuzu](../user-guide.md) sayfasını okuyun.
156
+ Desteklenen ajan ana bilgisayarları:
188
157
 
189
- ## Proje durumu
158
+ - Codex
159
+ - Claude Code
160
+ - GitHub Copilot
161
+ - OpenCode
162
+ - Antigravity
163
+ - Cursor
190
164
 
191
- Mevcut sürüm şunları sağlar:
165
+ <details>
166
+ <summary>Komut satırı başvurusu</summary>
192
167
 
193
- - init, check, index, impact ve iş akışı durumu için yerel CLI komutları
194
- - Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor için oluşturulan depo yerelinde ajan talimatları
195
- - yönlendirme, yetki, frontmatter, bağlantı, güncellik, üretilmiş yüzey, dal kapsamı ve kapsam tanıları
196
- - dal kapsamlı gerçeklik belgeleri ve türetilmiş depo zekâsı artefaktları
168
+ | Komut | Amaç |
169
+ | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
170
+ | `truthmark init` | Yapılandırmayı, yönlendirmeyi, şablonları ve seçilen ana bilgisayar akışlarını oluşturur veya yeniler |
171
+ | `truthmark check [--base <ref>]` | Depo gerçeğini doğrular ve isteğe bağlı olarak dal güncelliği tanılamasını çalıştırır |
172
+ | `truthmark index --json` | Türetilmiş depo ve yönlendirme meta verilerini inceler |
173
+ | `truthmark impact --base <ref> --json` | Değişen dosyaları belgelere, sahiplerine ve yakındaki testlere eşler |
174
+ | `truthmark workflow status --workflow <id> [--base <ref>] --json` | İş akışının uygulanabilirliğini ve hedeflerini inceler |
175
+ | `truthmark validate ...` | İş akışı raporlarını ve yazma kiralarını doğrular |
176
+ | `truthmark uninstall --dry-run\|--apply` | Yazılmış truth belgelerini koruyarak oluşturulan ana bilgisayar yüzeylerini önizler veya kaldırır |
197
177
 
198
- ## Dokümantasyon
178
+ Betikler ve sürekli entegrasyon için komut satırı arayüzünün tamamında yapılandırılmış JSON çıktısı bulunur.
199
179
 
200
- - [Kullanıcı kılavuzu](../user-guide.md)
201
- - [Dokümanlar dizini](../README.md)
202
- - [Mimari genel bakışı](../truthmark/engineering/architecture/overview.md)
203
- - [API ve CLI sözleşmeleri](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
204
- - [Depo gerçeği bakım kılavuzu](../standards/maintaining-repository-truth.md)
180
+ </details>
205
181
 
206
- Yerel geliştirme ve katkı komutları için [CONTRIBUTING.md](../../CONTRIBUTING.md) dosyasına bakın.
182
+ ## Daha fazlasını öğrenin
207
183
 
208
- ## Tasarım sınırları
184
+ - [Truthmark kullanıcı kılavuzu](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
185
+ - [Dokümantasyon dizini](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
186
+ - [Mimariye genel bakış](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
187
+ - [Yapılandırma, yönlendirme ve komut sözleşmeleri](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
188
+ - [Katkıda bulunma](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
209
189
 
210
- Truthmark bilinçli olarak küçüktür: yerel, commit edilmiş, dal kapsamlı ve incelenebilir.
211
-
212
- Barındırılan bir hizmet, MCP sunucusu, vektör veritabanı, gizli bellek katmanı, CI yaptırım ürünü veya otonom kod yeniden yazma motoru değildir. Depo gerçeğinin görünür kalmasına yardımcı olur; testlerin, kod incelemesinin veya insan yargısının yerini almaz.
190
+ **Truthmark kurun, kodlama ana bilgisayarınızı seçin ve gerçek bir davranışı bugün belgeye dönüştürün.**
213
191
 
214
192
  ## Lisans
215
193
 
216
194
  MIT. Bkz. [LICENSE](../../LICENSE).
217
-
218
- ## Güvenli kaldırma
219
-
220
- `truthmark uninstall --dry-run` komutunu kullanarak tam olarak oluşturulan ana bilgisayar yüzeylerini inceleyin, ardından kaldırmak için `truthmark uninstall --apply` komutunu çalıştırın. Oluşturulan truth, yapılandırma, şablonlar, Portal çıktısı, Gemini dosyaları ve alakasız kullanıcı dosyaları korunur; global npm kurulumunu paket yöneticinizle ayrı olarak kaldırın.