truthmark 1.6.1 → 2.1.0

package/README.ru.md

@@ -1,14 +1,14 @@
 # Truthmark
 
-**Ваши агенты пишут код. Truthmark делает их контекст проверяемым в Git.**
+**Ваши агенты пишут код. Truthmark поддерживает документацию для людей, версионируемую и проверяемую в Git.**
 
 [English](README.md) | [Deutsch](README.de.md) | [中文](README.zh.md) | [Español](README.es.md) | Русский
 
 ![Баннер Truthmark](docs/assets/truthmark-banner.png)
 
-ИИ-агенты для разработки могут менять репозиторий быстрее, чем люди успевают выравнивать его контекст.
+ИИ-агенты разработки могут менять репозиторий быстрее, чем люди успевают поддерживать его документацию в актуальном состоянии.
 
-Truthmark чинит ту часть, которая обычно ломается после написания кода: истину репозитория.
+Truthmark чинит ту часть, которая обычно ломается после написания кода: актуальное описание репозитория.
 
 Он устанавливает Git-native, ограниченный веткой слой рабочего процесса, который помогает ИИ-агентам обновлять правильные документы, соблюдать границы владения и оставлять людям обычные diff для ревью.
 
@@ -20,11 +20,11 @@ Truthmark чинит ту часть, которая обычно ломаетс
 
 Без дополнительного сервера в эксплуатации.
 
-Только истина репозитория, которая движется вместе с веткой.
+Только актуальное описание репозитория, которое движется вместе с веткой.
 
 ## Проблема
 
-ИИ-агенты для разработки хорошо создают код. Это порождает новый режим отказа.
+ИИ-агенты разработки хорошо создают код. Это порождает новый режим отказа.
 
 Реализация меняется, но история репозитория начинает расходиться:
 
@@ -33,11 +33,11 @@ Truthmark чинит ту часть, которая обычно ломаетс
 - продуктовые решения исчезают после передачи работы
 - ревьюеры видят diff кода без связанных diff истины
 - ветки незаметно развивают разные версии того, «что является правдой»
-- каждой сессии агента приходится заново открывать контекст
+- каждой сессии агента приходится заново понимать актуальное состояние репозитория
 
-Truthmark превращает этот хрупкий контекст в зафиксированную инфраструктуру репозитория.
+Truthmark превращает это хрупкое описание текущего состояния в зафиксированную инфраструктуру репозитория.
 
-Вместо надежды на то, что каждый человек и каждый агент вспомнят правильную привычку документирования, Truthmark устанавливает эту привычку в репозиторий.
+Вместо надежды на то, что каждый человек и каждый агент вспомнят нужную дисциплину документирования, Truthmark устанавливает эту привычку в репозиторий.
 
 ## Обещание
 
@@ -56,17 +56,17 @@ Truth Sync проверяет сопоставленные документы и
 
 Главная ценность такова: **ИИ-работе легче доверять, потому что репозиторий остается понятным.**
 
-## Две поверхности, одна система истины
+## Два интерфейса, одна система истины
 
 Truthmark — это не только CLI.
 
-У него две разные поверхности, и это различие важно.
+У него два разных интерфейса, и это различие важно.
 
 ### 1. CLI для людей
 
 CLI предназначен для мейнтейнеров, ревьюеров и автоматизации.
 
-Используйте его, чтобы настроить репозиторий, установить или обновить файлы рабочих процессов, проверить артефакты истины и создать дополнительный контекст для ревью.
+Используйте его, чтобы настроить репозиторий, установить или обновить файлы рабочих процессов, проверить артефакты истины и создать дополнительные материалы для ревью.
 
 ```bash
 truthmark config
@@ -78,11 +78,11 @@ CLI подготавливает и валидирует среду репози
 
 Он не является runtime для ИИ-рабочего процесса.
 
-### 2. Поверхности рабочих процессов для ИИ
+### 2. Интерфейсы рабочих процессов для ИИ
 
-Поверхности для ИИ предназначены для coding agents.
+Интерфейсы для ИИ предназначены для coding agents.
 
-Truthmark устанавливает host-native skills, prompts, commands, управляемые блоки инструкций и поддерживаемые поверхности subagents, чтобы ИИ-агенты могли следовать специфичным для репозитория truth-workflows внутри своих обычных инструментов разработки.
+Truthmark устанавливает host-native skills, prompts, commands, управляемые блоки инструкций и поддерживаемые интерфейсы subagents, чтобы ИИ-агенты могли следовать специфичным для репозитория truth-workflows внутри своих обычных инструментов разработки.
 
 Примеры:
 
@@ -105,7 +105,7 @@ Truthmark устанавливает host-native skills, prompts, commands, уп
 
 ```text
 люди владеют контрактом репозитория
