truthmark 1.3.0 → 1.5.0

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.
Files changed (8) hide show
  1. package/README.de.md +619 -189
  2. package/README.es.md +620 -190
  3. package/README.md +611 -188
  4. package/README.ru.md +628 -198
  5. package/README.zh.md +626 -194
  6. package/dist/main.js +2130 -178
  7. package/dist/main.js.map +1 -1
  8. package/package.json +1 -1
package/README.ru.md CHANGED
@@ -1,294 +1,640 @@
1
1
  # Truthmark
2
2
 
3
- **Truthmark устанавливает рабочие процессы истины репозитория для разработки ПО с ИИ.**
3
+ **Ваши агенты пишут код. Truthmark делает их контекст проверяемым в Git.**
4
4
 
5
5
  [English](README.md) | [Deutsch](README.de.md) | [中文](README.zh.md) | [Español](README.es.md) | Русский
6
6
 
7
- <img src="docs/assets/truthmark-banner.png" alt="Баннер Truthmark" width="100%" />
7
+ ![Баннер Truthmark](docs/assets/truthmark-banner.png)
8
8
 
9
- ИИ-агенты уже быстро пишут код. Дорогая часть — удерживать истину репозитория в соответствии с тем, что реально изменилось.
9
+ ИИ-агенты для разработки могут менять репозиторий быстрее, чем люди успевают выравнивать его контекст.
10
10
 
11
- Truthmark добавляет в этот процесс финальную защиту на уровне рабочего процесса. Обычный путь прост:
11
+ Truthmark чинит ту часть, которая обычно ломается после написания кода: истину репозитория.
12
12
 
13
- - агент меняет функциональный код
14
- - запускаются релевантные тесты
15
- - установленный рабочий процесс Truth Sync обновляет связанные документы истины до завершения работы агента
16
- - если был создан diff документов истины, его проверяют
13
+ Он устанавливает Git-native, ограниченный веткой слой рабочего процесса, который помогает ИИ-агентам обновлять правильные документы, соблюдать границы владения и оставлять людям обычные diff для ревью.
17
14
 
18
- Большинство инструментов просит команды выработать привычку. Truthmark превращает эту привычку в инфраструктуру рабочего процесса репозитория.
15
+ Без размещенного сервиса.
19
16
 
20
- Truthmark превращает ИИ-процесс в инфраструктуру репозитория, а не в персональный инструмент. Он устанавливает Git-native слой истины внутри репозитория, задает агентам явную маршрутизацию и ограниченные рабочие поверхности и сохраняет эту истину проверяемой в Git вместо того, чтобы разносить ее по истории промптов, устаревшей документации или приватному состоянию инструментов.
17
+ Без базы данных.
21
18
 
22
- Это важно, потому что процесс живет вместе с веткой. После инициализации репозитория правила, маршрутизация и установленные рабочие поверхности путешествуют внутри репозитория, поэтому совместная работа и передача задач меньше зависят от локальной настройки одного человека.
19
+ Без скрытого слоя памяти.
23
20
 
24
- Для команд, которые уже знают, что агенты умеют генерировать код, Truthmark решает следующую проблему: как сделать так, чтобы сам репозиторий оставался понятным, проверяемым и управляемым по мере роста ИИ-ассистированной разработки.
21
+ Без дополнительного сервера в эксплуатации.
25
22
 
26
- ## Визуальный обзор
23
+ Только истина репозитория, которая движется вместе с веткой.
27
24
 
28
- <table>
29
- <tr>
30
- <td align="center" width="50%">
31
- <img src="docs/assets/truthmark-features.png" alt="Возможности Truthmark" width="100%" />
32
- <br><strong>Возможности</strong><br>
33
- Что устанавливает Truthmark и как устроена рабочая поверхность.
34
- </td>
35
- <td align="center" width="50%">
36
- <img src="docs/assets/truthmark-position.png" alt="Позиционирование Truthmark" width="100%" />
37
- <br><strong>Позиционирование</strong><br>
38
- Где Truthmark находится относительно промптов, памяти и spec-first процессов.
39
- </td>
40
- </tr>
41
- <tr>
42
- <td align="center" colspan="2">
43
- <img src="docs/assets/truthmark-syncflow.png" alt="Поток sync в Truthmark" width="100%" />
44
- <br><strong>Поток sync</strong><br>
45
- Как Truth Sync закрывает обычные изменения кода перед передачей работы.
46
- </td>
47
- </tr>
48
- </table>
49
-
50
- ## Почему команды выбирают Truthmark
51
-
52
- Truthmark не пытается сделать так, чтобы агенты звучали умнее. Он пытается сделать изменения в репозитории, выполненные с помощью ИИ, более надежными.
53
-
54
- - Установленный Truth Sync после изменений кода превращает поддержку документации в защиту рабочего процесса, а не в командную привычку.
55
- - Истина, ограниченная веткой, движется вместе с кодом, поэтому ревьюеры могут проверять актуальную истину в обычных Git diff.
56
- - Рабочие поверхности, встроенные в репозиторий, упрощают внедрение и делают передачу работы устойчивее, чем одна лишь персональная настройка.
57
- - Явная маршрутизация в `docs/truthmark/areas.md` и делегированных дочерних файлах маршрутов дает агентам границы ответственности и более безопасные пути записи.
58
- - Local-first работа избавляет от зависимости на демон, базу данных, удаленный сервис или MCP.
59
- - Модель маршрутизации не зависит от языка и дает диагностику покрытия для распространенных поверхностей кода JavaScript, TypeScript, Go, Python, C# и Java.
60
-
61
- Для технических лидеров ценность в управлении без дополнительной инфраструктуры: тесты, ревью кода и владение зонами ответственности по-прежнему делают основную работу; Truthmark делает контекст агента долговечным, проверяемым и ограниченным веткой.
25
+ ## Проблема
62
26
 
63
- ## Где уместен Truthmark
27
+ ИИ-агенты для разработки хорошо создают код. Это порождает новый режим отказа.
28
+
29
+ Реализация меняется, но история репозитория начинает расходиться:
30
+
31
+ - поведение живет в истории чата
32
+ - архитектурные документы отстают
33
+ - продуктовые решения исчезают после передачи работы
34
+ - ревьюеры видят diff кода без связанных diff истины
35
+ - ветки незаметно развивают разные версии того, «что является правдой»
36
+ - каждой сессии агента приходится заново открывать контекст
37
+
38
+ Truthmark превращает этот хрупкий контекст в зафиксированную инфраструктуру репозитория.
64
39
 
