truthmark/README.es.md

Truthmark

Tus agentes escriben código. Truthmark hace que su contexto sea revisable en Git.

English | Deutsch | 中文 | Español | Русский

Los agentes de programación con IA pueden cambiar un repositorio más rápido de lo que las personas pueden mantener alineado su contexto.

Truthmark arregla la parte que normalmente se rompe después de escribir el código: la verdad del repositorio.

Instala una capa de flujo de trabajo nativa de Git y acotada a la rama que ayuda a los agentes de programación con IA a actualizar los documentos correctos, respetar los límites de propiedad y dejar a las personas diffs normales que puedan revisar.

Sin servicio alojado.

Sin base de datos.

Sin capa oculta de memoria.

Sin servidor adicional que operar.

Solo verdad del repositorio que se mueve con la rama.

El problema

Los agentes de programación con IA son buenos produciendo código. Eso crea un nuevo modo de fallo.

La implementación cambia, pero la historia del repositorio se desvía:

• el comportamiento vive en el historial de chat
• los documentos de arquitectura quedan atrás
• las decisiones de producto desaparecen después del traspaso
• quienes revisan ven diffs de código sin los diffs de verdad relacionados
• las ramas desarrollan silenciosamente distintas versiones de “lo que es verdad”
• cada sesión de agente tiene que redescubrir el contexto desde cero

Truthmark convierte ese contexto frágil en infraestructura del repositorio confirmada en Git.

En lugar de depender de que cada persona y cada agente recuerden el hábito correcto de documentación, Truthmark instala ese hábito en el repositorio.

La promesa

Cuando un agente cambia código funcional, el trabajo no debería terminar con solo un diff de código.

El camino normal de Truthmark es:

el agente cambia código funcional
se ejecutan pruebas relevantes
Truth Sync revisa los documentos de verdad asignados
los documentos de verdad se actualizan cuando hace falta
una persona revisa el diff de código + el diff de verdad
confirmar o traspasar

Ese es el valor central: el trabajo con IA es más fácil de confiar porque el repositorio sigue siendo legible.

Dos superficies, un sistema de verdad

Truthmark no es solo una CLI.

Tiene dos superficies distintas, y la distinción importa.

1. CLI orientada a personas

La CLI es para mantenedores, revisores y automatización.

Úsala para configurar un repositorio, instalar o refrescar archivos de flujo de trabajo, validar artefactos de verdad y generar contexto opcional para revisión.

truthmark config
truthmark init
truthmark check

La CLI prepara y valida el entorno del repositorio.

No es el runtime del flujo de trabajo con IA.

2. Superficies de flujo orientadas a IA

Las superficies orientadas a IA son para agentes de programación.

Truthmark instala skills, prompts, comandos, bloques de instrucciones administrados y superficies de subagentes nativos del host para que los agentes de IA puedan seguir flujos de verdad específicos del repositorio dentro de sus herramientas normales de programación.

Ejemplos:

/truthmark-sync
/truthmark-document
/truthmark-structure
/truthmark-realize
/truthmark-preview
/truthmark-check

Parecen comandos porque los hosts de agentes exponen flujos mediante slash commands, prompts, skills o comandos de proyecto.

No son comandos de shell.

Son puntos de entrada de flujo para IA.

La división es el producto:

las personas poseen el contrato del repositorio
Truthmark instala el contrato en el repo
los agentes operan dentro de ese contrato
las actualizaciones de verdad aparecen como diffs de Git
las personas revisan el resultado

Inicio rápido

Requisitos

• Node.js >=20
• npm
• un repositorio Git

Instalar Truthmark

Ejecuta esto dentro del repositorio que quieres inicializar:

cd /path/to/your-repo
npm install -g truthmark

Crear el contrato de verdad del repositorio

truthmark config

Esto crea:

.truthmark/config.yml

Revisa este archivo antes de continuar. Define el contrato de jerarquía confirmado en el repositorio.

Instalar las superficies de flujo

truthmark init

Esto instala o refresca:

• archivos de rutas
• scaffolding de documentos de verdad
• bloques de instrucciones administrados
• superficies de flujo orientadas a IA para las plataformas configuradas

Validar la configuración

truthmark check

Después revisa los archivos generados antes de confirmar.

Los archivos exactos dependen de .truthmark/config.yml, pero la instalación siempre tiene la misma forma: routing, truth scaffolding, instrucciones administradas compactas y superficies de workflow host-native para las plataformas habilitadas.