-Truthmark устанавливает контракт в repo
+Truthmark устанавливает контракт в репозиторий
 агенты работают внутри этого контракта
 обновления истины появляются как Git diff
 люди проверяют результат
@@ -142,7 +142,7 @@ truthmark config
 
 Проверьте этот файл перед продолжением. Он определяет зафиксированный контракт иерархии для репозитория.
 
-### Установить поверхности рабочих процессов
+### Установить интерфейсы рабочих процессов
 
 ```bash
 truthmark init
@@ -153,7 +153,7 @@ truthmark init
 - файлы маршрутов
 - scaffolding документов истины
 - управляемые блоки инструкций
-- поверхности рабочих процессов для ИИ для настроенных платформ
+- интерфейсы рабочих процессов для ИИ для настроенных платформ
 
 Обоснование стандартных шаблонов документов истины находится в [Template Standards](docs/standards/template-standards.md). В документе показано, как они соотносятся с признанными источниками по инженерии ПО, включая ISO/IEC/IEEE 42010, ISO/IEC/IEEE 29148, ISO/IEC/IEEE 12207, ISO/IEC 25010, C4, arc42, OpenAPI, SemVer, Google SRE и Diátaxis.
 
@@ -165,20 +165,28 @@ truthmark check
 
 Затем проверьте сгенерированные файлы перед коммитом.
 
-Точный набор файлов зависит от `.truthmark/config.yml`, но форма установки всегда одна: routing, truth scaffolding, компактные managed instructions и host-native workflow surfaces для включённых платформ.
+Точный набор файлов зависит от `.truthmark/config.yml`, но форма установки всегда одна: routing, truth scaffolding, компактные managed instructions и host-native интерфейсы workflow для включённых платформ.
 
 ## Первое реальное использование
 
 Большинству репозиториев после инициализации нужен один этап очистки.
 
-Стандартный scaffold начинается с широкого area `repository`. Реальным репозиториям обычно нужна более точная маршрутизация.
+Стандартный scaffold начинается с широкого area `repo`. Реальным репозиториям обычно нужна более точная маршрутизация.
 
 Попросите агента разделить широкий маршрут на реальные области продукта, сервиса, домена или владения:
 
 ```text