65
- Truthmark не является универсальным набором ИИ-инструментов для продуктивности. Он занимает конкретный слой в стеке: проверяемая истина репозитория, ограниченная веткой и выровненная с реализацией.
40
+ Вместо надежды на то, что каждый человек и каждый агент вспомнят правильную привычку документирования, Truthmark устанавливает эту привычку в репозиторий.
66
41
 
67
- | Если вам нужно | Лучший выбор |
68
- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
69
- | Лучшие результаты в одной сессии разработки | Более точные промпты и лучше очерченная задача |
70
- | Удобная преемственность между сессиями для одного агента или оператора | Инструменты памяти |
71
- | Spec-first планирование новых функций | Инструменты спецификаций, например Spec Kit |
72
- | Проверяемая истина репозитория с областью действия в пределах ветки, которая идет вместе с кодом | Truthmark |
42
+ ## Обещание
73
43
 
74
- Смысл не в том, что промпты, память или спецификации бесполезны. Смысл в том, что ни один из этих подходов сам по себе не превращает истину репозитория в зафиксированный в Git, проверяемый актив, который переживает передачу работы, ревью и расхождение веток.
44
+ Когда агент меняет функциональный код, работа не должна заканчиваться только diff кода.
75
45
 
76
- ## Содержание
46
+ Обычный путь Truthmark:
47
+
48
+ ```text
49
+ агент меняет функциональный код
50
+ запускаются релевантные тесты
51
+ Truth Sync проверяет сопоставленные документы истины
52
+ документы истины обновляются при необходимости
53
+ человек проверяет diff кода + diff истины
54
+ коммит или передача работы
55
+ ```
77
56
 
