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
- **Tus agentes escriben código. Truthmark mantiene documentación orientada a humanos y revisable en Git.**
3
+ **Tus agentes escriben código. Truthmark mantiene la documentación orientada a las personas y revisable en 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 instala flujos de trabajo nativos de Git que permiten a los agentes de programación con IA crear nueva documentación de producto e ingeniería a partir del código y las pruebas existentes, mantenerla actualizada después de cada cambio de código y ofrecerte diffs de Markdown convencionales para su revisión.
6
6
 
7
- ![Banner de Truthmark](../assets/truthmark-banner.png)
7
+ [![versión de 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
+ [![Licencia: 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
- ## 🚀 Inicio rápido: ejecutarlo localmente en cinco minutos
12
+ [Comenzar](#inicio-rápido-crea-tu-primer-documento-de-verdad) · [Sitio web](https://merlinhu1.github.io/truthmark/) · [Guía de usuario](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
10
13
 
11
- Ejecuta esto dentro del repositorio Git que quieres que Truthmark gestione:
14
+ <details>
15
+ <summary>Lee este README en 16 idiomas</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
- En una terminal interactiva, `truthmark init` muestra una selección múltiple numerada. Elige cero o más plataformas, o `none` para una configuración neutral respecto al host y solo de CLI.
19
+ </details>
22
20
 
23
- Para scripts y CI, repite `--platform`; `--json` nunca solicita entrada interactiva:
21
+ ## Crea los primeros documentos. Mantenlos fieles a la realidad.
24
22
 
25
- ```bash
26
- truthmark init --platform codex --platform cursor
27
- truthmark init --json
28
- ```
23
+ La mayoría de las herramientas de documentación se detienen después de generar contenido. Truthmark proporciona a los agentes un ciclo de vida completo para la documentación dentro de tu repositorio:
29
24
 
30
- En la primera ejecución no interactiva sin `--platform`, la configuración permanece neutral; las ejecuciones posteriores conservan la selección guardada en `.truthmark/config.yml`.
25
+ - **Crea documentación nueva a partir de software funcional.** Truth Document lee el código y las pruebas y, a continuación, crea documentación acotada de producto o ingeniería.
26
+ - **Mantén la documentación alineada automáticamente.** Truth Sync se ejecuta durante la entrega del agente después de cambios funcionales en el código y actualiza la verdad del repositorio antes de que finalice el trabajo.
27
+ - **Convierte la documentación de nuevo en código.** Truth Realize implementa documentos de verdad aprobados y conserva un flujo de trabajo limpio que parte de la documentación.
28
+ - **Repara la propiedad a medida que crece el código base.** Truth Structure crea rutas acotadas y documentos iniciales para áreas nuevas o sobrecargadas.
29
+ - **Revísalo todo en Git.** El código, las decisiones, los contratos, la arquitectura, las operaciones y el comportamiento viajan juntos en la rama.
31
30
 
32
- Ahora prueba la ruta de adopción más común: documentar un comportamiento existente a partir del código y las pruebas. En tu host de codificación con IA, pídele al workflow instalado:
31
+ Sin bases de conocimiento alojadas. Sin memoria privada de los agentes. Sin documentación atrapada en el historial del 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
+ ## Inicio rápido: crea tu primer documento de verdad
37
34
 
38
- Después de eso, normalmente los usuarios no deberían invocar Truth Sync directamente. Sigue programando mediante tu host de IA; las instrucciones instaladas en el repositorio le dicen al agente que ejecute las pruebas pertinentes y realice la revisión de Truth Sync antes de la entrega cuando haya cambios de código funcional. Tú revisas el diff de código resultante junto con el diff de los documentos de verdad.
35
+ **Requisitos:** Node.js 24 o posterior, un repositorio Git y un host de programación con IA compatible con flujos de trabajo de agentes.
39
36
 
40
- Si solo quieres validación por CLI, elige `none` y continúa con `truthmark check`; más tarde puedes volver a ejecutar `truthmark init` para seleccionar plataformas.
37
+ Ejecuta lo siguiente dentro del repositorio que quieres que gestione Truthmark:
41
38
 
42
- ## 💡 El problema: la brecha de documentación de la IA
39
+ ```bash
40
+ cd /path/to/your-repo
41
+ npm install -g truthmark
42
+ truthmark init
43
+ ```
43
44
 
44
- Los agentes de codificación con IA son increíbles escribiendo código rápidamente. Pero esa velocidad crea un nuevo modo de fallo peligroso: **la historia del repositorio se desvía de la realidad.**
45
+ `truthmark init` te permite seleccionar Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor o una configuración de interfaz de línea de comandos neutral respecto al host.
45
46
 
46
- * El comportamiento se pierde en historiales de chat efímeros.
47
- * Los documentos de arquitectura se quedan atrás rápidamente.
48
- * Las decisiones de producto desaparecen después de la entrega.
49
- * Los revisores de código acaban examinando diffs de código sin procesar, sin entender el «por qué».
50
- * Cada nueva sesión de IA se ve obligada a redescubrir desde cero la verdad de tu repositorio.
47
+ Ahora pide al agente configurado que documente un comportamiento real:
51
48
 
52
- ## 🎯 La solución: 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** instala en tu repositorio una capa de workflow nativa de Git. Arregla la parte del desarrollo con IA que normalmente se rompe: ayudar a que la documentación permanezca alineada con el código.
53
+ Truth Document crea un nuevo documento de verdad acotado cuando no existe ninguno, actualiza al propietario existente cuando ya lo hay y actualiza el enrutamiento cuando es necesario. No modifica el código funcional.
55
54
 
56
- En lugar de esperar que humanos y agentes de IA recuerden actualizar la documentación, Truthmark convierte la documentación en un hábito sistemático y revisable dentro de tu propio repositorio.
55
+ Revisa el resultado:
57
56
 
58
- ### ✨ Por qué Truthmark es único
57
+ ```bash
58
+ truthmark check
59
+ git status --short --untracked-files=all
60
+ git diff
61
+ ```
59
62
 
60
- Truthmark no es simplemente otra herramienta de documentación. Está profundamente integrado en el workflow de IA:
63
+ Ahora deberías tener:
61
64
 
62
- * **🚫 Sin dependencia de proveedor:** no hay servicios alojados, bases de datos ocultas ni servidores adicionales que operar.
63
- * **🌳 100 % nativo de Git:** todo vive en tu repositorio. La verdad se mueve con tu rama.
64
- * **🤝 Contrato propiedad de humanos y seguido por agentes:** Los mantenedores poseen el contrato del repositorio; los agentes siguen las instrucciones instaladas mientras programan.
65
- * **✅ Confianza mediante verificación:** el trabajo de la IA resulta más fácil de confiar porque el trabajo que cambia comportamiento incluye una decisión o un diff de documento de verdad revisable por humanos.
65
+ ```text
66
+ docs/truthmark/engineering/behaviors/session-timeout.md
67
+ docs/truthmark/routes/areas/authentication.md
68
+ ```
66
69
 
67
- ## 🔄 Cómo funciona
70
+ Las rutas exactas siguen la estructura de propiedad de tu repositorio. Los archivos nuevos aparecen en `git status`; los cambios en archivos con seguimiento aparecen en `git diff`.
68
71
 
69
- Cuando un agente de IA modifica tu código, el trabajo no ha terminado. Truthmark instala una protección de workflow al final de la tarea que los agentes siguen antes de la entrega:
72
+ La invocación varía según el host. OpenCode utiliza `/skill truthmark-document`, Antigravity utiliza `@truthmark-document` y los demás hosts compatibles emplean su superficie nativa de habilidades o comandos con barra. Consulta la [tabla de plataformas](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms) para conocer los comandos exactos.
70
73
 
71
- 1. 💻 **Código:** el agente modifica código funcional.
72
- 2. 🧪 **Prueba:** se ejecutan las pruebas pertinentes.
73
- 3. 🔍 **Comprobación:** Truthmark revisa la documentación mapeada como parte de la revisión de cierre instalada.
74
- 4. 📝 **Documentación:** el agente actualiza los docs cuando la verdad del repositorio ha cambiado.
75
- 5. 👀 **Revisión:** una persona revisa el *diff de código* + el *diff de verdad*.
74
+ Para scripts e integración continua, pasa explícitamente las plataformas seleccionadas:
76
75
 
77
- ## 🛠 Cómo interactúas con Truthmark
76
+ ```bash
77
+ truthmark init --platform codex --platform cursor
78
+ truthmark init --json
79
+ ```
78
80
 
79
- Truthmark tiene un contrato local del repositorio y dos formas de usarlo.
81
+ Elige `none` de forma interactiva o ejecuta `truthmark init --clear-platforms` para obtener un repositorio neutral respecto al host. Puedes añadir plataformas de agentes más adelante volviendo a ejecutar `truthmark init`.
80
82
 
81
- ### Las personas instalan y validan el contrato
83
+ Para diagnósticos de vigencia relativos a la rama, pasa una base de Git:
82
84
 
83
- Los mantenedores y CI usan la CLI:
85
+ ```bash
86
+ truthmark check --base <base-ref>
87
+ ```
84
88
 
85
- * `truthmark init` - crea o actualiza la configuración, permite elegir cero o más plataformas e instala el enrutamiento, los andamios de documentos de verdad y las instrucciones de los hosts elegidos.
86
- * `truthmark check` - valida la verdad del repositorio desde la terminal.
89
+ ## Cómo funciona Truthmark
87
90
 
88
- ### Los agentes siguen el contrato mientras programan
91
+ <picture>
92
+ <source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
93
+ <img src="../assets/truthmark-workflow.svg" alt="Cómo funciona Truthmark" width="1440">
94
+ </picture>
89
95
 
90
- Truthmark instala instrucciones locales del repositorio para hosts de codificación con IA compatibles, como Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity y Cursor.
96
+ La interfaz de línea de comandos de Truthmark instala y valida el contrato del repositorio. Tu agente de programación realiza la revisión de evidencias y el trabajo de documentación mediante los flujos de trabajo nativos del host instalados.
91
97
 
92
- El ciclo normal es simple:
98
+ Un cambio de código normal sigue un ciclo sencillo:
93
99
 
94
- 1. Pide a tu agente un cambio de código o que documente un comportamiento existente.
95
- 2. Las instrucciones instaladas le dicen al agente cuándo probar, cuándo actualizar documentos de verdad y cuándo detenerse para revisión humana.
96
- 3. Revisas diffs Git normales: código más cualquier cambio en documentos de verdad.
100
+ 1. El agente modifica el código funcional.
101
+ 2. Se ejecutan las pruebas pertinentes.
102
+ 3. Truth Sync comprueba la documentación asociada.
103
+ 4. El agente crea o actualiza la documentación y el enrutamiento cuando cambia la verdad del repositorio.
104
+ 5. Revisas juntos el diff de código y el diff de verdad.
97
105
 
98
- Las solicitudes de agente iniciadas por el usuario son deliberadamente pocas:
106
+ ## Flujos de trabajo
99
107
 
100
- * `/truthmark-document` - documenta comportamiento implementado existente a partir de código y tests.
101
- * `/truthmark-realize` - implementa código a partir de documentos de verdad existentes.
102
- * `/truthmark-check` - audita la verdad del repositorio.
108
+ | Flujo de trabajo | Cuándo usarlo | Resultado |
109
+ | -------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
110
+ | **Truth Document** | El código existente necesita documentación | Crea o actualiza documentación de producto e ingeniería respaldada por evidencias |
111
+ | **Truth Sync** | Ha cambiado el código funcional | Mantiene alineados la documentación asociada y el enrutamiento antes de la entrega |
112
+ | **Truth Structure** | Un área nueva necesita propiedad o la documentación existente es demasiado amplia | Crea rutas acotadas y documentos iniciales básicos |
113
+ | **Truth Realize** | Un documento de verdad aprobado debe convertirse en software funcional | Actualiza el código funcional a partir de la documentación |
114
+ | **Truth Check** | La verdad del repositorio necesita una auditoría | Informa de problemas de enrutamiento, propiedad, evidencias y documentación |
115
+ | **Truthmark Portal** | El equipo quiere un sitio de documentación navegable | Genera una presentación HTML estática y versionada a partir de documentos de verdad en Markdown |
103
116
 
104
- Truth Sync no es la forma habitual de iniciar trabajo; es la revisión de cierre después de cambios funcionales de código.
105
- Truth Structure no es un comando cotidiano; repara enrutamiento o propiedad solo cuando eso bloquea el trabajo.
117
+ Truthmark instala estos flujos de trabajo como superficies nativas del repositorio para Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity y Cursor.
106
118
 
107
119
  ## Lo que obtienes
108
120
 
109
- | Capacidad | Qué hace |
110
- | --- | --- |
111
- | Verdad nativa de Git | Mantiene la verdad del repositorio en Markdown y configuración versionados. |
112
- | Documentación con alcance de rama | La verdad se mueve con la rama en lugar de vivir en una sesión privada. |
113
- | CLI humana | Da a los mantenedores comandos de configuración, actualización, validación e inspección. |
114
- | Guía de agente instalada | Indica a los agentes de codificación cuándo documentar, probar, sincronizar verdad, auditar o detenerse para revisión. |
115
- | Enrutamiento explícito | Mapea áreas de código a documentos de verdad canónicos. |
116
- | Entregas revisables | Produce diffs Git ordinarios tanto para el código como para los documentos de verdad. |
117
- | Operación local-first | No requiere servicio alojado, demonio, base de datos ni servidor MCP. |
118
- | Límites de escritura más seguros | Separa workflows code-first, doc-first, read-only y doc-only. |
119
- | Validación | Informa problemas de enrutamiento, autoridad, frontmatter, enlaces, superficies generadas, alcance de rama, frescura y cobertura. |
120
- | Portal opcional | Genera, cuando se activa y solicita explícitamente, un sitio estático HTML versionado a partir de documentos de verdad Markdown. |
121
-
122
- ## Panorama visual
123
-
124
- ![Funciones de Truthmark](../assets/truthmark-features.png)
125
-
126
- **Funciones:** lo que instala Truthmark y cómo se divide la superficie de workflow.
121
+ ### Documentación que parte de la realidad
127
122
 
128
- ![Posición de Truthmark](../assets/truthmark-position.png)
123
+ Truthmark puede crear documentación sobre capacidades del producto, comportamiento de la implementación, interfaces de programación de aplicaciones, arquitectura, flujos de trabajo, operaciones y pruebas. El código y las pruebas aportan las evidencias; los documentos Markdown acotados conservan el resultado.
129
124
 
130
- **Posición:** dónde encaja Truthmark en relación con prompts, memoria y workflows de especificación.
125
+ ### Documentación que sobrevive al siguiente cambio
131
126
 
132
- ![Flujo de sincronización de Truthmark](../assets/truthmark-syncflow.png)
127
+ Las rutas conectan áreas del código con documentos canónicos. Cuando los agentes cambian el comportamiento, Truth Sync sabe dónde debe quedar registrada la verdad correspondiente y mantiene la entrega lista para revisión.
133
128
 
134
- **Flujo de sincronización:** cómo Truth Sync cierra los cambios de código normales antes de la entrega.
129
+ ### La verdad de producto e ingeniería en carriles separados
135
130
 
136
- ## Por qué los equipos lo adoptan
131
+ La verdad de producto recoge promesas orientadas al usuario, límites, decisiones y criterios de aceptación. La verdad de ingeniería recoge el comportamiento actual, los contratos, la arquitectura, los flujos de trabajo, las operaciones y el comportamiento de las pruebas.
137
132
 
138
- Truthmark es para equipos que ya saben que los agentes de IA pueden generar código.
133
+ ### Colaboración nativa de Git
139
134
 
140
- El siguiente problema es la gobernanza.
135
+ Todo lo importante reside en archivos versionados del repositorio. La verdad sigue a la rama, funciona con solicitudes de incorporación de cambios convencionales y permanece visible para cada mantenedor y agente de programación.
141
136
 
142
- No la gobernanza como ceremonia. Gobernanza como una pregunta sencilla:
137
+ ### Operación local primero
143
138
 
144
- > Después de este cambio asistido por IA, ¿el repositorio sigue diciendo la verdad?
145
-
146
- Truthmark ayuda a los equipos a responder con archivos versionados, enrutamiento explícito y diffs revisables.
147
-
148
- Es útil cuando necesitas:
149
-
150
- - menos deriva de documentación
151
- - mejores entregas
152
- - verdad de producto específica de la rama
153
- - documentación duradera de arquitectura y API
154
- - propiedad explícita entre docs y código
155
- - límites de escritura de agentes más seguros
156
- - documentación revisable en lugar de memoria oculta
157
- - guía de agente que sigue funcionando desde archivos versionados del repositorio
139
+ Truthmark no necesita servicios alojados, demonios, bases de datos, almacenes vectoriales ni servidores del Protocolo de Contexto de Modelo. El repositorio contiene su propio flujo de trabajo de documentación.
158
140
 
159
141
  ## Dónde encaja Truthmark
160
142
 
161
- Truthmark no reemplaza prompts, memoria, especificaciones, pruebas ni revisión de código.
162
-
163
- Les da a esos workflows un lugar duradero donde aterrizar en Git.
164
-
165
- | Necesidad | Mejor opción |
166
- | --- | --- |
167
- | Mejor salida de una sesión de agente | Mejor prompt |
168
- | Continuidad personal o a nivel de sesión | Herramienta de memoria |
169
- | Trabajo de funcionalidad con plan primero | Workflow de especificación |
170
- | Verdad con alcance de rama que viaja con el código | Truthmark |
171
- | Validar la corrección del comportamiento | Pruebas y revisión |
172
- | Revisar cambios de documentación asistidos por IA | Truthmark más revisión Git |
173
-
174
- El carril de Truthmark es estrecho por diseño:
143
+ | Necesidad | Mejor opción |
144
+ | ------------------------------------------------------- | ------------------------------------- |
145
+ | Mejor resultado de una sesión de agente | Un prompt mejor |
146
+ | Continuidad personal o a nivel de sesión | Una herramienta de memoria |
147
+ | Desarrollo de funcionalidades partiendo de un plan | Un flujo de trabajo de especificación |
148
+ | Documentación acotada a la rama que viaja con el código | **Truthmark** |
149
+ | Corrección del comportamiento | Pruebas y revisión de código |
150
+ | Documentación asistida por IA y revisable | **Truthmark + revisión en Git** |
175
151
 
176
- ```text
177
- make repository truth explicit
178
- route it to code
179
- instalar guía de agente alrededor de ella
180
- keep the result reviewable in Git
181
- ```
182
-
183
- ## Profundizar
152
+ Truthmark está diseñado para mantenedores y equipos de ingeniería que ya utilizan agentes de programación con IA y quieren que el repositorio siga diciendo la verdad con la misma rapidez con la que cambia el código.
184
153
 
185
- El README es el escaparate: contexto rápido, inicio rápido y el modelo mental central.
154
+ ## Hosts compatibles y línea de comandos
186
155
 
187
- Para uso comando por comando, comparaciones de superficies, detalles de plataformas compatibles, configuración, enrutamiento, Portal y ejemplos, lee la [guía de usuario de Truthmark](../user-guide.md).
156
+ Hosts de agentes compatibles:
188
157
 
189
- ## Estado del proyecto
158
+ - Codex
159
+ - Claude Code
160
+ - GitHub Copilot
161
+ - OpenCode
162
+ - Antigravity
163
+ - Cursor
190
164
 
191
- La versión actual proporciona:
165
+ <details>
166
+ <summary>Referencia de la línea de comandos</summary>
192
167
 
193
- - comandos CLI locales para init, check, index, impact y estado de workflows
194
- - instrucciones de agente locales del repositorio generadas para Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity y Cursor
195
- - diagnósticos de enrutamiento, autoridad, frontmatter, enlaces, frescura, superficies generadas, alcance de rama y cobertura
196
- - documentos de verdad con alcance de rama y artefactos derivados de inteligencia del repositorio
168
+ | Comando | Propósito |
169
+ | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
170
+ | `truthmark init` | Crea o actualiza la configuración, el enrutamiento, las plantillas y los flujos de trabajo de los hosts seleccionados |
171
+ | `truthmark check [--base <ref>]` | Valida la verdad del repositorio y, opcionalmente, ejecuta diagnósticos de vigencia de la rama |
172
+ | `truthmark index --json` | Inspecciona los metadatos derivados del repositorio y del enrutamiento |
173
+ | `truthmark impact --base <ref> --json` | Asocia los archivos modificados con la documentación, los propietarios y las pruebas cercanas |
174
+ | `truthmark workflow status --workflow <id> [--base <ref>] --json` | Inspecciona la aplicabilidad y los objetivos del flujo de trabajo |
175
+ | `truthmark validate ...` | Valida los informes de los flujos de trabajo y las concesiones de escritura |
176
+ | `truthmark uninstall --dry-run` / `truthmark uninstall --apply` | Previsualiza o elimina las superficies de host generadas sin alterar la verdad creada |
197
177
 
198
- ## Documentación
178
+ La salida JSON estructurada está disponible en toda la interfaz de línea de comandos para scripts e integración continua.
199
179
 
200
- - [Guía de usuario](../user-guide.md)
201
- - [Índice de docs](../README.md)
202
- - [Vista general de arquitectura](../truthmark/engineering/architecture/overview.md)
203
- - [Contratos de API y CLI](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
204
- - [Guía de mantenimiento de la verdad del repositorio](../standards/maintaining-repository-truth.md)
180
+ </details>
205
181
 
206
- Para comandos de desarrollo local y contribución, consulta [CONTRIBUTING.md](../../CONTRIBUTING.md).
182
+ ## Más información
207
183
 
208
- ## Límites de diseño
184
+ - [Guía de usuario de Truthmark](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
185
+ - [Índice de documentación](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
186
+ - [Descripción general de la arquitectura](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
187
+ - [Contratos de configuración, enrutamiento y comandos](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
188
+ - [Contribuir](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
209
189
 
210
- Truthmark es intencionadamente pequeño: local, versionado, con alcance de rama y revisable.
211
-
212
- No es un servicio alojado, servidor MCP, base de datos vectorial, capa de memoria oculta, producto de aplicación de CI ni motor autónomo de reescritura de código. Ayuda a que la verdad del repositorio permanezca visible; no reemplaza pruebas, revisión de código ni juicio humano.
190
+ **Instala Truthmark, selecciona tu host de programación y convierte hoy un comportamiento real en documentación.**
213
191
 
214
192
  ## Licencia
215
193
 
216
194
  MIT. Consulta [LICENSE](../../LICENSE).
217
-
218
- ## Eliminación segura
219
-
220
- Use `truthmark uninstall --dry-run` para revisar las superficies de host generadas exactas, luego `truthmark uninstall --apply` para eliminarlas. Los truth creados, la configuración, las plantillas, la salida de Portal, los archivos de Gemini y los archivos de usuario no relacionados se conservan; quite una instalación global de npm por separado con su gestor de paquetes.