-/truthmark-structure раздели широкий repository area на auth, billing и notifications
+/truthmark-structure раздели широкий repo area на auth, billing и notifications
 ```
 
+Если в проекте уже есть реализованные функции, но документы истины отсутствуют или слабы, попросите установленный workflow Truth Document задокументировать сфокусированный scope:
+
+```text
+/truthmark-document задокументируй реализованное поведение payment retry в src/billing/retry.ts и связанных тестах
+```
+
+Truth Document — самый частый первый workflow для существующих проектов. Он инспектирует реализацию, тесты, маршруты и существующие документы, затем создает или исправляет документы истины и маршрутизацию, не меняя функциональный код.
+
 После этого используйте своего ИИ-агента для разработки как обычно.
 
 Когда агент меняет функциональный код, Truth Sync действует как финальная защита, которая перед передачей работы проверяет, должны ли измениться сопоставленные документы истины.
@@ -187,8 +195,8 @@ truthmark check
 
 | Возможность | Что она делает |
 | --- | --- |
-| Git-native истина | Хранит истину репозитория в зафиксированных Markdown и config. |
-| Контекст в пределах ветки | Истина движется с веткой вместо жизни в приватной сессии. |
+| Git-native истина | Хранит актуальное описание репозитория в зафиксированных Markdown и config. |
+| Документация в пределах ветки | Истина движется с веткой вместо жизни в приватной сессии. |
 | CLI для людей | Дает мейнтейнерам команды настройки, обновления, валидации и инспекции. |
 | Workflows для ИИ | Дает агентам host-native workflows для sync, documentation, structure, preview, realization и audit. |
 | Явная маршрутизация | Сопоставляет области кода с каноническими документами истины. |
@@ -202,7 +210,7 @@ truthmark check
 
 ![Возможности Truthmark](docs/assets/truthmark-features.png)
 
-**Возможности:** что устанавливает Truthmark и как разделена поверхность workflow.
+**Возможности:** что устанавливает Truthmark и как устроен интерфейс workflow.
 
 ![Позиционирование Truthmark](docs/assets/truthmark-position.png)
 
@@ -229,11 +237,11 @@ Truthmark помогает командам отвечать на это с по
 - меньший дрейф документации
 - лучшие передачи работы
 - продуктовая истина, специфичная для ветки
-- долговечный архитектурный и API-контекст
+- долговечная архитектурная и API-документация
 - явное владение между документацией и кодом
 - более безопасные границы записи для агентов
-- проверяемый контекст вместо скрытой памяти
-- ИИ-workflows, которые продолжают работать из зафиксированных файлов repo
+- проверяемая документация вместо скрытой памяти
+- ИИ-workflows, которые продолжают работать из зафиксированных файлов репозитория
 
 ## Где уместен Truthmark
 
@@ -248,12 +256,12 @@ Truthmark не заменяет prompts, memory, specs, tests или code review
 | Работа над функцией plan-first | Spec workflow |
 | Истина в пределах ветки, которая путешествует с кодом | Truthmark |
 | Проверка корректности поведения | Tests and review |
-| Ревью контекстных изменений, выполненных с ИИ | Truthmark plus Git review |
+| Ревью изменений документации, выполненных с ИИ | Truthmark plus Git review |
 
 Область Truthmark намеренно узкая:
 
 ```text
-сделать истину репозитория явной
+сделать актуальное состояние репозитория явным
 связать ее с кодом
 установить вокруг нее workflows агентов
 сохранить результат проверяемым в Git
@@ -265,7 +273,7 @@ Truthmark работает локально с активным Git worktree.
 
 CLI для людей читает и записывает файлы репозитория, а затем завершается.
 
-Поверхности рабочих процессов для ИИ — это зафиксированные файлы, которые agent hosts могут загрузить позже. Поэтому агенты могут следовать установленному workflow из состояния репозитория, не завися от фонового процесса Truthmark.
+Интерфейсы рабочих процессов для ИИ — это зафиксированные файлы, которые agent hosts могут загрузить позже. Поэтому агенты могут следовать установленному workflow из состояния репозитория, не завися от фонового процесса Truthmark.
 
 Эти слои связаны так:
 
@@ -283,9 +291,9 @@ flowchart LR
 
 Agents не подключаются к daemon Truthmark, но могут запускать установленный Truthmark CLI, когда workflow требует validation, indexing или helper checks.
 
-Truthmark владеет сгенерированными workflow surfaces, но главный контракт архитектурный: repo-local config и routing направляют agents к каноническим truth docs, а host-native workflows дают каждому поддерживаемому agent способ выполнять одни и те же процедуры Truthmark.
+Truthmark владеет сгенерированными интерфейсами workflow, но главный контракт архитектурный: repo-local config и routing направляют agents к каноническим truth docs, а host-native workflows дают каждому поддерживаемому agent способ выполнять одни и те же процедуры Truthmark.
 
-Сгенерированные поверхности workflow включают маркеры версии Truthmark. После обновления Truthmark снова выполните:
+Сгенерированные интерфейсы workflow включают маркеры версии Truthmark. После обновления Truthmark снова выполните:
 
 ```bash
 truthmark init
@@ -303,9 +311,9 @@ truthmark init
 truthmark init
 ```
 
-| Имя платформы в config | Сгенерированная поверхность | Форма вызова |
+| Имя платформы в config | Сгенерированный интерфейс | Форма вызова |
 | --- | --- | --- |
-| `codex` | `.codex/skills/truthmark-*/`, `.codex/agents/` | `/truthmark-*` или `$truthmark-*` |
+| `codex` | `.agents/skills/truthmark-*/`, `.codex/agents/` | `/truthmark-*` или `$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-*` в поддерживаемых Copilot IDE; custom agents `@truth-*` в Copilot CLI |
 | `opencode` | `.opencode/skills/truthmark-*/`, `.opencode/agents/` | `/skill truthmark-*` |