Primer uso real

La mayoría de los repositorios necesita una pasada de limpieza después de la inicialización.

El scaffold predeterminado empieza con un área amplia repository. Los repositorios reales suelen necesitar rutas más precisas.

Pide a tu agente que divida la ruta amplia en áreas reales de producto, servicio, dominio o propiedad:

/truthmark-structure divide el área amplia repository en auth, billing y notifications

Después usa tu agente de programación con IA normalmente.

Cuando el agente cambia código funcional, Truth Sync actúa como guarda de cierre que revisa si los documentos de verdad asignados deben cambiar antes del traspaso.

Qué obtienes

Capacidad	Qué hace
Verdad nativa de Git	Mantiene la verdad del repositorio en Markdown y config confirmados.
Contexto acotado a la rama	La verdad se mueve con la rama en lugar de vivir en una sesión privada.
CLI humana	Da a mantenedores comandos de configuración, refresco, validación e inspección.
Flujos orientados a IA	Da a los agentes flujos nativos del host para sincronización, documentación, estructura, preview, realización y auditoría.
Rutas explícitas	Mapea áreas de código a documentos de verdad canónicos.
Traspasos revisables	Produce diffs normales de Git para código y documentos de verdad.
Operación local-first	No requiere servicio alojado, demonio, base de datos ni servidor MCP.
Límites de escritura más seguros	Separa flujos code-first, doc-first, read-only y doc-only.
Validación	Reporta problemas de rutas, autoridad, frontmatter, enlaces, superficies generadas, alcance de rama, frescura y cobertura.
Portal opcional	Genera un sitio HTML estático confirmado desde documentos de verdad Markdown cuando se habilita y solicita explícitamente.

Resumen visual

Características: qué instala Truthmark y cómo se divide la superficie de flujo.

Posición: dónde encaja Truthmark frente a prompts, memoria y flujos de especificación.

Flujo de sync: cómo Truth Sync cierra cambios normales de código antes del traspaso.

Por qué los equipos lo adoptan

Truthmark es para equipos que ya saben que los agentes de IA pueden generar código.

El siguiente problema es la gobernanza.

No gobernanza como ceremonia. Gobernanza como una pregunta simple:

Después de este cambio asistido por IA, ¿el repositorio todavía dice la verdad?

Truthmark ayuda a los equipos a responder con archivos confirmados, rutas explícitas y diffs revisables.

Es útil cuando necesitas:

• menos deriva de documentación
• mejores traspasos
• verdad de producto específica de cada rama
• contexto duradero de arquitectura y API
• propiedad explícita entre documentos y código
• límites de escritura más seguros para agentes
• contexto revisable en lugar de memoria oculta
• flujos de IA que sigan funcionando desde archivos confirmados del repo

Dónde encaja Truthmark

Truthmark no reemplaza prompts, memoria, especificaciones, pruebas ni revisión de código.

Les da a esos flujos un lugar duradero donde aterrizar en Git.

Necesidad	Mejor opción
Mejor salida de una sesión de agente	Mejor prompt
Continuidad personal o por sesión	Herramienta de memoria
Trabajo de funciones plan-first	Flujo de especificación
Verdad acotada a la rama que viaja con el código	Truthmark
Validar la corrección del comportamiento	Pruebas y revisión
Revisar cambios de contexto asistidos por IA	Truthmark más revisión Git

El carril de Truthmark es estrecho por diseño:

hacer explícita la verdad del repositorio
mapearla al código
instalar flujos de agentes alrededor de ella
mantener el resultado revisable en Git

Cómo se ejecuta Truthmark

Truthmark se ejecuta localmente contra el worktree Git activo.

La CLI orientada a personas lee y escribe archivos del repositorio, y luego termina.

Las superficies de flujo orientadas a IA son archivos confirmados que los hosts de agentes pueden cargar después. Eso permite que los agentes sigan el flujo instalado desde el estado del repositorio, sin depender de un proceso de Truthmark en segundo plano.

Las capas encajan así:

flowchart LR
  Human["Human / CI"] --> CLI["Truthmark CLI"]
  CLI --> Config["Config y routing"]
  CLI --> Truth["Documentos truth canónicos"]
  CLI --> Surfaces["Workflows host-native generados"]
  Surfaces --> Hosts["Codex / Claude Code / Copilot / OpenCode / Gemini"]
  Hosts --> Worktree["Git worktree activo"]
  Hosts -->|"helper checks / validate / index"| CLI
  Worktree --> Truth