78
- - [Почему команды выбирают Truthmark](#почему-команды-выбирают-truthmark)
79
- - [Что решает Truthmark](#что-решает-truthmark)
80
- - [Где уместен Truthmark](#где-уместен-truthmark)
81
- - [Начало работы](#начало-работы)
82
- - [Как он работает](#как-он-работает)
83
- - [Что он устанавливает](#что-он-устанавливает)
84
- - [Команды](#команды)
85
- - [Зачем он существует](#зачем-он-существует)
86
- - [Статус проекта](#статус-проекта)
87
- - [Документация](#документация)
88
- - [Не-цели](#не-цели)
89
- - [Лицензия](#лицензия)
57
+ Главная ценность такова: **ИИ-работе легче доверять, потому что репозиторий остается понятным.**
90
58
 
91
- ## Что решает Truthmark
59
+ ## Две поверхности, одна система истины
92
60
 
93
- Truthmark превращает истину репозитория в явную рабочую поверхность для агентов:
61
+ Truthmark — это не только CLI.
94
62
 
95
- - `.truthmark/config.yml` определяет зафиксированный контракт иерархии.
96
- - `docs/truthmark/areas.md` и делегированные дочерние файлы маршрутов сопоставляют области кода с документами, которые за них отвечают.
97
- - Truth Document создает или исправляет канонические документы истины для уже реализованного поведения, когда изменение кода не нужно.
98
- - Truth Sync поддерживает синхронизацию сопоставленных документов истины при функциональных изменениях.
99
- - Truth Realize дает изменениям, начинающимся с документации, ограниченный путь для обновления кода.
100
- - `truthmark check` валидирует получившиеся артефакты истины.
101
- - Вся модель остается local-first и Git-native.
63
+ У него две разные поверхности, и это различие важно.
102
64
 
103
- Главное обещание такое: контекст агента становится зафиксированным состоянием репозитория, а не приватным артефактом отдельной сессии.
65
+ ### 1. CLI для людей
104
66
 
105
- ## Начало работы
67
+ CLI предназначен для мейнтейнеров, ревьюеров и автоматизации.
106
68
 
107
- Установите Truthmark в репозитории, который хотите инициализировать:
69
+ Используйте его, чтобы настроить репозиторий, установить или обновить файлы рабочих процессов, проверить артефакты истины и создать дополнительный контекст для ревью.
108
70
 
109
71
  ```bash
110
- cd /path/to/your-repo
111
- npm install -g truthmark
112
72
  truthmark config
113
73
  truthmark init
114
74
  truthmark check
115
75
  ```
116
76
 
117
- Если вы хотите попробовать еще не выпущенные изменения из исходного checkout:
77
+ CLI подготавливает и валидирует среду репозитория.
78
+
79
+ Он не является runtime для ИИ-рабочего процесса.
80
+
81
+ ### 2. Поверхности рабочих процессов для ИИ
82
+
83
+ Поверхности для ИИ предназначены для coding agents.
84
+
85
+ Truthmark устанавливает host-native skills, prompts, commands, управляемые блоки инструкций и поддерживаемые поверхности subagents, чтобы ИИ-агенты могли следовать специфичным для репозитория truth-workflows внутри своих обычных инструментов разработки.
86
+
87
+ Примеры:
88
+
89
+ ```text
90
+ /truthmark-sync
91
+ /truthmark-document
92
+ /truthmark-structure
93
+ /truthmark-realize
94
+ /truthmark-preview
95
+ /truthmark-check
96
+ ```
97
+
98
+ Они выглядят как команды, потому что agent hosts раскрывают workflows через slash commands, prompts, skills или project commands.
99
+
100
+ Это не shell-команды.
101
+
102
+ Это точки входа workflow для ИИ.
103
+
104
+ Разделение и есть продукт:
105
+
106
+ ```text
107
+ люди владеют контрактом репозитория
108
+ Truthmark устанавливает контракт в repo
109
+ агенты работают внутри этого контракта
110
+ обновления истины появляются как Git diff
111
+ люди проверяют результат
112
+ ```
113
+
114
+ ## Быстрый старт
115
+
116
+ ### Требования
117
+
118
+ - Node.js `>=20`
119
+ - npm
120
+ - Git-репозиторий
121
+
122
+ ### Установить Truthmark
123
+
124
+ Выполните это внутри репозитория, который хотите инициализировать:
118
125
 
119
126
  ```bash
120
- cd /path/to/truthmark
121
- npm install
122
- npm run build
123
127
  cd /path/to/your-repo
124
- node /path/to/truthmark/dist/main.js config
125
- node /path/to/truthmark/dist/main.js init
126
- node /path/to/truthmark/dist/main.js check
128
+ npm install -g truthmark
127
129
  ```
128
130
 
129
- Проверьте `.truthmark/config.yml` перед `init`; это зафиксированный в Git контракт иерархии. После `init` проверьте сгенерированную рабочую поверхность и файлы маршрутов, чтобы маршрутизированная документация действительно совпадала с документами, которые отвечают за ваш код:
131
+ ### Создать контракт истины репозитория
132
+
133
+ ```bash
134
+ truthmark config
135
+ ```
136
+
137
+ Это создает:
130
138
 
131
139
  ```text
132
140
  .truthmark/config.yml
133
- docs/truthmark/areas.md
134
- docs/truthmark/areas/repository.md
135
- docs/templates/behavior-doc.md
136
- docs/truth/README.md
137
- docs/truth/repository/README.md
138
- docs/truth/repository/overview.md
139
- AGENTS.md
140
- CLAUDE.md
141
- GEMINI.md
142
141
  ```
143
142
 
144
- Поддерживаемые платформы: `codex`, `opencode`, `claude-code`, `github-copilot` и `gemini-cli`. Конфигурация по умолчанию включает их все; удалите из `.truthmark/config.yml` платформы, которыми не пользуетесь, перед повторным запуском `truthmark init`.
145
- Стандартная шаблонная структура использует truth-`README.md` как индексы и начинает описывать истину текущего поведения в ограниченных листовых документах, например `docs/truth/repository/overview.md`.
143
+ Проверьте этот файл перед продолжением. Он определяет зафиксированный контракт иерархии для репозитория.
146
144
 
147
- Существующим репозиториям обычно нужен один этап очистки после `init`: запустите установленный рабочий процесс Truth Structure, если созданный маршрут `repository` слишком широкий, владение охватывает несколько продуктов или сервисов, либо файлы маршрутов все еще указывают на документы-заглушки. Truth Structure разделяет широкие маршруты, создает или исправляет начальные канонические документы истины и дает Truth Sync точные цели до начала работы с функциональным кодом. Codex, Claude Code и поддерживаемые IDE Copilot могут вызвать его через `/truthmark-structure`; хосты в стиле OpenCode могут использовать `/skill truthmark-structure`.
145
+ ### Установить поверхности рабочих процессов
148
146
 
149
- ## Как он работает
147
+ ```bash
148
+ truthmark init
149
+ ```
150
150
 
151
- Сильная сторона Truthmark — путь по умолчанию, а не набор ручных команд. Действующий агент и среда хоста сами решают, делегировать работу или выполнить установленный процесс на месте.
151
+ Это устанавливает или обновляет:
152
152
 
153
- ### Существующее поведение без документации
153
+ - файлы маршрутов
154
+ - scaffolding документов истины
155
+ - управляемые блоки инструкций
156
+ - поверхности рабочих процессов для ИИ для настроенных платформ
154
157
 
155
- Используйте это, когда реализация уже есть, но канонические документы истины отсутствуют или слабы:
158
+ ### Проверить настройку
156
159
 
157
- ```text
158
- пользователь определяет реализованное поведение или api-эндпоинт
159
- пользователь явно вызывает truth document
160
- агент читает реализацию, тесты, маршрутизацию и существующие docs
161
- агент пишет только truth docs и маршрутизацию
162
- проверить diff truth docs
160
+ ```bash
161
+ truthmark check
163
162
  ```
164
163
 
165
- Truth Document — это ручной процесс с приоритетом реализации: код служит доказательством, документы истины создаются или исправляются, и функциональный код менять нельзя. Codex, Claude Code и поддерживаемые IDE Copilot могут вызывать его через `/truthmark-document`; хосты в стиле OpenCode могут использовать `/skill truthmark-document`.
164
+ Затем проверьте сгенерированные файлы перед коммитом.
165
+
166
+ Точный набор файлов зависит от `.truthmark/config.yml`, но форма установки всегда одна: routing, truth scaffolding, компактные managed instructions и host-native workflow surfaces для включённых платформ.
167
+
168
+ ## Первое реальное использование
169
+
170
+ Большинству репозиториев после инициализации нужен один этап очистки.
171
+
172
+ Стандартный scaffold начинается с широкого area `repository`. Реальным репозиториям обычно нужна более точная маршрутизация.
173
+
174
+ Попросите агента разделить широкий маршрут на реальные области продукта, сервиса, домена или владения:
166
175
 
167
176
  ```text
168
- /truthmark-document документирует реализованное поведение session timeout в docs/truth/authentication
177
+ /truthmark-structure раздели широкий repository area на auth, billing и notifications
169
178
  ```
170
179
 
171
- ### Обычные изменения кода
180
+ После этого используйте своего ИИ-агента для разработки как обычно.
181
+
182
+ Когда агент меняет функциональный код, Truth Sync действует как финальная защита, которая перед передачей работы проверяет, должны ли измениться сопоставленные документы истины.
183
+
184
+ ## Что вы получаете
185
+
186
+ | Возможность | Что она делает |
187
+ | --- | --- |
188
+ | Git-native истина | Хранит истину репозитория в зафиксированных Markdown и config. |
189
+ | Контекст в пределах ветки | Истина движется с веткой вместо жизни в приватной сессии. |
190
+ | CLI для людей | Дает мейнтейнерам команды настройки, обновления, валидации и инспекции. |
191
+ | Workflows для ИИ | Дает агентам host-native workflows для sync, documentation, structure, preview, realization и audit. |
192
+ | Явная маршрутизация | Сопоставляет области кода с каноническими документами истины. |
193
+ | Проверяемые передачи работы | Создает обычные Git diff для кода и документов истины. |
194
+ | Local-first работа | Не требует размещенного сервиса, daemon, базы данных или MCP-сервера. |
195
+ | Более безопасные границы записи | Разделяет code-first, doc-first, read-only и doc-only workflows. |
196
+ | Валидация | Сообщает о проблемах маршрутизации, authority, frontmatter, ссылок, generated surfaces, branch scope, freshness и coverage. |
197
+
198
+ ## Визуальный обзор
199
+
200
+ ![Возможности Truthmark](docs/assets/truthmark-features.png)
201
+
202
+ **Возможности:** что устанавливает Truthmark и как разделена поверхность workflow.
203
+
204
+ ![Позиционирование Truthmark](docs/assets/truthmark-position.png)
205
+
206
+ **Позиция:** где Truthmark находится относительно prompts, memory и spec workflows.
207
+
208
+ ![Поток sync Truthmark](docs/assets/truthmark-syncflow.png)
209
+
210
+ **Поток sync:** как Truth Sync закрывает обычные изменения кода перед передачей.
211
+
212
+ ## Почему команды выбирают его
213
+
214
+ Truthmark предназначен для команд, которые уже знают, что ИИ-агенты могут генерировать код.
215
+
216
+ Следующая проблема — governance.
217
+
218
+ Не governance как церемония. Governance как простой вопрос:
172
219
 
173
- Большинству пользователей не нужно напрямую вызывать Truth Sync. Главное, что установленный агентский процесс рассматривает Truth Sync как финальную защиту, когда менялся функциональный код. Нормальный путь выглядит так:
220
+ > После этого ИИ-ассистированного изменения репозиторий все еще говорит правду?
221
+
222
+ Truthmark помогает командам отвечать на это с помощью зафиксированных файлов, явной маршрутизации и проверяемых diff.
223
+
224
+ Он полезен, когда нужны:
225
+
226
+ - меньший дрейф документации
227
+ - лучшие передачи работы
228
+ - продуктовая истина, специфичная для ветки
229
+ - долговечный архитектурный и API-контекст
230
+ - явное владение между документацией и кодом
231
+ - более безопасные границы записи для агентов
232
+ - проверяемый контекст вместо скрытой памяти
233
+ - ИИ-workflows, которые продолжают работать из зафиксированных файлов repo
234
+
235
+ ## Где уместен Truthmark
236
+
237
+ Truthmark не заменяет prompts, memory, specs, tests или code review.
238
+
239
+ Он дает этим workflows долговечное место в Git.
240
+
241
+ | Потребность | Лучше подходит |
242
+ | --- | --- |
243
+ | Лучший результат из одной сессии агента | Лучший prompt |
244
+ | Персональная или сессионная преемственность | Memory tool |
245
+ | Работа над функцией plan-first | Spec workflow |
246
+ | Истина в пределах ветки, которая путешествует с кодом | Truthmark |
247
+ | Проверка корректности поведения | Tests and review |
248
+ | Ревью контекстных изменений, выполненных с ИИ | Truthmark plus Git review |
249
+
250
+ Область Truthmark намеренно узкая:
174
251
 
175
252
  ```text
176
- агент изменяет функциональный код
177
- запускаются релевантные тесты
178
- установленный truth sync workflow запускается до завершения агента
179
- если был создан diff truth docs, он проверяется
180
- работа коммитится или передается дальше
253
+ сделать истину репозитория явной
254
+ связать ее с кодом
255
+ установить вокруг нее workflows агентов
256
+ сохранить результат проверяемым в Git
257
+ ```
258
+
259
+ ## Как работает Truthmark
260
+
261
+ Truthmark работает локально с активным Git worktree.
262
+
263
+ CLI для людей читает и записывает файлы репозитория, а затем завершается.
264
+
265
+ Поверхности рабочих процессов для ИИ — это зафиксированные файлы, которые agent hosts могут загрузить позже. Поэтому агенты могут следовать установленному workflow из состояния репозитория, не завися от фонового процесса Truthmark.
266
+
267
+ Эти слои связаны так:
268
+
269
+ ```mermaid
270
+ flowchart LR
271
+ Human["Human / CI"] --> CLI["Truthmark CLI"]
272
+ CLI --> Config["Config и routing"]
273
+ CLI --> Truth["Канонические truth docs"]
274
+ CLI --> Surfaces["Сгенерированные host-native workflows"]
275
+ Surfaces --> Hosts["Codex / Claude Code / Copilot / OpenCode / Gemini"]
276
+ Hosts --> Worktree["Активный Git worktree"]
277
+ Hosts -->|"helper checks / validate / index"| CLI
278
+ Worktree --> Truth
279
+ ```
280
+
281
+ Agents не подключаются к daemon Truthmark, но могут запускать установленный Truthmark CLI, когда workflow требует validation, indexing или helper checks.
282
+
283
+ Truthmark владеет сгенерированными workflow surfaces, но главный контракт архитектурный: repo-local config и routing направляют agents к каноническим truth docs, а host-native workflows дают каждому поддерживаемому agent способ выполнять одни и те же процедуры Truthmark.
284
+
285
+ Сгенерированные поверхности workflow включают маркеры версии Truthmark. После обновления Truthmark снова выполните:
286
+
287
+ ```bash
288
+ truthmark init
289
+ ```
290
+
291
+ Затем проверьте сгенерированные diff.
292
+
293
+ ## Поддерживаемые платформы агентов
294
+
295
+ Конфигурация по умолчанию включает все поддерживаемые платформы.
296
+
297
+ Удалите платформы, которыми не пользуетесь, из `.truthmark/config.yml`, затем снова выполните:
298
+
299
+ ```bash
300
+ truthmark init
181
301
  ```
182
302
 
183
- Truth Sync работает по принципу code-first: сначала идет код, затем документы истины, и Truth Sync не должен переписывать функциональный код. Его основная задача - выполняться через установленный агентский процесс как финальная защита, когда менялся функциональный код. Прямой вызов нужен в основном для отладки, ранней синхронизации перед передачей работы или намеренного запуска рабочего процесса.
303
+ | Имя платформы в config | Сгенерированная поверхность | Форма вызова |
304
+ | --- | --- | --- |
305
+ | `codex` | `.codex/skills/truthmark-*/`, `.codex/agents/` | `/truthmark-*` или `$truthmark-*` |
306
+ | `claude-code` | `.claude/skills/truthmark-*/`, `.claude/agents/`, `CLAUDE.md` | `/truthmark-*` |
307
+ | `github-copilot` | `.github/skills/truthmark-*/`, `.github/prompts/`, `.github/agents/`, `.github/copilot-instructions.md` | `/truthmark-*` в поддерживаемых Copilot IDE; custom agents `@truth-*` в Copilot CLI |
308
+ | `opencode` | `.opencode/skills/truthmark-*/`, `.opencode/agents/` | `/skill truthmark-*` |
309
+ | `gemini-cli` | `.gemini/skills/truthmark-*/`, `.gemini/commands/truthmark/`, `.gemini/agents/`, `GEMINI.md` | `/truthmark:*` |
184
310
 
185
- Codex, Claude Code и поддерживаемые IDE Copilot могут вызывать его через `/truthmark-sync`. Хосты в стиле OpenCode могут использовать `/skill truthmark-sync`.
311
+ Неизвестные имена платформ являются ошибками config.
312
+
313
+ Удаление платформы останавливает будущие обновления для нее. Оно не удаляет ранее сгенерированные файлы.
314
+
315
+ ## Workflows для ИИ
316
+
317
+ Эти workflows устанавливаются в поддерживаемые ИИ coding hosts.
318
+
319
+ Они используются агентами или agent hosts во время работы с репозиторием. Это не shell-команды верхнего уровня.
320
+
321
+ | Workflow | Направление | Когда использовать | Граница записи |
322
+ | --- | --- | --- | --- |
323
+ | Truth Structure | topology-first | Стандартный маршрут слишком широкий, владение охватывает несколько областей или файлы маршрутов все еще указывают на placeholders. | Создает или чинит routing и стартовые документы истины. |
324
+ | Truth Document | implementation-first | Поведение уже есть в коде, но канонические документы истины отсутствуют или слабы. | Пишет только документы истины и routing. Функциональный код менять нельзя. |
325
+ | Truth Sync | code-first | Функциональный код изменился, и сопоставленные документы истины могут потребовать обновления перед передачей. | Обновляет документы истины. Truth Sync не должен переписывать функциональный код. |
326
+ | Truth Preview | read-only | Агенту нужно предварительно понять вероятный routing перед правками. | Только чтение. Не авторизует записи. |
327
+ | Truth Realize | doc-first | Продуктовые или архитектурные документы истины ведут, и код нужно обновить под них. | Обновляет только код. Агент не должен редактировать документы истины, которые реализует. |
328
+ | Truth Check | audit-first | Ревьюеру или агенту нужно проверить здоровье истины репозитория. | Аудитирует и сообщает. |
329
+
330
+ ### Важное различие
331
+
332
+ Не путайте эти две поверхности:
333
+
334
+ | Поверхность | Используется | Пример | Значение |
335
+ | --- | --- | --- | --- |
336
+ | CLI для людей | людьми, скриптами, CI-подобными проверками | `truthmark check` | Проверить артефакты истины репозитория из терминала. |
337
+ | Workflow для ИИ | coding agents и agent hosts | `/truthmark-check` | Попросить агента выполнить установленный audit workflow. |
338
+
339
+ Имена намеренно похожи, но поверхности разные.
340
+
341
+ ## Обычное изменение кода с помощью ИИ
342
+
343
+ Большинству пользователей не нужно вручную вызывать Truth Sync каждый раз.
344
+
345
+ Truth Sync — установленная финальная защита для изменений функционального кода.
346
+
347
+ ```text
348
+ агент меняет функциональный код
349
+ агент запускает или запрашивает релевантные тесты
350
+ установленный workflow обнаруживает, что функциональный код изменился
351
+ Truth Sync проверяет сопоставленные документы истины
352
+ агент обновляет документы истины при необходимости
353
+ человек проверяет diff кода + diff истины
354
+ ```
355
+
356
+ Прямой вызов все равно полезен для отладки, принудительной ранней синхронизации или явной передачи работы:
186
357
 
187
358
  ```text
188
359
  /truthmark-sync синхронизируй истину репозитория прямо сейчас перед передачей
189
360
  ```
190
361
 
191
- ### Doc-first изменения
362
+ ## Существующее поведение без docs
192
363
 
193
- Используйте этот путь, когда продуктовое или архитектурное решение начинается в документации:
364
+ Используйте Truth Document, когда реализация уже существует, но истина репозитория неполна.
194
365
 
195
366
  ```text
196
- пользователь редактирует truth docs
197
- пользователь явно вызывает truth realize
198
- агент читает truth docs и связанный код
199
- агент обновляет только код
200
- запускаются релевантные тесты
201
- работа коммитится или передается дальше
367
+ /truthmark-document задокументируй реализованное поведение session timeout в docs/truth/authentication
368
+ ```
369
+
370
+ Truth Document проверяет реализацию, тесты, файлы маршрутов и существующие docs как evidence.
371
+
372
+ Он пишет только документы истины и routing.
373
+
374
+ Он не должен менять функциональный код.
375
+
376
+ ## Doc-first изменения
377
+
378
+ Используйте Truth Realize, когда продуктовое или архитектурное решение начинается в docs и код нужно обновить под него.
379
+
380
+ ```text
381
+ /truthmark-realize реализуй docs/truth/authentication/session-timeout.md в коде
382
+ ```
383
+
384
+ Truth Realize работает doc-first.
385
+
386
+ Документы истины ведут. Код следует.
387
+
388
+ Агент не должен редактировать документы истины, которые реализует.
389
+
390
+ ## Read-only preview маршрутизации
391
+
392
+ Используйте Truth Preview перед изменением, когда агенту нужно понять вероятную маршрутизацию.
393
+
394
+ ```text
395
+ /truthmark-preview покажи вероятный truth routing для изменений billing API
202
396
  ```
203
397
 
204
- Truth Realize — это ручной doc-first процесс: документы истины идут первыми, код следует за ними, и агент не должен редактировать документы истины, которые он реализует.
398
+ Truth Preview работает read-only.
399
+
400
+ Это средство выбора и планирования, а не авторизация записи и не замена Truth Check.
401
+
402
+ ## Аудит истины репозитория
205
403
 
206
- Codex, Claude Code и поддерживаемые IDE Copilot могут вызывать его через `/truthmark-realize`. Хосты в стиле OpenCode могут использовать `/skill truthmark-realize`.
404
+ Используйте Truth Check, когда нужен audit workflow для агента.
207
405
 
208
406
  ```text
209
- /truthmark-realize реализуй docs/truth/authentication/session-timeout.md в код
407
+ /truthmark-check проверь routing и truth coverage перед review
408
+ ```
409
+
410
+ Используйте CLI для людей, когда нужна terminal validation:
411
+
412
+ ```bash
413
+ truthmark check
414
+ ```
415
+
416
+ Оба варианта полезны. Это не одна и та же поверхность.
417
+
418
+ ## CLI-команды для людей
419
+
420
+ Большинство мейнтейнеров начинают с трех команд.
421
+
422
+ | Команда | Назначение |
423
+ | --- | --- |
424
+ | `truthmark config` | Создает `.truthmark/config.yml`. Пишет только этот файл, если не используется `--stdout`. |
425
+ | `truthmark init` | Устанавливает или обновляет настроенные поверхности workflow из проверенной config. |
426
+ | `truthmark check` | Валидирует config, authority, routing, документы с decisions, frontmatter, внутренние ссылки, branch scope, generated surfaces, freshness и coverage diagnostics. |
427
+
428
+ Необязательные helpers repository-intelligence создают производный review context для активного checkout. Сгенерированные workflow skill packages также могут предоставлять helper manifests и helper policies, которые вызывают установленные CLI validators `truthmark validate ... --json`; эти helpers являются ускорителями, а не локальными скриптами, упакованными в репозиторий, и не источниками истины. Отдельные Copilot prompts и Gemini commands используют тот же CLI validator contract, когда установленный runner доступен; иначе они должны сообщать видимый skipped helper status и выполнять manual validation.
429
+
430
+ Они не являются источниками истины.
431
+
432
+ | Команда | Назначение |
433
+ | --- | --- |
434
+ | `truthmark index` | Строит JSON RepoIndex и RouteMap для активного checkout. |
435
+ | `truthmark impact --base <ref>` | Сопоставляет измененные файлы с routed truth docs, owning routes, nearby tests и public symbols. |
436
+ | `truthmark context --workflow <workflow> [--base <ref>]` | Генерирует ограниченный ContextPack для Truth Sync, Truth Document или Truth Realize. Используйте `--format markdown` для человекочитаемой версии. |
437
+
438
+ Структурированный вывод доступен с `--json` там, где поддерживается.
439
+
440
+ ## Конфигурация
441
+
442
+ Truthmark работает config-first.
443
+
444
+ Главный config-файл:
445
+
446
+ ```text
447
+ .truthmark/config.yml
448
+ ```
449
+
450
+ Новые репозитории должны выполнить:
451
+
452
+ ```bash
453
+ truthmark config
454
+ ```
455
+
456
+ Затем проверить сгенерированную config перед запуском:
457
+
458
+ ```bash
459
+ truthmark init
210
460
  ```
211
461
 
212
- ## Что он устанавливает
462
+ Важные области config:
463
+
464
+ | Область config | Назначение |
465
+ | --- | --- |
466
+ | `version` | Версия контракта config. |
467
+ | `platforms` | Agent hosts, которые должны получить сгенерированные поверхности для платформы. |
468
+ | `docs.layout` | Текущий режим layout документации. |
469
+ | `docs.roots` | Именованные корни канонической документации. |
470
+ | `docs.routing.root_index` | Путь к корневому индексу маршрутов. |
471
+ | `docs.routing.area_files_root` | Директория для делегированных дочерних файлов маршрутов. |
472
+ | `docs.routing.default_area` | Базовое имя начального scaffolded дочернего маршрута. |
473
+ | `docs.routing.max_delegation_depth` | Текущая максимальная глубина делегирования routing. |
474
+ | `authority` | Упорядоченные канонические docs и globs, используемые как authority истины репозитория. |
475
+ | `instruction_targets` | Файлы, которые получают общие управляемые блоки инструкций, например `AGENTS.md`. |
476
+ | `frontmatter.required` | Поля metadata, которые создают error diagnostics при отсутствии. |
477
+ | `frontmatter.recommended` | Поля metadata, которые создают review diagnostics при отсутствии. |
478
+ | `ignore` | Glob-паттерны, исключенные из релевантных checks и routing logic. |
479
+
480
+ ## Маршрутизация истины репозитория
481
+
482
+ Truthmark сопоставляет code surfaces с документами истины.
483
+
484
+ Основные файлы маршрутизации:
485
+
486
+ ```text
487
+ docs/truthmark/areas.md
488
+ docs/truthmark/areas/**/*.md
489
+ ```
490
+
491
+ Маршрут сообщает агенту:
492
+
493
+ - какая code surface принадлежит области
494
+ - какие документы истины владеют этой областью
495
+ - когда истину нужно обновлять
496
+ - какой тип документа истины участвует
497
+
498
+ Стандартный scaffold начинается широко. Существующие репозитории обычно должны разделить стандартный маршрут на реальные области владения.
499
+
500
+ Пример:
501
+
502
+ ```text
503
+ /truthmark-structure раздели широкий repository area на frontend, backend, billing и deployment
504
+ ```
505
+
506
+ Хороший routing дает Truth Sync точные цели.
507
+
508
+ Плохой routing заставляет агентов гадать.
509
+
510
+ ## Что устанавливает Truthmark
511
+
512
+ Truthmark устанавливает компактный, встроенный в репозиторий слой истины.
513
+
514
+ Он устанавливает четыре слоя:
515
+
516
+ - config и routing для границ владения
517
+ - канонические truth docs и стартовые шаблоны
518
+ - компактные управляемые instruction blocks для repo-wide agent context
519
+ - host-native workflow packages, commands, prompts и verifier agents для платформ, включённых в config
520
+
521
+ Truthmark сохраняет ручной контент вне управляемых блоков инструкций.
522
+
523
+ Сгенерированные поверхности workflow управляются Truthmark и могут обновляться повторным запуском:
524
+
525
+ ```bash
526
+ truthmark init
527
+ ```
528
+
529
+ ## Subagents и ограниченные проверки evidence
530
+
531
+ Там, где host поддерживает это, Truthmark может устанавливать project-scoped verifier agents и leased `truth-doc-writer`.
532
+
533
+ Они помогают держать большие truth-задачи ограниченными:
534
+
535
+ - route auditors проверяют владение маршрутами
536
+ - claim verifiers проверяют, поддержаны ли claims документов evidence
537
+ - doc reviewers проверяют качество truth docs
538
+ - leased doc writers обрабатывают ограниченные shards записи truth docs
539
+
540
+ Родительский workflow все еще владеет финальной интерпретацией, границами записи, проверкой diff и приемкой.
213
541
 
214
- Truthmark держит постоянную рабочую поверхность маленькой и встроенной в репозиторий. После `truthmark init` сам репозиторий несет маршрутизацию, правила и установленные рабочие поверхности, поэтому команда не зависит только от локальной настройки одного человека.
542
+ Это важно: subagents помогают с ограниченной evidence work. Они не заменяют основной контракт workflow.
215
543
 
216
- - `.truthmark/config.yml` для машиночитаемого зафиксированного контракта иерархии
217
- - `docs/truthmark/areas.md` для корневого индекса маршрутов
218
- - `docs/truthmark/areas/**/*.md` для делегированных дочерних файлов маршрутов
219
- - `docs/templates/behavior-doc.md` и другие шаблоны по видам под `docs/templates/` для редактируемых стандартов truth docs, используемых сгенерированными рабочими процессами
220
- - управляемые блоки инструкций для настроенных платформ, таких как `AGENTS.md`, `CLAUDE.md`, инструкции Copilot и `GEMINI.md`
221
- - нативные для хоста skills, prompts или commands для Truth Structure, Truth Document, Truth Sync, Truth Realize и Truth Check
544
+ ## Цикл ревью
222
545
 
223
- Установленные рабочие поверхности и есть среда выполнения:
546
+ Truthmark спроектирован для обычного Git review.
224
547
 
225
- - Truth Structure создает или исправляет маршрутизацию областей и стартовые документы истины.
226
- - Truth Document создает или исправляет документы истины для уже реализованного поведения.
227
- - Truth Sync поддерживает синхронизацию сопоставленных документов истины с функциональными изменениями.
228
- - Truth Realize обновляет код так, чтобы он соответствовал документам истины.
229
- - Truth Check аудитирует здоровье истины репозитория.
548
+ Хорошая ИИ-ассистированная передача работы должна показывать:
230
549
 
231
- `README.md` функциональных разделов это индексы. Ожидается, что Truth Sync будет читать и обновлять ограниченные листовые документы для текущего поведения. Сгенерированные рабочие поверхности сохраняют приоритет правил репозитория, рассматривая код реализации и канонические документы истины как свидетельства текущего поведения.
550
+ ```text
551
+ diff кода
552
+ test evidence
553
+ diff truth docs, если нужен
554
+ изменения routing, если нужны
555
+ отчет агента
556
+ ```
557
+
558
+ Ревьюер должен уметь ответить:
232
559
 
233
- Сгенерированные поверхности управляются Truthmark, содержат маркер версии и могут обновляться через `truthmark init`.
560
+ - Какой код изменился?
561
+ - Какие документы истины владеют этим кодом?
562
+ - Нужно ли было обновлять эти документы?
563
+ - Если нет, почему?
564
+ - Остался ли агент внутри границы записи workflow?
565
+ - Приложена ли evidence тестов или проверки?
234
566
 
235
- ## Команды
567
+ ## Примеры
236
568
 
237
- Truthmark V1 намеренно держит CLI небольшим, потому что постоянный рабочий процесс должен жить в установленных агентских поверхностях, а не в длинном списке ежедневных ручных команд. В нижестоящих репозиториях `truthmark config` создает зафиксированный контракт иерархии, `truthmark init` устанавливает и обновляет рабочие поверхности на основе этой проверенной конфигурации, `truthmark check` валидирует артефакты истины для ручных аудитов, CI или отладки, а команды репозиторной аналитики создают производные артефакты для проверки, когда доступны локальные инструменты.
569
+ ### Инициализировать репозиторий
238
570
 
239
571
  ```bash
572
+ npm install -g truthmark
240
573
  truthmark config
241
574
  truthmark init
242
575
  truthmark check
243
- truthmark index
244
- truthmark impact --base main
245
- truthmark context --workflow truth-sync --base main
246
- truthmark config --json
247
- truthmark check --json
248
- truthmark index --json
249
- truthmark impact --base main --json
250
- truthmark context --workflow truth-sync --base main --json
251
576
  ```
252
577
 
253
- `config` пишет только `.truthmark/config.yml`, если не используется `--stdout`.
578
+ ### Удалить неиспользуемые платформы агентов
254
579
 
255
- `init` требует `.truthmark/config.yml`, а затем устанавливает или обновляет локальные файлы рабочих процессов.
580
+ Отредактируйте:
256
581
 
257
- `check` валидирует конфигурацию, полномочия, маршрутизацию, документы с решениями, frontmatter, внутренние ссылки, область действия ветки и диагностику покрытия.
582
+ ```text
583
+ .truthmark/config.yml
584
+ ```
258
585
 
259
- `index` строит JSON RepoIndex и RouteMap для активного checkout.
586
+ Затем снова выполните:
260
587
 
261
- `impact --base <ref>` сопоставляет измененные файлы с routed truth docs, owning routes, nearby tests и public symbols.
588
+ ```bash
589
+ truthmark init
590
+ truthmark check
591
+ ```
262
592
 
263
- `context --workflow <workflow> [--base <ref>]` генерирует ограниченный ContextPack для Truth Sync, Truth Document или Truth Realize. `--format markdown` рендерит его в читаемый человеком вид.
593
+ ### Разделить широкий routing
264
594
 
265
- Truth Structure, Truth Document, Truth Sync, Truth Realize и Truth Check это установленные агентские рабочие процессы, а не повседневные CLI-команды верхнего уровня.
595
+ ```text
596
+ /truthmark-structure раздели широкий repository area на auth, billing, notifications и deployment
597
+ ```
266
598
 
267
- Они запускаются через настроенные поверхности хоста агента, например Codex/Claude/Copilot `/truthmark-*`, OpenCode `/skill truthmark-*` или Gemini `/truthmark:*`.
599
+ ### Документировать реализованное поведение
268
600
 
269
601
  ```text
270
- /truthmark-check проверь маршрутизацию и покрытие truth перед review
602
+ /truthmark-document задокументируй реализованный password reset flow в docs/truth/authentication
271
603
  ```
272
604
 
273
- ## Зачем он существует
605
+ ### Синхронизировать после изменений кода
274
606
 
275
- Большинство ИИ-процессов для разработки оптимизируют следующий ответ. Truthmark оптимизирует следующую передачу работы.
276
- Он исходит из того, что серьезным командам нужны:
607
+ ```text
608
+ /truthmark-sync синхронизируй истину репозитория прямо сейчас перед передачей
609
+ ```
277
610
 
278
- - продуктовая истина, специфичная для ветки
279
- - долговечные архитектурные и API-решения
280
- - явная ответственность между документацией и кодом
281
- - безопасные границы записи для агентов
282
- - обычные Git diff, которые могут проверить люди
283
- - читаемый Markdown, который команда может просматривать без специальных инструментов
284
- - истина, которая путешествует вместе с веткой, а не живет в скрытом состоянии сессии
285
- - рабочие процессы, которые продолжают работать, даже если пакет не установлен глобально
611
+ ### Реализовать doc-first решение
286
612
 
287
- ## Статус проекта
613
+ ```text
614
+ /truthmark-realize реализуй docs/truth/billing/invoice-retry-policy.md в коде
615
+ ```
616
+
617
+ ### Проверить здоровье истины из терминала
618
+
619
+ ```bash
620
+ truthmark check
621
+ ```
622
+
623
+ ### Создать branch-impact context
624
+
625
+ ```bash
626
+ truthmark impact --base main
627
+ ```
288
628
 
289
- Truthmark не является сервером памяти и не является MCP-сервером. Это репозиторная практика, упакованная как небольшой CLI-установщик и родные для агентов рабочие поверхности, которые превращают правила ИИ-процесса в инфраструктуру репозитория.
629
+ ### Создать workflow context
290
630
 
291
- V1 сейчас предоставляет:
631
+ ```bash
632
+ truthmark context --workflow truth-sync --base main --format markdown
633
+ ```
634
+
635
+ ## Статус проекта
636
+
637
+ Truthmark V1 сейчас предоставляет:
292
638
 
293
639
  - `truthmark config`
294
640
  - `truthmark init`
@@ -296,39 +642,123 @@ V1 сейчас предоставляет:
296
642
  - `truthmark index`
297
643
  - `truthmark impact`
298
644
  - `truthmark context`
299
- - управляемые инструкции рабочих процессов в `AGENTS.md`
300
- - сгенерированные skill-поверхности Truth Structure, Truth Document, Truth Sync, Truth Realize и Truth Check для настроенных агентских хостов
301
- - метаданные области ветки
302
- - диагностика конфигурации, полномочий, маршрутизации, структуры решений, frontmatter, ссылок и полиглотного покрытия
303
- - производные артефакты RepoIndex, RouteMap, ImpactSet и ContextPack для более быстрой локальной проверки, когда CLI доступен
645
+ - branch-scope metadata
646
+ - управляемые блоки инструкций
647
+ - сгенерированные поверхности workflow Truth Structure
648
+ - сгенерированные поверхности workflow Truth Document
649
+ - сгенерированные поверхности workflow Truth Sync
650
+ - сгенерированные поверхности workflow Truth Preview
651
+ - сгенерированные поверхности workflow Truth Realize
652
+ - сгенерированные поверхности workflow Truth Check
653
+ - diagnostics для route, authority, decision-structure, frontmatter, links, freshness, generated-surface и coverage
654
+ - производные артефакты RepoIndex, RouteMap, ImpactSet и ContextPack
655
+ - host-specific поверхности для Codex, Claude Code, GitHub Copilot, OpenCode и Gemini CLI
656
+
657
+ ## Разработка
658
+
659
+ Установить зависимости:
660
+
661
+ ```bash
662
+ npm install
663
+ ```
664
+
665
+ Запустить локальную development CLI:
666
+
667
+ ```bash
668
+ npm run dev -- init
669
+ npm run dev -- check
670
+ ```
671
+
672
+ Запустить полный project check:
673
+
674
+ ```bash
675
+ npm run check
676
+ ```
677
+
678
+ Полезные scripts:
679
+
680
+ | Script | Назначение |
681
+ | --- | --- |
682
+ | `npm run dev` | Запускает TypeScript CLI entry point через `tsx`. |
683
+ | `npm run build` | Собирает package. |
684
+ | `npm run lint` | Запускает ESLint. |
685
+ | `npm run typecheck` | Запускает TypeScript checks. |
686
+ | `npm run test` | Запускает tests. |
687
+ | `npm run check` | Запускает lint, typecheck, tests и build. |
688
+ | `npm run release:check` | Запускает release-oriented validation. |
689
+
690
+ Когда меняете сам Truthmark, смотрите [CONTRIBUTORS.md](CONTRIBUTORS.md).
304
691
 
305
692
  ## Документация
306
693
 
307
- Корневой README предназначен для людей, которые оценивают и пробуют пакет. Подробные функциональные и бизнес-спецификации находятся в `docs/`:
694
+ README — быстрый путь для оценки и настройки.
695
+
696
+ Подробное текущее поведение живет в `docs/`:
308
697
 
309
698
  - [Индекс документации](docs/README.md)
310
699
  - [Обзор архитектуры](docs/architecture/overview.md)
311
700
  - [Контракты API и CLI](docs/truth/contracts.md)
312
701
  - [Поведение init и scaffold](docs/truth/init-and-scaffold.md)
313
702
  - [Диагностика check](docs/truth/check-diagnostics.md)
314
- - [Установленные workflow](docs/truth/workflows/overview.md)
703
+ - [Установленные workflows](docs/truth/workflows/overview.md)
315
704
  - [Руководство по поддержанию истины репозитория](docs/standards/maintaining-repository-truth.md)
316
705
 
317
- Текущее поведение должно жить в каноническом дереве документации выше.
706
+ ## Границы дизайна
318
707
 
319
- ## Не-цели
708
+ Truthmark намеренно небольшой.
320
709
 
321
- Truthmark V1 не является:
710
+ Он не является:
322
711
 
323
712
  - размещенным сервисом
324
713
  - MCP-сервером
325
714
  - векторной базой данных
326
715
  - генератором сайтов документации
327
- - продуктом принудительного контроля для CI или PR
328
- - заменой тестов, code review или технического лидерства
329
- - автономным движком для переписывания кода
716
+ - CI- или PR-enforcement продуктом
717
+ - заменой tests, code review или technical leadership
718
+ - автономным движком переписывания кода
719
+ - framework для model training или fine-tuning
720
+ - скрытым слоем памяти
721
+
722
+ Эти границы — часть продукта.
723
+
724
+ Truthmark держит workflow локальным, зафиксированным, ограниченным веткой и проверяемым.
725
+
726
+ ## Безопасность и дисциплина ревью
727
+
728
+ Truthmark помогает репозиторию оставаться честным. Он не доказывает, что код корректен.
729
+
730
+ Команды все равно должны:
330
731
 
331
- Это легкий способ заставить локальных ИИ-агентов для разработки уважать истину, которую ваша команда хранит в Git.
732
+ - запускать релевантные тесты
733
+ - проверять изменения функционального кода
734
+ - проверять изменения документов истины
735
+ - держать secrets вне документации
736
+ - держать специфичные для репозитория инструкции вне managed blocks
737
+ - проверять diff сгенерированных workflow surfaces после upgrades
738
+ - сохранять человеческое владение продуктовыми и архитектурными решениями
739
+
740
+ Truthmark делает контекст агента видимым. Он не заменяет человеческое суждение.
741
+
742
+ ## Направление roadmap
743
+
744
+ Текущее будущее направление делает акцент на:
745
+
746
+ - более сильной evidence reporting в `truthmark check`
747
+ - более ясных примерах adoption
748
+ - примерных репозиториях, показывающих реальные циклы Truth Sync
749
+ - migration guides для команд, уже использующих agent instruction files
750
+ - conformance tests для generated host surfaces
751
+ - route-aware подсказках о stale truth
752
+ - ограниченных implementation checklists для doc-first work
753
+
754
+ Центр тяжести остается прежним:
755
+
756
+ ```text
757
+ истина репозитория
758
+ agent-native workflows
759
+ Git review
760
+ контекст в пределах ветки
761
+ ```
332
762
 
333
763
  ## Лицензия
334
764