@@ -323,24 +331,24 @@ truthmark init
 
 | Workflow | Направление | Когда использовать | Граница записи |
 | --- | --- | --- | --- |
-| Truth Structure | topology-first | Стандартный маршрут слишком широкий, владение охватывает несколько областей или файлы маршрутов все еще указывают на placeholders. | Создает или чинит routing и стартовые документы истины. |
-| Truth Document | implementation-first | Поведение уже есть в коде, но канонические документы истины отсутствуют или слабы. | Пишет только документы истины и routing. Функциональный код менять нельзя. |
+| Truth Structure | topology-first | Стандартный маршрут слишком широкий, владение охватывает несколько областей или файлы маршрутов все еще указывают на placeholders. | Создает или исправляет маршрутизацию и стартовые документы истины. |
+| Truth Document | implementation-first | Поведение уже есть в коде, но канонические документы истины отсутствуют или слабы. | Пишет только документы истины и маршрутизацию. Функциональный код менять нельзя. |
 | Truth Sync | code-first | Функциональный код изменился, и сопоставленные документы истины могут потребовать обновления перед передачей. | Обновляет документы истины. Truth Sync не должен переписывать функциональный код. |
-| Truth Preview | read-only | Агенту нужно предварительно понять вероятный routing перед правками. | Только чтение. Не авторизует записи. |
+| Truth Preview | read-only | Агенту нужно предварительно понять вероятную маршрутизацию перед правками. | Только чтение. Не авторизует записи. |
 | Truth Realize | doc-first | Продуктовые или архитектурные документы истины ведут, и код нужно обновить под них. | Обновляет только код. Агент не должен редактировать документы истины, которые реализует. |
-| Truth Check | audit-first | Ревьюеру или агенту нужно проверить здоровье истины репозитория. | Аудитирует и сообщает. |
+| Truth Check | audit-first | Ревьюеру или агенту нужно проверить актуальность истины репозитория. | Аудитирует и сообщает. |
 | Truthmark Portal | presentation-only | Человек явно просит доступный для просмотра статический HTML Portal по документам истины репозитория. | Пишет только сгенерированные неканонические статические файлы в настроенную директорию вывода Portal. |
 
 ### Важное различие
 
-Не путайте эти две поверхности:
+Не путайте эти два интерфейса:
 
-| Поверхность | Используется | Пример | Значение |
+| Интерфейс | Используется | Пример | Значение |
 | --- | --- | --- | --- |
 | CLI для людей | людьми, скриптами, CI-подобными проверками | `truthmark check` | Проверить артефакты истины репозитория из терминала. |
 | Workflow для ИИ | coding agents и agent hosts | `/truthmark-check` | Попросить агента выполнить установленный audit workflow. |
 
-Имена намеренно похожи, но поверхности разные.
+Имена намеренно похожи, но интерфейсы разные.
 
 ## Обычное изменение кода с помощью ИИ
 
@@ -365,15 +373,19 @@ Truth Sync проверяет сопоставленные документы и
 
 ## Существующее поведение без docs
 
-Используйте Truth Document, когда реализация уже существует, но истина репозитория неполна.
+Используйте Truth Document, когда реализация уже существует, но истина репозитория неполна. Это обычный путь для зрелых репозиториев, которые внедряют Truthmark после того, как кодовая база уже существует.
 
 ```text
-/truthmark-document задокументируй реализованное поведение session timeout в docs/truth/authentication
+/truthmark-document задокументируй реализованное поведение session timeout в src/auth/session.ts, src/auth/middleware.ts и tests/auth/session.test.ts
 ```
 
-Truth Document проверяет реализацию, тесты, файлы маршрутов и существующие docs как evidence.
+Укажите имя функции, пути к коду, пути к тестам или желаемую область truth-документов. В OpenCode-подобных хостах тот же workflow вызывается как `/skill truthmark-document ...`; в Gemini CLI используйте `/truthmark:doc ...`.
+
+Для большого репозитория, где все еще есть один широкий placeholder-маршрут, сначала запустите Truth Structure, а затем вызывайте Truth Document для одной ограниченной функции или области за раз.
+
+Truth Document проверяет реализацию, тесты, файлы маршрутов и существующие документы как подтверждения.
 
