truthmark 2.2.0 → 2.2.2

package/README.de.md

@@ -171,7 +171,7 @@ Die konkreten Dateien hängen von `.truthmark/config.yml` ab, aber die Installat
 
 Die meisten Repositories brauchen nach der Initialisierung einen Aufräumschritt.
 
-Das Standard-Scaffold beginnt mit einem breiten Bereich `repository`. Echte Repositories brauchen meist präziseres Routing.
+Das Standard-Scaffold beginnt mit einem vorläufigen breiten Bootstrap-Bereich `repository`. Bevor echter Code normal synchronisiert wird, teile diese Bootstrap-Route in präzises Routing auf.
 
 Bitte deinen Agenten, die breite Route in tatsächliche Produkt-, Service-, Domänen- oder Ownership-Bereiche aufzuteilen:
 
@@ -394,7 +394,7 @@ Es darf keinen funktionalen Code ändern.
 Nutze Truth Realize, wenn eine Produkt- oder Architekturentscheidung in Dokumenten beginnt und Code daran angepasst werden soll.
 
 ```text
-/truthmark-realize docs/truthmark/truth/authentication/session-timeout.md in Code realisieren
+/truthmark-realize docs/truthmark/product/capabilities/session-timeout.md in Code realisieren
 ```
 
 Truth Realize ist doc-first.
@@ -441,7 +441,7 @@ Die meisten Maintainer beginnen mit drei Befehlen.
 | `truthmark init` | Installiert oder aktualisiert konfigurierte Workflow-Schnittstellen aus der geprüften Config. |
 | `truthmark check` | Validiert Config, Autorität, Routing, entscheidungstragende Dokumente, Frontmatter, interne Links, Branch-Scope, generierte Oberflächen, Freshness und Coverage-Diagnostik. |
 
-Optionale Repository-Intelligence-Helfer erzeugen abgeleitetes Review-Material für den aktiven Checkout, etwa RepoIndex-, RouteMap-, ImpactSet- und begrenzte ContextPack-Artefakte. Generierte Workflow-Skill-Pakete können außerdem Helper-Manifeste und Helper-Policies bereitstellen, die installierte `truthmark validate ... --json` CLI-Validatoren aufrufen; diese Helpers sind Beschleuniger, keine im Repository gebündelten lokalen Skripte und keine Quellen der Wahrheit. Eigenständige Copilot-Prompts und Gemini-Commands verwenden denselben CLI-Validator-Vertrag, wenn der installierte Runner verfügbar ist; andernfalls melden sie einen sichtbaren übersprungenen Helper-Status und führen eine manuelle Validierung durch.
+Optionale Repository-Intelligence-Helfer erzeugen abgeleitetes Review-Material für den aktiven Checkout, etwa RepoIndex-, RouteMap-, ImpactSet- und kompaktes WorkflowState/action-context-JSON. Generierte Workflow-Skill-Pakete können außerdem Helper-Manifeste und Helper-Policies bereitstellen, die installierte `truthmark validate ... --json` CLI-Validatoren aufrufen; diese Helpers sind Beschleuniger, keine im Repository gebündelten lokalen Skripte und keine Quellen der Wahrheit. Eigenständige Copilot-Prompts und Gemini-Commands verwenden denselben CLI-Validator-Vertrag, wenn der installierte Runner verfügbar ist; andernfalls melden sie einen sichtbaren übersprungenen Helper-Status und führen eine manuelle Validierung durch.
 
 Sie sind keine Quellen der Wahrheit.
 
@@ -449,7 +449,7 @@ Sie sind keine Quellen der Wahrheit.
 | --- | --- |
 | `truthmark index` | Baut RepoIndex- und RouteMap-JSON für den aktiven Checkout. |
 | `truthmark impact --base <ref>` | Ordnet geänderte Dateien gerouteten Truth-Dokumenten, besitzenden Routen, nahen Tests und öffentlichen Symbolen zu. |
