truthmark 2.1.0 → 2.2.1

package/README.de.md

@@ -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.
 
@@ -511,12 +511,9 @@ Wichtige Config-Bereiche sind:
 | `version` | Version des Config-Vertrags. |
 | `platforms` | Agenten-Hosts, die plattformspezifische generierte Oberflächen erhalten sollen. |
 | `truthmark.workspace` | Truthmark-eigener Workspace für Routen, Truth-Dokumente, Vorlagen und generierte Präsentationsausgabe. |
-| `truthmark.routes.index` | Root-Routenindex relativ zu `truthmark.workspace`. |
-| `truthmark.routes.areas` | Verzeichnis für delegierte untergeordnete Routendateien relativ zu `truthmark.workspace`. |
-| `truthmark.routes.default_area` | Dateiname des initial erzeugten untergeordneten Routings ohne Erweiterung. |
-| `truthmark.routes.max_delegation_depth` | Aktuelle maximale Routing-Delegationstiefe. |
-| `truthmark.truth.root` | Truth-Dokumentwurzel relativ zu `truthmark.workspace`. |
-| `truthmark.templates.root` | Truth-Dokumentvorlagenwurzel relativ zu `truthmark.workspace`. |
+| Feste Routen | Routen liegen unter `routes/areas.md` und `routes/areas/` innerhalb von `truthmark.workspace`; die Standard-Area ist `repository`, die Delegationstiefe ist `1`. |
+| Feste Truth-Lanes | Product-Truth liegt unter `product/` und Engineering-Truth unter `engineering/` innerhalb von `truthmark.workspace`. |
+| Feste Vorlagen | Truth-Dokumentvorlagen liegen unter `templates/` innerhalb von `truthmark.workspace`. |
 | `truthmark.generated.portal` | Optionale manuelle Präsentations-Workflow-Aktivierung: `enabled`. |
 | `instruction_targets` | Dateien, die gemeinsam verwaltete Instruktionsblöcke erhalten, etwa `AGENTS.md`. |
 | `frontmatter.required` | Metadatenfelder, die bei Fehlen Error-Diagnostik erzeugen. |
@@ -645,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
@@ -657,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
@@ -672,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
@@ -702,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
@@ -713,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
@@ -749,7 +746,7 @@ Nützliche Skripte:
 | `npm run check` | Führt Lint, Typecheck, Tests und Build aus. |
 | `npm run release:check` | Führt release-orientierte Validierung aus. |
 