-Он пишет только документы истины и routing.
+Он пишет только документы истины и маршрутизацию.
 
 Он не должен менять функциональный код.
 
@@ -382,7 +394,7 @@ Truth Document проверяет реализацию, тесты, файлы
 Используйте Truth Realize, когда продуктовое или архитектурное решение начинается в docs и код нужно обновить под него.
 
 ```text
-/truthmark-realize реализуй docs/truth/authentication/session-timeout.md в коде
+/truthmark-realize реализуй docs/truthmark/truth/authentication/session-timeout.md в коде
 ```
 
 Truth Realize работает doc-first.
@@ -426,10 +438,10 @@ truthmark check
 | Команда | Назначение |
 | --- | --- |
 | `truthmark config` | Создает `.truthmark/config.yml`. Пишет только этот файл, если не используется `--stdout`. |
-| `truthmark init` | Устанавливает или обновляет настроенные поверхности workflow из проверенной config. |
+| `truthmark init` | Устанавливает или обновляет настроенные интерфейсы workflow из проверенной config. |
 | `truthmark check` | Валидирует config, authority, routing, документы с decisions, frontmatter, внутренние ссылки, branch scope, generated surfaces, freshness и coverage diagnostics. |
 
-Необязательные 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.
+Необязательные helpers repository-intelligence создают производные материалы для ревью активного checkout, например артефакты RepoIndex, RouteMap, ImpactSet и ограниченные ContextPack. Сгенерированные 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.
 
 Они не являются источниками истины.
 
@@ -437,7 +449,7 @@ truthmark check
 | --- | --- |
 | `truthmark index` | Строит JSON RepoIndex и RouteMap для активного checkout. |
 | `truthmark impact --base <ref>` | Сопоставляет измененные файлы с routed truth docs, owning routes, nearby tests и public symbols. |
-| `truthmark context --workflow <workflow> [--base <ref>]` | Генерирует ограниченный ContextPack для Truth Sync, Truth Document или Truth Realize. Используйте `--format markdown` для человекочитаемой версии. |
+| `truthmark ctx --workflow <workflow> [--base <ref>]` | Генерирует ограниченный ContextPack для Truth Sync, Truth Document или Truth Realize. Используйте `--format markdown` для человекочитаемой версии. |
 
 Структурированный вывод доступен с `--json` там, где поддерживается.
 
@@ -456,10 +468,10 @@ Truthmark Portal — опциональный презентационный wor
 Включите его namespaced config-блоком:
 
 ```yaml
-truthmark-portal:
-  enabled: true
-  output: docs/truthmark-portal
-  template: default
+truthmark:
+  generated:
+    portal:
+      enabled: true
 ```
 
 Затем запустите снова:
