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
- **I tuoi agenti scrivono codice. Truthmark mantiene documentazione pensata per le persone e revisionabile in Git.**
3
+ **I tuoi agenti scrivono codice. Truthmark mantiene la documentazione pensata per le persone e revisionabile in Git.**
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 installa workflow nativi di Git che permettono agli agenti di coding IA di creare nuova documentazione di prodotto e ingegneria a partire dal codice e dai test esistenti, mantenerla aggiornata dopo ogni modifica al codice e consegnarti normali diff Markdown da revisionare.
6
6
 
7
- ![Banner di Truthmark](../assets/truthmark-banner.png)
7
+ [![versione 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
+ [![Licenza: 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
- ## 🚀 Avvio rapido: eseguirlo localmente in cinque minuti
12
+ [Inizia](#avvio-rapido-crea-il-tuo-primo-documento-di-verità) · [Sito web](https://merlinhu1.github.io/truthmark/) · [Guida utente](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
10
13
 
11
- Esegui questo comando nel repository Git che vuoi far gestire a Truthmark:
14
+ <details>
15
+ <summary>Leggi questo README in 16 lingue</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
- In un terminale interattivo, `truthmark init` mostra una selezione multipla numerata. Scegli zero o più piattaforme, oppure `none` per una configurazione neutrale rispetto all’host e solo CLI.
19
+ </details>
22
20
 
23
- Per script e CI, ripeti `--platform`; `--json` non mostra mai prompt:
21
+ ## Crea i primi documenti. Mantienili fedeli alla realtà.
24
22
 
25
- ```bash
26
- truthmark init --platform codex --platform cursor
27
- truthmark init --json
28
- ```
23
+ La maggior parte degli strumenti di documentazione si ferma dopo la generazione. Truthmark offre agli agenti un ciclo di vita completo della documentazione all’interno del tuo repository:
29
24
 
30
- Alla prima esecuzione non interattiva senza `--platform`, la configurazione resta neutrale; le esecuzioni successive mantengono la selezione salvata in `.truthmark/config.yml`.
25
+ - **Crea nuova documentazione da software funzionante.** Truth Document legge codice e test, quindi crea documentazione di prodotto o ingegneria con un perimetro definito.
26
+ - **Mantieni la documentazione allineata automaticamente.** Truth Sync viene eseguito al passaggio di consegne dell’agente dopo modifiche funzionali al codice e aggiorna la verità del repository prima che il lavoro sia concluso.
27
+ - **Trasforma nuovamente la documentazione in codice.** Truth Realize implementa documenti di verità approvati mantenendo un workflow pulito che parte dalla documentazione.
28
+ - **Ripristina la proprietà man mano che la codebase cresce.** Truth Structure crea percorsi delimitati e documenti iniziali per aree nuove o sovraccariche.
29
+ - **Revisiona tutto in Git.** Codice, decisioni, contratti, architettura, operazioni e comportamento viaggiano insieme al branch.
31
30
 
32
- Ora prova il percorso di adozione più comune: documentare un comportamento esistente a partire da codice e test. Nel tuo host di coding IA, chiedi al workflow installato:
31
+ Nessuna knowledge base ospitata. Nessuna memoria privata degli agenti. Nessuna documentazione intrappolata nella cronologia delle chat.
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
+ ## Avvio rapido: crea il tuo primo documento di verità
37
34
 
38
- Dopo questo, di norma gli utenti non dovrebbero invocare Truth Sync direttamente. Continua a scrivere codice tramite il tuo host IA; le istruzioni installate nel repository dicono all’agente di eseguire i test pertinenti e svolgere la revisione Truth Sync prima della consegna quando cambiano parti di codice funzionale. Tu revisioni il diff di codice risultante insieme al diff dei documenti di verità.
35
+ **Requisiti:** Node.js 24 o versione successiva, un repository Git e un host di coding IA supportato per i workflow degli agenti.
39
36
 
40
- Se vuoi solo la validazione CLI, scegli `none` e continua con `truthmark check`; potrai rieseguire `truthmark init` in seguito per selezionare le piattaforme.
37
+ Esegui quanto segue nel repository che vuoi far gestire a Truthmark:
41
38
 
42
- ## 💡 Il problema: il divario di documentazione dell’IA
39
+ ```bash
40
+ cd /path/to/your-repo
41
+ npm install -g truthmark
42
+ truthmark init
43
+ ```
43
44
 
44
- Gli agenti di coding IA sono straordinari nello scrivere codice rapidamente. Ma questa velocità crea una nuova modalità di errore pericolosa: **la storia del repository si allontana dalla realtà.**
45
+ `truthmark init` permette di selezionare Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor oppure una configurazione dell’interfaccia a riga di comando neutrale rispetto all’host.
45
46
 
46
- * Il comportamento si perde in cronologie chat effimere.
47
- * I documenti di architettura restano rapidamente indietro.
48
- * Le decisioni di prodotto scompaiono dopo la consegna.
49
- * I revisori del codice si ritrovano a esaminare diff di codice grezzi senza capire il “perché”.
50
- * Ogni nuova sessione IA è costretta a riscoprire da zero la verità del repository.
47
+ Ora chiedi all’agente configurato di documentare un comportamento reale:
51
48
 
52
- ## 🎯 La soluzione: 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** installa nel tuo repository un livello di workflow nativo di Git. Risolve la parte dello sviluppo con IA che di solito si rompe: aiutare la documentazione a restare allineata al codice.
53
+ Truth Document crea un nuovo documento di verità delimitato quando non ne esiste uno, aggiorna il documento proprietario esistente quando è presente e aggiorna il routing quando necessario. Non modifica il codice funzionale.
55
54
 
56
- Invece di sperare che persone e agenti IA si ricordino di aggiornare la documentazione, Truthmark rende la documentazione un’abitudine sistematica e revisionabile direttamente nel repository.
55
+ Revisiona il risultato:
57
56
 
58
- ### ✨ Perché Truthmark è unico
57
+ ```bash
58
+ truthmark check
59
+ git status --short --untracked-files=all
60
+ git diff
61
+ ```
59
62
 
60
- Truthmark non è semplicemente un altro strumento di documentazione. È profondamente integrato nel workflow IA:
63
+ Ora dovresti avere:
61
64
 
62
- * **🚫 Nessun lock-in del fornitore:** nessun servizio ospitato, nessun database nascosto, nessun server aggiuntivo da gestire.
63
- * **🌳 100% nativo di Git:** tutto vive nel tuo repository. La verità si muove con il tuo branch.
64
- * **🤝 Contratto posseduto dagli umani e seguito dagli agenti:** I maintainer possiedono il contratto del repository; gli agenti seguono le istruzioni installate mentre scrivono codice.
65
- * **✅ Fiducia tramite verifica:** il lavoro dell’IA diventa più facile da fidare perché il lavoro che cambia comportamento include una decisione o un diff di documento di verità revisionabile da una persona.
65
+ ```text
66
+ docs/truthmark/engineering/behaviors/session-timeout.md
67
+ docs/truthmark/routes/areas/authentication.md
68
+ ```
66
69
 
67
- ## 🔄 Come funziona
70
+ I percorsi esatti seguono la struttura di proprietà del tuo repository. I nuovi file compaiono in `git status`; le modifiche ai file tracciati compaiono in `git diff`.
68
71
 
69
- Quando un agente IA modifica il tuo codice, il lavoro non è finito. Truthmark installa una protezione di workflow a fine attività che gli agenti seguono prima della consegna:
72
+ La modalità di invocazione varia in base all’host. OpenCode usa `/skill truthmark-document`, Antigravity usa `@truthmark-document` e gli altri host supportati utilizzano la propria interfaccia nativa per skill o comandi slash. Consulta la [tabella delle piattaforme](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) per i comandi esatti.
70
73
 
71
- 1. 💻 **Codice:** l’agente modifica codice funzionale.
72
- 2. 🧪 **Test:** vengono eseguiti i test pertinenti.
73
- 3. 🔍 **Controllo:** Truthmark controlla la documentazione mappata come parte della revisione finale installata.
74
- 4. 📝 **Documentazione:** i docs vengono aggiornati dall’agente quando la verità del repository è cambiata.
75
- 5. 👀 **Revisione:** una persona revisiona il *diff di codice* + il *diff di verità*.
74
+ Per script e integrazione continua, passa esplicitamente le piattaforme selezionate:
76
75
 
77
- ## 🛠 Come interagisci con Truthmark
76
+ ```bash
77
+ truthmark init --platform codex --platform cursor
78
+ truthmark init --json
79
+ ```
78
80
 
79
- Truthmark ha un contratto locale al repository e due modi per usarlo.
81
+ Scegli `none` in modalità interattiva oppure esegui `truthmark init --clear-platforms` per ottenere un repository neutrale rispetto all’host. Puoi aggiungere piattaforme per agenti in seguito rieseguendo `truthmark init`.
80
82
 
81
- ### Gli esseri umani installano e validano il contratto
83
+ Per la diagnostica di aggiornamento relativa al branch, passa una base Git:
82
84
 
83
- Maintainer e CI usano la CLI:
85
+ ```bash
86
+ truthmark check --base <base-ref>
87
+ ```
84
88
 
85
- * `truthmark init` - crea o aggiorna la configurazione, consente di scegliere zero o più piattaforme e installa routing, scaffold dei documenti di verità e istruzioni per gli host selezionati.
86
- * `truthmark check` - valida la verità del repository dal terminale.
89
+ ## Come funziona Truthmark
87
90
 
88
- ### Gli agenti seguono il contratto mentre scrivono codice
91
+ <picture>
92
+ <source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
93
+ <img src="../assets/truthmark-workflow.svg" alt="Come funziona Truthmark" width="1440">
94
+ </picture>
89
95
 
90
- Truthmark installa istruzioni locali al repository per host di coding IA supportati come Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor.
96
+ L’interfaccia a riga di comando di Truthmark installa e convalida il contratto del repository. Il tuo agente di coding esegue la revisione delle evidenze e il lavoro di documentazione attraverso i workflow nativi dell’host installati.
91
97
 
92
- Il ciclo normale è semplice:
98
+ Una normale modifica al codice segue un ciclo semplice:
93
99
 
94
- 1. Chiedi al tuo agente una modifica al codice o di documentare un comportamento esistente.
95
- 2. Le istruzioni installate dicono all’agente quando testare, quando aggiornare i documenti di verità e quando fermarsi per la revisione umana.
96
- 3. Tu revisioni normali diff Git: codice più eventuali modifiche ai documenti di verità.
100
+ 1. L’agente modifica il codice funzionale.
101
+ 2. Vengono eseguiti i test pertinenti.
102
+ 3. Truth Sync controlla la documentazione mappata.
103
+ 4. L’agente crea o aggiorna documentazione e routing quando cambia la verità del repository.
104
+ 5. Revisioni insieme il diff del codice e il diff della verità.
97
105
 
98
- Le richieste agente avviate dall’utente sono intenzionalmente poche:
106
+ ## Workflow
99
107
 
100
- * `/truthmark-document` - documenta comportamento implementato esistente da codice e test.
101
- * `/truthmark-realize` - implementa codice da documenti di verità esistenti.
102
- * `/truthmark-check` - audita la verità del repository.
108
+ | Workflow | Quando usarlo | Risultato |
109
+ | -------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
110
+ | **Truth Document** | Il codice esistente ha bisogno di documentazione | Crea o aggiorna documentazione di prodotto e ingegneria basata su evidenze |
111
+ | **Truth Sync** | Il codice funzionale è cambiato | Mantiene allineati la documentazione mappata e il routing prima della consegna |
112
+ | **Truth Structure** | Una nuova area ha bisogno di proprietà o la documentazione esistente è troppo ampia | Crea percorsi delimitati e strutture iniziali per i documenti |
113
+ | **Truth Realize** | Un documento di verità approvato deve diventare software funzionante | Aggiorna il codice funzionale a partire dalla documentazione |
114
+ | **Truth Check** | La verità del repository deve essere sottoposta ad audit | Segnala problemi di routing, proprietà, evidenze e documentazione |
115
+ | **Truthmark Portal** | Il team desidera un sito di documentazione navigabile | Genera una presentazione HTML statica e versionata dai documenti di verità Markdown |
103
116
 
104
- Truth Sync non è il modo abituale per iniziare il lavoro; è la revisione finale dopo modifiche funzionali al codice.
105
- Truth Structure non è un comando quotidiano; ripara routing o ownership solo quando ciò blocca il lavoro.
117
+ Truthmark installa questi workflow come superfici native del repository per Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor.
106
118
 
107
119
  ## Cosa ottieni
108
120
 
109
- | Capacità | Cosa fa |
110
- | --- | --- |
111
- | Verità nativa di Git | Mantiene la verità del repository in Markdown e configurazione committati. |
112
- | Documentazione con ambito di branch | La verità si muove con il branch invece di vivere in una sessione privata. |
113
- | CLI umana | Offre ai maintainer comandi di setup, aggiornamento, validazione e ispezione. |
114
- | Guida agente installata | Dice agli agenti di coding quando documentare, testare, sincronizzare la verità, auditare o fermarsi per revisione. |
115
- | Routing esplicito | Mappa aree di codice a documenti di verità canonici. |
116
- | Consegne revisionabili | Produce normali diff Git sia per il codice sia per i documenti di verità. |
117
- | Operatività local-first | Non richiede servizi ospitati, daemon, database o server MCP. |
118
- | Confini di scrittura più sicuri | Separa workflow code-first, doc-first, read-only e doc-only. |
119
- | Validazione | Segnala problemi di routing, autorità, frontmatter, link, superfici generate, ambito di branch, freschezza e copertura. |
120
- | Portal opzionale | Genera, quando esplicitamente abilitato e richiesto, un sito statico HTML committato a partire da documenti di verità Markdown. |
121
-
122
- ## Panoramica visiva
123
-
124
- ![Funzionalità di Truthmark](../assets/truthmark-features.png)
125
-
126
- **Funzionalità:** cosa installa Truthmark e come è divisa la superficie di workflow.
121
+ ### Documentazione che parte dalla realtà
127
122
 
128
- ![Posizione di Truthmark](../assets/truthmark-position.png)
123
+ Truthmark può creare documentazione per funzionalità di prodotto, comportamento dell’implementazione, interfacce di programmazione delle applicazioni, architettura, workflow, operazioni e test. Codice e test forniscono le evidenze; documenti Markdown delimitati conservano il risultato.
129
124
 
130
- **Posizione:** dove Truthmark si colloca rispetto a prompt, memoria e workflow di specifica.
125
+ ### Documentazione che supera il cambiamento successivo
131
126
 
132
- ![Flusso di sincronizzazione di Truthmark](../assets/truthmark-syncflow.png)
127
+ I percorsi collegano le aree di codice ai documenti canonici. Quando gli agenti modificano il comportamento, Truth Sync sa dove deve risiedere la verità corrispondente e mantiene la consegna revisionabile.
133
128
 
134
- **Flusso di sincronizzazione:** come Truth Sync conclude le normali modifiche di codice prima della consegna.
129
+ ### Verità di prodotto e ingegneria su percorsi separati
135
130
 
136
- ## Perché i team lo adottano
131
+ La verità di prodotto raccoglie promesse rivolte agli utenti, limiti, decisioni e criteri di accettazione. La verità di ingegneria raccoglie comportamento corrente, contratti, architettura, workflow, operazioni e comportamento dei test.
137
132
 
138
- Truthmark è per team che sanno già che gli agenti IA possono generare codice.
133
+ ### Collaborazione nativa di Git
139
134
 
140
- Il problema successivo è la governance.
135
+ Tutto ciò che conta risiede in file versionati del repository. La verità segue il branch, funziona con normali pull request e rimane visibile a ogni maintainer e agente di coding.
141
136
 
142
- Non governance come cerimonia. Governance come una semplice domanda:
137
+ ### Operatività local-first
143
138
 
144
- > Dopo questa modifica assistita dall’IA, il repository dice ancora la verità?
145
-
146
- Truthmark aiuta i team a rispondere con file committati, routing esplicito e diff revisionabili.
147
-
148
- È utile quando hai bisogno di:
149
-
150
- - meno deriva della documentazione
151
- - consegne migliori
152
- - verità di prodotto specifica per branch
153
- - documentazione durevole di architettura e API
154
- - ownership esplicita tra docs e codice
155
- - confini di scrittura degli agenti più sicuri
156
- - documentazione revisionabile invece di memoria nascosta
157
- - guida agente che funziona ancora da file committati nel repository
139
+ Truthmark non richiede servizi ospitati, daemon, database, archivi vettoriali o server Model Context Protocol. Il repository contiene il proprio workflow di documentazione.
158
140
 
159
141
  ## Dove si colloca Truthmark
160
142
 
161
- Truthmark non sostituisce prompt, memoria, specifiche, test o code review.
162
-
163
- Offre a questi workflow un luogo durevole in cui atterrare in Git.
164
-
165
- | Esigenza | Scelta migliore |
166
- | --- | --- |
167
- | Output migliore da una sessione di agente | Prompt migliore |
168
- | Continuità personale o a livello di sessione | Strumento di memoria |
169
- | Lavoro su funzionalità guidato prima da un piano | Workflow di specifica |
170
- | Verità con ambito di branch che viaggia con il codice | Truthmark |
171
- | Validare la correttezza del comportamento | Test e revisione |
172
- | Revisionare modifiche di documentazione assistite dall’IA | Truthmark più revisione Git |
173
-
174
- La corsia di Truthmark è stretta per progettazione:
143
+ | Esigenza | Soluzione migliore |
144
+ | ------------------------------------------------------------- | ----------------------------- |
145
+ | Output migliore da una sessione di agente | Un prompt migliore |
146
+ | Continuità personale o a livello di sessione | Uno strumento di memoria |
147
+ | Sviluppo di funzionalità che parte da un piano | Un workflow di specifica |
148
+ | Documentazione con ambito di branch che viaggia con il codice | **Truthmark** |
149
+ | Correttezza del comportamento | Test e code review |
150
+ | Documentazione assistita dall’IA e revisionabile | **Truthmark + revisione Git** |
175
151
 
176
- ```text
177
- make repository truth explicit
178
- route it to code
179
- installare guida agente intorno a essa
180
- keep the result reviewable in Git
181
- ```
182
-
183
- ## Approfondisci
152
+ Truthmark è progettato per maintainer e team di ingegneria che usano già agenti di coding IA e vogliono che il repository continui a dire la verità con la stessa rapidità con cui cambia il codice.
184
153
 
185
- Il README è la vetrina: contesto rapido, avvio rapido e il modello mentale centrale.
154
+ ## Host supportati e riga di comando
186
155
 
187
- Per l’uso comando per comando, confronti tra superfici, dettagli sulle piattaforme supportate, configurazione, routing, Portal ed esempi, leggi la [guida utente di Truthmark](../user-guide.md).
156
+ Host per agenti supportati:
188
157
 
189
- ## Stato del progetto
158
+ - Codex
159
+ - Claude Code
160
+ - GitHub Copilot
161
+ - OpenCode
162
+ - Antigravity
163
+ - Cursor
190
164
 
191
- La release attuale fornisce:
165
+ <details>
166
+ <summary>Riferimento della riga di comando</summary>
192
167
 
193
- - comandi CLI locali per init, check, index, impact e stato dei workflow
194
- - istruzioni agente locali al repository generate per Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor
195
- - diagnostica su routing, autorità, frontmatter, link, freschezza, superfici generate, ambito di branch e copertura
196
- - documenti di verità con ambito di branch e artefatti derivati di intelligence del repository
168
+ | Comando | Scopo |
169
+ | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
170
+ | `truthmark init` | Crea o aggiorna configurazione, routing, template e workflow degli host selezionati |
171
+ | `truthmark check [--base <ref>]` | Convalida la verità del repository e, facoltativamente, esegue la diagnostica di aggiornamento del branch |
172
+ | `truthmark index --json` | Ispeziona i metadati derivati del repository e del routing |
173
+ | `truthmark impact --base <ref> --json` | Mappa i file modificati su documenti, proprietari e test vicini |
174
+ | `truthmark workflow status --workflow <id> [--base <ref>] --json` | Ispeziona applicabilità e obiettivi del workflow |
175
+ | `truthmark validate ...` | Convalida i report dei workflow e le concessioni di scrittura |
176
+ | `truthmark uninstall --dry-run` / `truthmark uninstall --apply` | Mostra in anteprima o rimuove le superfici host generate preservando la verità creata |
197
177
 
198
- ## Documentazione
178
+ L’output JSON strutturato è disponibile in tutta l’interfaccia a riga di comando per script e integrazione continua.
199
179
 
200
- - [Guida utente](../user-guide.md)
201
- - [Indice docs](../README.md)
202
- - [Panoramica dell’architettura](../truthmark/engineering/architecture/overview.md)
203
- - [Contratti API e CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
204
- - [Guida alla manutenzione della verità del repository](../standards/maintaining-repository-truth.md)
180
+ </details>
205
181
 
206
- Per i comandi di sviluppo locale e contribuzione, vedi [CONTRIBUTING.md](../../CONTRIBUTING.md).
182
+ ## Scopri di più
207
183
 
208
- ## Confini di progettazione
184
+ - [Guida utente di Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
185
+ - [Indice della documentazione](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
186
+ - [Panoramica dell’architettura](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
187
+ - [Contratti di configurazione, routing e comandi](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
188
+ - [Contribuire](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
209
189
 
210
- Truthmark è intenzionalmente piccolo: locale, committato, con ambito di branch e revisionabile.
211
-
212
- Non è un servizio ospitato, un server MCP, un database vettoriale, un livello di memoria nascosto, un prodotto di enforcement CI o un motore autonomo di riscrittura del codice. Aiuta la verità del repository a restare visibile; non sostituisce test, code review o giudizio umano.
190
+ **Installa Truthmark, seleziona il tuo host di coding e trasforma oggi stesso un comportamento reale in documentazione.**
213
191
 
214
192
  ## Licenza
215
193
 
216
194
  MIT. Vedi [LICENSE](../../LICENSE).
217
-
218
- ## Rimozione sicura
219
-
220
- Usa `truthmark uninstall --dry-run` per rivedere le superfici host generate con precisione, quindi `truthmark uninstall --apply` per rimuoverle. I truth creati, la configurazione, i template, l’output di Portal, i file Gemini e i file utente non correlati vengono preservati; rimuovi separatamente un’installazione npm globale con il tuo gestore pacchetti.