-| `truthmark ctx --workflow <workflow> [--base <ref>]` | Erzeugt ein begrenztes ContextPack für Truth Sync, Truth Document oder Truth Realize. Nutze `--format markdown` für eine menschenlesbare Fassung. |
+| `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | Liefert Workflow-Anwendbarkeit, Schreibgrenzen, Ziel-Truth-Dokumente, Checks, Helper-Commands und kompakte Hinweise zu betroffenen Tests. |
 
 Strukturierte Ausgabe ist mit `--json` verfügbar, wo sie unterstützt wird.
 
@@ -538,7 +538,7 @@ Eine Route sagt dem Agenten:
 - wann Truth aktualisiert werden sollte
 - welche Art von Truth-Dokument beteiligt ist
 
-Das Standard-Scaffold beginnt breit. Bestehende Repositories sollten die Standardroute meist in echte Ownership-Bereiche aufteilen.
+Das Standard-Scaffold beginnt mit einer vorläufigen breiten Bootstrap-Route, damit ein neues Repository routbar ist. Wenn echter Code berührt wird, teile diese Bootstrap-Route vor normalem Truth Sync in echte Produkt-, Service-, Domänen- oder Ownership-Bereiche auf; mache den Bootstrap-Handoff nicht zu einem Catch-all-Verhaltensdokument.
 
 Beispiel:
 
@@ -642,7 +642,7 @@ truthmark check
 ### Implementiertes Verhalten dokumentieren
 
 ```text
-/truthmark-document den implementierten Password-Reset-Flow unter docs/truthmark/truth/authentication dokumentieren
+/truthmark-document den implementierten Password-Reset-Flow unter docs/truthmark/engineering/behaviors/authentication dokumentieren
 ```
 
 ### Nach Codeänderungen synchronisieren
@@ -654,7 +654,7 @@ truthmark check
 ### Eine doc-first Entscheidung realisieren
 
 ```text
-/truthmark-realize docs/truthmark/truth/billing/invoice-retry-policy.md in Code realisieren
+/truthmark-realize docs/truthmark/product/capabilities/invoice-retry-policy.md in Code realisieren
 ```
 
 ### Truth-Gesundheit im Terminal auditieren
@@ -669,10 +669,10 @@ truthmark check
 truthmark impact --base main
 ```
 
-### Workflow-ContextPack erzeugen
+### Workflow-Status prüfen
 
 ```bash
-truthmark ctx --workflow truth-sync --base main --format markdown
+truthmark workflow status --workflow truthmark-sync --base main --json
 ```
 
 ### Optionalen Portal-Workflow aktivieren
@@ -699,7 +699,7 @@ Truthmark V1 bietet derzeit:
 - `truthmark check`
 - `truthmark index`
 - `truthmark impact`
-- `truthmark ctx`
+- `truthmark workflow status`
 - Branch-Scope-Metadaten
 - verwaltete Instruktionsblöcke
 - generierte Truth-Structure-Workflow-Schnittstellen
@@ -710,7 +710,7 @@ Truthmark V1 bietet derzeit:
 - generierte Truth-Check-Workflow-Schnittstellen
 - optionale generierte Truthmark-Portal-Workflow-Schnittstellen
 - Diagnostik für Route, Autorität, Entscheidungsstruktur, Frontmatter, Links, Freshness, generierte Schnittstellen und Coverage
-- abgeleitete RepoIndex-, RouteMap-, ImpactSet- und ContextPack-Artefakte
+- abgeleitete RepoIndex-, RouteMap-, ImpactSet- und WorkflowState-Artefakte
 - host-spezifische Schnittstellen für Codex, Claude Code, GitHub Copilot, OpenCode und Gemini CLI
 
 ## Entwicklung
@@ -755,11 +755,11 @@ Die README ist der schnelle Pfad für Evaluation und Setup.
 Aktuelles Verhalten im Detail lebt unter `docs/`:
 
 - [Dokumentationsindex](docs/README.md)