Los agentes no hablan con un daemon de Truthmark, pero pueden ejecutar la CLI instalada de Truthmark cuando un workflow pide validación, indexing o helper checks.

Truthmark es dueño de las superficies de workflow que genera, pero el contrato importante es arquitectónico: la config y el routing del repo apuntan a los agentes hacia los documentos truth canónicos, mientras que los workflows host-native dan a cada agente compatible una forma de ejecutar los mismos procedimientos de Truthmark.

Las superficies de flujo generadas incluyen marcadores de versión de Truthmark. Después de actualizar Truthmark, vuelve a ejecutar:

truthmark init

Luego revisa los diffs generados.

Plataformas de agentes compatibles

La configuración predeterminada incluye todas las plataformas compatibles.

Elimina de .truthmark/config.yml las plataformas que no uses, y luego vuelve a ejecutar:

truthmark init

Nombre de plataforma en config	Superficie generada	Forma de invocación
codex	.codex/skills/truthmark-*/, .codex/agents/	/truthmark-* o $truthmark-*
claude-code	.claude/skills/truthmark-*/, .claude/agents/, CLAUDE.md	/truthmark-*
github-copilot	.github/skills/truthmark-*/, .github/prompts/, .github/agents/, .github/copilot-instructions.md	/truthmark-* en IDEs de Copilot compatibles; agentes personalizados @truth-* en Copilot CLI
opencode	.opencode/skills/truthmark-*/, .opencode/agents/	/skill truthmark-*
gemini-cli	.gemini/skills/truthmark-*/, .gemini/commands/truthmark/, .gemini/agents/, GEMINI.md	/truthmark:*

Los nombres de plataforma desconocidos son errores de configuración.

Eliminar una plataforma detiene futuros refrescos para esa plataforma. No elimina archivos generados previamente.

Flujos orientados a IA

Estos flujos se instalan en hosts de programación con IA compatibles.

Los usan agentes o hosts de agentes durante el trabajo en el repositorio. No son comandos de shell de nivel superior.

Flujo	Dirección	Úsalo cuando	Límite de escritura
Truth Structure	topology-first	La ruta predeterminada es demasiado amplia, la propiedad abarca varias áreas o los archivos de rutas siguen apuntando a placeholders.	Crea o repara rutas y documentos de verdad iniciales.
Truth Document	implementation-first	El comportamiento ya existe en código, pero faltan o son débiles los documentos de verdad canónicos.	Escribe solo documentos de verdad y rutas. No debe cambiar código funcional.
Truth Sync	code-first	Cambió código funcional y puede que los documentos de verdad asignados deban actualizarse antes del traspaso.	Actualiza documentos de verdad. Truth Sync no debe reescribir código funcional.
Truth Preview	read-only	El agente necesita previsualizar rutas probables antes de editar.	Solo lee. No autoriza escrituras.
Truth Realize	doc-first	Documentos de verdad de producto o arquitectura lideran y el código debe actualizarse para coincidir.	Actualiza solo código. El agente no debe editar los documentos de verdad que está realizando.
Truth Check	audit-first	Un revisor o agente necesita auditar la salud de la verdad del repositorio.	Audita e informa.
Truthmark Portal	presentation-only	Una persona pide explícitamente un Portal HTML estático navegable sobre los documentos de verdad del repositorio.	Escribe solo archivos estáticos generados no canónicos bajo el directorio de salida Portal configurado.

Distinción importante

No confundas estas dos superficies:

Superficie	Usada por	Ejemplo	Significado
CLI humana	personas, scripts, checks tipo CI	truthmark check	Validar artefactos de verdad del repositorio desde la terminal.
Flujo orientado a IA	agentes de programación y hosts de agentes	/truthmark-check	Pedir a un agente que ejecute el flujo instalado de auditoría.

Los nombres están relacionados a propósito, pero las superficies son distintas.

Cambio normal de código asistido por IA

La mayoría de los usuarios no debería invocar Truth Sync manualmente cada vez.

Truth Sync es la guarda de cierre instalada para cambios de código funcional.

el agente cambia código funcional
el agente ejecuta o pide pruebas relevantes
el flujo instalado detecta que cambió código funcional
Truth Sync revisa los documentos de verdad asignados
el agente actualiza documentos de verdad si hace falta
una persona revisa el diff de código + el diff de verdad

La invocación directa sigue siendo útil para depurar, forzar una sincronización temprana o hacer explícito el traspaso:

/truthmark-sync sincroniza ahora la verdad del repositorio antes del traspaso

Comportamiento existente sin docs

Usa Truth Document cuando la implementación ya existe pero la verdad del repositorio está incompleta.

/truthmark-document documenta el comportamiento implementado de timeout de sesión bajo docs/truth/authentication

Truth Document inspecciona implementación, pruebas, archivos de rutas y documentación existente como evidencia.

Escribe solo documentos de verdad y rutas.

No debe cambiar código funcional.

Cambios doc-first

Usa Truth Realize cuando una decisión de producto o arquitectura empieza en documentos y el código debe actualizarse para coincidir.

/truthmark-realize realiza docs/truth/authentication/session-timeout.md como código

Truth Realize es doc-first.

Los documentos de verdad lideran. El código sigue.

El agente no debe editar los documentos de verdad que está realizando.

Preview de rutas de solo lectura

Usa Truth Preview antes de un cambio cuando el agente necesita entender la ruta probable.

/truthmark-preview previsualiza la ruta de verdad probable para cambios en la API de billing

Truth Preview es read-only.

Es una ayuda de selección y planificación, no una autorización de escritura ni un reemplazo de Truth Check.

Auditoría de verdad del repositorio

Usa Truth Check cuando quieres un flujo de auditoría orientado a agentes.

/truthmark-check audita rutas y cobertura de verdad antes de la revisión

Usa la CLI orientada a personas cuando quieres validación en terminal:

truthmark check

Ambas son útiles. No son la misma superficie.

Comandos CLI orientados a personas

La mayoría de los mantenedores empieza con tres comandos.

Comando	Propósito
truthmark config	Crea .truthmark/config.yml. Solo escribe ese archivo, salvo que se use --stdout.
truthmark init	Instala o refresca superficies de flujo configuradas desde la config revisada.
truthmark check	Valida configuración, autoridad, rutas, documentos con decisiones, frontmatter, enlaces internos, alcance de rama, superficies generadas, frescura y diagnósticos de cobertura.

Los ayudantes opcionales de inteligencia del repositorio generan contexto derivado para revisión sobre el checkout activo. Los paquetes de skill de flujo generados también pueden exponer manifests y policies de helpers que llaman a validadores CLI truthmark validate ... --json instalados; esos helpers son aceleradores, no scripts locales empaquetados en el repo ni fuentes de verdad. Los prompts independientes de Copilot y los comandos de Gemini usan el mismo contrato de validador CLI cuando el runner instalado está disponible; de lo contrario informan un estado de helper omitido visible y hacen validación manual.

No son fuentes de verdad.

Comando	Propósito
truthmark index	Construye JSON de RepoIndex y RouteMap para el checkout activo.
truthmark impact --base <ref>	Mapea archivos cambiados a documentos de verdad enrutados, rutas propietarias, pruebas cercanas y símbolos públicos.
truthmark context --workflow <workflow> [--base <ref>]	Genera un ContextPack acotado para Truth Sync, Truth Document o Truth Realize. Usa --format markdown para una versión legible por personas.

La salida estructurada está disponible con --json donde se admite.

Truthmark Portal

Truthmark Portal es un flujo opcional de presentación para equipos que quieren un sitio legible por personas sobre sus documentos de verdad confirmados.

Está separado deliberadamente del flujo central de verdad:

• Los documentos de verdad Markdown siguen siendo canónicos.
• El HTML Portal generado es solo presentación.
• Portal se ejecuta solo manualmente; no se ejecuta como puerta de finalización, paso de Truth Sync, paso de truthmark check ni hook automático post-change.
• Las escrituras de Portal permanecen dentro del directorio de salida configurado salvo que la persona cambie el alcance explícitamente.
• Las páginas generadas deben usar assets locales, procedencia de fuentes y un aviso visible de que Markdown es canónico.

Habilítalo con el bloque de configuración con espacio de nombres:

truthmark-portal:
  enabled: true
  output: docs/truthmark-portal
  template: default

Luego vuelve a ejecutar:

truthmark init

Cuando está habilitado, Truthmark instala superficies Portal host-native para las plataformas configuradas, como /truthmark-portal o /truthmark:portal según el host de agente.

Configuración

Truthmark es config-first.

El archivo principal de configuración es:

.truthmark/config.yml

Los repositorios nuevos deberían ejecutar:

truthmark config

Luego revisar la config generada antes de ejecutar:

truthmark init