@@ -468,7 +480,7 @@ truthmark-portal:
 truthmark init
 ```
 
-Когда Portal включен, Truthmark устанавливает host-native Portal workflow surfaces для настроенных платформ, например `/truthmark-portal` или `/truthmark:portal` в зависимости от agent host.
+Когда Portal включен, Truthmark устанавливает host-native Portal-интерфейсы workflow для настроенных платформ, например `/truthmark-portal` или `/truthmark:portal` в зависимости от agent host.
 
 ## Конфигурация
 
@@ -497,15 +509,15 @@ truthmark init
 | Область config | Назначение |
 | --- | --- |
 | `version` | Версия контракта config. |
-| `platforms` | Agent hosts, которые должны получить сгенерированные поверхности для платформы. |
-| `docs.layout` | Текущий режим layout документации. |
-| `docs.roots` | Именованные корни канонической документации. |
-| `docs.routing.root_index` | Путь к корневому индексу маршрутов. |
-| `docs.routing.area_files_root` | Директория для делегированных дочерних файлов маршрутов. |
-| `docs.routing.default_area` | Базовое имя начального scaffolded дочернего маршрута. |
-| `docs.routing.max_delegation_depth` | Текущая максимальная глубина делегирования routing. |
-| `truthmark-portal` | Опциональные настройки ручного презентационного workflow: `enabled`, `output` и `template`. |
-| `authority` | Упорядоченные канонические docs и globs, используемые как authority истины репозитория. |
+| `platforms` | Agent hosts, которые должны получить сгенерированные интерфейсы для платформы. |
+| `truthmark.workspace` | Workspace, принадлежащий Truthmark, для маршрутов, документов истины, шаблонов и сгенерированного презентационного вывода. |
+| `truthmark.routes.index` | Путь к корневому индексу маршрутов относительно `truthmark.workspace`. |
+| `truthmark.routes.areas` | Директория делегированных дочерних маршрутов относительно `truthmark.workspace`. |
+| `truthmark.routes.default_area` | Базовое имя начального scaffolded дочернего маршрута. |
+| `truthmark.routes.max_delegation_depth` | Текущая максимальная глубина делегирования routing. |
+| `truthmark.truth.root` | Корень документов истины относительно `truthmark.workspace`. |
+| `truthmark.templates.root` | Корень шаблонов документов истины относительно `truthmark.workspace`. |
+| `truthmark.generated.portal` | Опциональное включение ручного презентационного workflow: `enabled`. |
 | `instruction_targets` | Файлы, которые получают общие управляемые блоки инструкций, например `AGENTS.md`. |
 | `frontmatter.required` | Поля metadata, которые создают error diagnostics при отсутствии. |
 | `frontmatter.recommended` | Поля metadata, которые создают review diagnostics при отсутствии. |
@@ -518,8 +530,8 @@ Truthmark сопоставляет code surfaces с документами ис
 Основные файлы маршрутизации:
 
 ```text
-docs/truthmark/areas.md
-docs/truthmark/areas/**/*.md
+docs/truthmark/routes/areas.md
+docs/truthmark/routes/areas/**/*.md
 ```
 
 Маршрут сообщает агенту:
@@ -534,7 +546,7 @@ docs/truthmark/areas/**/*.md
 Пример:
 
 ```text
-/truthmark-structure раздели широкий repository area на frontend, backend, billing и deployment
+/truthmark-structure раздели широкий repo area на frontend, backend, billing и deployment
 ```
 
 Хороший routing дает Truth Sync точные цели.
@@ -549,12 +561,12 @@ Truthmark устанавливает компактный, встроенный
 
 - config и routing для границ владения
 - канонические truth docs и стартовые шаблоны
-- компактные управляемые instruction blocks для repo-wide agent context
+- компактные управляемые instruction blocks для repo-wide agent instructions
 - host-native workflow packages, commands, prompts и verifier agents для платформ, включённых в config
 
 Truthmark сохраняет ручной контент вне управляемых блоков инструкций.
 
-Сгенерированные поверхности workflow управляются Truthmark и могут обновляться повторным запуском:
+Сгенерированные интерфейсы workflow управляются Truthmark и могут обновляться повторным запуском:
 
 ```bash
 truthmark init
@@ -627,13 +639,13 @@ truthmark check
 ### Разделить широкий routing
 
 ```text
-/truthmark-structure раздели широкий repository area на auth, billing, notifications и deployment
+/truthmark-structure раздели широкий repo area на auth, billing, notifications и deployment
 ```
 
 ### Документировать реализованное поведение
 
 ```text
-/truthmark-document задокументируй реализованный password reset flow в docs/truth/authentication
+/truthmark-document задокументируй реализованный password reset flow в docs/truthmark/truth/authentication
 ```
 
 ### Синхронизировать после изменений кода
@@ -645,7 +657,7 @@ truthmark check
 ### Реализовать doc-first решение
 
 ```text
-/truthmark-realize реализуй docs/truth/billing/invoice-retry-policy.md в коде
+/truthmark-realize реализуй docs/truthmark/truth/billing/invoice-retry-policy.md в коде
 ```
 
 ### Проверить здоровье истины из терминала
@@ -654,25 +666,25 @@ truthmark check
 truthmark check
 ```
 
-### Создать branch-impact context
+### Создать summary branch-impact
 
 ```bash
 truthmark impact --base main
 ```
 
-### Создать workflow context
+### Создать workflow ContextPack
 
 ```bash
