truthmark 2.2.3 → 2.2.6

package/docs/readmes/README.ru.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**Ваши агенты пишут код. Truthmark поддерживает понятную людям документацию, которую можно проверять в Git.**
+
+[🇺🇸 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)
+
+![Баннер Truthmark](../assets/truthmark-banner.png)
+
+## 🚀 Быстрый старт: локальный запуск за пять минут
+
+Выполните это внутри Git-репозитория, которым должен управлять Truthmark:
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+Включите AI-хост, которым вы действительно пользуетесь. Новые конфигурации нейтральны к хостам, поэтому перед инициализацией добавьте список верхнего уровня `platforms` в `.truthmark/config.yml`:
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+Затем установите локальные для репозитория truth-документы, маршрутизацию и поверхности рабочих процессов агентов:
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+Теперь попробуйте самый распространенный путь внедрения: задокументируйте одно существующее поведение по коду и тестам. В вашем AI-хосте для разработки попросите установленный рабочий процесс:
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+После этого пользователям обычно не следует напрямую вызывать Truth Sync. Продолжайте писать код через ваш AI-хост; установленные инструкции репозитория скажут агенту запускать релевантные тесты и выполнять проверку Truth Sync перед передачей, когда меняется функциональный код. Вы просматриваете получившийся diff кода вместе с diff truth-документов.
+
+Если вам нужна только CLI-валидация, а хост-специфичные AI workflow пока не нужны, оставьте `platforms` неуказанным и выполните `truthmark init && truthmark check`; позже можно добавить платформу и заново выполнить `truthmark init`.
+
+## 💡 Проблема: разрыв в AI-документации
+
+AI-агенты разработки невероятно быстро пишут код. Но эта скорость создает новый опасный режим отказа: **история репозитория начинает расходиться с реальностью.**
+
+* Поведение теряется в эфемерных историях чатов.
+* Архитектурная документация быстро устаревает.
+* Продуктовые решения исчезают после передачи работы.
+* Ревьюерам кода приходится изучать сырые diff кода без понимания «почему».
+* Каждая новая AI-сессия вынуждена заново обнаруживать truth репозитория.
+
+## 🎯 Решение: Truthmark
+
+**Truthmark** устанавливает в ваш репозиторий Git-native слой рабочего процесса. Он исправляет ту часть AI-разработки, которая обычно ломается: помогает документации оставаться согласованной с кодом.
+
+Вместо надежды на то, что люди и AI-агенты вспомнят об обновлении документации, Truthmark делает документирование системной и проверяемой привычкой прямо внутри репозитория.
+
+### ✨ Почему Truthmark уникален
+
+Truthmark — не просто очередной инструмент документации. Он глубоко интегрирован в AI workflow:
+
+* **🚫 Никакой привязки к поставщику:** нет hosted-сервисов, скрытых баз данных и дополнительных серверов для эксплуатации.
+* **🌳 100% Git-native:** всё находится в вашем репозитории. Truth движется вместе с веткой.
+* **🤝 Контракт, принадлежащий людям и выполняемый агентами:** Мейнтейнеры владеют контрактом репозитория; агенты следуют установленным инструкциям во время кодинга.
+* **✅ Доверие через проверку:** AI-работе проще доверять, потому что работа, меняющая поведение, включает human-reviewable решение или diff в truth-doc.
+
+## 🔄 Как это работает
+
+Когда AI-агент меняет ваш код, работа еще не завершена. Truthmark устанавливает guard рабочего процесса на момент завершения, которому агенты следуют перед передачей:
+
+1. 💻 **Код:** агент изменяет функциональный код.
+2. 🧪 **Тест:** выполняются релевантные тесты.
+3. 🔍 **Проверка:** Truthmark проверяет сопоставленную документацию как часть установленного завершающего ревью.
+4. 📝 **Документирование:** агент обновляет docs, когда truth репозитория изменился.
+5. 👀 **Ревью:** человек проверяет *diff кода* + *diff truth*.
+
+## 🛠 Как вы взаимодействуете с Truthmark
+
+У Truthmark есть один локальный контракт репозитория и два способа его использовать.
+
+### Люди устанавливают и проверяют контракт
+
+Мейнтейнеры и CI используют CLI:
+
+* `truthmark config` - создает начальную конфигурацию.
+* `truthmark init` - устанавливает или обновляет маршруты, scaffold для truth-doc и инструкции для AI-хостов.
+* `truthmark check` - проверяет truth репозитория из терминала.
+
+### Агенты следуют контракту во время кодинга
+
+Truthmark устанавливает локальные инструкции репозитория для поддерживаемых AI coding hosts, таких как Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity и Cursor.
+
+Обычный цикл прост:
+
+1. Попросите агента изменить код или задокументировать существующее поведение.
+2. Установленные инструкции говорят агенту, когда тестировать, когда обновлять truth docs и когда остановиться для человеческого ревью.
+3. Вы ревьюите обычные Git diff: код плюс любые изменения truth-doc.
+
+Пользовательских запросов к агенту намеренно мало:
+
+* `/truthmark-document` - документирует существующее реализованное поведение по коду и тестам.
+* `/truthmark-realize` - реализует код из существующих truth docs.
+* `/truthmark-check` - аудитирует truth репозитория.
+
+Truth Sync — не обычный способ начать работу; это завершающее ревью после функциональных изменений кода.
+Truth Structure — не повседневная команда; она исправляет routing или ownership только тогда, когда это блокирует работу.
+
+## Что вы получаете
+
+| Возможность | Что она делает |
+| --- | --- |
+| Git-native truth | Хранит truth репозитория в закоммиченных Markdown и конфигурации. |
+| Документация в пределах ветки | Truth движется с веткой, а не живет в приватной сессии. |
+| CLI для людей | Дает мейнтейнерам команды настройки, обновления, валидации и инспекции. |
+| Установленные инструкции агента | Говорит coding-агентам, когда документировать, тестировать, синхронизировать truth, аудитировать или останавливаться для ревью. |
+| Явная маршрутизация | Сопоставляет области кода с каноническими truth-docs. |
+| Проверяемая передача | Создает обычные Git diff как для кода, так и для truth-docs. |
+| Local-first работа | Не требует hosted-сервиса, daemon, базы данных или MCP-сервера. |
+| Более безопасные границы записи | Разделяет code-first, doc-first, read-only и doc-only workflows. |
+| Валидация | Сообщает о проблемах routing, authority, frontmatter, links, generated-surface, branch-scope, freshness и coverage. |
+| Опциональный Portal | Генерирует закоммиченный статический HTML-сайт презентации из Markdown truth-docs, когда он явно включен и запрошен. |
+
+## Визуальный обзор
+
+![Возможности Truthmark](../assets/truthmark-features.png)
+
+**Возможности:** что устанавливает Truthmark и как агенты используют локальные инструкции репозитория.
+
+![Позиционирование Truthmark](../assets/truthmark-position.png)
+
+**Позиция:** где Truthmark находится относительно prompts, memory и spec workflows.
+
+![Поток синхронизации Truthmark](../assets/truthmark-syncflow.png)
+
+**Поток синхронизации:** как Truth Sync завершает обычные изменения кода перед передачей.
+
+## Почему команды выбирают его
+
+Truthmark создан для команд, которые уже знают, что AI-агенты могут генерировать код.
+
+Следующая проблема — governance.
+
+Не governance как церемония. Governance как простой вопрос:
+
+> После этого AI-assisted изменения репозиторий все еще говорит truth?
+
+Truthmark помогает командам отвечать на это с помощью закоммиченных файлов, явной маршрутизации и проверяемых diff.
+
+Он полезен, когда вам нужны:
+
+- меньший дрейф документации
+- лучшая передача работы
+- branch-specific продуктовая truth
+- долговечная архитектурная и API-документация
+- явное владение между docs и кодом
+- более безопасные границы записи для агентов
+- проверяемая документация вместо скрытой memory
+- инструкции для агентов, которые продолжают работать из закоммиченных файлов репозитория
+
+## Где уместен Truthmark
+
+Truthmark не заменяет prompts, memory, specs, tests или code review.
+
+Он дает этим workflows долговечное место для фиксации в Git.
+
+| Потребность | Лучше подходит |
+| --- | --- |
+| Лучший результат из одной сессии агента | Лучший prompt |
+| Персональная или сессионная непрерывность | Memory tool |
+| Plan-first работа над функцией | Spec workflow |
+| Branch-scoped truth, которая перемещается вместе с кодом | Truthmark |
+| Проверка корректности поведения | Tests and review |
+| Ревью изменений документации, выполненных с AI | Truthmark плюс Git review |
+
+Область Truthmark намеренно узкая:
+
+```text
+make repository truth explicit
+route it to code
+установить вокруг нее инструкции для агентов
+keep the result reviewable in Git
+```
+
+## Подробнее
+
+README — это витрина: быстрый контекст, быстрый старт и основная ментальная модель.
+
+Для пошагового использования команд, сравнения поверхностей, деталей поддерживаемых платформ, конфигурации, маршрутизации, Portal и примеров читайте [руководство пользователя Truthmark](../user-guide.md).
+
+## Статус проекта
+
+Текущий релиз предоставляет:
+
+- локальные CLI-команды для config, init, check, index, impact и workflow status
+- сгенерированные локальные инструкции агента для Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity и Cursor
+- диагностику route, authority, frontmatter, links, freshness, generated-surface, branch-scope и coverage
+- branch-scoped truth docs и производные артефакты repository intelligence
+
+## Документация
+
+- [Руководство пользователя](../user-guide.md)
+- [Индекс документации](../README.md)
+- [Обзор архитектуры](../truthmark/engineering/architecture/overview.md)
+- [Контракты API и CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Руководство по поддержанию repository truth](../standards/maintaining-repository-truth.md)
+
+Команды для локальной разработки и участия см. в [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Границы дизайна
+
+Truthmark намеренно мал: локальный, закоммиченный, scoped по ветке и проверяемый.
+
+Это не hosted-сервис, MCP-сервер, векторная база данных, скрытый слой memory, продукт для принудительного CI-контроля или автономный движок переписывания кода. Он помогает truth репозитория оставаться видимой; он не заменяет tests, code review или человеческое суждение.
+
+## Лицензия
+
+MIT. См. [LICENSE](../../LICENSE).

package/docs/readmes/README.tr.md

@@ -0,0 +1,225 @@
+# Truthmark
+
+**Ajanlarınız kod yazar. Truthmark, insanlara yönelik ve Git üzerinden incelenebilir belgeleri korur.**
+
+[🇺🇸 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)
+
+![Truthmark afişi](../assets/truthmark-banner.png)
+
+## 🚀 Hızlı Başlangıç: beş dakikada yerelde çalıştırma
+
+Bunu Truthmark tarafından yönetilmesini istediğiniz Git deposunun içinde çalıştırın:
+
+```bash
+cd /path/to/your-repo
+npm install -g truthmark
+truthmark config
+```
+
+Gerçekten kullandığınız AI ana makinesini etkinleştirin. Yeni yapılandırmalar ana makineden bağımsızdır; bu yüzden başlatmadan önce `.truthmark/config.yml` dosyasına üst düzey bir `platforms` listesi ekleyin:
+
+```yaml
+version: 2
+platforms:
+  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
+truthmark:
+  workspace: docs/truthmark
+  generated:
+    portal:
+      enabled: false
+```
+
+Ardından depoya yerel gerçeklik belgelerini, yönlendirmeyi ve ajan iş akışı yüzeylerini kurun:
+
+```bash
+truthmark init
+truthmark check
+git diff
+```
+
+Şimdi en yaygın benimseme yolunu deneyin: kod ve testlerden mevcut bir davranışı belgeleyin. AI kodlama ana makinenizde, kurulu iş akışına şunu isteyin:
+
+```text
+/truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
+```
+
+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.
+
+Yalnızca CLI doğrulaması istiyor ve henüz ana makineye özgü AI iş akışları istemiyorsanız, `platforms` alanını dışarıda bırakıp `truthmark init && truthmark check` çalıştırın; daha sonra bir platform ekleyip `truthmark init` komutunu yeniden çalıştırabilirsiniz.
+
+## 💡 Sorun: AI dokümantasyon boşluğu
+
+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.**
+
+* Davranış, geçici sohbet geçmişlerinde kaybolur.
+* Mimari belgeleri hızla geride kalır.
+* Ürün kararları teslimden sonra kaybolur.
+* Kod inceleyenler, "neden"i anlamadan ham kod farklarını incelemek zorunda kalır.
+* Her yeni AI oturumu, deponuzun gerçeğini sıfırdan yeniden keşfetmeye zorlanır.
+
+## 🎯 Çözüm: Truthmark
+
+**Truthmark**, deponuza Git'e özgü bir iş akışı katmanı kurar. AI geliştirmesinde genellikle bozulan kısmı düzeltir: belgelerin kodla uyumlu kalmasına yardımcı olmak.
+
+İ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.
+
+### ✨ Truthmark neden benzersizdir
+
+Truthmark sıradan bir dokümantasyon aracı değildir. AI iş akışına derinlemesine entegredir:
+
+* **🚫 Tedarikçi kilidi yok:** Barındırılan hizmet yok, gizli veritabanı yok, işletilecek ek sunucu yok.
+* **🌳 %100 Git'e özgü:** Her şey deponuzda yaşar. Gerçek, dalınızla birlikte hareket eder.
+* **🤝 İ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.
+* **✅ 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.
+
+## 🔄 Nasıl çalışır
+
+Bir AI ajanı kodunuzu değiştirdiğinde iş bitmiş sayılmaz. Truthmark, ajanların teslimden önce izlediği bir bitiş zamanı iş akışı koruması kurar:
+
+1. 💻 **Kod:** Ajan işlevsel kodu değiştirir.
+2. 🧪 **Test:** İlgili testler çalıştırılır.
+3. 🔍 **Kontrol:** Truthmark, kurulu bitiş incelemesinin parçası olarak eşlenen dokümantasyonu kontrol eder.
+4. 📝 **Belgeleme:** Depo gerçeği değiştiğinde belgeler ajan tarafından güncellenir.
+5. 👀 **İnceleme:** Bir insan *kod farkını* + *gerçeklik farkını* inceler.
+
+## 🛠 Truthmark ile nasıl etkileşirsiniz
+
+Truthmark’ın depo yerelinde tek bir sözleşmesi ve onu kullanmanın iki yolu vardır.
+
+### İnsanlar sözleşmeyi kurar ve doğrular
+
+Bakımcılar ve CI, CLI kullanır:
+
+* `truthmark config` - ilk yapılandırmayı oluşturur.
+* `truthmark init` - yönlendirmeyi, truth-doc iskelelerini ve AI ana makine talimatlarını kurar veya yeniler.
+* `truthmark check` - depo gerçeğini terminalden doğrular.
+
+### Ajanlar kod yazarken sözleşmeyi izler
+
+Truthmark, Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor gibi desteklenen AI kodlama ana makineleri için depo yerelinde talimatlar kurar.
+
+Normal döngü basittir:
+
+1. Ajanınızdan kod değişikliği isteyin veya mevcut bir davranışı belgelemesini isteyin.
+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.
+3. Siz sıradan Git diff’lerini incelersiniz: kod ve varsa truth-doc değişiklikleri.
+
+Kullanıcı tarafından başlatılan ajan istekleri bilinçli olarak azdır:
+
+* `/truthmark-document` - kod ve testlerden mevcut uygulanmış davranışı belgeler.
+* `/truthmark-realize` - mevcut truth dokümanlarından kod uygular.
+* `/truthmark-check` - depo gerçeğini denetler.
+
+Truth Sync işe başlamanın olağan yolu değildir; işlevsel kod değişikliklerinden sonraki bitiş incelemesidir.
+Truth Structure günlük bir komut değildir; yalnızca çalışmayı engellediğinde yönlendirmeyi veya sahipliği onarır.
+
+## Neler elde edersiniz
+
+| Yetenek | Ne yapar |
+| --- | --- |
+| Git'e özgü gerçeklik | Depo gerçeğini commit edilmiş Markdown ve yapılandırmada tutar. |
+| Dal kapsamlı dokümantasyon | Gerçek, özel bir oturumda yaşamak yerine dalla birlikte hareket eder. |
+| İnsan CLI'si | Bakımcılara kurulum, yenileme, doğrulama ve inceleme komutları sağlar. |
+| 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. |
+| Açık yönlendirme | Kod alanlarını kanonik gerçeklik belgelerine eşler. |
+| İncelenebilir teslimler | Hem kod hem de gerçeklik belgeleri için sıradan Git farkları üretir. |
+| Yerel-öncelikli çalışma | Barındırılan hizmet, daemon, veritabanı veya MCP sunucusu gerektirmez. |
+| Daha güvenli yazma sınırları | Kod-öncelikli, belge-öncelikli, salt-okunur ve yalnızca-belge iş akışlarını ayırır. |
+| Doğrulama | Yönlendirme, yetki, frontmatter, bağlantı, üretilmiş yüzey, dal kapsamı, güncellik ve kapsam sorunlarını raporlar. |
+| İsteğe bağlı Portal | Açıkça etkinleştirilip istendiğinde Markdown gerçeklik belgelerinden commit edilmiş statik bir HTML sunum sitesi üretir. |
+
+## Görsel genel bakış
+
+![Truthmark özellikleri](../assets/truthmark-features.png)
+
+**Özellikler:** Truthmark'ın ne kurduğu ve iş akışı yüzeyinin nasıl bölündüğü.
+
+![Truthmark konumu](../assets/truthmark-position.png)
+
+**Konum:** Truthmark'ın istemlere, belleğe ve spesifikasyon iş akışlarına göre nerede yer aldığı.
+
+![Truthmark senkronizasyon akışı](../assets/truthmark-syncflow.png)
+
+**Senkronizasyon akışı:** Truth Sync'in normal kod değişikliklerini teslimden önce nasıl kapattığı.
+
+## Ekipler neden benimser
+
+Truthmark, AI ajanlarının kod üretebildiğini zaten bilen ekipler içindir.
+
+Sıradaki sorun yönetişimdir.
+
+Tören anlamında yönetişim değil. Basit bir soru olarak yönetişim:
+
+> Bu AI destekli değişiklikten sonra depo hâlâ gerçeği söylüyor mu?
+
+Truthmark, commit edilmiş dosyalar, açık yönlendirme ve incelenebilir farklarla ekiplerin buna yanıt vermesine yardımcı olur.
+
+Şunlara ihtiyaç duyduğunuzda yararlıdır:
+
+- daha az dokümantasyon kayması
+- daha iyi teslimler
+- dala özgü ürün gerçeği
+- kalıcı mimari ve API dokümantasyonu
+- belgeler ile kod arasında açık sahiplik
+- daha güvenli ajan yazma sınırları
+- gizli bellek yerine incelenebilir dokümantasyon
+- commit edilmiş depo dosyalarından çalışmaya devam eden AI iş akışları
+
+## Truthmark nerede yer alır
+
+Truthmark istemlerin, belleğin, spesifikasyonların, testlerin veya kod incelemesinin yerini almaz.
+
+Bu iş akışlarına Git içinde kalıcı bir iniş alanı sağlar.
+
+| İhtiyaç | Daha uygun seçenek |
+| --- | --- |
+| Tek bir ajan oturumundan daha iyi çıktı | Daha iyi istem |
+| Kişisel veya oturum düzeyinde süreklilik | Bellek aracı |
+| Plan-öncelikli özellik çalışması | Spesifikasyon iş akışı |
+| Kodla birlikte taşınan dal kapsamlı gerçek | Truthmark |
+| Davranış doğruluğunu doğrulama | Testler ve inceleme |
+| AI destekli dokümantasyon değişikliklerini inceleme | Truthmark artı Git incelemesi |
+
+Truthmark'ın alanı tasarım gereği dardır:
+
+```text
+make repository truth explicit
+route it to code
+etrafına ajan rehberliği kurmak
+keep the result reviewable in Git
+```
+
+## Daha derine inin
+
+README vitrin görevi görür: hızlı bağlam, hızlı başlangıç ve temel zihinsel model.
+
+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.
+
+## Proje durumu
+
+Mevcut sürüm şunları sağlar:
+
+- config, init, check, index, impact ve iş akışı durumu için yerel CLI komutları
+- Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor için oluşturulan depo yerelinde ajan talimatları
+- yönlendirme, yetki, frontmatter, bağlantı, güncellik, üretilmiş yüzey, dal kapsamı ve kapsam tanıları
+- dal kapsamlı gerçeklik belgeleri ve türetilmiş depo zekâsı artefaktları
+
+## Dokümantasyon
+
+- [Kullanıcı kılavuzu](../user-guide.md)
+- [Dokümanlar dizini](../README.md)
+- [Mimari genel bakışı](../truthmark/engineering/architecture/overview.md)
+- [API ve CLI sözleşmeleri](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Depo gerçeği bakım kılavuzu](../standards/maintaining-repository-truth.md)
+
+Yerel geliştirme ve katkı komutları için [CONTRIBUTING.md](../../CONTRIBUTING.md) dosyasına bakın.
+
+## Tasarım sınırları
+
+Truthmark bilinçli olarak küçüktür: yerel, commit edilmiş, dal kapsamlı ve incelenebilir.
+
+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.
+
+## Lisans
+
+MIT. Bkz. [LICENSE](../../LICENSE).