Las áreas importantes de configuración incluyen:

Área de config	Propósito
version	Versión del contrato de configuración.
platforms	Hosts de agentes que deben recibir superficies generadas específicas de plataforma.
docs.layout	Modo actual de layout de documentación.
docs.roots	Raíces nombradas de documentación canónica.
docs.routing.root_index	Ruta del índice raíz de rutas.
docs.routing.area_files_root	Directorio para archivos de rutas secundarias delegadas.
docs.routing.default_area	Nombre base de la ruta secundaria inicial generada.
docs.routing.max_delegation_depth	Profundidad máxima actual de delegación de rutas.
truthmark-portal	Ajustes opcionales del flujo manual de presentación: enabled, output y template.
authority	Documentos canónicos y globs ordenados usados como autoridad de verdad del repositorio.
instruction_targets	Archivos que reciben bloques de instrucciones administrados compartidos, como AGENTS.md.
frontmatter.required	Campos de metadatos que producen diagnósticos de error cuando faltan.
frontmatter.recommended	Campos de metadatos que producen diagnósticos de revisión cuando faltan.
ignore	Patrones glob excluidos de checks relevantes y lógica de rutas.

Rutas de verdad del repositorio

Truthmark mapea superficies de código a documentos de verdad.

Los archivos principales de rutas son:

docs/truthmark/areas.md
docs/truthmark/areas/**/*.md

Una ruta le dice al agente:

• qué superficie de código pertenece a un área
• qué documentos de verdad poseen esa área
• cuándo debe actualizarse la verdad
• qué tipo de documento de verdad participa

El scaffold predeterminado empieza amplio. Los repositorios existentes suelen tener que dividir la ruta predeterminada en áreas reales de propiedad.

Ejemplo:

/truthmark-structure divide el área amplia repository en frontend, backend, billing y deployment

Un buen routing da a Truth Sync destinos precisos.

Un mal routing hace que los agentes adivinen.

Qué instala Truthmark

Truthmark instala una capa compacta de verdad nativa del repositorio.

Lo instala en cuatro capas:

• config y routing para límites de ownership
• documentos truth canónicos y plantillas iniciales
• bloques de instrucciones administrados y compactos para contexto de agente en todo el repo
• paquetes de workflow, comandos, prompts y agentes verificadores host-native para las plataformas habilitadas en la config

Truthmark conserva el contenido manual fuera de los bloques de instrucciones administrados.

Las superficies de flujo generadas son administradas por Truthmark y pueden refrescarse volviendo a ejecutar:

truthmark init

Subagentes y checks acotados de evidencia

Donde el host lo admite, Truthmark puede instalar agentes verificadores con alcance de proyecto y un truth-doc-writer con lease.

Ayudan a mantener acotadas las tareas grandes de verdad:

• route auditors inspeccionan la propiedad de rutas
• claim verifiers revisan si las afirmaciones de docs están respaldadas por evidencia
• doc reviewers inspeccionan la calidad de los documentos de verdad
• leased doc writers manejan shards acotados de escritura de documentos de verdad

El flujo padre sigue siendo dueño de la interpretación final, los límites de escritura, la validación del diff y la aceptación.

Esto es importante: los subagentes ayudan con trabajo acotado de evidencia. No reemplazan el contrato principal del flujo.

Bucle de revisión

Truthmark está diseñado para revisión normal en Git.

Un buen traspaso asistido por IA debería mostrar:

diff de código
evidencia de pruebas
diff de documentos de verdad, si hace falta
cambios de rutas, si hacen falta
informe del agente

Quien revisa debería poder responder:

• ¿Qué código cambió?
• ¿Qué documentos de verdad poseen ese código?
• ¿Esos documentos necesitaron actualizaciones?
• Si no, ¿por qué no?
• ¿El agente permaneció dentro del límite de escritura del flujo?
• ¿Se incluye evidencia de pruebas o verificación?

Ejemplos

Inicializar un repositorio

npm install -g truthmark
truthmark config
truthmark init
truthmark check

Quitar plataformas de agentes no usadas

Edita:

.truthmark/config.yml

Luego vuelve a ejecutar:

truthmark init
truthmark check

Dividir una ruta amplia

/truthmark-structure divide el área amplia repository en auth, billing, notifications y deployment

Documentar comportamiento implementado

/truthmark-document documenta el flujo implementado de restablecimiento de contraseña bajo docs/truth/authentication

Sincronizar después de cambios de código