-truthmark context --workflow truth-sync --base main --format markdown
+truthmark ctx --workflow truth-sync --base main --format markdown
 ```
 
 ### Включить опциональный Portal workflow
 
 ```yaml
-truthmark-portal:
-  enabled: true
-  output: docs/truthmark-portal
-  template: default
+truthmark:
+  generated:
+    portal:
+      enabled: true
 ```
 
 ```bash
@@ -690,19 +702,19 @@ Truthmark V1 сейчас предоставляет:
 - `truthmark check`
 - `truthmark index`
 - `truthmark impact`
-- `truthmark context`
+- `truthmark ctx`
 - branch-scope metadata
 - управляемые блоки инструкций
-- сгенерированные поверхности workflow Truth Structure
-- сгенерированные поверхности workflow Truth Document
-- сгенерированные поверхности workflow Truth Sync
-- сгенерированные поверхности workflow Truth Preview
-- сгенерированные поверхности workflow Truth Realize
-- сгенерированные поверхности workflow Truth Check
-- опциональные сгенерированные поверхности workflow Truthmark Portal
+- сгенерированные интерфейсы workflow Truth Structure
+- сгенерированные интерфейсы workflow Truth Document
+- сгенерированные интерфейсы workflow Truth Sync
+- сгенерированные интерфейсы workflow Truth Preview
+- сгенерированные интерфейсы workflow Truth Realize
+- сгенерированные интерфейсы workflow Truth Check
+- опциональные сгенерированные интерфейсы workflow Truthmark Portal
 - diagnostics для route, authority, decision-structure, frontmatter, links, freshness, generated-surface и coverage
 - производные артефакты RepoIndex, RouteMap, ImpactSet и ContextPack
-- host-specific поверхности для Codex, Claude Code, GitHub Copilot, OpenCode и Gemini CLI
+- host-specific интерфейсы для Codex, Claude Code, GitHub Copilot, OpenCode и Gemini CLI
 
 ## Разработка
 
@@ -746,11 +758,11 @@ README — быстрый путь для оценки и настройки.
 Подробное текущее поведение живет в `docs/`:
 
 - [Индекс документации](docs/README.md)
-- [Обзор архитектуры](docs/architecture/overview.md)
-- [Контракты API и CLI](docs/truth/contracts.md)
-- [Поведение init и scaffold](docs/truth/init-and-scaffold.md)
-- [Диагностика check](docs/truth/check-diagnostics.md)
-- [Установленные workflows](docs/truth/workflows/overview.md)
+- [Обзор архитектуры](docs/truthmark/truth/architecture/overview.md)
+- [Контракты API и CLI](docs/truthmark/truth/contracts.md)
+- [Поведение init и scaffold](docs/truthmark/truth/init-and-scaffold.md)
+- [Диагностика check](docs/truthmark/truth/check-diagnostics.md)
+- [Установленные workflows](docs/truthmark/truth/workflows/overview.md)
 - [Руководство по поддержанию истины репозитория](docs/standards/maintaining-repository-truth.md)
 
 ## Границы дизайна
@@ -784,16 +796,16 @@ Truthmark помогает репозиторию оставаться чест
 - проверять изменения документов истины
 - держать secrets вне документации
 - держать специфичные для репозитория инструкции вне managed blocks
-- проверять diff сгенерированных workflow surfaces после upgrades
+- проверять diff сгенерированных интерфейсов workflow после upgrades
 - сохранять человеческое владение продуктовыми и архитектурными решениями
 
-Truthmark делает контекст агента видимым. Он не заменяет человеческое суждение.
+Truthmark делает видимой ориентированную на агента истину репозитория. Он не заменяет человеческое суждение.
 
 ## Направление roadmap
 
 Текущее будущее направление делает акцент на:
 
-- более сильной evidence reporting в `truthmark check`
+- более подробной отчетности по подтверждениям в `truthmark check`
 - более ясных примерах adoption
 - примерных репозиториях, показывающих реальные циклы Truth Sync
 - migration guides для команд, уже использующих agent instruction files
@@ -807,7 +819,7 @@ Truthmark делает контекст агента видимым. Он не
 истина репозитория
 agent-native workflows
 Git review
-контекст в пределах ветки
+документация в пределах ветки
 ```
 
 ## Лицензия