-- [Architekturüberblick](docs/truthmark/truth/architecture/overview.md)
-- [API- und CLI-Verträge](docs/truthmark/truth/contracts.md)
-- [Init- und Scaffold-Verhalten](docs/truthmark/truth/init-and-scaffold.md)
-- [Check-Diagnostik](docs/truthmark/truth/check-diagnostics.md)
-- [Installierte Workflows](docs/truthmark/truth/workflows/overview.md)
+- [Architekturüberblick](docs/truthmark/engineering/architecture/overview.md)
+- [API- und CLI-Verträge](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Init- und Scaffold-Verhalten](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
+- [Check-Diagnostik](docs/truthmark/engineering/behaviors/check-diagnostics.md)
+- [Installierte Workflows](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
 - [Leitfaden zur Pflege von Repository-Truth](docs/standards/maintaining-repository-truth.md)
 
 ## Designgrenzen

package/README.es.md

@@ -171,7 +171,7 @@ Los archivos exactos dependen de `.truthmark/config.yml`, pero la instalación s
 
 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.
+El scaffold predeterminado empieza con un área amplia provisional de arranque `repository`. Antes de sincronizar código real de forma normal, divide esa ruta de arranque en rutas precisas.
 
 Pide a tu agente que divida la ruta amplia en áreas reales de producto, servicio, dominio o propiedad:
 
@@ -394,7 +394,7 @@ No debe cambiar código funcional.
 Usa Truth Realize cuando una decisión de producto o arquitectura empieza en documentos y el código debe actualizarse para coincidir.
 
 ```text
-/truthmark-realize realiza docs/truthmark/truth/authentication/session-timeout.md como código
+/truthmark-realize realiza docs/truthmark/product/capabilities/session-timeout.md como código
 ```
 
 Truth Realize es doc-first.
@@ -441,7 +441,7 @@ La mayoría de los mantenedores empieza con tres comandos.
 | `truthmark init` | Instala o refresca interfaces de flujo de trabajo configuradas desde la config revisada. |
 | `truthmark check` | Valida configuración, autoridad, rutas, documentos con decisiones, frontmatter, enlaces internos, alcance de rama, interfaces generadas, vigencia y diagnósticos de cobertura. |
 
-Los ayudantes opcionales de inteligencia del repositorio generan material derivado para revisión sobre el checkout activo, como artefactos RepoIndex, RouteMap, ImpactSet y ContextPack acotados. Los paquetes de skills de flujo generados también pueden exponer manifiestos y políticas 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 visible de helper omitido y hacen validación manual.
+Los ayudantes opcionales de inteligencia del repositorio generan material derivado para revisión sobre el checkout activo, como RepoIndex, RouteMap, ImpactSet y JSON compacto de WorkflowState/action-context. Los paquetes de skills de flujo generados también pueden exponer manifiestos y políticas 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 visible de helper omitido y hacen validación manual.
 
 No son fuentes de verdad.
 
@@ -449,7 +449,7 @@ No son fuentes de verdad.
 | --- | --- |
 | `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 ctx --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. |
+| `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | Devuelve aplicabilidad del flujo, límites de escritura, documentos de verdad objetivo, checks, comandos helper y guía compacta de pruebas afectadas. |
 
 La salida estructurada está disponible con `--json` donde se admite.
 
@@ -538,7 +538,7 @@ Una ruta le dice al agente:
 - 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.
+El scaffold predeterminado empieza con una ruta amplia provisional de arranque para que un repositorio nuevo sea enrutable. Cuando se toca código real, divide esa ruta de arranque en áreas reales de producto, servicio, dominio o propiedad antes de Truth Sync normal; no conviertas el handoff de arranque en un documento comodín de comportamiento.
 
 Ejemplo:
 
@@ -642,7 +642,7 @@ truthmark check
 ### Documentar comportamiento implementado
 
 ```text
-/truthmark-document documenta el flujo implementado de restablecimiento de contraseña bajo docs/truthmark/truth/authentication
+/truthmark-document documenta el flujo implementado de restablecimiento de contraseña bajo docs/truthmark/engineering/behaviors/authentication
 ```
 
 ### Sincronizar después de cambios de código
@@ -654,7 +654,7 @@ truthmark check
 ### Realizar una decisión doc-first
 
 ```text
-/truthmark-realize realiza docs/truthmark/truth/billing/invoice-retry-policy.md como código
+/truthmark-realize realiza docs/truthmark/product/capabilities/invoice-retry-policy.md como código
 ```
 
 ### Auditar la salud de verdad desde la terminal
@@ -669,10 +669,10 @@ truthmark check
 truthmark impact --base main
 ```
 
-### Generar un ContextPack de workflow
+### Inspeccionar el estado del workflow
 
 ```bash
-truthmark ctx --workflow truth-sync --base main --format markdown
+truthmark workflow status --workflow truthmark-sync --base main --json
 ```
 
 ### Habilitar el flujo Portal opcional
@@ -699,7 +699,7 @@ Truthmark V1 actualmente proporciona:
 - `truthmark check`
 - `truthmark index`
 - `truthmark impact`
-- `truthmark ctx`
+- `truthmark workflow status`
 - metadatos de alcance de rama
 - bloques de instrucciones administrados
 - interfaces generadas de flujo Truth Structure
@@ -710,7 +710,7 @@ Truthmark V1 actualmente proporciona:
 - interfaces generadas de flujo Truth Check
 - interfaces generadas opcionales de flujo Truthmark Portal
 - diagnósticos de rutas, autoridad, estructura de decisiones, frontmatter, enlaces, vigencia, interfaces generadas y cobertura
-- artefactos derivados RepoIndex, RouteMap, ImpactSet y ContextPack
+- artefactos derivados RepoIndex, RouteMap, ImpactSet y WorkflowState
 - interfaces específicas de host para Codex, Claude Code, GitHub Copilot, OpenCode y Gemini CLI
 
 ## Desarrollo
@@ -755,11 +755,11 @@ El README es el camino rápido para evaluación y configuración.
 El comportamiento actual detallado vive bajo `docs/`:
 
 - [Índice de documentación](docs/README.md)
-- [Resumen de arquitectura](docs/truthmark/truth/architecture/overview.md)
-- [Contratos de API y CLI](docs/truthmark/truth/contracts.md)
-- [Comportamiento de init y scaffold](docs/truthmark/truth/init-and-scaffold.md)
-- [Diagnósticos de check](docs/truthmark/truth/check-diagnostics.md)
-- [Flujos instalados](docs/truthmark/truth/workflows/overview.md)
+- [Resumen de arquitectura](docs/truthmark/engineering/architecture/overview.md)
+- [Contratos de API y CLI](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Comportamiento de init y scaffold](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
+- [Diagnósticos de check](docs/truthmark/engineering/behaviors/check-diagnostics.md)
+- [Flujos instalados](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
 - [Guía para mantener la verdad del repositorio](docs/standards/maintaining-repository-truth.md)
 
 ## Límites de diseño

package/README.md

@@ -171,7 +171,7 @@ The exact files depend on `.truthmark/config.yml`, but the install always has th
 
 Most repositories need one cleanup pass after initialization.
 
-The default scaffold starts with a broad `repository` area. Real repositories usually need more precise routing.
+The default scaffold starts with a provisional broad `repository` bootstrap area. Before normal syncing on real code, split that bootstrap route into precise routing.
 
 Ask your agent to split the broad route into actual product, service, domain, or ownership areas:
 
@@ -394,7 +394,7 @@ It must not change functional code.
 Use Truth Realize when a product or architecture decision starts in docs and code should be updated to match.
 
 ```text
-/truthmark-realize realize docs/truthmark/truth/authentication/session-timeout.md into code
+/truthmark-realize realize docs/truthmark/product/capabilities/session-timeout.md into code
 ```
 
 Truth Realize is doc-first.
@@ -441,7 +441,7 @@ Most maintainers start with three commands.
 | `truthmark init` | Install or refresh configured workflow surfaces from the reviewed config. |
 | `truthmark check` | Validate configuration, authority, routing, decision-bearing docs, frontmatter, internal links, branch scope, generated surfaces, freshness, and coverage diagnostics. |
 
-Optional repository-intelligence helpers generate derived review material for the active checkout, such as RepoIndex, RouteMap, ImpactSet, and bounded ContextPack artifacts. Generated workflow skill packages may also expose helper manifests and helper policies that call installed `truthmark validate ... --json` CLI validators; those helpers are accelerators, not bundled repo-local scripts or sources of truth. Standalone Copilot prompts and Gemini commands use the same CLI validator contract when the installed runner is available, and otherwise report a visible skipped helper status with manual validation.
+Optional repository-intelligence helpers generate derived review material for the active checkout, such as RepoIndex, RouteMap, ImpactSet, and compact WorkflowState/action-context JSON. Generated workflow skill packages may also expose helper manifests and helper policies that call installed `truthmark validate ... --json` CLI validators; those helpers are accelerators, not bundled repo-local scripts or sources of truth. Standalone Copilot prompts and Gemini commands use the same CLI validator contract when the installed runner is available, and otherwise report a visible skipped helper status with manual validation.
 
 They are not sources of truth.
 
@@ -449,7 +449,7 @@ They are not sources of truth.
 | --- | --- |
 | `truthmark index` | Build RepoIndex and RouteMap JSON for the active checkout. |
 | `truthmark impact --base <ref>` | Map changed files to routed truth docs, owning routes, nearby tests, and public symbols. |
-| `truthmark context --workflow <workflow> [--base <ref>]` | Generate a bounded ContextPack for Truth Sync, Truth Document, or Truth Realize. Use `--format markdown` for a human-readable pack. |
+| `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | Return workflow applicability, write boundaries, target truth docs, checks, helper commands, and compact affected-test guidance. |
 
 Structured output is available with `--json` where supported.
 
@@ -461,7 +461,7 @@ It is deliberately separate from the core truth workflow:
 
 - Markdown truth docs remain canonical.
 - Generated Portal HTML is presentation only.
-- Portal is manual-only; it does not run as a completion gate, Truth Sync step, `truthmark check` step, or automatic post-change hook.
+- Portal is manual-only; it does not run as a completion review, Truth Sync step, `truthmark check` step, or automatic post-change hook.
 - Portal writes stay inside the fixed Truthmark-derived output directory.
 - Generated pages should use local assets, source provenance, and a visible Markdown-canonical disclaimer.
 
@@ -538,7 +538,7 @@ A route tells the agent:
 - when truth should be updated
 - what kind of truth doc is involved
 
-The default scaffold starts broad. Existing repositories should usually split the default route into real ownership areas.
+The default scaffold starts with a provisional broad bootstrap route so a fresh repository is routeable. When real code is touched, split that bootstrap route into real product, service, domain, or ownership areas before normal Truth Sync; do not turn the bootstrap handoff into a catch-all behavior doc.
 
 Example:
 
@@ -642,7 +642,7 @@ truthmark check
 ### Document implemented behavior
 
 ```text
-/truthmark-document document the implemented password reset flow under docs/truthmark/truth/authentication
+/truthmark-document document the implemented password reset flow under docs/truthmark/engineering/behaviors/authentication
 ```
 
 ### Sync after code changes
@@ -654,7 +654,7 @@ truthmark check
 ### Realize a doc-first decision
 
 ```text
-/truthmark-realize realize docs/truthmark/truth/billing/invoice-retry-policy.md into code
+/truthmark-realize realize docs/truthmark/product/capabilities/invoice-retry-policy.md into code
 ```
 
 ### Audit truth health from the terminal
@@ -669,10 +669,10 @@ truthmark check
 truthmark impact --base main
 ```
 
-### Generate a workflow ContextPack
+### Inspect workflow status
 
 ```bash
-truthmark context --workflow truth-sync --base main --format markdown
+truthmark workflow status --workflow truthmark-sync --base main --json
 ```
 
 ### Enable the optional Portal workflow
@@ -699,7 +699,7 @@ Truthmark V1 currently provides:
 - `truthmark check`
 - `truthmark index`
 - `truthmark impact`
-- `truthmark context`
+- `truthmark workflow status`
 - branch-scope metadata
 - managed instruction blocks
 - generated Truth Structure workflow surfaces
@@ -710,7 +710,7 @@ Truthmark V1 currently provides:
 - generated Truth Check workflow surfaces
 - optional generated Truthmark Portal workflow surfaces
 - route, authority, decision-structure, frontmatter, link, freshness, generated-surface, and coverage diagnostics
-- derived RepoIndex, RouteMap, ImpactSet, and ContextPack artifacts
+- derived RepoIndex, RouteMap, ImpactSet, and WorkflowState artifacts
 - host-specific surfaces for Codex, Claude Code, GitHub Copilot, OpenCode, and Gemini CLI
 
 ## Development
@@ -755,11 +755,11 @@ The README is the fast path for evaluation and setup.
 Detailed current behavior lives under `docs/`:
 
 - [Docs index](docs/README.md)
-- [Architecture overview](docs/truthmark/truth/architecture/overview.md)
-- [API and CLI contracts](docs/truthmark/truth/contracts.md)
-- [Init and scaffold behavior](docs/truthmark/truth/init-and-scaffold.md)
-- [Check diagnostics](docs/truthmark/truth/check-diagnostics.md)
-- [Installed workflows](docs/truthmark/truth/workflows/overview.md)
+- [Architecture overview](docs/truthmark/engineering/architecture/overview.md)
+- [API and CLI contracts](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Init and scaffold behavior](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
+- [Check diagnostics](docs/truthmark/engineering/behaviors/check-diagnostics.md)
+- [Installed workflows](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
 - [Repository truth maintenance guide](docs/standards/maintaining-repository-truth.md)
 
 ## Design boundaries

package/README.ru.md

@@ -171,7 +171,7 @@ truthmark check
 
 Большинству репозиториев после инициализации нужен один этап очистки.
 
-Стандартный scaffold начинается с широкого area `repo`. Реальным репозиториям обычно нужна более точная маршрутизация.
+Стандартный scaffold начинается с временной широкой bootstrap-области `repository`. Перед обычной синхронизацией реального кода разделите этот bootstrap-маршрут на точные маршруты.
 
 Попросите агента разделить широкий маршрут на реальные области продукта, сервиса, домена или владения:
 
@@ -394,7 +394,7 @@ Truth Document проверяет реализацию, тесты, файлы
 Используйте Truth Realize, когда продуктовое или архитектурное решение начинается в docs и код нужно обновить под него.
 
 ```text
-/truthmark-realize реализуй docs/truthmark/truth/authentication/session-timeout.md в коде
+/truthmark-realize реализуй docs/truthmark/product/capabilities/session-timeout.md в коде
 ```
 
 Truth Realize работает doc-first.
@@ -441,7 +441,7 @@ truthmark check
 | `truthmark init` | Устанавливает или обновляет настроенные интерфейсы workflow из проверенной config. |
 | `truthmark check` | Валидирует config, authority, routing, документы с decisions, frontmatter, внутренние ссылки, branch scope, generated surfaces, freshness и coverage diagnostics. |
 
-Необязательные 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.
+Необязательные helpers repository-intelligence создают производные материалы для ревью активного checkout, например RepoIndex, RouteMap, ImpactSet и компактный WorkflowState/action-context JSON. Сгенерированные 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.
 
 Они не являются источниками истины.
 
@@ -449,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 ctx --workflow <workflow> [--base <ref>]` | Генерирует ограниченный ContextPack для Truth Sync, Truth Document или Truth Realize. Используйте `--format markdown` для человекочитаемой версии. |
+| `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | Возвращает применимость workflow, границы записи, целевые truth docs, checks, helper commands и компактные hints по affected tests. |
 
 Структурированный вывод доступен с `--json` там, где поддерживается.
 
@@ -461,7 +461,7 @@ Truthmark Portal — опциональный презентационный wor
 
 - Markdown-документы истины остаются каноническими.
 - Сгенерированный HTML Portal предназначен только для презентации.
-- Portal запускается только вручную; он не выполняется как completion gate, шаг Truth Sync, шаг `truthmark check` или автоматический post-change hook.
+- Portal запускается только вручную; он не выполняется как completion review, шаг Truth Sync, шаг `truthmark check` или автоматический post-change hook.
 - Записи Portal остаются внутри настроенной директории вывода, если пользователь явно не меняет scope.
 - Сгенерированные страницы должны использовать локальные assets, provenance источников и видимое уведомление, что Markdown является каноническим источником.
 
@@ -538,7 +538,7 @@ docs/truthmark/routes/areas/**/*.md
 - когда истину нужно обновлять
 - какой тип документа истины участвует
 
-Стандартный scaffold начинается широко. Существующие репозитории обычно должны разделить стандартный маршрут на реальные области владения.
+Стандартный scaffold сначала создаёт временный широкий bootstrap-маршрут, чтобы новый репозиторий можно было маршрутизировать. Когда затронут реальный код, до обычного Truth Sync разделите этот bootstrap-маршрут на реальные области продукта, сервиса, домена или владения; не превращайте bootstrap-handoff в универсальный документ поведения.
 
 Пример:
 
@@ -642,7 +642,7 @@ truthmark check
 ### Документировать реализованное поведение
 
 ```text
-/truthmark-document задокументируй реализованный password reset flow в docs/truthmark/truth/authentication
+/truthmark-document задокументируй реализованный password reset flow в docs/truthmark/engineering/behaviors/authentication
 ```
 
 ### Синхронизировать после изменений кода
@@ -654,7 +654,7 @@ truthmark check
 ### Реализовать doc-first решение
 
 ```text
-/truthmark-realize реализуй docs/truthmark/truth/billing/invoice-retry-policy.md в коде
+/truthmark-realize реализуй docs/truthmark/product/capabilities/invoice-retry-policy.md в коде
 ```
 
 ### Проверить здоровье истины из терминала
@@ -669,10 +669,10 @@ truthmark check
 truthmark impact --base main
 ```
 
-### Создать workflow ContextPack
+### Проверить workflow status
 
 ```bash
-truthmark ctx --workflow truth-sync --base main --format markdown
+truthmark workflow status --workflow truthmark-sync --base main --json
 ```
 
 ### Включить опциональный Portal workflow
@@ -699,7 +699,7 @@ Truthmark V1 сейчас предоставляет:
 - `truthmark check`
 - `truthmark index`
 - `truthmark impact`
-- `truthmark ctx`
+- `truthmark workflow status`
 - branch-scope metadata
 - управляемые блоки инструкций
 - сгенерированные интерфейсы workflow Truth Structure
@@ -710,7 +710,7 @@ Truthmark V1 сейчас предоставляет:
 - сгенерированные интерфейсы workflow Truth Check
 - опциональные сгенерированные интерфейсы workflow Truthmark Portal
 - diagnostics для route, authority, decision-structure, frontmatter, links, freshness, generated-surface и coverage
-- производные артефакты RepoIndex, RouteMap, ImpactSet и ContextPack
+- производные артефакты RepoIndex, RouteMap, ImpactSet и WorkflowState
 - host-specific интерфейсы для Codex, Claude Code, GitHub Copilot, OpenCode и Gemini CLI
 
 ## Разработка
@@ -755,11 +755,11 @@ README — быстрый путь для оценки и настройки.
 Подробное текущее поведение живет в `docs/`:
 
 - [Индекс документации](docs/README.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/truthmark/engineering/architecture/overview.md)
+- [Контракты API и CLI](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Поведение init и scaffold](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
+- [Диагностика check](docs/truthmark/engineering/behaviors/check-diagnostics.md)
+- [Установленные workflows](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
 - [Руководство по поддержанию истины репозитория](docs/standards/maintaining-repository-truth.md)
 
 ## Границы дизайна

package/README.zh.md

@@ -171,7 +171,7 @@ truthmark check
 
 大多数仓库在初始化后需要一次清理。
 
-默认脚手架从一个宽泛的 `repository` 区域开始。真实仓库通常需要更精确的路由。
+默认脚手架从一个临时的宽泛 `repository` 引导区域开始。真实代码进入正常同步前，应先把该引导路由拆成精确路由。
 
 让你的代理把宽泛路由拆成真实的产品、服务、领域或所有权区域：
 
@@ -394,7 +394,7 @@ Truth Document 会把实现、测试、路由文件和现有文档作为证据
 当产品或架构决策从文档开始，并且代码应更新以匹配时，使用 Truth Realize。
 
 ```text
-/truthmark-realize 将 docs/truthmark/truth/authentication/session-timeout.md 实现到代码中
+/truthmark-realize 将 docs/truthmark/product/capabilities/session-timeout.md 实现到代码中
 ```
 
 Truth Realize 是 doc-first。
@@ -441,7 +441,7 @@ truthmark check
 | `truthmark init` | 从已审查配置安装或刷新已配置的工作流接口。 |
 | `truthmark check` | 验证配置、权限边界、路由、承载决策的文档、frontmatter、内部链接、分支范围、生成接口、freshness 和覆盖率诊断。 |
 
-可选的仓库情报辅助工具会为当前 checkout 生成派生审查材料，例如 RepoIndex、RouteMap、ImpactSet 和有边界的 ContextPack 产物。生成的工作流 skill packages 也可以暴露 helper manifests 和 helper policies，用来调用已安装的 `truthmark validate ... --json` CLI validators；这些 helpers 是加速器，不是打包进仓库的本地脚本，也不是事实来源。独立的 Copilot prompts 和 Gemini commands 在已安装 runner 可用时使用同一 CLI validator contract；不可用时应报告可见的 skipped helper status，并进行 manual validation。
+可选的仓库情报辅助工具会为当前 checkout 生成派生审查材料，例如 RepoIndex、RouteMap、ImpactSet 和紧凑的 WorkflowState/action-context JSON。生成的工作流 skill packages 也可以暴露 helper manifests 和 helper policies，用来调用已安装的 `truthmark validate ... --json` CLI validators；这些 helpers 是加速器，不是打包进仓库的本地脚本，也不是事实来源。独立的 Copilot prompts 和 Gemini commands 在已安装 runner 可用时使用同一 CLI validator contract；不可用时应报告可见的 skipped helper status，并进行 manual validation。
 
 它们不是事实来源。
 
@@ -449,7 +449,7 @@ truthmark check
 | --- | --- |
 | `truthmark index` | 为当前 checkout 构建 RepoIndex 和 RouteMap JSON。 |
 | `truthmark impact --base <ref>` | 将变更文件映射到已路由事实文档、所属路由、附近测试和公开符号。 |
-| `truthmark ctx --workflow <workflow> [--base <ref>]` | 为 Truth Sync、Truth Document 或 Truth Realize 生成有边界的 ContextPack。使用 `--format markdown` 生成可读版本。 |
+| `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | 返回工作流适用性、写入边界、目标事实文档、检查项、helper commands 和紧凑的受影响测试指引。 |
 
 受支持位置可使用 `--json` 获取结构化输出。
 
@@ -538,7 +538,7 @@ docs/truthmark/routes/areas/**/*.md
 - 何时应该更新事实
 - 涉及哪类事实文档
 
-默认脚手架从宽泛路由开始。现有仓库通常应该把默认路由拆成真实所有权区域。
+默认脚手架先创建临时的宽泛引导路由，让新仓库可被路由。触及真实代码时，在正常 Truth Sync 前把该引导路由拆成真实产品、服务、领域或所有权区域；不要把引导交接文档写成兜底行为文档。
 
 示例：
 
@@ -642,7 +642,7 @@ truthmark check
 ### 记录已实现行为
 
 ```text
-/truthmark-document 在 docs/truthmark/truth/authentication 下记录已实现的密码重置流程
+/truthmark-document 在 docs/truthmark/engineering/behaviors/authentication 下记录已实现的密码重置流程
 ```
 
 ### 代码变更后同步
@@ -654,7 +654,7 @@ truthmark check
 ### 实现 doc-first 决策
 
 ```text
-/truthmark-realize 将 docs/truthmark/truth/billing/invoice-retry-policy.md 实现到代码中
+/truthmark-realize 将 docs/truthmark/product/capabilities/invoice-retry-policy.md 实现到代码中
 ```
 
 ### 从终端审计事实健康
@@ -669,10 +669,10 @@ truthmark check
 truthmark impact --base main
 ```
 
-### 生成工作流 ContextPack
+### 查看工作流状态
 
 ```bash
-truthmark ctx --workflow truth-sync --base main --format markdown
+truthmark workflow status --workflow truthmark-sync --base main --json
 ```
 
 ### 启用可选 Portal 工作流
@@ -699,7 +699,7 @@ Truthmark V1 目前提供：
 - `truthmark check`
 - `truthmark index`
 - `truthmark impact`
-- `truthmark ctx`
+- `truthmark workflow status`
 - 分支范围元数据
 - 受管指令块
 - 生成的 Truth Structure 工作流接口
@@ -710,7 +710,7 @@ Truthmark V1 目前提供：
 - 生成的 Truth Check 工作流接口
 - 可选生成的 Truthmark Portal 工作流接口
 - 路由、权限边界、决策结构、frontmatter、链接、freshness、生成接口和覆盖率诊断
-- 派生的 RepoIndex、RouteMap、ImpactSet 和 ContextPack 产物
+- 派生的 RepoIndex、RouteMap、ImpactSet 和 WorkflowState 产物
 - 面向 Codex、Claude Code、GitHub Copilot、OpenCode 和 Gemini CLI 的宿主专属接口
 
 ## 开发
@@ -755,11 +755,11 @@ README 是评估和设置的快速路径。
 详细的当前行为位于 `docs/` 下：
 
 - [文档索引](docs/README.md)
-- [架构概览](docs/truthmark/truth/architecture/overview.md)
-- [API 和 CLI 契约](docs/truthmark/truth/contracts.md)
-- [Init 和脚手架行为](docs/truthmark/truth/init-and-scaffold.md)
-- [Check 诊断](docs/truthmark/truth/check-diagnostics.md)
-- [已安装工作流](docs/truthmark/truth/workflows/overview.md)
+- [架构概览](docs/truthmark/engineering/architecture/overview.md)
+- [API 和 CLI 契约](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
+- [Init 和脚手架行为](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
+- [Check 诊断](docs/truthmark/engineering/behaviors/check-diagnostics.md)
+- [已安装工作流](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
 - [仓库事实维护指南](docs/standards/maintaining-repository-truth.md)
 
 ## 设计边界