-Wenn du Truthmark selbst änderst, siehe [CONTRIBUTORS.md](CONTRIBUTORS.md).
+Wenn du Truthmark selbst änderst, siehe [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Dokumentation
 
@@ -758,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

@@ -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.
 
@@ -511,12 +511,9 @@ Las áreas importantes de configuración incluyen:
 | `version` | Versión del contrato de configuración. |
 | `platforms` | Hosts de agentes que deben recibir interfaces generadas específicas de plataforma. |
 | `truthmark.workspace` | Workspace propiedad de Truthmark para rutas, documentos de verdad, plantillas y salida de presentación generada. |
-| `truthmark.routes.index` | Ruta del índice raíz relativa a `truthmark.workspace`. |
-| `truthmark.routes.areas` | Directorio de rutas secundarias delegadas relativo a `truthmark.workspace`. |
-| `truthmark.routes.default_area` | Nombre base de la ruta secundaria inicial generada. |
-| `truthmark.routes.max_delegation_depth` | Profundidad máxima actual de delegación de rutas. |
-| `truthmark.truth.root` | Raíz de documentos de verdad relativa a `truthmark.workspace`. |
-| `truthmark.templates.root` | Raíz de plantillas de documentos de verdad relativa a `truthmark.workspace`. |
+| Rutas fijas | Las rutas viven en `routes/areas.md` y `routes/areas/` dentro de `truthmark.workspace`; el área predeterminada es `repository` y la profundidad de delegación es `1`. |
+| Carriles de verdad fijos | La verdad de producto vive en `product/` y la verdad de ingeniería en `engineering/` dentro de `truthmark.workspace`. |
+| Plantillas fijas | Las plantillas de documentos de verdad viven en `templates/` dentro de `truthmark.workspace`. |
 | `truthmark.generated.portal` | Activación opcional del flujo manual de presentación: `enabled`. |
 | `instruction_targets` | Archivos que reciben bloques de instrucciones administrados compartidos, como `AGENTS.md`. |
 | `frontmatter.required` | Campos de metadatos que producen diagnósticos de error cuando faltan. |
@@ -645,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
@@ -657,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
@@ -672,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
@@ -702,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
@@ -713,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
@@ -749,7 +746,7 @@ Scripts útiles:
 | `npm run check` | Ejecuta lint, typecheck, pruebas y build. |
 | `npm run release:check` | Ejecuta validación orientada a release. |
 
-Cuando cambies Truthmark en sí, consulta [CONTRIBUTORS.md](CONTRIBUTORS.md).
+Cuando cambies Truthmark en sí, consulta [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Documentación
 
@@ -758,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

@@ -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.
 
@@ -511,12 +511,9 @@ Important config areas include:
 | `version` | Config contract version. |
 | `platforms` | Agent hosts that should receive platform-specific generated surfaces. |
 | `truthmark.workspace` | Truthmark-owned workspace for routes, truth docs, templates, and generated presentation output. |
-| `truthmark.routes.index` | Root route index path relative to `truthmark.workspace`. |
-| `truthmark.routes.areas` | Directory for delegated child route files relative to `truthmark.workspace`. |
-| `truthmark.routes.default_area` | Initial scaffolded child route basename. |
-| `truthmark.routes.max_delegation_depth` | Current maximum route delegation depth. |
-| `truthmark.truth.root` | Truth doc root relative to `truthmark.workspace`. |
-| `truthmark.templates.root` | Truth-doc template root relative to `truthmark.workspace`. |
+| Fixed routes | Routes live under `routes/areas.md` and `routes/areas/` inside `truthmark.workspace`; the default area is `repository` and delegation depth is `1`. |
+| Fixed truth lanes | Product truth lives under `product/` and engineering truth under `engineering/` inside `truthmark.workspace`. |
+| Fixed templates | Truth-doc templates live under `templates/` inside `truthmark.workspace`. |
 | `truthmark.generated.portal` | Optional manual presentation workflow enablement: `enabled`. |
 | `instruction_targets` | Files that receive shared managed instruction blocks, such as `AGENTS.md`. |
 | `frontmatter.required` | Metadata fields that produce error diagnostics when missing. |
@@ -645,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
@@ -657,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
@@ -672,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
@@ -702,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
@@ -713,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
@@ -749,7 +746,7 @@ Useful scripts:
 | `npm run check` | Run lint, typecheck, tests, and build. |
 | `npm run release:check` | Run release-oriented validation. |
 
-When changing Truthmark itself, see [CONTRIBUTORS.md](CONTRIBUTORS.md).
+When changing Truthmark itself, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Documentation
 
@@ -758,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

@@ -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` там, где поддерживается.
 
@@ -511,12 +511,9 @@ truthmark init
 | `version` | Версия контракта config. |
 | `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`. |
+| Фиксированные маршруты | Маршруты находятся в `routes/areas.md` и `routes/areas/` внутри `truthmark.workspace`; область по умолчанию — `repository`, глубина делегирования — `1`. |
+| Фиксированные дорожки истины | Product truth находится в `product/`, а engineering truth в `engineering/` внутри `truthmark.workspace`. |
+| Фиксированные шаблоны | Шаблоны документов истины находятся в `templates/` внутри `truthmark.workspace`. |
 | `truthmark.generated.portal` | Опциональное включение ручного презентационного workflow: `enabled`. |
 | `instruction_targets` | Файлы, которые получают общие управляемые блоки инструкций, например `AGENTS.md`. |
 | `frontmatter.required` | Поля metadata, которые создают error diagnostics при отсутствии. |
@@ -645,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
 ```
 
 ### Синхронизировать после изменений кода
@@ -657,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 в коде
 ```
 
 ### Проверить здоровье истины из терминала
@@ -672,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
@@ -702,7 +699,7 @@ Truthmark V1 сейчас предоставляет:
 - `truthmark check`
 - `truthmark index`
 - `truthmark impact`
-- `truthmark ctx`
+- `truthmark workflow status`
 - branch-scope metadata
 - управляемые блоки инструкций
 - сгенерированные интерфейсы workflow Truth Structure
@@ -713,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
 
 ## Разработка
@@ -749,7 +746,7 @@ npm run check
 | `npm run check` | Запускает lint, typecheck, tests и build. |
 | `npm run release:check` | Запускает release-oriented validation. |
 
-Когда меняете сам Truthmark, смотрите [CONTRIBUTORS.md](CONTRIBUTORS.md).
+Когда меняете сам Truthmark, смотрите [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Документация
 
@@ -758,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

@@ -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` 获取结构化输出。
 
@@ -511,12 +511,9 @@ truthmark init
 | `version` | 配置契约版本。 |
 | `platforms` | 应接收平台专属生成接口的代理宿主。 |
 | `truthmark.workspace` | Truthmark 拥有的工作区，用于路由、事实文档、模板和生成的展示输出。 |
-| `truthmark.routes.index` | 相对于 `truthmark.workspace` 的根路由索引路径。 |
-| `truthmark.routes.areas` | 相对于 `truthmark.workspace` 的委托子路由目录。 |
-| `truthmark.routes.default_area` | 初始脚手架子路由 basename。 |
-| `truthmark.routes.max_delegation_depth` | 当前最大路由委托深度。 |
-| `truthmark.truth.root` | 相对于 `truthmark.workspace` 的事实文档根。 |
-| `truthmark.templates.root` | 相对于 `truthmark.workspace` 的事实文档模板根。 |
+| 固定路由 | 路由固定在 `truthmark.workspace` 内的 `routes/areas.md` 和 `routes/areas/`；默认 area 是 `repository`，委托深度为 `1`。 |
+| 固定事实分区 | 产品事实位于 `truthmark.workspace` 内的 `product/`，工程事实位于 `engineering/`。 |
+| 固定模板 | 事实文档模板固定在 `truthmark.workspace` 内的 `templates/`。 |
 | `truthmark.generated.portal` | 可选手动展示工作流启用设置：`enabled`。 |
 | `instruction_targets` | 接收共享受管指令块的文件，例如 `AGENTS.md`。 |
 | `frontmatter.required` | 缺失时产生错误诊断的元数据字段。 |
@@ -645,7 +642,7 @@ truthmark check
 ### 记录已实现行为
 
 ```text
-/truthmark-document 在 docs/truthmark/truth/authentication 下记录已实现的密码重置流程
+/truthmark-document 在 docs/truthmark/engineering/behaviors/authentication 下记录已实现的密码重置流程
 ```
 
 ### 代码变更后同步
@@ -657,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 实现到代码中
 ```
 
 ### 从终端审计事实健康
@@ -672,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 工作流
@@ -702,7 +699,7 @@ Truthmark V1 目前提供：
 - `truthmark check`
 - `truthmark index`
 - `truthmark impact`
-- `truthmark ctx`
+- `truthmark workflow status`
 - 分支范围元数据
 - 受管指令块
 - 生成的 Truth Structure 工作流接口
@@ -713,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 的宿主专属接口
 
 ## 开发
@@ -749,7 +746,7 @@ npm run check
 | `npm run check` | 运行 lint、typecheck、测试和 build。 |
 | `npm run release:check` | 运行面向发布的验证。 |
 
-修改 Truthmark 本身时，请参阅 [CONTRIBUTORS.md](CONTRIBUTORS.md)。
+修改 Truthmark 本身时，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
 
 ## 文档
 
@@ -758,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)
 
 ## 设计边界