truthmark 2.2.7 → 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,229 +1,194 @@
1
1
  # Truthmark
2
2
 
3
- **Agen Anda menulis kode. Truthmark memelihara dokumentasi yang ditujukan untuk manusia dan dapat ditinjau melalui Git.**
3
+ **Agen Anda menulis kode. Truthmark menjaga dokumentasi yang ditujukan untuk manusia dan siap ditinjau di Git.**
4
+
5
+ Truthmark memasang alur kerja native Git yang memungkinkan agen pengodean AI membuat dokumentasi produk dan rekayasa baru dari kode serta pengujian yang sudah ada, menjaganya tetap mutakhir setelah setiap perubahan kode, dan memberikan diff Markdown biasa untuk Anda tinjau.
6
+
7
+ [![versi npm](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
+ [![Lisensi: 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)
11
+
12
+ [Mulai](#mulai-cepat-buat-dokumen-truth-pertama-anda) · [Situs web](https://merlinhu1.github.io/truthmark/) · [Panduan pengguna](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
13
+
14
+ <details>
15
+ <summary>Baca README ini dalam salah satu dari 16 bahasa</summary>
4
16
 
5
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)
6
18
 
7
- ![Banner Truthmark](../assets/truthmark-banner.png)
19
+ </details>
8
20
 
9
- ## 🚀 Mulai cepat: berjalan lokal dalam lima menit
21
+ ## Buat dokumentasi pertama. Jaga agar tetap benar.
10
22
 
11
- Jalankan ini di dalam repositori Git yang ingin Anda kelola dengan Truthmark:
23
+ Sebagian besar alat dokumentasi berhenti setelah pembuatan. Truthmark memberi agen siklus hidup dokumentasi lengkap di dalam repositori Anda:
12
24
 
13
- ```bash
14
- cd /path/to/your-repo
15
- npm install -g truthmark
16
- truthmark config
17
- ```
25
+ - **Buat dokumentasi baru dari perangkat lunak yang berfungsi.** Truth Document membaca kode dan pengujian, lalu membuat dokumentasi produk atau rekayasa dengan cakupan yang jelas.
26
+ - **Jaga dokumentasi tetap selaras secara otomatis.** Truth Sync berjalan saat serah terima agen setelah perubahan kode fungsional dan memperbarui kebenaran repositori sebelum pekerjaan dinyatakan selesai.
27
+ - **Ubah dokumentasi kembali menjadi kode.** Truth Realize mengimplementasikan dokumen truth yang disetujui sambil mempertahankan alur kerja doc-first yang rapi.
28
+ - **Perbaiki kepemilikan seiring pertumbuhan basis kode.** Truth Structure membuat rute dengan cakupan jelas dan dokumen awal untuk area baru atau yang terlalu luas.
29
+ - **Tinjau semuanya di Git.** Kode, keputusan, kontrak, arsitektur, operasi, dan perilaku bergerak bersama branch.
18
30
 
19
- Aktifkan host AI yang benar-benar Anda gunakan. Konfigurasi baru bersifat netral terhadap host, jadi tambahkan daftar `platforms` tingkat atas ke `.truthmark/config.yml` sebelum inisialisasi:
20
-
21
- ```yaml
22
- version: 2
23
- platforms:
24
- - codex # or: claude-code, github-copilot, opencode, antigravity, cursor
25
- truthmark:
26
- workspace: docs/truthmark
27
- generated:
28
- portal:
29
- enabled: false
30
- ```
31
+ Tanpa basis pengetahuan ter-host. Tanpa memori agen privat. Tanpa dokumentasi yang terjebak dalam riwayat chat.
31
32
 
32
- Kemudian pasang dokumen kebenaran lokal repositori, perutean, dan permukaan alur kerja agen:
33
+ ## Mulai cepat: buat dokumen truth pertama Anda
34
+
35
+ **Persyaratan:** Node.js 24 atau yang lebih baru, repositori Git, dan host pengodean AI yang didukung untuk alur kerja agen.
36
+
37
+ Jalankan perintah berikut di dalam repositori yang ingin Anda kelola dengan Truthmark:
33
38
 
34
39
  ```bash
40
+ cd /path/to/your-repo
41
+ npm install -g truthmark
35
42
  truthmark init
36
- truthmark check
37
- git diff
38
43
  ```
39
44
 
40
- Sekarang coba jalur adopsi yang paling umum: dokumentasikan satu perilaku yang sudah ada dari kode dan pengujian. Di host pengodean AI Anda, minta alur kerja yang terpasang:
45
+ `truthmark init` memungkinkan Anda memilih Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor, atau penyiapan antarmuka baris perintah yang netral terhadap host.
46
+
47
+ Sekarang minta agen yang telah dikonfigurasi untuk mendokumentasikan satu perilaku nyata:
41
48
 
42
49
  ```text
43
50
  /truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
44
51
  ```
45
52
 
46
- Setelah itu, pengguna biasanya tidak perlu memanggil Truth Sync secara langsung. Teruslah membuat kode melalui host AI Anda; instruksi repositori yang terpasang memberi tahu agen untuk menjalankan pengujian yang relevan dan melakukan tinjauan Truth Sync sebelum serah terima ketika kode fungsional berubah. Anda meninjau diff kode yang dihasilkan beserta diff dokumen truth.
47
-
48
- Jika Anda hanya menginginkan validasi CLI dan belum menginginkan alur kerja AI khusus host, biarkan `platforms` tidak dicantumkan dan jalankan `truthmark init && truthmark check`; Anda dapat menambahkan platform nanti dan menjalankan ulang `truthmark init`.
49
-
50
- ## 💡 Masalah: kesenjangan dokumentasi AI
53
+ Truth Document membuat dokumen truth baru dengan cakupan jelas jika belum ada, memperbarui pemilik yang sudah ada jika tersedia, dan memperbarui perutean bila diperlukan. Alur ini tidak mengubah kode fungsional.
51
54
 
52
- Agen pengodean AI luar biasa dalam menulis kode dengan cepat. Namun kecepatan ini menciptakan mode kegagalan baru yang berbahaya: **cerita repositori menyimpang dari kenyataan.**
55
+ Tinjau hasilnya:
53
56
 
54
- * Perilaku hilang dalam riwayat chat yang sementara.
55
- * Dokumen arsitektur cepat tertinggal.
56
- * Keputusan produk lenyap setelah serah terima.
57
- * Peninjau kode dibiarkan memeriksa diff kode mentah tanpa memahami "mengapa".
58
- * Setiap sesi AI baru dipaksa menemukan ulang kebenaran repositori Anda dari awal.
59
-
60
- ## 🎯 Solusi: Truthmark
61
-
62
- **Truthmark** memasang lapisan alur kerja native Git ke dalam repositori Anda. Ini memperbaiki bagian pengembangan AI yang biasanya rusak: membantu dokumentasi tetap selaras dengan kode.
63
-
64
- Alih-alih berharap manusia dan agen AI ingat memperbarui dokumen, Truthmark menjadikan dokumentasi sebagai kebiasaan sistematis dan dapat ditinjau langsung di dalam repositori Anda.
65
-
66
- ### ✨ Mengapa Truthmark unik
57
+ ```bash
58
+ truthmark check
59
+ git status --short --untracked-files=all
60
+ git diff
61
+ ```
67
62
 
68
- Truthmark bukan sekadar alat dokumentasi lain. Ia terintegrasi mendalam ke dalam alur kerja AI:
63
+ Sekarang Anda akan memiliki:
69
64
 
70
- * **🚫 Tanpa ketergantungan vendor:** Tidak ada layanan ter-host, tidak ada basis data tersembunyi, tidak ada server tambahan untuk dioperasikan.
71
- * **🌳 100% native Git:** Semuanya hidup di repositori Anda. Kebenaran bergerak bersama branch Anda.
72
- * **🤝 Kontrak yang dimiliki manusia dan diikuti agen:** Pemelihara memiliki kontrak repositori; agen mengikuti instruksi yang terpasang saat membuat kode.
73
- * **✅ Kepercayaan melalui verifikasi:** Pekerjaan AI menjadi lebih mudah dipercaya karena pekerjaan yang mengubah perilaku menyertakan keputusan atau diff dokumen kebenaran yang dapat ditinjau manusia.
65
+ ```text
66
+ docs/truthmark/engineering/behaviors/session-timeout.md
67
+ docs/truthmark/routes/areas/authentication.md
68
+ ```
74
69
 
75
- ## 🔄 Cara kerjanya
70
+ Path yang tepat mengikuti struktur kepemilikan repositori Anda. File baru muncul di `git status`; perubahan pada file yang dilacak muncul di `git diff`.
76
71
 
77
- Ketika agen AI memodifikasi kode Anda, pekerjaannya belum selesai. Truthmark memasang penjaga alur kerja saat penyelesaian yang diikuti agen sebelum serah terima:
72
+ Cara pemanggilan berbeda menurut host. OpenCode menggunakan `/skill truthmark-document`, Antigravity menggunakan `@truthmark-document`, dan host lain yang didukung menggunakan permukaan skill atau perintah garis miring native masing-masing. Lihat [tabel platform](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) untuk perintah yang tepat.
78
73
 
79
- 1. 💻 **Kode:** Agen memodifikasi kode fungsional.
80
- 2. 🧪 **Uji:** Pengujian yang relevan dijalankan.
81
- 3. 🔍 **Periksa:** Truthmark memeriksa dokumentasi yang dipetakan sebagai bagian dari tinjauan akhir yang terpasang.
82
- 4. 📝 **Dokumentasikan:** Dokumen diperbarui oleh agen ketika kebenaran repositori berubah.
83
- 5. 👀 **Tinjau:** Manusia meninjau *diff kode* + *diff kebenaran*.
74
+ Untuk skrip dan integrasi berkelanjutan, berikan platform yang dipilih secara eksplisit:
84
75
 
85
- ## 🛠 Cara Anda berinteraksi dengan Truthmark
76
+ ```bash
77
+ truthmark init --platform codex --platform cursor
78
+ truthmark init --json
79
+ ```
86
80
 
87
- Truthmark memiliki satu kontrak lokal repositori dengan dua cara pemakaian.
81
+ Pilih `none` secara interaktif atau jalankan `truthmark init --clear-platforms` untuk repositori yang netral terhadap host. Anda dapat menambahkan platform agen nanti dengan menjalankan ulang `truthmark init`.
88
82
 
89
- ### Manusia memasang dan memvalidasi kontrak
83
+ Untuk diagnostik kesegaran relatif terhadap branch, berikan basis Git:
90
84
 
91
- Pemelihara dan CI menggunakan CLI:
85
+ ```bash
86
+ truthmark check --base <base-ref>
87
+ ```
92
88
 
93
- * `truthmark config` - membuat konfigurasi awal.
94
- * `truthmark init` - memasang atau menyegarkan perutean, scaffold dokumen kebenaran, dan instruksi host AI.
95
- * `truthmark check` - memvalidasi kebenaran repositori dari terminal.
89
+ ## Cara kerja Truthmark
96
90
 
97
- ### Agen mengikuti kontrak saat membuat kode
91
+ <picture>
92
+ <source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
93
+ <img src="../assets/truthmark-workflow.svg" alt="Cara kerja Truthmark" width="1440">
94
+ </picture>
98
95
 
99
- Truthmark memasang instruksi lokal repositori untuk host pengodean AI yang didukung seperti Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor.
96
+ Antarmuka baris perintah Truthmark memasang dan memvalidasi kontrak repositori. Agen pengodean Anda melakukan peninjauan bukti dan pekerjaan dokumentasi melalui alur kerja native host yang telah terpasang.
100
97
 
101
- Alur normalnya sederhana:
98
+ Perubahan kode normal mengikuti satu putaran sederhana:
102
99
 
103
- 1. Minta agen Anda melakukan perubahan kode, atau minta ia mendokumentasikan perilaku yang sudah ada.
104
- 2. Instruksi yang terpasang memberi tahu agen kapan harus menguji, kapan memperbarui dokumen kebenaran, dan kapan berhenti untuk tinjauan manusia.
105
- 3. Anda meninjau diff Git biasa: kode plus perubahan dokumen kebenaran apa pun.
100
+ 1. Agen mengubah kode fungsional.
101
+ 2. Pengujian yang relevan dijalankan.
102
+ 3. Truth Sync memeriksa dokumentasi yang dipetakan.
103
+ 4. Agen membuat atau memperbarui dokumentasi dan perutean saat kebenaran repositori berubah.
104
+ 5. Anda meninjau diff kode dan diff truth secara bersamaan.
106
105
 
107
- Permintaan agen yang dimulai pengguna sengaja dibuat sedikit:
106
+ ## Alur kerja
108
107
 
109
- * `/truthmark-document` - mendokumentasikan perilaku terimplementasi yang sudah ada dari kode dan pengujian.
110
- * `/truthmark-realize` - mengimplementasikan kode dari dokumen kebenaran yang sudah ada.
111
- * `/truthmark-check` - mengaudit kebenaran repositori.
108
+ | Alur kerja | Gunakan saat | Hasil |
109
+ | -------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
110
+ | **Truth Document** | Kode yang sudah ada memerlukan dokumentasi | Membuat atau memperbarui dokumentasi produk dan rekayasa berbasis bukti |
111
+ | **Truth Sync** | Kode fungsional berubah | Menjaga dokumentasi yang dipetakan dan perutean tetap selaras sebelum serah terima |
112
+ | **Truth Structure** | Area baru memerlukan kepemilikan atau dokumentasi yang ada terlalu luas | Membuat rute dengan cakupan jelas dan kerangka dokumen awal |
113
+ | **Truth Realize** | Dokumen truth yang disetujui harus menjadi perangkat lunak yang berfungsi | Memperbarui kode fungsional dari dokumentasi |
114
+ | **Truth Check** | Kebenaran repositori perlu diaudit | Melaporkan masalah perutean, kepemilikan, bukti, dan dokumentasi |
115
+ | **Truthmark Portal** | Tim menginginkan situs dokumentasi yang mudah dijelajahi | Menghasilkan presentasi HTML statis yang di-commit dari dokumen truth Markdown |
112
116
 
113
- Truth Sync bukan cara biasa untuk memulai pekerjaan; itu adalah tinjauan akhir setelah perubahan kode fungsional.
114
- Truth Structure bukan perintah harian; ia memperbaiki perutean atau kepemilikan hanya ketika hal itu memblokir pekerjaan.
117
+ Truthmark memasang alur kerja ini sebagai permukaan repositori native untuk Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor.
115
118
 
116
119
  ## Yang Anda dapatkan
117
120
 
118
- | Kapabilitas | Apa yang dilakukan |
119
- | --- | --- |
120
- | Kebenaran native Git | Menyimpan kebenaran repositori dalam Markdown dan konfigurasi yang di-commit. |
121
- | Dokumentasi berlingkup branch | Kebenaran bergerak bersama branch alih-alih hidup dalam sesi privat. |
122
- | CLI manusia | Memberi pemelihara perintah penyiapan, penyegaran, validasi, dan inspeksi. |
123
- | Kontrak agen terpasang | Memberi agen panduan native host untuk dokumentasi, realisasi, audit, sinkronisasi akhir, dan perbaikan perutean terbatas. |
124
- | Perutean eksplisit | Memetakan area kode ke dokumen kebenaran kanonis. |
125
- | Serah terima yang dapat ditinjau | Menghasilkan diff Git biasa untuk kode maupun dokumen kebenaran. |
126
- | Operasi lokal terlebih dahulu | Tidak membutuhkan layanan ter-host, daemon, basis data, atau server MCP. |
127
- | Batas tulis yang lebih aman | Memisahkan alur kerja code-first, doc-first, read-only, dan doc-only. |
128
- | Validasi | Melaporkan masalah perutean, otoritas, frontmatter, tautan, permukaan yang dihasilkan, cakupan branch, kesegaran, dan coverage. |
129
- | Portal opsional | Menghasilkan situs presentasi HTML statis yang di-commit dari dokumen kebenaran Markdown ketika diaktifkan dan diminta secara eksplisit. |
130
-
131
- ## Gambaran visual
121
+ ### Dokumentasi yang berawal dari kenyataan
132
122
 
133
- ![Fitur Truthmark](../assets/truthmark-features.png)
123
+ Truthmark dapat membuat dokumentasi untuk kapabilitas produk, perilaku implementasi, antarmuka pemrograman aplikasi, arsitektur, alur kerja, operasi, dan pengujian. Kode dan pengujian menyediakan bukti; dokumen Markdown dengan cakupan jelas mempertahankan hasilnya.
134
124
 
135
- **Fitur:** apa yang dipasang Truthmark dan bagaimana permukaan alur kerja dibagi.
125
+ ### Dokumentasi yang bertahan melewati perubahan berikutnya
136
126
 
137
- ![Posisi Truthmark](../assets/truthmark-position.png)
127
+ Rute menghubungkan area kode ke dokumen kanonis. Saat agen mengubah perilaku, Truth Sync mengetahui tempat kebenaran terkait harus berada dan menjaga serah terima tetap dapat ditinjau.
138
128
 
139
- **Posisi:** di mana Truthmark berada relatif terhadap prompt, memori, dan alur kerja spesifikasi.
129
+ ### Kebenaran produk dan rekayasa di jalur terpisah
140
130
 
141
- ![Alur sinkronisasi Truthmark](../assets/truthmark-syncflow.png)
131
+ Kebenaran produk merekam janji kepada pengguna, batasan, keputusan, dan kriteria penerimaan. Kebenaran rekayasa merekam perilaku saat ini, kontrak, arsitektur, alur kerja, operasi, dan perilaku pengujian.
142
132
 
143
- **Alur sinkronisasi:** bagaimana Truth Sync menutup perubahan kode normal sebelum serah terima.
133
+ ### Kolaborasi native Git
144
134
 
145
- ## Mengapa tim mengadopsinya
135
+ Semua yang penting berada dalam file repositori yang di-commit. Kebenaran mengikuti branch, bekerja dengan pull request biasa, dan tetap terlihat oleh setiap pemelihara serta agen pengodean.
146
136
 
147
- Truthmark ditujukan untuk tim yang sudah tahu bahwa agen AI dapat menghasilkan kode.
137
+ ### Operasi yang mengutamakan lokal
148
138
 
149
- Masalah berikutnya adalah tata kelola.
139
+ Truthmark tidak memerlukan layanan ter-host, daemon, basis data, penyimpanan vektor, atau server Model Context Protocol. Repositori membawa alur kerja dokumentasinya sendiri.
150
140
 
151
- Bukan tata kelola sebagai seremoni. Tata kelola sebagai pertanyaan sederhana:
141
+ ## Posisi Truthmark
152
142
 
153
- > Setelah perubahan berbantuan AI ini, apakah repositori masih mengatakan kebenaran?
143
+ | Kebutuhan | Pilihan terbaik |
144
+ | ------------------------------------------------- | ---------------------------- |
145
+ | Output yang lebih baik dari satu sesi agen | Prompt yang lebih baik |
146
+ | Kontinuitas pribadi atau tingkat sesi | Alat memori |
147
+ | Pekerjaan fitur yang dimulai dengan perencanaan | Alur kerja spesifikasi |
148
+ | Dokumentasi berlingkup branch yang mengikuti kode | **Truthmark** |
149
+ | Kebenaran perilaku | Pengujian dan tinjauan kode |
150
+ | Dokumentasi berbantuan AI yang dapat ditinjau | **Truthmark + tinjauan Git** |
154
151
 
155
- Truthmark membantu tim menjawabnya dengan file yang di-commit, perutean eksplisit, dan diff yang dapat ditinjau.
152
+ Truthmark dibuat untuk pemelihara dan tim rekayasa yang sudah menggunakan agen pengodean AI dan ingin repositori terus menyampaikan kebenaran secepat kode berubah.
156
153
 
157
- Ini berguna saat Anda membutuhkan:
154
+ ## Host yang didukung dan baris perintah
158
155
 
159
- - penyimpangan dokumentasi yang lebih kecil
160
- - serah terima yang lebih baik
161
- - kebenaran produk khusus branch
162
- - dokumentasi arsitektur dan API yang tahan lama
163
- - kepemilikan eksplisit antara dokumen dan kode
164
- - batas tulis agen yang lebih aman
165
- - dokumentasi yang dapat ditinjau alih-alih memori tersembunyi
166
- - alur kerja AI yang tetap bekerja dari file repositori yang di-commit
156
+ Host agen yang didukung:
167
157
 
168
- ## Di mana Truthmark cocok
158
+ - Codex
159
+ - Claude Code
160
+ - GitHub Copilot
161
+ - OpenCode
162
+ - Antigravity
163
+ - Cursor
169
164
 
170
- Truthmark tidak menggantikan prompt, memori, spesifikasi, pengujian, atau tinjauan kode.
165
+ <details>
166
+ <summary>Referensi baris perintah</summary>
171
167
 
172
- Ia memberi alur kerja tersebut tempat yang tahan lama untuk mendarat di Git.
168
+ | Perintah | Tujuan |
169
+ | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
170
+ | `truthmark init` | Membuat atau menyegarkan konfigurasi, perutean, template, dan alur kerja host yang dipilih |
171
+ | `truthmark check [--base <ref>]` | Memvalidasi kebenaran repositori dan secara opsional menjalankan diagnostik kesegaran branch |
172
+ | `truthmark index --json` | Memeriksa metadata turunan repositori dan perutean |
173
+ | `truthmark impact --base <ref> --json` | Memetakan file yang berubah ke dokumentasi, pemilik, dan pengujian terdekat |
174
+ | `truthmark workflow status --workflow <id> [--base <ref>] --json` | Memeriksa penerapan dan target alur kerja |
175
+ | `truthmark validate ...` | Memvalidasi laporan alur kerja dan sewa penulisan |
176
+ | `truthmark uninstall --dry-run\|--apply` | Meninjau atau menghapus permukaan host yang dihasilkan sambil mempertahankan truth yang ditulis pengguna |
173
177
 
174
- | Kebutuhan | Lebih cocok |
175
- | --- | --- |
176
- | Output lebih baik dari satu sesi agen | Prompt yang lebih baik |
177
- | Kontinuitas pribadi atau tingkat sesi | Alat memori |
178
- | Pekerjaan fitur yang dimulai dengan rencana | Alur kerja spesifikasi |
179
- | Truth berlingkup branch yang ikut bersama kode | Truthmark |
180
- | Memvalidasi kebenaran perilaku | Pengujian dan tinjauan |
181
- | Meninjau perubahan dokumentasi berbantuan AI | Truthmark plus tinjauan Git |
178
+ Output JSON terstruktur tersedia di seluruh antarmuka baris perintah untuk skrip dan integrasi berkelanjutan.
182
179
 
183
- Jalur Truthmark sengaja dirancang sempit:
184
-
185
- ```text
186
- make repository truth explicit
187
- route it to code
188
- memasang panduan agen di sekelilingnya
189
- keep the result reviewable in Git
190
- ```
180
+ </details>
191
181
 
192
- ## Pelajari lebih dalam
182
+ ## Pelajari lebih lanjut
193
183
 
194
- README adalah etalase: konteks cepat, mulai cepat, dan model mental inti.
184
+ - [Panduan pengguna Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
185
+ - [Indeks dokumentasi](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
186
+ - [Ikhtisar arsitektur](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
187
+ - [Kontrak konfigurasi, perutean, dan perintah](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
188
+ - [Berkontribusi](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
195
189
 
196
- Untuk penggunaan per perintah, perbandingan permukaan, detail platform yang didukung, konfigurasi, perutean, Portal, dan contoh, baca [Panduan Pengguna Truthmark](../user-guide.md).
197
-
198
- ## Status proyek
199
-
200
- Rilis saat ini menyediakan:
201
-
202
- - perintah CLI lokal untuk config, init, check, index, impact, dan status alur kerja
203
- - instruksi agen lokal repositori yang dihasilkan untuk Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor
204
- - diagnostik perutean, otoritas, frontmatter, tautan, kesegaran, permukaan yang dihasilkan, cakupan branch, dan coverage
205
- - dokumen kebenaran berlingkup branch dan artefak kecerdasan repositori turunan
206
-
207
- ## Dokumentasi
208
-
209
- - [Panduan pengguna](../user-guide.md)
210
- - [Indeks dokumen](../README.md)
211
- - [Ikhtisar arsitektur](../truthmark/engineering/architecture/overview.md)
212
- - [Kontrak API dan CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
213
- - [Panduan pemeliharaan kebenaran repositori](../standards/maintaining-repository-truth.md)
214
-
215
- Untuk perintah pengembangan lokal dan kontribusi, lihat [CONTRIBUTING.md](../../CONTRIBUTING.md).
216
-
217
- ## Batas desain
218
-
219
- Truthmark sengaja kecil: lokal, di-commit, berlingkup branch, dan dapat ditinjau.
220
-
221
- Ini bukan layanan ter-host, server MCP, basis data vektor, lapisan memori tersembunyi, produk penegakan CI, atau mesin penulisan ulang kode otonom. Ini membantu kebenaran repositori tetap terlihat; tidak menggantikan pengujian, tinjauan kode, atau penilaian manusia.
190
+ **Pasang Truthmark, pilih host pengodean Anda, dan ubah satu perilaku nyata menjadi dokumentasi hari ini.**
222
191
 
223
192
  ## Lisensi
224
193
 
225
194
  MIT. Lihat [LICENSE](../../LICENSE).
226
-
227
- ## Penghapusan aman
228
-
229
- Gunakan `truthmark uninstall --dry-run` untuk meninjau permukaan host yang tepat dihasilkan, lalu `truthmark uninstall --apply` untuk menghapusnya. Truth hasil penulisan, konfigurasi, template, keluaran Portal, berkas Gemini, dan berkas pengguna yang tidak terkait akan tetap dipertahankan; hapus instalasi npm global secara terpisah melalui pengelola paket Anda.