/truthmark-sync sincroniza ahora la verdad del repositorio antes del traspaso

Realizar una decisión doc-first

/truthmark-realize realiza docs/truth/billing/invoice-retry-policy.md como código

Auditar la salud de verdad desde la terminal

truthmark check

Generar contexto de impacto de rama

truthmark impact --base main

Generar contexto de workflow

truthmark context --workflow truth-sync --base main --format markdown

Habilitar el flujo Portal opcional

truthmark-portal:
  enabled: true
  output: docs/truthmark-portal
  template: default

truthmark init

Luego pide explícitamente al host de agente que ejecute el flujo Portal instalado cuando quieras generar o refrescar el sitio estático de presentación.

Estado del proyecto

Truthmark V1 actualmente proporciona:

• truthmark config
• truthmark init
• truthmark check
• truthmark index
• truthmark impact
• truthmark context
• metadatos de alcance de rama
• bloques de instrucciones administrados
• superficies generadas de flujo Truth Structure
• superficies generadas de flujo Truth Document
• superficies generadas de flujo Truth Sync
• superficies generadas de flujo Truth Preview
• superficies generadas de flujo Truth Realize
• superficies generadas de flujo Truth Check
• superficies generadas opcionales de flujo Truthmark Portal
• diagnósticos de rutas, autoridad, estructura de decisiones, frontmatter, enlaces, frescura, superficies generadas y cobertura
• artefactos derivados RepoIndex, RouteMap, ImpactSet y ContextPack
• superficies específicas de host para Codex, Claude Code, GitHub Copilot, OpenCode y Gemini CLI

Desarrollo

Instalar dependencias:

npm install

Ejecutar la CLI local de desarrollo:

npm run dev -- init
npm run dev -- check

Ejecutar el check completo del proyecto:

npm run check

Scripts útiles:

Script	Propósito
npm run dev	Ejecuta el punto de entrada CLI en TypeScript con tsx.
npm run build	Construye el paquete.
npm run lint	Ejecuta ESLint.
npm run typecheck	Ejecuta checks de TypeScript.
npm run test	Ejecuta las pruebas.
npm run check	Ejecuta lint, typecheck, pruebas y build.
npm run release:check	Ejecuta validación orientada a release.

Cuando cambies Truthmark en sí, consulta CONTRIBUTORS.md.

Documentación

El README es el camino rápido para evaluación y configuración.

El comportamiento actual detallado vive bajo docs/:

• Índice de documentación
• Resumen de arquitectura
• Contratos de API y CLI
• Comportamiento de init y scaffold
• Diagnósticos de check
• Flujos instalados
• Guía para mantener la verdad del repositorio

Límites de diseño

Truthmark es intencionalmente pequeño.

No es:

• un servicio alojado
• un servidor MCP
• una base de datos vectorial
• un generador canónico de sitios de documentación o plataforma de docs alojada
• un producto de enforcement para CI o PR
• un reemplazo de pruebas, revisión de código o liderazgo técnico
• un motor autónomo de reescritura de código
• un framework de entrenamiento o fine-tuning de modelos
• una capa oculta de memoria

Esos límites son parte del producto.

Truthmark mantiene el flujo local, confirmado, acotado a la rama y revisable.

Seguridad y disciplina de revisión

Truthmark ayuda a que el repositorio se mantenga honesto. No prueba que el código sea correcto.

Los equipos deberían seguir:

• ejecutando pruebas relevantes
• revisando cambios de código funcional
• revisando cambios de documentos de verdad
• manteniendo secretos fuera de la documentación
• manteniendo instrucciones específicas del repositorio fuera de bloques administrados
• revisando diffs de superficies de flujo generadas después de upgrades
• conservando propiedad humana sobre decisiones de producto y arquitectura

Truthmark hace visible el contexto del agente. No reemplaza el juicio humano.

Dirección de la hoja de ruta

La dirección futura actual enfatiza:

• reportes de evidencia más fuertes en truthmark check
• ejemplos de adopción más claros
• repositorios de ejemplo que muestren ciclos reales de Truth Sync
• guías de migración para equipos que ya usan archivos de instrucciones para agentes
• pruebas de conformidad para superficies generadas de host
• pistas de verdad obsoleta conscientes de rutas
• checklists acotadas de implementación para trabajo doc-first

El centro de gravedad se mantiene igual:

verdad del repositorio
flujos nativos para agentes
revisión en Git
contexto acotado a la rama

Licencia

MIT. Consulta LICENSE.