chore(deps): bump the npm_and_yarn group across 1 directory with 2 updates (#40 )

Bumps the npm_and_yarn group with 2 updates in the / directory: [fast-uri](https://github.com/fastify/fast-uri) and [js-yaml](https://github.com/nodeca/js-yaml). Updates `fast-uri` from 3.1.4 to 3.1.5 - [Release notes](https://github.com/fastify/fast-uri/releases) - [Commits](https://github.com/fastify/fast-uri/compare/v3.1.4...v3.1.5) Updates `js-yaml` from 4.3.0 to 4.3.1 - [Changelog](https://github.com/nodeca/js-yaml/blob/4.3.1/CHANGELOG.md) - [Commits](https://github.com/nodeca/js-yaml/compare/4.3.0...4.3.1) --- updated-dependencies: - dependency-name: fast-uri dependency-version: 3.1.5 dependency-type: indirect dependency-group: npm_and_yarn - dependency-name: js-yaml dependency-version: 4.3.1 dependency-type: indirect dependency-group: npm_and_yarn ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
docs: replace README diagram with responsive visual
2026-08-25 07:53:25 +02:00 · 2026-08-19 16:35:24 +10:00 · 2026-08-02 03:25:27 +10:00 · 2026-08-02 03:25:27 +10:00 · 2026-07-31 18:54:10 +10:00 · 2026-07-30 23:03:23 +10:00
445 changed files with 17034 additions and 12658 deletions
@@ -9,15 +9,10 @@ user-invocable: true

 Use this skill to audit repository truth health.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect canonical docs and relevant implementation directly.
 - Report issues and suggested fixes; do not silently rewrite unrelated files.
- Read support/procedure.md before auditing details.
- Read support/subagents-and-leases.md only when dispatching verifier subagents.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill to audit repository truth health.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Truth Check is agent-led:

 - inspect .truthmark/config.yml and configured route files only when they exist; then inspect canonical docs and relevant implementation directly
@@ -9,16 +9,11 @@ user-invocable: true

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.

-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect existing canonical docs, implementation code, and tests directly.
 - Document current implemented behavior; do not invent future behavior.
 - May write canonical truth docs and truth routing files only; must not write functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -5,7 +5,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che
 # Truthmark Document

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.
-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.

 Truth Document is manual and implementation-first:

@@ -61,7 +60,12 @@ Treat the HTML comments under each template section as normative authoring guida
 Align existing docs to that template and write or repair section content so it satisfies the comment guidance while preserving accurate authored content.
 If the template is missing, use lane-specific sections: product truth says what must be true and why; engineering truth says how the repository currently realizes it.
 Teams may edit template files under the configured Truthmark templates root to define their local truth-doc standards.
-Prefer diff-friendly Markdown: one durable claim per bullet or line, paragraphs no longer than one or two short sentences, and bullets or tables for rules, criteria, fields, files, and lists.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Truth-doc shape repair review:
 - Truth Document may restructure only truth docs for the implemented behavior being documented.
 - repair shape in place only after the ownership review confirms the doc is the right bounded owner
@@ -9,15 +9,11 @@ user-invocable: true

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Read the source truth docs, inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist, then inspect tests and relevant functional code directly.
 - Truth docs lead; code follows.
 - may write functional code only; must not edit truth docs or truth routing while realizing those docs.
- Read support/procedure.md before changing code.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Truth Realize is doc-first:

 - truth docs lead
@@ -9,15 +9,11 @@ user-invocable: true

 Use this skill to design or repair Truthmark area structure.

-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect current docs and relevant code directly.
 - Define areas by product or behavior ownership, not by mechanical directory mirroring.
 - Do not edit functional code.
- Read support/procedure.md before writing route or starter truth-doc changes.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -3,7 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill to design or repair Truthmark area structure.
-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
+
 Truth Structure is agent-native:
 - inspect repository layout, current docs, Truthmark config and route files when present, and relevant code directly
 - Evidence authority:
@@ -9,17 +9,12 @@ user-invocable: true

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.

-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Skip docs-only, formatting-only, behavior-preserving renames with no truth impact, missing config, and no-code changes.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect relevant canonical docs directly.
 - direct checkout inspection is the canonical path; do not require the truthmark binary.
 - May write canonical truth docs and truth routing files only; must not rewrite functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -3,8 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.
-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-Explicit invocation runs immediately. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
+Explicit invocation runs immediately when the user directly requests this workflow. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
 Skip when changes are documentation-only, formatting-only, clearly behavior-preserving renames with no truth impact, when no Truthmark config exists yet, or when there are no functional code changes.
 Parent workflow:
 1. Inspect git status, staged changes, unstaged changes, and untracked files directly.
@@ -33,6 +32,12 @@ Parent workflow:
   - No-update-needed rationale: why mapped truth is already current when no truth doc should change
   - Blockers: missing routing, ambiguous ownership, failed verification, unavailable evidence, or off-boundary write needs
 11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, repair topology first when the repair is safe and in scope, otherwise stop and recommend Truth Structure instead of guessing.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Topology review and repair:
 - before updating truth docs, verify the changed code resolves to a specific behavior-owned area and bounded truth owner
 - if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when topology repair is safe and in scope
@@ -11,26 +11,26 @@ Changed code reviewed:

 Sync Intent:
 - Changed code reviewed: src/auth/session.ts
- Affected route/truth owner: docs/truthmark/routes/areas.md
- Target truth docs: docs/truthmark/engineering/repository/bootstrap-routing.md
+- Affected route/truth owner: docs/truthmark/routes/areas/authentication.md
+- Target truth docs: docs/truthmark/engineering/behaviors/session-timeout.md
 - Intended update: Update session timeout behavior.
- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
 - User-provided decisions/rationale: User rationale: session timeout behavior changed for internal implementation consistency
 - No-update-needed rationale: not applicable; mapped truth is stale
 - Blockers: none

 Ownership reviewed:
- docs/truthmark/routes/areas.md
+- docs/truthmark/routes/areas/authentication.md

 Truth docs updated:
- docs/truthmark/engineering/repository/bootstrap-routing.md
+- docs/truthmark/engineering/behaviors/session-timeout.md

 Decision/rationale captured:
- Placed user rationale in the mapped engineering truth doc under Engineering Decisions/Rationale.
+- Placed user rationale in the bounded authentication behavior truth doc under Engineering Decisions/Rationale.

 Evidence checked:
- Claim: Session timeout behavior is documented in the mapped repository truth doc.
-  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Claim: Session timeout behavior is documented in the bounded authentication behavior truth doc.
+  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
  Result: supported

 Notes:
@@ -41,11 +41,12 @@ Blocked report example:
 Truth Sync: blocked

 Reason:
- routing repair is not allowed
+- Changed code maps only to the provisional bootstrap route.

 Files requiring manual review:
- docs/truthmark/routes/areas.md
+- src/auth/**
+- docs/truthmark/routes/areas/repository.md

 Next action:
- update routing metadata and rerun Truth Sync
+- Run Truth Structure for src/auth/** before updating behavior truth.
 ```
@@ -0,0 +1,92 @@
+# Truthmark Check
+
+Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
+
+This rule is the Antigravity entrypoint for Truthmark Check.
+
+Do not invoke another Truthmark command from here.
+
+Manual invocation: @truthmark-check
+
+If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
+
+Description: Use when the user asks to audit repository truth health, routing, ownership, or canonical docs. Not for normal lint/test/typecheck/code-review verification, finish-time Sync, or silently rewriting docs.
+
+## Procedure
+
+# Truthmark Check
+
+Use this skill to audit repository truth health.
+
+Truth Check is agent-led:
+
+- inspect .truthmark/config.yml and configured route files only when they exist; then inspect canonical docs and relevant implementation directly
+- inspect the configured root route index at docs/truthmark/routes/areas.md and relevant child route files under docs/truthmark/routes/areas/ when they exist
+- Evidence authority:
+  - Repository instruction files and explicitly configured policy docs remain instruction authority when present; do not assume a repository uses any particular policy path.
+  - Implementation code and canonical truth docs are inspected evidence for current behavior; they do not silently override workflow write boundaries.
+- Lane classification:
+  - classify the request or changed surface as product-lane, engineering-lane, both-lane, or ambiguous for reporting only
+  - product-lane ownership belongs under docs/truthmark/product and describes product promises, boundaries, rationale, decisions, and success criteria
+  - engineering-lane ownership belongs under docs/truthmark/engineering and describes source-backed current realization, contracts, architecture, workflows, operations, or tests
+  - both-lane ownership uses separate product and engineering docs cross-linked in route YAML with realized_by and realizes, not in doc frontmatter
+  - ambiguous lane ownership should be reported for manual handoff or routed to Truth Structure
+  - Do not make product docs a summary of engineering docs. Do not make engineering docs a detailed version of product docs. Product truth says what must be true and why. Engineering truth says how the repository currently realizes it.
+- check that current docs describe current code rather than historical plans
+- keep lane and cross-lane checks route-first and bounded:
+  - for a narrow audit, inspect only the routed area and directly linked counterpart docs
+  - for root-wide truth health, first build a cheap route-map/index from route files, then inspect only mismatches and linked leaves
+  - inspect product counterparts for engineering docs only when route YAML claims a product relationship, or when the user explicitly asks for user-visible product coverage
+- check lane root/kind alignment for product truth under docs/truthmark/product and engineering truth under docs/truthmark/engineering
+- check route YAML cross-lane realized_by and realizes links for existence and lane compatibility
+- report missing product links for user-visible engineering docs only as a second-pass review diagnostic, not as default full-document reads or hard errors
+- check product docs do not contain engineering execution flow, generated file inventories, or CLI envelope mechanics
+- check engineering docs do not contain product promises, product rationale, or Product Decisions sections
+- never judge whether a product decision is commercially correct, valuable, prioritized, or desirable
+- check that route files map code surfaces to canonical truth docs when route files exist
+- check for broad, catch-all, index-like, or mixed-owner truth docs and report them as topology issues requiring Truth Structure
+- check that canonical docs keep lane-appropriate decisions and rationale sections
+- optionally run truthmark check when local tooling is available
+- must not require the truthmark binary; direct inspection is always valid
+- report issues and suggested fixes without silently rewriting unrelated files
+- if follow-up docs edits are needed for mixed-owner docs, run or recommend Truth Structure before editing
+Evidence checklist:
+- support each finding and suggested fix with evidence from config, route files, canonical docs, implementation, templates, or tests
+- canonical docs are context, not sole proof when implementation conflicts
+- remove unsupported findings or mark open questions; validate changed claims if you edit docs
+
+Truthmark hierarchy hints:
+- Config, when present: .truthmark/config.yml
+- Root route index, when present: docs/truthmark/routes/areas.md
+- Area route files, when present: docs/truthmark/routes/areas/**/*.md
+- Product truth docs, when present: docs/truthmark/product/**/*.md
+- Engineering truth docs, when present: docs/truthmark/engineering/**/*.md
+Decision truth lives in the canonical doc it governs; date active decisions inline when added or changed.
+Do not create separate active-decision ADR/planning logs; replace the active decision and let Git history carry the audit trail.
+Product decisions belong in product truth; engineering, architecture, contract, workflow, and operational decisions belong in engineering truth.
+
+## Report Template
+
+Report completion in this shape:
+
+```md
+Truth Check: completed
+
+Files reviewed:
+- docs/truthmark/routes/areas.md
+
+Issues found:
+- none
+
+Fixes suggested:
+- none
+
+Evidence checked:
+- Finding: The root route index is present and maps repository truth owners.
+  Evidence: docs/truthmark/routes/areas.md:1
+  Suggested fix: none
+  Confidence: high
+
+Validation:
+- truthmark check
+```
@@ -0,0 +1,137 @@
+# Truthmark Document
+
+Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
+
+This rule is the Antigravity entrypoint for Truthmark Document.
+
+Do not invoke another Truthmark command from here.
+
+Manual invocation: @truthmark-document
+
+If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
+
+Description: Use when the user asks to document existing implemented behavior, or Sync, Check, or Structure finds implemented behavior missing canonical truth. Not for functional-code changes, doc-first implementation, or topology repair that needs Structure.
+
+## Procedure
+
+# Truthmark Document
+
+Use this skill to document existing implemented behavior when no functional-code changes are required for the task.
+
+Truth Document is manual and implementation-first:
+
+- run only when the user explicitly asks to generate or update truth docs for existing behavior, or when Truth Sync, Truth Check, or Truth Structure reports implemented behavior that lacks canonical truth docs
+- inspect .truthmark/config.yml and configured route files only when they exist; then inspect existing canonical docs, implementation code, and tests directly
+- Evidence authority:
+  - Repository instruction files and explicitly configured policy docs remain instruction authority when present; do not assume a repository uses any particular policy path.
+  - Implementation code and canonical truth docs are inspected evidence for current behavior; they do not silently override workflow write boundaries.
+- Lane classification:
+  - before writing canonical truth docs, classify the request or change as product-lane, engineering-lane, both-lane, or ambiguous
+  - product-lane writes belong under docs/truthmark/product and state product promises, boundaries, rationale, decisions, and success criteria
+  - engineering-lane writes belong under docs/truthmark/engineering and state source-backed current realization, contracts, architecture, workflows, operations, or tests
+  - both-lane work must write separate product and engineering docs and cross-link them in route YAML with realized_by and realizes, not in doc frontmatter
+  - ambiguous lane ownership must stop or invoke Truth Structure instead of writing a mixed document
+  - Do not make product docs a summary of engineering docs. Do not make engineering docs a detailed version of product docs. Product truth says what must be true and why. Engineering truth says how the repository currently realizes it.
+- document current implemented behavior; do not invent future behavior or planned endpoints
+- may write canonical truth docs and docs/truthmark/routes/areas.md or relevant child route files only
+- must not write functional code
+- when routing is missing, stale, broad, overloaded, catch-all, or cannot map the behavior to a bounded truth owner, run Truth Structure first when routing repair is safe and in scope
+- stop and recommend Truth Structure when routing repair is unsafe, ambiguous, or outside the task boundary
+- keep feature README.md files as indexes rather than truth-document targets
+- create or update bounded leaf truth docs when behavior does not fit an existing leaf doc
+- write product capability/boundary truth under docs/truthmark/product when documenting product promise, boundary, rationale, or user/stakeholder value
+- write engineering truth under docs/truthmark/engineering when documenting implementation behavior, contracts, architecture, workflows, operations, or tests
+- for both-lane documentation requests, write separate product and engineering docs and cross-link them in route YAML with realized_by and realizes, not in doc frontmatter
+- keep engineering behavior truth behavior-oriented, not endpoint-oriented, unless the endpoint itself is the behavior boundary
+- keep API endpoint details in the nearest contract truth doc when such a doc owns the API contract
+- preserve unrelated authored content
+Truth-doc ownership review:
+- before editing or relying on the implemented behavior and candidate truth docs, verify each target/source truth doc is a bounded owner for the behavior
+- if a target/source doc mixes independent owners, spans unrelated behaviors, acts as an index, or needs cross-owner edits, do not patch or in-place repair it
+- if the target doc is broad, mixed-owner, index-like, or the documented behavior spans independent owners, run Truth Structure first when safe and in scope; otherwise stop and recommend Truth Structure
+- report Ownership reviewed, Structure required, Truth docs split, Truth docs restructured, or Manual handoff reason as applicable
+Decision/Rationale preservation review:
+- before any truth-doc split, restructure, or shape repair, inventory existing Product Decisions, Engineering Decisions, and Rationale sections in every source or touched truth doc
+- preserve each current decision and rationale in the correct product or engineering lane owner; when splitting, move it to the new owner doc rather than deleting it or leaving it in an index
+- remove or narrow a decision or rationale only when checkout evidence shows it is stale or unsupported, and report the exact claim, evidence, and result
+- if ownership of a decision or rationale is unclear, stop with manual-review files instead of deleting it or guessing
+- after the edit, verify every touched truth doc keeps lane-appropriate decision/rationale sections and every pre-existing entry is preserved, moved, narrowed, removed with evidence, or blocked
+Evidence checklist:
+- route-first: map the documented behavior to bounded route owners and primary canonical docs
+- review new or changed behavior-bearing claims only in touched docs, route ownership, lane-specific decisions, and rationale
+- support claims with primary checkout evidence: implementation, config, routing, generated templates, schemas, or contract definitions
+- tests/examples/canonical docs corroborate; they are not sole proof when implementation conflicts
+- remove, narrow, or record unsupported claims for manual handoff
+- if no truth doc changed, report why current truth was already sufficient or why documentation was blocked
+Repository intelligence artifacts are optional derived context: RepoIndex, RouteMap, ImpactSet, and WorkflowState/action context may guide routing, write boundaries, and verification planning when available.
+They do not override checkout evidence, canonical truth docs, route files, or workflow write boundaries.
+If unavailable, inspect any present Truthmark config, route files, source files, truth docs, and tests directly, then report that repository-intelligence artifacts were not generated.
+When creating or updating a truth doc, inspect the routed truth kind and use the matching template under the configured Truthmark templates root.
+Supported kinds: product-capability, engineering-behavior, engineering-contract, engineering-architecture, engineering-workflow, engineering-operations, and engineering-test-behavior.
+Treat the HTML comments under each template section as normative authoring guidance for that section.
+Align existing docs to that template and write or repair section content so it satisfies the comment guidance while preserving accurate authored content.
+If the template is missing, use lane-specific sections: product truth says what must be true and why; engineering truth says how the repository currently realizes it.
+Teams may edit template files under the configured Truthmark templates root to define their local truth-doc standards.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
+Truth-doc shape repair review:
+- Truth Document may restructure only truth docs for the implemented behavior being documented.
+- repair shape in place only after the ownership review confirms the doc is the right bounded owner
+- use Truth Structure for ownership splits; do not treat broad or mixed-owner docs as in-place repair work
+- repair shape when a narrow edit would make truth worse: missing template sections, stale evidence conflicts, cross-section updates within one owner, or wrong frontmatter/source/headings
+- preserve supported claims; remove, narrow, or record unsupported or stale claims for manual handoff
+- report docs restructured and why a narrow edit was not sufficient
+Maintain architecture docs only for structure-level changes: system structure, module boundaries, runtime topology, persistence boundaries, cross-cutting contracts, or generated-surface ownership.
+Keep ordinary behavior, endpoints, UI copy, validation rules, and bug fixes in behavior or contract docs unless they change those boundaries.
+Truthmark hierarchy hints:
+- Config, when present: .truthmark/config.yml
+- Root route index, when present: docs/truthmark/routes/areas.md
+- Area route files, when present: docs/truthmark/routes/areas/**/*.md
+- Product truth docs, when present: docs/truthmark/product/**/*.md
+- Engineering truth docs, when present: docs/truthmark/engineering/**/*.md
+Decision truth lives in the canonical doc it governs; date active decisions inline when added or changed.
+Do not create separate active-decision ADR/planning logs; replace the active decision and let Git history carry the audit trail.
+Product decisions belong in product truth; engineering, architecture, contract, workflow, and operational decisions belong in engineering truth.
+Optional validation: when local tooling is available, you may validate the final report with `truthmark validate document-report <report-file> --json`; direct checkout inspection and evidence review remain authoritative.
+Parent post-document verification:
+- verify only truth docs and leased truth routing files changed during document work
+- stop on functional code, generated host surfaces, or unrelated diffs caused by document work
+- for each write lease, validate the worker report against the actual worker diff, allowedWrites, forbiddenWrites, identity fields, filesChanged, offLeaseChanges, blockers, and expected report fields before accepting it
+- verify the final report records ownership review, structure requirement, restructure, routing update, or manual handoff reason when applicable
+
+## Report Template
+
+Report completion in this shape:
+```md
+Truth Document: completed
+
+Implementation reviewed:
+- src/routing/area-resolver.ts
+
+Ownership reviewed:
+- docs/truthmark/routes/areas.md
+
+Truth docs created:
+- docs/truthmark/engineering/contracts/routing.md
+
+Truth docs updated:
+- docs/truthmark/engineering/behaviors/check-diagnostics.md
+
+Truth docs restructured:
+- docs/truthmark/engineering/behaviors/check-diagnostics.md
+
+Routing updated:
+- docs/truthmark/routes/areas.md
+
+Evidence checked:
+- Claim: Route resolution behavior is documented in the contracts truth doc.
+  Evidence: src/routing/area-resolver.ts:14 / docs/truthmark/routes/areas.md:9
+  Result: supported
+
+Notes:
+- Documented routing and behavior from route handlers and tests.
+```
@@ -0,0 +1,71 @@
+# Truthmark Realize
+
+Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
+
+This rule is the Antigravity entrypoint for Truthmark Realize.
+
+Do not invoke another Truthmark command from here.
+
+Manual invocation: @truthmark-realize
+
+If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
+
+Description: Use when the user explicitly asks to realize Truthmark truth docs into code, including /truthmark-realize, $truthmark-realize, or /truthmark:realize. Not for syncing docs after code changes, documenting existing code, topology repair, or truth audits.
+
+## Procedure
+
+# Truthmark Realize
+
+Use this skill only when the user explicitly asks to realize truth docs into code.
+
+Truth Realize is doc-first:
+
+- truth docs lead
+- code follows
+- Truth Realize never edits the truth docs it is realizing
+
+Workflow:
+
+1. Read the updated truth docs named by the user, or infer the relevant docs from configured route files when present.
+2. Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then read tests and the relevant functional code.
+3. Repository instruction files and explicitly configured policy docs remain instruction authority when present; do not assume a repository uses any particular policy path.
+Implementation code and canonical truth docs are inspected evidence for current behavior; they do not silently override workflow write boundaries.
+Truth-doc ownership review:
+- before editing or relying on source truth docs before writing code, verify each target/source truth doc is a bounded owner for the behavior
+- if a target/source doc mixes independent owners, spans unrelated behaviors, acts as an index, or needs cross-owner edits, do not patch or in-place repair it
+- if a source truth doc is broad, mixed-owner, index-like, unrouteable, stale, or conflicts with implementation evidence, stop before writing code and recommend Truth Structure or Truth Document
+- report Ownership reviewed, Structure required, Truth docs split, Truth docs restructured, or Manual handoff reason as applicable
+4. Update functional code only so implementation matches bounded, current truth claims from the source docs.
+5. Do not edit truth docs or truth routing while realizing those docs.
+6. Run relevant tests for the changed code.
+7. Report changed code files and verification steps.
+Truthmark hierarchy hints:
+- Config, when present: .truthmark/config.yml
+- Root route index, when present: docs/truthmark/routes/areas.md
+- Area route files, when present: docs/truthmark/routes/areas/**/*.md
+- Product truth docs, when present: docs/truthmark/product/**/*.md
+- Engineering truth docs, when present: docs/truthmark/engineering/**/*.md
+
+Read and write boundaries:
+
+- may read truth docs, routing docs, and relevant functional code
+- may write functional code only
+- must not edit truth docs or truth routing while realizing those docs
+
+## Report Template
+
+Report completion in this shape:
+
+```md
+Truth Realize: completed
+
+Truth docs used:
+- docs/truthmark/product/capabilities/authentication-session.md
+- docs/truthmark/engineering/behaviors/authentication-session.md
+
+Code updated:
+- src/auth/session.ts
+
+Verification:
+- npm test -- auth
+```
@@ -0,0 +1,150 @@
+# Truthmark Structure
+
+Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
+
+This rule is the Antigravity entrypoint for Truthmark Structure.
+
+Do not invoke another Truthmark command from here.
+
+Manual invocation: @truthmark-structure
+
+If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
+
+Description: Use when routing or truth ownership is missing, stale, broad, overloaded, catch-all, unrouteable, mixed-owner, needs split/repair, or needs new area setup. Not for documenting implemented behavior, syncing a code diff, or realizing docs into code.
+
+## Procedure
+
+Use this skill to design or repair Truthmark area structure.
+
+Truth Structure is agent-native:
+- inspect repository layout, current docs, Truthmark config and route files when present, and relevant code directly
+- Evidence authority:
+  - Repository instruction files and explicitly configured policy docs remain instruction authority when present; do not assume a repository uses any particular policy path.
+  - Implementation code and canonical truth docs are inspected evidence for current behavior; they do not silently override workflow write boundaries.
+- Lane classification:
+  - before writing canonical truth docs, classify the request or change as product-lane, engineering-lane, both-lane, or ambiguous
+  - product-lane writes belong under docs/truthmark/product and state product promises, boundaries, rationale, decisions, and success criteria
+  - engineering-lane writes belong under docs/truthmark/engineering and state source-backed current realization, contracts, architecture, workflows, operations, or tests
+  - both-lane work must write separate product and engineering docs and cross-link them in route YAML with realized_by and realizes, not in doc frontmatter
+  - ambiguous lane ownership must stop or invoke Truth Structure instead of writing a mixed document
+  - Do not make product docs a summary of engineering docs. Do not make engineering docs a detailed version of product docs. Product truth says what must be true and why. Engineering truth says how the repository currently realizes it.
+- inspect the configured root route index at docs/truthmark/routes/areas.md and relevant child route files under docs/truthmark/routes/areas/ when they exist
+- define areas by product or behavior ownership, not by mechanical directory mirroring
+- create or repair docs/truthmark/routes/areas.md
+- create skeletal starter truth docs only when missing ownership would otherwise block future workflows
+- Starter truth docs must use closed YAML frontmatter bounded by opening and closing --- lines; include status, truth_kind, and last_reviewed inside that frontmatter. Put source references in the final ## Source References section, not in frontmatter.
+- Starter truth docs are ownership anchors, not behavior writeups: include only the title, bounded area/scope, and Source References needed to make routing explicit.
+- Starter truth docs must keep product and engineering truth in separate files; leave substantive behavior, contract, architecture, workflow, operations, or test prose to Truth Document.
+
+- use docs/truthmark/product/** for product truth destinations
+- use docs/truthmark/engineering/** for engineering truth destinations
+- use only canonical current-truth destinations for starter truth docs
+- keep Product Decisions in product truth and Engineering Decisions in engineering truth when selecting destinations; report any relocation need instead of rewriting decision prose during topology review
+- preserve unrelated authored content
+## New area setup
+Use when a user asks to onboard a new code area into Truthmark, a new package, controller, domain, or product area lacks bounded truth ownership, or a new product area needs routing and starter truth docs.
+Do:
+- inspect the named code area
+- infer bounded product or behavior ownership
+- choose the owning route when ownership is clear; otherwise propose the route and stop for manual review
+- create or update the child route entry or file
+- create starter truth docs only where current truth is missing
+- report the initial truth boundary
+Do not:
+- do not edit functional code
+- do not perform full behavior documentation unless evidence is inspected and the task explicitly asks for it
+- do not patch broad or mixed-owner docs in place
+- do not create generic catch-all docs
+- do not treat README files as Sync targets
+## Topology Governance
+Truth Structure owns documentation topology, lane splits, decision relocation, and relationship repair. Do not depend on humans to manually organize docs/truthmark/product or docs/truthmark/engineering. Treat both configured lane roots as managed semantic roots.
+Inspect controllers, routes, handlers, services, packages, tests, existing truth docs, and route files; infer product and domain ownership from behavior boundaries, not from mechanical directory mirroring.
+When topology pressure exists, repair route structure before creating or extending truth ownership anchors.
+Truth-doc ownership review:
+- before editing or relying on candidate route owners and current truth docs, verify each target/source truth doc is a bounded owner for the behavior
+- if a target/source doc mixes independent owners, spans unrelated behaviors, acts as an index, or needs cross-owner edits, do not patch or in-place repair it
+- if a truth doc mixes independent owners, route ownership is broad, or a split is required for bounded ownership, split or reroute only the ownership topology when safe; otherwise stop with manual-review files
+- report Ownership reviewed, Structure required, Truth docs split, Truth docs restructured, or Manual handoff reason as applicable
+Topology pressure signals:
+- one area maps broad code such as src/**, app/**, server/**, services/**, or packages/**
+- one area maps multiple unrelated controllers, route groups, services, or bounded contexts
+- one truth doc owns unrelated behaviors or unrelated endpoint families
+- either configured lane root has many direct non-index docs
+- a changed controller, route, or service cannot map to a specific behavior doc
+- Truth Sync would need to create a new generic truth doc because routing is too broad
+- endpoint or controller names reveal domains missing from docs/truthmark/routes/areas/**
+Use these review thresholds as guidance:
+- more than 10 direct truth docs in one folder
+- more than 15 leaf areas in one child route file
+- more than 8 truth docs mapped to one area
+- more than 5 controllers mapped through one catch-all area
+Repair rules:
+- split broad, overloaded, or catch-all areas into behavior-owned child route files
+- split or flag mixed-owner truth docs for bounded owners before any workflow adds new behavior claims
+- create route files under docs/truthmark/routes/areas/ when a product/domain boundary is clear
+- create skeletal engineering ownership anchors under docs/truthmark/engineering only when behavior lacks a current owner
+- create skeletal product ownership anchors under docs/truthmark/product only when product promise, boundary, rationale, or user-visible capability ownership is in scope
+- README.md files are indexes, not Truth Sync targets
+- prefer bounded product docs under product/capabilities or product/decisions and engineering docs under engineering/<kind>/<surface>.md
+- keep behavior truth docs behavior-oriented, not endpoint-oriented
+- keep API endpoint details in the nearest contract truth doc when such a doc exists
+- update routing so future Truth Sync can target small docs
+- preserve existing authored docs; move or rewrite only when needed to remove ambiguity
+- report Truth docs split when one broad or mixed-owner truth doc becomes multiple bounded docs
+Evidence checklist:
+- apply the evidence checklist before finishing when Truth Structure writes routed docs, ownership claims, lane-specific decisions, or rationale
+- support ownership/behavior claims with topology or primary checkout evidence from layout, implementation boundaries, docs, config, route files, tests, templates, schemas, or contracts
+- tests/examples/canonical docs corroborate; remove, narrow, or record unsupported claims for manual handoff
+- Do not finish topology repair with mixed product/engineering authority in a single canonical truth doc.
+- If an existing canonical doc has wrong-lane sections, report the lane repair needed and only move content when the topology split explicitly requires it.
+Portable fallback:
+- If this skill surface is unavailable, perform the same workflow directly from committed repository files.
+- Do not require the truthmark CLI.
+- Inspect .truthmark/config.yml and configured route files only when they exist; then inspect canonical docs and representative implementation code.
+- Use a subagent only when the host supports that pattern; otherwise perform the topology repair inline.
+Truthmark hierarchy hints:
+- Config, when present: .truthmark/config.yml
+- Root route index, when present: docs/truthmark/routes/areas.md
+- Area route files, when present: docs/truthmark/routes/areas/**/*.md
+- Product truth docs, when present: docs/truthmark/product/**/*.md
+- Engineering truth docs, when present: docs/truthmark/engineering/**/*.md
+Decision truth lives in the canonical doc it governs; date active decisions inline when added or changed.
+Do not create separate active-decision ADR/planning logs; replace the active decision and let Git history carry the audit trail.
+Product decisions belong in product truth; engineering, architecture, contract, workflow, and operational decisions belong in engineering truth.
+
+## Report Template
+
+Report completion in this shape:
+```md
+Truth Structure: completed
+Topology reviewed:
+- controllers: src/auth/**
+- product docs root: docs/truthmark/product
+- engineering docs root: docs/truthmark/engineering
+- route files: docs/truthmark/routes/areas.md
+Areas reviewed:
+- src/auth/**
+Routing updated:
+- docs/truthmark/routes/areas.md
+Initial truth boundary:
+- Area: Authentication
+- Code: src/auth/**
+- Product owner: docs/truthmark/product/capabilities/authentication-session.md
+- Engineering owner: docs/truthmark/engineering/behaviors/authentication-session.md
+- Scope: session behavior only
+Truth docs created:
+- docs/truthmark/product/capabilities/authentication-session.md
+- docs/truthmark/engineering/behaviors/authentication-session.md
+Truth docs split:
+- docs/truthmark/truth/authentication/README.md -> docs/truthmark/product/capabilities/authentication-session.md and docs/truthmark/engineering/behaviors/authentication-session.md
+Truth docs restructured:
+- docs/truthmark/truth/authentication/README.md
+Evidence checked:
+- Claim: Session behavior belongs to a dedicated Authentication truth owner.
+  Evidence: src/auth/** / docs/truthmark/routes/areas.md:7
+  Result: supported
+Topology decisions:
+- Added an Authentication area because session behavior has a distinct code surface and truth owner.
+Notes:
+- Added an Authentication area for session behavior.
+```
@@ -0,0 +1,133 @@
+# Truthmark Sync
+
+Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
+
+This rule is the Antigravity entrypoint for Truthmark Sync.
+
+Do not invoke another Truthmark command from here.
+
+Manual invocation: @truthmark-sync
+
+If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
+
+Description: Use automatically at finish-time after functional code changes, or explicit /truthmark-sync, $truthmark-sync, or /truthmark:sync. Skip docs-only, formatting-only, behavior-preserving renames, missing config, and no-code changes. Not for doc-first realization or manual topology design.
+
+## Procedure
+
+Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.
+Explicit invocation runs immediately when the user directly requests this workflow. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
+Skip when changes are documentation-only, formatting-only, clearly behavior-preserving renames with no truth impact, when no Truthmark config exists yet, or when there are no functional code changes.
+Parent workflow:
+1. Inspect git status, staged changes, unstaged changes, and untracked files directly.
+2. Inspect .truthmark/config.yml and configured route files only when they exist; then inspect relevant canonical docs.
+3. Identify functional-code changes and the nearest truth docs or routing repairs.
+4. Evidence authority:
+  - Repository instruction files and explicitly configured policy docs remain instruction authority when present; do not assume a repository uses any particular policy path.
+  - Implementation code and canonical truth docs are inspected evidence for current behavior; they do not silently override workflow write boundaries.
+5. Product truth decision:
+  - ask whether a user-visible promise, capability boundary, API contract, acceptance criterion, or explicit user/product evidence changed
+  - if yes, update or route product truth under docs/truthmark/product as well as engineering truth under docs/truthmark/engineering
+  - if no, default to engineering truth under docs/truthmark/engineering for internal implementation changes
+  - when both lanes change, keep separate product and engineering docs cross-linked through route YAML with realized_by and realizes
+  - when ownership is ambiguous, stop or route to Truth Structure instead of writing a mixed document
+6. Capture decision context from the task conversation: ask whether the user provided a product or technical decision, rationale, constraint, tradeoff, rejection reason, or scope boundary. Preserve concise user-provided decision rationale in Sync Intent before truth edits, route it to Product Decisions, Engineering Decisions, Rationale, Capability Scope, Non-Goals, Maintenance Notes, or the relevant workflow/contract section, and report whether it was placed, skipped because none was provided, or needs manual handoff.
+7. Update engineering truth first after code changes. Product truth is opt-in for externally visible promises, product boundaries, APIs, acceptance criteria, or explicit user/product evidence.
+8. Code verification is parent-owned: follow repository instructions and task context, and report what ran or why it did not run.
+9. Dispatch bounded Truth Sync workers only when the host supports subagent dispatch and the acting agent chooses that path; otherwise execute the same sync task inline.
+10. Fill Sync Intent before editing truth docs or truth routing files:
+   - Changed code reviewed: functional files, tests, configs, generated outputs, or other implementation evidence inspected
+   - Affected route/truth owner: bounded route area or canonical truth owner that maps the change
+   - Target truth docs: docs expected to change, or docs reviewed and left unchanged
+   - Intended update: claim/doc/routing update planned before writing
+   - Evidence to verify: checkout evidence that will support, narrow, remove, or record each claim for manual handoff
+   - User-provided decisions/rationale: decisions, rationale, constraints, tradeoffs, rejection reasons, or scope boundaries from the current task conversation, or "none provided"
+   - No-update-needed rationale: why mapped truth is already current when no truth doc should change
+   - Blockers: missing routing, ambiguous ownership, failed verification, unavailable evidence, or off-boundary write needs
+11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, repair topology first when the repair is safe and in scope, otherwise stop and recommend Truth Structure instead of guessing.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
+Topology review and repair:
+- before updating truth docs, verify the changed code resolves to a specific behavior-owned area and bounded truth owner
+- if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when topology repair is safe and in scope
+- safe in-scope topology repair may update truth routing files and create or update bounded leaf truth docs needed to map the changed functional code; keep the repair limited to the affected route owner
+- stop and recommend Truth Structure only when topology repair is unsafe, ambiguous, or outside the current task boundary
+- report the route files and changed code paths that required structure repair
+- do not create another generic truth doc
+- README.md files are indexes, not Truth Sync targets
+- must not append behavior details to a README.md index
+- write engineering truth under docs/truthmark/engineering; product truth updates under docs/truthmark/product are allowed only for explicit current product behavior changes
+Optional validation tooling:
+- you may run truthmark check when local tooling is available
+- you may validate the final report with `truthmark validate sync-report <report-file> --json` when available
+- do not require the truthmark binary; direct checkout inspection is the canonical path
+- optional validation must not replace agent judgment about docs and routing
+- update Product Decisions only in product truth and Engineering Decisions only in engineering truth when evidence supports the lane-specific decision change
+Truthmark hierarchy hints:
+- Config, when present: .truthmark/config.yml
+- Root route index, when present: docs/truthmark/routes/areas.md
+- Area route files, when present: docs/truthmark/routes/areas/**/*.md
+- Product truth docs, when present: docs/truthmark/product/**/*.md
+- Engineering truth docs, when present: docs/truthmark/engineering/**/*.md
+Parent post-sync verification:
+- verify only truth docs and leased truth routing files changed during sync
+- stop on any unrelated diff caused by the sync step
+- stop if functional code changed during sync
+- validate the final report against the structured Truth Sync report contract, including Claim, indented Evidence, and Result values supported, narrowed, removed, or blocked under Evidence checked
+- verify the updated docs correspond to reviewed checkout evidence, changed-code impact, or a recorded stale-truth correction made within the sync write lease
+- verify the final report records ownership review, structure requirement, split, restructure, or manual handoff reason when the ownership review applies
+- manual handoff outcomes must preserve the working tree as-is: no rollback, no post-block cleanup edits, and manual-review reporting of any remaining files
+
+## Report Template
+
+Report completion in this shape:
+```md
+Truth Sync: completed
+
+Changed code reviewed:
+- src/auth/session.ts
+
+Sync Intent:
+- Changed code reviewed: src/auth/session.ts
+- Affected route/truth owner: docs/truthmark/routes/areas/authentication.md
+- Target truth docs: docs/truthmark/engineering/behaviors/session-timeout.md
+- Intended update: Update session timeout behavior.
+- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
+- User-provided decisions/rationale: User rationale: session timeout behavior changed for internal implementation consistency
+- No-update-needed rationale: not applicable; mapped truth is stale
+- Blockers: none
+
+Ownership reviewed:
+- docs/truthmark/routes/areas/authentication.md
+
+Truth docs updated:
+- docs/truthmark/engineering/behaviors/session-timeout.md
+
+Decision/rationale captured:
+- Placed user rationale in the bounded authentication behavior truth doc under Engineering Decisions/Rationale.
+
+Evidence checked:
+- Claim: Session timeout behavior is documented in the bounded authentication behavior truth doc.
+  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
+  Result: supported
+
+Notes:
+- Updated session timeout behavior.
+```
+Blocked report example:
+```md
+Truth Sync: blocked
+
+Reason:
+- Changed code maps only to the provisional bootstrap route.
+
+Files requiring manual review:
+- src/auth/**
+- docs/truthmark/routes/areas/repository.md
+
+Next action:
+- Run Truth Structure for src/auth/** before updating behavior truth.
+```
@@ -16,6 +16,6 @@ For every checked claim, classify the result as supported | narrowed | removed |
 Do not edit files, stage changes, or invent missing behavior.
 Return JSON only with keys: scope, filesReviewed, claimsChecked, evidence, unsupportedClaims, confidence, recommendedWorkflow, notes.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -15,6 +15,6 @@ Do not edit files, stage changes, or rewrite docs.
 Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
 recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -23,6 +23,6 @@ Do not edit files, stage changes, or propose broad rewrites.
 Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
 recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -9,15 +9,10 @@ user-invocable: true

 Use this skill to audit repository truth health.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect canonical docs and relevant implementation directly.
 - Report issues and suggested fixes; do not silently rewrite unrelated files.
- Read support/procedure.md before auditing details.
- Read support/subagents-and-leases.md only when dispatching verifier subagents.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill to audit repository truth health.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Truth Check is agent-led:

 - inspect .truthmark/config.yml and configured route files only when they exist; then inspect canonical docs and relevant implementation directly
@@ -9,16 +9,11 @@ user-invocable: true

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.

-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect existing canonical docs, implementation code, and tests directly.
 - Document current implemented behavior; do not invent future behavior.
 - May write canonical truth docs and truth routing files only; must not write functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -5,7 +5,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che
 # Truthmark Document

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.
-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.

 Truth Document is manual and implementation-first:

@@ -61,7 +60,12 @@ Treat the HTML comments under each template section as normative authoring guida
 Align existing docs to that template and write or repair section content so it satisfies the comment guidance while preserving accurate authored content.
 If the template is missing, use lane-specific sections: product truth says what must be true and why; engineering truth says how the repository currently realizes it.
 Teams may edit template files under the configured Truthmark templates root to define their local truth-doc standards.
-Prefer diff-friendly Markdown: one durable claim per bullet or line, paragraphs no longer than one or two short sentences, and bullets or tables for rules, criteria, fields, files, and lists.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Truth-doc shape repair review:
 - Truth Document may restructure only truth docs for the implemented behavior being documented.
 - repair shape in place only after the ownership review confirms the doc is the right bounded owner
@@ -9,15 +9,11 @@ user-invocable: true

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Read the source truth docs, inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist, then inspect tests and relevant functional code directly.
 - Truth docs lead; code follows.
 - may write functional code only; must not edit truth docs or truth routing while realizing those docs.
- Read support/procedure.md before changing code.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Truth Realize is doc-first:

 - truth docs lead
@@ -9,15 +9,11 @@ user-invocable: true

 Use this skill to design or repair Truthmark area structure.

-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect current docs and relevant code directly.
 - Define areas by product or behavior ownership, not by mechanical directory mirroring.
 - Do not edit functional code.
- Read support/procedure.md before writing route or starter truth-doc changes.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -3,7 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill to design or repair Truthmark area structure.
-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
+
 Truth Structure is agent-native:
 - inspect repository layout, current docs, Truthmark config and route files when present, and relevant code directly
 - Evidence authority:
@@ -9,17 +9,12 @@ user-invocable: true

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.

-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Skip docs-only, formatting-only, behavior-preserving renames with no truth impact, missing config, and no-code changes.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect relevant canonical docs directly.
 - direct checkout inspection is the canonical path; do not require the truthmark binary.
 - May write canonical truth docs and truth routing files only; must not rewrite functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -3,8 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.
-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-Explicit invocation runs immediately. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
+Explicit invocation runs immediately when the user directly requests this workflow. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
 Skip when changes are documentation-only, formatting-only, clearly behavior-preserving renames with no truth impact, when no Truthmark config exists yet, or when there are no functional code changes.
 Parent workflow:
 1. Inspect git status, staged changes, unstaged changes, and untracked files directly.
@@ -33,6 +32,12 @@ Parent workflow:
   - No-update-needed rationale: why mapped truth is already current when no truth doc should change
   - Blockers: missing routing, ambiguous ownership, failed verification, unavailable evidence, or off-boundary write needs
 11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, repair topology first when the repair is safe and in scope, otherwise stop and recommend Truth Structure instead of guessing.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Topology review and repair:
 - before updating truth docs, verify the changed code resolves to a specific behavior-owned area and bounded truth owner
 - if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when topology repair is safe and in scope
@@ -11,26 +11,26 @@ Changed code reviewed:

 Sync Intent:
 - Changed code reviewed: src/auth/session.ts
- Affected route/truth owner: docs/truthmark/routes/areas.md
- Target truth docs: docs/truthmark/engineering/repository/bootstrap-routing.md
+- Affected route/truth owner: docs/truthmark/routes/areas/authentication.md
+- Target truth docs: docs/truthmark/engineering/behaviors/session-timeout.md
 - Intended update: Update session timeout behavior.
- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
 - User-provided decisions/rationale: User rationale: session timeout behavior changed for internal implementation consistency
 - No-update-needed rationale: not applicable; mapped truth is stale
 - Blockers: none

 Ownership reviewed:
- docs/truthmark/routes/areas.md
+- docs/truthmark/routes/areas/authentication.md

 Truth docs updated:
- docs/truthmark/engineering/repository/bootstrap-routing.md
+- docs/truthmark/engineering/behaviors/session-timeout.md

 Decision/rationale captured:
- Placed user rationale in the mapped engineering truth doc under Engineering Decisions/Rationale.
+- Placed user rationale in the bounded authentication behavior truth doc under Engineering Decisions/Rationale.

 Evidence checked:
- Claim: Session timeout behavior is documented in the mapped repository truth doc.
-  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Claim: Session timeout behavior is documented in the bounded authentication behavior truth doc.
+  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
  Result: supported

 Notes:
@@ -41,11 +41,12 @@ Blocked report example:
 Truth Sync: blocked

 Reason:
- routing repair is not allowed
+- Changed code maps only to the provisional bootstrap route.

 Files requiring manual review:
- docs/truthmark/routes/areas.md
+- src/auth/**
+- docs/truthmark/routes/areas/repository.md

 Next action:
- update routing metadata and rerun Truth Sync
+- Run Truth Structure for src/auth/** before updating behavior truth.
 ```
@@ -12,7 +12,7 @@ For every checked claim, classify the result as supported | narrowed | removed |
 Do not edit files, stage changes, or invent missing behavior.
 Return JSON only with keys: scope, filesReviewed, claimsChecked, evidence, unsupportedClaims, confidence, recommendedWorkflow, notes.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
 """
@@ -11,7 +11,7 @@ Do not edit files, stage changes, or rewrite docs.
 Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
 recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
 """
@@ -19,7 +19,7 @@ Do not edit files, stage changes, or propose broad rewrites.
 Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
 recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
 """
@@ -9,19 +9,13 @@ user-invocable: true

 Use this skill to audit repository truth health.

-Use as a Gemini CLI Agent Skill; commands remain available under `/truthmark:*` for command-first invocation.
-
-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
+Use as a Cursor Agent Skill. Cursor discovers project skills under `.cursor/skills/`, selects them from the description when relevant, and supports manual `/` invocation.

 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect canonical docs and relevant implementation directly.
 - Report issues and suggested fixes; do not silently rewrite unrelated files.
- Read support/procedure.md before auditing details.
- Read support/subagents-and-leases.md only when dispatching verifier subagents.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
 - support/report-template.md — read before the final report
- support/subagents-and-leases.md — read only when using subagents, leases, or accepting worker output
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill to audit repository truth health.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Truth Check is agent-led:

 - inspect .truthmark/config.yml and configured route files only when they exist; then inspect canonical docs and relevant implementation directly
@@ -9,20 +9,14 @@ user-invocable: true

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.

-Use as a Gemini CLI Agent Skill; commands remain available under `/truthmark:*` for command-first invocation.
-
-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.
+Use as a Cursor Agent Skill. Cursor discovers project skills under `.cursor/skills/`, selects them from the description when relevant, and supports manual `/` invocation.

 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect existing canonical docs, implementation code, and tests directly.
 - Document current implemented behavior; do not invent future behavior.
 - May write canonical truth docs and truth routing files only; must not write functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
 - support/report-template.md — read before the final report
- support/subagents-and-leases.md — read only when using subagents, leases, or accepting worker output
@@ -5,7 +5,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che
 # Truthmark Document

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.
-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.

 Truth Document is manual and implementation-first:

@@ -61,7 +60,12 @@ Treat the HTML comments under each template section as normative authoring guida
 Align existing docs to that template and write or repair section content so it satisfies the comment guidance while preserving accurate authored content.
 If the template is missing, use lane-specific sections: product truth says what must be true and why; engineering truth says how the repository currently realizes it.
 Teams may edit template files under the configured Truthmark templates root to define their local truth-doc standards.
-Prefer diff-friendly Markdown: one durable claim per bullet or line, paragraphs no longer than one or two short sentences, and bullets or tables for rules, criteria, fields, files, and lists.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Truth-doc shape repair review:
 - Truth Document may restructure only truth docs for the implemented behavior being documented.
 - repair shape in place only after the ownership review confirms the doc is the right bounded owner
@@ -9,17 +9,13 @@ user-invocable: true

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Use as a Gemini CLI Agent Skill; commands remain available under `/truthmark:*` for command-first invocation.
-
-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
+Use as a Cursor Agent Skill. Cursor discovers project skills under `.cursor/skills/`, selects them from the description when relevant, and supports manual `/` invocation.

 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Read the source truth docs, inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist, then inspect tests and relevant functional code directly.
 - Truth docs lead; code follows.
 - may write functional code only; must not edit truth docs or truth routing while realizing those docs.
- Read support/procedure.md before changing code.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Truth Realize is doc-first:

 - truth docs lead
@@ -9,19 +9,14 @@ user-invocable: true

 Use this skill to design or repair Truthmark area structure.

-Use as a Gemini CLI Agent Skill; commands remain available under `/truthmark:*` for command-first invocation.
-
-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
+Use as a Cursor Agent Skill. Cursor discovers project skills under `.cursor/skills/`, selects them from the description when relevant, and supports manual `/` invocation.

 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect current docs and relevant code directly.
 - Define areas by product or behavior ownership, not by mechanical directory mirroring.
 - Do not edit functional code.
- Read support/procedure.md before writing route or starter truth-doc changes.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
 - support/report-template.md — read before the final report
- support/subagents-and-leases.md — read only when using subagents, leases, or accepting worker output
@@ -3,7 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill to design or repair Truthmark area structure.
-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
+
 Truth Structure is agent-native:
 - inspect repository layout, current docs, Truthmark config and route files when present, and relevant code directly
 - Evidence authority:
@@ -9,9 +9,7 @@ user-invocable: true

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.

-Use as a Gemini CLI Agent Skill; commands remain available under `/truthmark:*` for command-first invocation.
-
-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
+Use as a Cursor Agent Skill. Cursor discovers project skills under `.cursor/skills/`, selects them from the description when relevant, and supports manual `/` invocation.

 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
@@ -19,11 +17,7 @@ Quick procedure:
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect relevant canonical docs directly.
 - direct checkout inspection is the canonical path; do not require the truthmark binary.
 - May write canonical truth docs and truth routing files only; must not rewrite functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
 - support/report-template.md — read before the final report
- support/subagents-and-leases.md — read only when using subagents, leases, or accepting worker output
@@ -3,8 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.
-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-Explicit invocation runs immediately. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
+Explicit invocation runs immediately when the user directly requests this workflow. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
 Skip when changes are documentation-only, formatting-only, clearly behavior-preserving renames with no truth impact, when no Truthmark config exists yet, or when there are no functional code changes.
 Parent workflow:
 1. Inspect git status, staged changes, unstaged changes, and untracked files directly.
@@ -33,6 +32,12 @@ Parent workflow:
   - No-update-needed rationale: why mapped truth is already current when no truth doc should change
   - Blockers: missing routing, ambiguous ownership, failed verification, unavailable evidence, or off-boundary write needs
 11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, repair topology first when the repair is safe and in scope, otherwise stop and recommend Truth Structure instead of guessing.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Topology review and repair:
 - before updating truth docs, verify the changed code resolves to a specific behavior-owned area and bounded truth owner
 - if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when topology repair is safe and in scope
@@ -11,26 +11,26 @@ Changed code reviewed:

 Sync Intent:
 - Changed code reviewed: src/auth/session.ts
- Affected route/truth owner: docs/truthmark/routes/areas.md
- Target truth docs: docs/truthmark/engineering/repository/bootstrap-routing.md
+- Affected route/truth owner: docs/truthmark/routes/areas/authentication.md
+- Target truth docs: docs/truthmark/engineering/behaviors/session-timeout.md
 - Intended update: Update session timeout behavior.
- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
 - User-provided decisions/rationale: User rationale: session timeout behavior changed for internal implementation consistency
 - No-update-needed rationale: not applicable; mapped truth is stale
 - Blockers: none

 Ownership reviewed:
- docs/truthmark/routes/areas.md
+- docs/truthmark/routes/areas/authentication.md

 Truth docs updated:
- docs/truthmark/engineering/repository/bootstrap-routing.md
+- docs/truthmark/engineering/behaviors/session-timeout.md

 Decision/rationale captured:
- Placed user rationale in the mapped engineering truth doc under Engineering Decisions/Rationale.
+- Placed user rationale in the bounded authentication behavior truth doc under Engineering Decisions/Rationale.

 Evidence checked:
- Claim: Session timeout behavior is documented in the mapped repository truth doc.
-  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Claim: Session timeout behavior is documented in the bounded authentication behavior truth doc.
+  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
  Result: supported

 Notes:
@@ -41,11 +41,12 @@ Blocked report example:
 Truth Sync: blocked

 Reason:
- routing repair is not allowed
+- Changed code maps only to the provisional bootstrap route.

 Files requiring manual review:
- docs/truthmark/routes/areas.md
+- src/auth/**
+- docs/truthmark/routes/areas/repository.md

 Next action:
- update routing metadata and rerun Truth Sync
+- Run Truth Structure for src/auth/** before updating behavior truth.
 ```
@@ -1,22 +0,0 @@
---
-name: truth-claim-verifier
-description: Read-only Truthmark claim verifier for checking canonical truth against checkout evidence.
-kind: local
-tools: [read_file, grep_search]
---
-
-# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Manual invocation: @truth-claim-verifier
-
-Stay read-only.
-Verify the behavior-bearing truth claims assigned by the parent against primary checkout evidence.
-Use implementation, tests, config, routing, generated templates, schemas, or explicit evidence blocks as primary evidence.
-Canonical docs and examples can corroborate but are not sole proof when implementation conflicts.
-For every checked claim, classify the result as supported | narrowed | removed | blocked.
-Do not edit files, stage changes, or invent missing behavior.
-Return JSON only with keys: scope, filesReviewed, claimsChecked, evidence, unsupportedClaims, confidence, recommendedWorkflow, notes.
-Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
-Use only the parent-assigned shard plus required checkout evidence files.
-Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -1,21 +0,0 @@
---
-name: truth-doc-reviewer
-description: Read-only Truthmark doc reviewer for shape, decision, rationale, and evidence hygiene.
-kind: local
-tools: [read_file, grep_search]
---
-
-# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Manual invocation: @truth-doc-reviewer
-
-Stay read-only.
-Review assigned canonical truth docs for compact frontmatter, required template sections, final Source References entries, Evidence checked entries, and lane-appropriate decision sections (Product Decisions in product truth, Engineering Decisions in engineering truth).
-Flag README.md files used as behavior truth targets, mixed-owner docs, and shape repairs that should move to Truth Structure.
-Do not edit files, stage changes, or rewrite docs.
-Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
-recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
-Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
-Use only the parent-assigned shard plus required checkout evidence files.
-Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -1,22 +0,0 @@
---
-name: truth-doc-writer
-description: Write-capable Truthmark doc worker for one parent-leased truth-document shard.
-kind: local
-tools: [read_file, grep_search, write_file]
---
-
-# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Manual invocation: @truth-doc-writer with an explicit parent write lease.
-
-Write one leased Truthmark truth-document shard assigned by the parent.
-Require an explicit write lease before editing. The lease must name workflow, worker, shard, objective, requiredReads, allowedWrites, forbiddenWrites, evidenceRequired, verification, and reportFields.
-Read every requiredReads entry directly before editing.
-Edit only leased canonical truth docs or leased truth routing files. Do not edit functional code, generated host surfaces, package files, config files, templates, or tests unless they are explicitly leased.
-Do not expand your own write scope. If the task needs an off-lease file, stop and report blocked.
-Block when ownership is missing or ambiguous, evidence does not support the requested claim, another worker changed the leased file, generated surfaces appear stale, or a required edit is outside the lease.
-Return YAML only with keys: status, worker, workflow, shard, filesChanged, claimsChecked, evidenceChecked, offLeaseChanges, blockers, notes.
-status must be completed or blocked.
-filesChanged must list only files you actually changed.
-offLeaseChanges must be empty for completed reports.
-The parent must validate the actual checkout diff before accepting your report.
@@ -1,29 +0,0 @@
---
-name: truth-route-auditor
-description: Read-only Truthmark route auditor for bounded routing and ownership verification.
-kind: local
-tools: [read_file, grep_search]
---
-
-# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Manual invocation: @truth-route-auditor
-
-Stay read-only.
-Audit one bounded Truthmark route, area, or doc shard assigned by the parent.
-Inspect .truthmark/config.yml and route files only when they exist; then inspect mapped truth docs and relevant implementation files directly.
-Use a route-first bounded strategy: narrow audits inspect only the routed area and directly linked counterpart docs; root-wide health first builds a cheap route-map/index from route files, then inspects only mismatches and linked leaves.
-Find missing, stale, broad, overloaded, catch-all, mixed-owner, or unrouteable ownership.
-Validate route ownership against lane-specific roots and route kind:
- confirm mapped truth docs resolve to the correct lane root (product or engineering) for their kind
- flag mismatch between assigned route kind and resolved doc kind (for example, product-capability routed to engineering paths)
- verify route-doc linkage for lane pairings via realized_by and realizes before recommending edits
- inspect product counterparts for engineering docs only when route YAML claims a product relationship, or when the parent explicitly asks for user-visible product coverage
- treat missing product links for user-visible engineering docs as a second-pass diagnostic, not a default full-document read.
-Do not edit files, stage changes, or propose broad rewrites.
-Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
-recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
-Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
-Use only the parent-assigned shard plus required checkout evidence files.
-Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -1,15 +0,0 @@
-description = "Use when the user asks to audit repository truth health, routing, ownership, or canonical docs. Not for normal lint/test/typecheck/code-review verification, finish-time Sync, or silently rewriting docs."
-prompt = '''
-This command is the Gemini CLI entrypoint for Truthmark Check.
-
-Do not invoke another Truthmark command from here.
-
-Read these host-local files in order only as needed:
- .gemini/skills/truthmark-check/SKILL.md
- .gemini/skills/truthmark-check/support/procedure.md
- .gemini/skills/truthmark-check/support/report-template.md
- .gemini/skills/truthmark-check/support/subagents-and-leases.md
-
-If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
-User focus or arguments: {{args}}
-'''
@@ -1,15 +0,0 @@
-description = "Use when the user asks to document existing implemented behavior, or Sync, Check, or Structure finds implemented behavior missing canonical truth. Not for functional-code changes, doc-first implementation, or topology repair that needs Structure."
-prompt = '''
-This command is the Gemini CLI entrypoint for Truthmark Document.
-
-Do not invoke another Truthmark command from here.
-
-Read these host-local files in order only as needed:
- .gemini/skills/truthmark-document/SKILL.md
- .gemini/skills/truthmark-document/support/procedure.md
- .gemini/skills/truthmark-document/support/report-template.md
- .gemini/skills/truthmark-document/support/subagents-and-leases.md
-
-If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
-User focus or arguments: {{args}}
-'''
@@ -1,67 +0,0 @@
-description = "Use when the user explicitly asks to preview likely workflow routing, target files, writes, or subagent use before edits. Not for validation, automatic gates, final correctness, or replacing Truth Check."
-prompt = '''
-This command is the Gemini CLI entrypoint for Truthmark Preview.
-
-Truth Preview is read-only and explicit. Do not invoke another Truthmark command from here.
-
-Use this skill only when the user explicitly asks to preview Truthmark routing or workflow choice before edits.
-
-Invocations: Gemini CLI /truthmark:preview.
-
-Truth Preview is read-only. Its report is intended, not authorized.
-
-Purpose:
- preview the likely Truthmark workflow, route owner, target files, expected write classes, suggested subagent use, and manual handoff questions before edits happen
- report likely product lane impact, engineering lane impact, target docs, and ambiguity before edits
- hand off to the selected workflow after user approval
- keep the selector thin so agents can avoid loading or acting through heavier workflows prematurely
-
-Read:
- .truthmark/config.yml, only when present
- docs/truthmark/routes/areas.md, first, only when present
- relevant child route files under docs/truthmark/routes/areas/ for the selected scope or changed paths, only when present
- relevant truth docs and implementation files needed to preview ownership
- Evidence authority:
-  - Repository instruction files and explicitly configured policy docs remain instruction authority when present; do not assume a repository uses any particular policy path.
-  - Implementation code and canonical truth docs are inspected evidence for current behavior; they do not silently override workflow write boundaries.
- Lane classification:
-  - classify the request or changed surface as product-lane, engineering-lane, both-lane, or ambiguous for reporting only
-  - product-lane ownership belongs under docs/truthmark/product and describes product promises, boundaries, rationale, decisions, and success criteria
-  - engineering-lane ownership belongs under docs/truthmark/engineering and describes source-backed current realization, contracts, architecture, workflows, operations, or tests
-  - both-lane ownership uses separate product and engineering docs cross-linked in route YAML with realized_by and realizes, not in doc frontmatter
-  - ambiguous lane ownership should be reported for manual handoff or routed to Truth Structure
-  - Do not make product docs a summary of engineering docs. Do not make engineering docs a detailed version of product docs. Product truth says what must be true and why. Engineering truth says how the repository currently realizes it.
-
-Do not:
- must not edit files
- must not create truth docs
- must not update routing
- must not run Truth Sync automatically
- must not replace Truth Check
- must not claim final correctness
- must not issue write leases
- must not mutate code
-
-Suggested subagent use:
- optional read-only verifier: truth_route_auditor
- write workers: none
- leases needed: none
-
-Truthmark hierarchy hints:
- Config, when present: .truthmark/config.yml
- Root route index, when present: docs/truthmark/routes/areas.md
- Area route files, when present: docs/truthmark/routes/areas/**/*.md
- Product truth docs, when present: docs/truthmark/product/**/*.md
- Engineering truth docs, when present: docs/truthmark/engineering/**/*.md
-Return a concise Truth Preview report with these fields:
- requested outcome
- likely workflow
- why this workflow
- likely route owner and lane impact
- expected write classes
- expected target files
- suggested subagent use
- manual handoff questions
- handoff recommendation
-User focus or arguments: {{args}}
-'''
@@ -1,14 +0,0 @@
-description = "Use when the user explicitly asks to realize Truthmark truth docs into code, including /truthmark-realize, $truthmark-realize, or /truthmark:realize. Not for syncing docs after code changes, documenting existing code, topology repair, or truth audits."
-prompt = '''
-This command is the Gemini CLI entrypoint for Truthmark Realize.
-
-Do not invoke another Truthmark command from here.
-
-Read these host-local files in order only as needed:
- .gemini/skills/truthmark-realize/SKILL.md
- .gemini/skills/truthmark-realize/support/procedure.md
- .gemini/skills/truthmark-realize/support/report-template.md
-
-If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
-User focus or arguments: {{args}}
-'''
@@ -1,15 +0,0 @@
-description = "Use when routing or truth ownership is missing, stale, broad, overloaded, catch-all, unrouteable, mixed-owner, needs split/repair, or needs new area setup. Not for documenting implemented behavior, syncing a code diff, or realizing docs into code."
-prompt = '''
-This command is the Gemini CLI entrypoint for Truthmark Structure.
-
-Do not invoke another Truthmark command from here.
-
-Read these host-local files in order only as needed:
- .gemini/skills/truthmark-structure/SKILL.md
- .gemini/skills/truthmark-structure/support/procedure.md
- .gemini/skills/truthmark-structure/support/report-template.md
- .gemini/skills/truthmark-structure/support/subagents-and-leases.md
-
-If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
-User focus or arguments: {{args}}
-'''
@@ -1,15 +0,0 @@
-description = "Use automatically at finish-time after functional code changes, or explicit /truthmark-sync, $truthmark-sync, or /truthmark:sync. Skip docs-only, formatting-only, behavior-preserving renames, missing config, and no-code changes. Not for doc-first realization or manual topology design."
-prompt = '''
-This command is the Gemini CLI entrypoint for Truthmark Sync.
-
-Do not invoke another Truthmark command from here.
-
-Read these host-local files in order only as needed:
- .gemini/skills/truthmark-sync/SKILL.md
- .gemini/skills/truthmark-sync/support/procedure.md
- .gemini/skills/truthmark-sync/support/report-template.md
- .gemini/skills/truthmark-sync/support/subagents-and-leases.md
-
-If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
-User focus or arguments: {{args}}
-'''
@@ -1,10 +0,0 @@
-# Truthmark Check Subagents And Leases
-
-Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Gemini CLI subagent mode:
- use automatically when this workflow runs in Gemini CLI and the parent agent chooses bounded project subagent fan-out
- dispatch read-only project subagents only: @truth-route-auditor, @truth-claim-verifier, @truth-doc-reviewer
- subagents inspect checkout evidence directly, return structured findings, and must not edit files
- parent supplies bounded evidence shards; subagents must not preload host instruction files or repo-wide policy docs unless assigned as evidence
- Parent agent owns the final Truth Check report
@@ -1,14 +0,0 @@
-# Truthmark Document Subagents And Leases
-
-Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Gemini CLI subagent mode:
- use automatically when this workflow runs in Gemini CLI and the parent agent chooses bounded project subagent fan-out
- dispatch read-only project subagents for verification: @truth-route-auditor, @truth-claim-verifier
- read-only subagents inspect checkout evidence directly, return structured findings, and must not edit files
- parent supplies bounded evidence shards; read-only subagents must not preload host instruction files or repo-wide policy docs unless assigned as evidence
- dispatch write-capable project subagents only with explicit write leases: @truth-doc-writer
- each write lease must name objective, required reads, allowed writes, forbidden writes, evidence, verification, and report fields
- write workers must stop when a required edit is off-lease and report status, filesChanged, evidence, offLeaseChanges, blockers, and notes
- parent must inspect the actual checkout diff against each lease before accepting a worker report
- Parent agent owns Truth Document acceptance, lease validation, and final report
@@ -1,10 +0,0 @@
-# Truthmark Structure Subagents And Leases
-
-Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Gemini CLI subagent mode:
- use automatically when this workflow runs in Gemini CLI and the parent agent chooses bounded project subagent fan-out
- dispatch read-only project subagents only: @truth-route-auditor
- subagents inspect checkout evidence directly, return structured findings, and must not edit files
- parent supplies bounded evidence shards; subagents must not preload host instruction files or repo-wide policy docs unless assigned as evidence
- Parent agent owns all Truth Structure writes and final topology decisions
@@ -1,14 +0,0 @@
-# Truthmark Sync Subagents And Leases
-
-Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Gemini CLI subagent mode:
- use automatically when this workflow runs in Gemini CLI and the parent agent chooses bounded project subagent fan-out
- dispatch read-only project subagents for verification: @truth-route-auditor, @truth-claim-verifier
- read-only subagents inspect checkout evidence directly, return structured findings, and must not edit files
- parent supplies bounded evidence shards; read-only subagents must not preload host instruction files or repo-wide policy docs unless assigned as evidence
- dispatch write-capable project subagents only with explicit write leases: @truth-doc-writer
- each write lease must name objective, required reads, allowed writes, forbidden writes, evidence, verification, and report fields
- write workers must stop when a required edit is off-lease and report status, filesChanged, evidence, offLeaseChanges, blockers, and notes
- parent must inspect the actual checkout diff against each lease before accepting a worker report
- Parent agent owns Truth Sync acceptance, lease validation, and final report
@@ -14,6 +14,6 @@ For every checked claim, classify the result as supported | narrowed | removed |
 Do not edit files, stage changes, or invent missing behavior.
 Return JSON only with keys: scope, filesReviewed, claimsChecked, evidence, unsupportedClaims, confidence, recommendedWorkflow, notes.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -13,6 +13,6 @@ Do not edit files, stage changes, or rewrite docs.
 Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
 recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -21,6 +21,6 @@ Do not edit files, stage changes, or propose broad rewrites.
 Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
 recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -1,68 +0,0 @@
---
-agent: 'agent'
-description: 'Use when the user explicitly asks to preview likely workflow routing, target files, writes, or subagent use before edits. Not for validation, automatic gates, final correctness, or replacing Truth Check.'
---
-
-This prompt is the GitHub Copilot entrypoint for Truthmark Preview.
-
-Truth Preview is read-only and explicit. Do not invoke another Truthmark command from here.
-
-Use this skill only when the user explicitly asks to preview Truthmark routing or workflow choice before edits.
-
-Invocations: GitHub Copilot /truthmark-preview.
-
-Truth Preview is read-only. Its report is intended, not authorized.
-
-Purpose:
- preview the likely Truthmark workflow, route owner, target files, expected write classes, suggested subagent use, and manual handoff questions before edits happen
- report likely product lane impact, engineering lane impact, target docs, and ambiguity before edits
- hand off to the selected workflow after user approval
- keep the selector thin so agents can avoid loading or acting through heavier workflows prematurely
-
-Read:
- .truthmark/config.yml, only when present
- docs/truthmark/routes/areas.md, first, only when present
- relevant child route files under docs/truthmark/routes/areas/ for the selected scope or changed paths, only when present
- relevant truth docs and implementation files needed to preview ownership
- Evidence authority:
-  - Repository instruction files and explicitly configured policy docs remain instruction authority when present; do not assume a repository uses any particular policy path.
-  - Implementation code and canonical truth docs are inspected evidence for current behavior; they do not silently override workflow write boundaries.
- Lane classification:
-  - classify the request or changed surface as product-lane, engineering-lane, both-lane, or ambiguous for reporting only
-  - product-lane ownership belongs under docs/truthmark/product and describes product promises, boundaries, rationale, decisions, and success criteria
-  - engineering-lane ownership belongs under docs/truthmark/engineering and describes source-backed current realization, contracts, architecture, workflows, operations, or tests
-  - both-lane ownership uses separate product and engineering docs cross-linked in route YAML with realized_by and realizes, not in doc frontmatter
-  - ambiguous lane ownership should be reported for manual handoff or routed to Truth Structure
-  - Do not make product docs a summary of engineering docs. Do not make engineering docs a detailed version of product docs. Product truth says what must be true and why. Engineering truth says how the repository currently realizes it.
-
-Do not:
- must not edit files
- must not create truth docs
- must not update routing
- must not run Truth Sync automatically
- must not replace Truth Check
- must not claim final correctness
- must not issue write leases
- must not mutate code
-
-Suggested subagent use:
- optional read-only verifier: truth_route_auditor
- write workers: none
- leases needed: none
-
-Truthmark hierarchy hints:
- Config, when present: .truthmark/config.yml
- Root route index, when present: docs/truthmark/routes/areas.md
- Area route files, when present: docs/truthmark/routes/areas/**/*.md
- Product truth docs, when present: docs/truthmark/product/**/*.md
- Engineering truth docs, when present: docs/truthmark/engineering/**/*.md
-Return a concise Truth Preview report with these fields:
- requested outcome
- likely workflow
- why this workflow
- likely route owner and lane impact
- expected write classes
- expected target files
- suggested subagent use
- manual handoff questions
- handoff recommendation
@@ -11,15 +11,10 @@ Use this skill to audit repository truth health.

 Use as a Copilot agent skill. Prompt files remain available under `.github/prompts/` for command-style invocation in supported Copilot IDEs.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect canonical docs and relevant implementation directly.
 - Report issues and suggested fixes; do not silently rewrite unrelated files.
- Read support/procedure.md before auditing details.
- Read support/subagents-and-leases.md only when dispatching verifier subagents.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill to audit repository truth health.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Truth Check is agent-led:

 - inspect .truthmark/config.yml and configured route files only when they exist; then inspect canonical docs and relevant implementation directly
@@ -11,16 +11,11 @@ Use this skill to document existing implemented behavior when no functional-code

 Use as a Copilot agent skill. Prompt files remain available under `.github/prompts/` for command-style invocation in supported Copilot IDEs.

-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect existing canonical docs, implementation code, and tests directly.
 - Document current implemented behavior; do not invent future behavior.
 - May write canonical truth docs and truth routing files only; must not write functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -5,7 +5,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che
 # Truthmark Document

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.
-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.

 Truth Document is manual and implementation-first:

@@ -61,7 +60,12 @@ Treat the HTML comments under each template section as normative authoring guida
 Align existing docs to that template and write or repair section content so it satisfies the comment guidance while preserving accurate authored content.
 If the template is missing, use lane-specific sections: product truth says what must be true and why; engineering truth says how the repository currently realizes it.
 Teams may edit template files under the configured Truthmark templates root to define their local truth-doc standards.
-Prefer diff-friendly Markdown: one durable claim per bullet or line, paragraphs no longer than one or two short sentences, and bullets or tables for rules, criteria, fields, files, and lists.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Truth-doc shape repair review:
 - Truth Document may restructure only truth docs for the implemented behavior being documented.
 - repair shape in place only after the ownership review confirms the doc is the right bounded owner
@@ -11,15 +11,11 @@ Use this skill only when the user explicitly asks to realize truth docs into cod

 Use as a Copilot agent skill. Prompt files remain available under `.github/prompts/` for command-style invocation in supported Copilot IDEs.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Read the source truth docs, inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist, then inspect tests and relevant functional code directly.
 - Truth docs lead; code follows.
 - may write functional code only; must not edit truth docs or truth routing while realizing those docs.
- Read support/procedure.md before changing code.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Truth Realize is doc-first:

 - truth docs lead
@@ -11,15 +11,11 @@ Use this skill to design or repair Truthmark area structure.

 Use as a Copilot agent skill. Prompt files remain available under `.github/prompts/` for command-style invocation in supported Copilot IDEs.

-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect current docs and relevant code directly.
 - Define areas by product or behavior ownership, not by mechanical directory mirroring.
 - Do not edit functional code.
- Read support/procedure.md before writing route or starter truth-doc changes.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -3,7 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill to design or repair Truthmark area structure.
-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
+
 Truth Structure is agent-native:
 - inspect repository layout, current docs, Truthmark config and route files when present, and relevant code directly
 - Evidence authority:
@@ -11,17 +11,12 @@ Use this skill automatically before finishing when functional code changed since

 Use as a Copilot agent skill. Prompt files remain available under `.github/prompts/` for command-style invocation in supported Copilot IDEs.

-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Skip docs-only, formatting-only, behavior-preserving renames with no truth impact, missing config, and no-code changes.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect relevant canonical docs directly.
 - direct checkout inspection is the canonical path; do not require the truthmark binary.
 - May write canonical truth docs and truth routing files only; must not rewrite functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -3,8 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.
-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-Explicit invocation runs immediately. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
+Explicit invocation runs immediately when the user directly requests this workflow. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
 Skip when changes are documentation-only, formatting-only, clearly behavior-preserving renames with no truth impact, when no Truthmark config exists yet, or when there are no functional code changes.
 Parent workflow:
 1. Inspect git status, staged changes, unstaged changes, and untracked files directly.
@@ -33,6 +32,12 @@ Parent workflow:
   - No-update-needed rationale: why mapped truth is already current when no truth doc should change
   - Blockers: missing routing, ambiguous ownership, failed verification, unavailable evidence, or off-boundary write needs
 11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, repair topology first when the repair is safe and in scope, otherwise stop and recommend Truth Structure instead of guessing.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Topology review and repair:
 - before updating truth docs, verify the changed code resolves to a specific behavior-owned area and bounded truth owner
 - if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when topology repair is safe and in scope
@@ -11,26 +11,26 @@ Changed code reviewed:

 Sync Intent:
 - Changed code reviewed: src/auth/session.ts
- Affected route/truth owner: docs/truthmark/routes/areas.md
- Target truth docs: docs/truthmark/engineering/repository/bootstrap-routing.md
+- Affected route/truth owner: docs/truthmark/routes/areas/authentication.md
+- Target truth docs: docs/truthmark/engineering/behaviors/session-timeout.md
 - Intended update: Update session timeout behavior.
- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
 - User-provided decisions/rationale: User rationale: session timeout behavior changed for internal implementation consistency
 - No-update-needed rationale: not applicable; mapped truth is stale
 - Blockers: none

 Ownership reviewed:
- docs/truthmark/routes/areas.md
+- docs/truthmark/routes/areas/authentication.md

 Truth docs updated:
- docs/truthmark/engineering/repository/bootstrap-routing.md
+- docs/truthmark/engineering/behaviors/session-timeout.md

 Decision/rationale captured:
- Placed user rationale in the mapped engineering truth doc under Engineering Decisions/Rationale.
+- Placed user rationale in the bounded authentication behavior truth doc under Engineering Decisions/Rationale.

 Evidence checked:
- Claim: Session timeout behavior is documented in the mapped repository truth doc.
-  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Claim: Session timeout behavior is documented in the bounded authentication behavior truth doc.
+  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
  Result: supported

 Notes:
@@ -41,11 +41,12 @@ Blocked report example:
 Truth Sync: blocked

 Reason:
- routing repair is not allowed
+- Changed code maps only to the provisional bootstrap route.

 Files requiring manual review:
- docs/truthmark/routes/areas.md
+- src/auth/**
+- docs/truthmark/routes/areas/repository.md

 Next action:
- update routing metadata and rerun Truth Sync
+- Run Truth Structure for src/auth/** before updating behavior truth.
 ```
@@ -13,10 +13,10 @@ jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
        with:
-          node-version: 24
+          node-version: 24.x
          cache: npm
      - run: npm ci
      - run: npm run check
@@ -0,0 +1,34 @@
+name: Deploy Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'site/**'
+      - '.github/workflows/pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+      - uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5
+      - uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3
+        with:
+          path: site
+      - id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4
@@ -1,9 +1,10 @@
 name: Publish

 on:
-  release:
-    types:
-      - published
+  push:
+    tags:
+      - 'release/**'
+  workflow_dispatch:

 permissions:
  contents: read
@@ -13,10 +14,10 @@ jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
        with:
-          node-version: 24
+          node-version: 24.x
          registry-url: https://registry.npmjs.org
          cache: npm
      - run: npm ci
@@ -35,3 +35,7 @@ Thumbs.db
 .hermes/
 .lean-ctx/graph.db
 .lean-ctx/graph.meta.json
+
+# Manual workflow eval run artifacts
+workflow-eval-framwork/runs/*
+!workflow-eval-framwork/runs/.gitkeep
@@ -28,6 +28,6 @@ For every checked claim, classify the result as supported | narrowed | removed |
 Do not edit files, stage changes, or invent missing behavior.
 Return JSON only with keys: scope, filesReviewed, claimsChecked, evidence, unsupportedClaims, confidence, recommendedWorkflow, notes.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -27,6 +27,6 @@ Do not edit files, stage changes, or rewrite docs.
 Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
 recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -35,6 +35,6 @@ Do not edit files, stage changes, or propose broad rewrites.
 Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
 recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.
 Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.
@@ -9,15 +9,10 @@ user-invocable: true

 Use this skill to audit repository truth health.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect canonical docs and relevant implementation directly.
 - Report issues and suggested fixes; do not silently rewrite unrelated files.
- Read support/procedure.md before auditing details.
- Read support/subagents-and-leases.md only when dispatching verifier subagents.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill to audit repository truth health.

-Invocations: OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.
-
 Truth Check is agent-led:

 - inspect .truthmark/config.yml and configured route files only when they exist; then inspect canonical docs and relevant implementation directly
@@ -9,16 +9,11 @@ user-invocable: true

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.

-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect existing canonical docs, implementation code, and tests directly.
 - Document current implemented behavior; do not invent future behavior.
 - May write canonical truth docs and truth routing files only; must not write functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -5,7 +5,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che
 # Truthmark Document

 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.
-Invocations: OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.

 Truth Document is manual and implementation-first:

@@ -61,7 +60,12 @@ Treat the HTML comments under each template section as normative authoring guida
 Align existing docs to that template and write or repair section content so it satisfies the comment guidance while preserving accurate authored content.
 If the template is missing, use lane-specific sections: product truth says what must be true and why; engineering truth says how the repository currently realizes it.
 Teams may edit template files under the configured Truthmark templates root to define their local truth-doc standards.
-Prefer diff-friendly Markdown: one durable claim per bullet or line, paragraphs no longer than one or two short sentences, and bullets or tables for rules, criteria, fields, files, and lists.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Truth-doc shape repair review:
 - Truth Document may restructure only truth docs for the implemented behavior being documented.
 - repair shape in place only after the ownership review confirms the doc is the right bounded owner
@@ -9,15 +9,11 @@ user-invocable: true

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Read the source truth docs, inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist, then inspect tests and relevant functional code directly.
 - Truth docs lead; code follows.
 - may write functional code only; must not edit truth docs or truth routing while realizing those docs.
- Read support/procedure.md before changing code.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -6,8 +6,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che

 Use this skill only when the user explicitly asks to realize truth docs into code.

-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Truth Realize is doc-first:

 - truth docs lead
@@ -9,15 +9,11 @@ user-invocable: true

 Use this skill to design or repair Truthmark area structure.

-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect current docs and relevant code directly.
 - Define areas by product or behavior ownership, not by mechanical directory mirroring.
 - Do not edit functional code.
- Read support/procedure.md before writing route or starter truth-doc changes.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -3,7 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill to design or repair Truthmark area structure.
-Invocations: OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.
+
 Truth Structure is agent-native:
 - inspect repository layout, current docs, Truthmark config and route files when present, and relevant code directly
 - Evidence authority:
@@ -9,17 +9,12 @@ user-invocable: true

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.

-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-
 Quick procedure:
 - Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.
 - Skip docs-only, formatting-only, behavior-preserving renames with no truth impact, missing config, and no-code changes.
 - Inspect .truthmark/config.yml and configured route files (docs/truthmark/routes/areas.md; docs/truthmark/routes/areas/) only when they exist; then inspect relevant canonical docs directly.
 - direct checkout inspection is the canonical path; do not require the truthmark binary.
 - May write canonical truth docs and truth routing files only; must not rewrite functional code.
- Read support/procedure.md before editing truth docs.
- Read support/subagents-and-leases.md only when dispatching or accepting worker output.
- Read support/report-template.md before the final report.

 Progressive disclosure:
 - support/procedure.md — read before edits or detailed auditing; contains core review questions
@@ -3,8 +3,7 @@
 Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.

 Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.
-Invocations: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.
-Explicit invocation runs immediately. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
+Explicit invocation runs immediately when the user directly requests this workflow. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
 Skip when changes are documentation-only, formatting-only, clearly behavior-preserving renames with no truth impact, when no Truthmark config exists yet, or when there are no functional code changes.
 Parent workflow:
 1. Inspect git status, staged changes, unstaged changes, and untracked files directly.
@@ -33,6 +32,12 @@ Parent workflow:
   - No-update-needed rationale: why mapped truth is already current when no truth doc should change
   - Blockers: missing routing, ambiguous ownership, failed verification, unavailable evidence, or off-boundary write needs
 11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, repair topology first when the repair is safe and in scope, otherwise stop and recommend Truth Structure instead of guessing.
+Truth-doc prose style:
+- Use professional, plain technical prose. Prefer specific current-state claims over promotional, symbolic, or generic significance language.
+- Avoid common AI-writing tells: pivotal, crucial, underscores, serves as, stands as, showcases, landscape, vague expert attributions, and generic upbeat conclusions.
+- Keep claims evidence-backed and diff-friendly: one durable claim per bullet or line; paragraphs should be no longer than one or two short sentences.
+- Do not add personality, rhetorical flourish, first-person commentary, or marketing tone.
+- Rewrite dense or formulaic prose only when it improves readability without removing scope, evidence, decisions, or source references.
 Topology review and repair:
 - before updating truth docs, verify the changed code resolves to a specific behavior-owned area and bounded truth owner
 - if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when topology repair is safe and in scope
@@ -11,26 +11,26 @@ Changed code reviewed:

 Sync Intent:
 - Changed code reviewed: src/auth/session.ts
- Affected route/truth owner: docs/truthmark/routes/areas.md
- Target truth docs: docs/truthmark/engineering/repository/bootstrap-routing.md
+- Affected route/truth owner: docs/truthmark/routes/areas/authentication.md
+- Target truth docs: docs/truthmark/engineering/behaviors/session-timeout.md
 - Intended update: Update session timeout behavior.
- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Evidence to verify: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
 - User-provided decisions/rationale: User rationale: session timeout behavior changed for internal implementation consistency
 - No-update-needed rationale: not applicable; mapped truth is stale
 - Blockers: none

 Ownership reviewed:
- docs/truthmark/routes/areas.md
+- docs/truthmark/routes/areas/authentication.md

 Truth docs updated:
- docs/truthmark/engineering/repository/bootstrap-routing.md
+- docs/truthmark/engineering/behaviors/session-timeout.md

 Decision/rationale captured:
- Placed user rationale in the mapped engineering truth doc under Engineering Decisions/Rationale.
+- Placed user rationale in the bounded authentication behavior truth doc under Engineering Decisions/Rationale.

 Evidence checked:
- Claim: Session timeout behavior is documented in the mapped repository truth doc.
-  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas.md:11
+- Claim: Session timeout behavior is documented in the bounded authentication behavior truth doc.
+  Evidence: src/auth/session.ts:12 / docs/truthmark/routes/areas/authentication.md:11
  Result: supported

 Notes:
@@ -41,11 +41,12 @@ Blocked report example:
 Truth Sync: blocked

 Reason:
- routing repair is not allowed
+- Changed code maps only to the provisional bootstrap route.

 Files requiring manual review:
- docs/truthmark/routes/areas.md
+- src/auth/**
+- docs/truthmark/routes/areas/repository.md

 Next action:
- update routing metadata and rerun Truth Sync
+- Run Truth Structure for src/auth/** before updating behavior truth.
 ```
@@ -4,14 +4,13 @@ platforms:
  - opencode
  - claude-code
  - github-copilot
-  - gemini-cli
+  - antigravity
+  - cursor
 truthmark:
  workspace: docs/truthmark
  generated:
    portal:
      enabled: false
-instruction_targets:
-  - AGENTS.md
 frontmatter:
  required: []
  recommended:
@@ -1,4 +1,4 @@
-Follow repository instruction files that are present in this checkout; do not assume optional policy docs exist.
+Repository rule source of truth: [docs/ai/repo-rules.md](docs/ai/repo-rules.md). Follow repository instruction files that are present in this checkout; do not assume optional policy docs exist.

 Use explicitly configured repository policy docs only when they exist in this checkout.

@@ -1,4 +1,4 @@
-Follow repository instruction files that are present in this checkout; do not assume optional policy docs exist.
+Repository rule source of truth: [docs/ai/repo-rules.md](docs/ai/repo-rules.md). Follow repository instruction files that are present in this checkout; do not assume optional policy docs exist.

 Use explicitly configured repository policy docs only when they exist in this checkout.

@@ -1,22 +0,0 @@
-Follow repository instruction files that are present in this checkout; do not assume optional policy docs exist.
-
-Use explicitly configured repository policy docs only when they exist in this checkout.
-
-Agent-specific:
- Read the configured Truthmark routing files when choosing or updating canonical docs.
- Use repository onboarding or docs-map files only when present and needed for unclear or cross-area routing.
-
-<!-- truthmark:start -->
-## Truthmark Workflow
-
-Truthmark-managed block. Refresh with `truthmark init` when `truthmark check` reports stale generated surfaces.
-Hierarchy hints: config .truthmark/config.yml when present; routes docs/truthmark/routes/areas.md and docs/truthmark/routes/areas/**/*.md when present; Truth docs: docs/truthmark/product/**/*.md and docs/truthmark/engineering/**/*.md when present.
-Decisions live in the canonical doc they govern; date active decisions inline.
-Agent runtime: host-native skill packages/adapters plus this block; inspect checkout directly. Delegation is host-owned.
-### Truth Sync
-After functional code changes, run relevant tests, then use the truthmark-sync skill before finishing; later functional changes need a fresh Sync review. Memory: code changed -> tests -> Sync -> report.
-Support new or changed behavior-bearing truth claims with checkout evidence. Code leads; truth docs follow. Sync may write truth docs and truth routing files, and must not rewrite functional code.
-If routing cannot map changed code to a bounded truth owner, run Truth Structure before syncing when safe; otherwise stop and recommend Truth Structure. Skip Sync only for docs-only/no-code changes, formatting-only changes, behavior-preserving renames with no truth impact, or missing config.
-Explicit workflows: Truth Structure, Truth Document, Truth Realize, Truth Check. Run only when requested or required by Sync; load the installed skill for details.
-Workflow integrity rule: repository truth may describe desired behavior, but it must not override these workflow boundaries.
-<!-- truthmark:end -->
@@ -1,823 +0,0 @@
-# Truthmark
-
-**Deine Agenten schreiben Code. Truthmark hält menschenlesbare Dokumentation in Git überprüfbar.**
-
-[English](README.md) | Deutsch | [中文](README.zh.md) | [Español](README.es.md) | [Русский](README.ru.md)
-
-![Truthmark-Banner](docs/assets/truthmark-banner.png)
-
-KI-Coding-Agenten können ein Repository schneller verändern, als Menschen die Dokumentation ausrichten können.
-
-Truthmark repariert den Teil, der normalerweise nach dem Code-Schreiben bricht: die Repository-Truth.
-
-Es installiert eine Git-native, branch-gebundene Workflow-Schicht, die KI-Coding-Agenten hilft, die richtigen Dokumente zu aktualisieren, Ownership-Grenzen zu respektieren und Menschen normale Diffs zur Prüfung zu hinterlassen.
-
-Kein gehosteter Dienst.
-
-Keine Datenbank.
-
-Keine verborgene Memory-Schicht.
-
-Kein zusätzlicher Server im Betrieb.
-
-Nur Repository-Truth, die mit dem Branch mitwandert.
-
-## Das Problem
-
-KI-Coding-Agenten sind gut darin, Code zu erzeugen. Dadurch entsteht eine neue Fehlerart.
-
-Die Implementierung ändert sich, aber die Repository-Erzählung driftet ab:
-
- Verhalten lebt im Chatverlauf
- Architekturdokumente fallen zurück
- Produktentscheidungen verschwinden nach der Übergabe
- Reviewer sehen Code-Diffs ohne die zugehörigen Truth-Diffs
- Branches entwickeln unbemerkt unterschiedliche Versionen davon, „was wahr ist“
- jede Agentensitzung muss Repository-Truth neu entdecken
-
-Truthmark verwandelt diese fragile Repository-Truth in versionierte Repository-Infrastruktur.
-
-Statt darauf zu vertrauen, dass jeder Mensch und jeder Agent die richtige Dokumentationsgewohnheit beibehält, installiert Truthmark diese Gewohnheit im Repository.
-
-## Das Versprechen
-
-Wenn ein Agent funktionalen Code ändert, sollte die Arbeit nicht mit einem reinen Code-Diff enden.
-
-Der normale Truthmark-Pfad ist:
-
-```text
-agent ändert funktionalen Code
-relevante Tests laufen
-Truth Sync prüft zugeordnete Truth-Dokumente
-Truth-Dokumente werden bei Bedarf aktualisiert
-Mensch prüft Code-Diff + Truth-Diff
-committen oder übergeben
-```
-
-Das ist der Kernwert: **KI-Arbeit wird leichter vertrauenswürdig, weil das Repository lesbar bleibt.**
-
-## Zwei Schnittstellen, ein Truth-System
-
-Truthmark ist nicht nur eine CLI.
-
-Es hat zwei unterschiedliche Schnittstellen, und diese Unterscheidung ist wichtig.
-
-### 1. CLI für Menschen
-
-Die CLI ist für Maintainer, Reviewer und Automatisierung.
-
-Nutze sie, um ein Repository zu konfigurieren, Workflow-Dateien zu installieren oder zu aktualisieren, Truth-Artefakte zu validieren und optionales Review-Material zu erzeugen.
-
-```bash
-truthmark config
-truthmark init
-truthmark check
-```
-
-Die CLI bereitet die Repository-Umgebung vor und validiert sie.
-
-Sie ist nicht die Runtime für den KI-Workflow.
-
-### 2. KI-seitige Workflow-Schnittstellen
-
-Die KI-seitigen Schnittstellen sind für Coding-Agenten.
-
-Truthmark installiert host-native Skills, Prompts, Commands, verwaltete Instruktionsblöcke und unterstützte Subagent-Schnittstellen, damit KI-Agenten repository-spezifische Truth-Workflows in ihren normalen Coding-Tools befolgen können.
-
-Beispiele:
-
-```text
-/truthmark-sync
-/truthmark-document
-/truthmark-structure
-/truthmark-realize
-/truthmark-check
-```
-
-Sie sehen wie Befehle aus, weil Agenten-Hosts Workflows über Slash-Commands, Prompts, Skills oder Projektbefehle bereitstellen.
-
-Es sind keine Shell-Befehle.
-
-Es sind KI-seitige Workflow-Einstiegspunkte.
-
-Die Trennung ist das Produkt:
-
-```text
-Menschen besitzen den Repository-Vertrag
-Truthmark installiert den Vertrag ins Repo
-Agenten arbeiten innerhalb dieses Vertrags
-Truth-Updates erscheinen als Git-Diffs
-Menschen prüfen das Ergebnis
-```
-
-## Quick Start
-
-### Voraussetzungen
-
- Node.js `>=20`
- npm
- ein Git-Repository
-
-### Truthmark installieren
-
-Führe dies in dem Repository aus, das du initialisieren möchtest:
-
-```bash
-cd /path/to/your-repo
-npm install -g truthmark
-```
-
-### Den Repository-Truth-Vertrag erstellen
-
-```bash
-truthmark config
-```
-
-Das erzeugt:
-
-```text
-.truthmark/config.yml
-```
-
-Prüfe diese Datei, bevor du fortfährst. Sie definiert den versionierten Hierarchievertrag für das Repository.
-
-### Die Workflow-Schnittstellen installieren
-
-```bash
-truthmark init
-```
-
-Das installiert oder aktualisiert:
-
- Routendateien
- Truth-Doc-Scaffolding
- verwaltete Instruktionsblöcke
- KI-seitige Workflow-Schnittstellen für konfigurierte Plattformen
-
-Die Standardvorlagen für Truth-Dokumente werden in [Template Standards](docs/standards/template-standards.md) begründet. Dort werden sie anerkannten Software-Engineering-Referenzen wie ISO/IEC/IEEE 42010, ISO/IEC/IEEE 29148, ISO/IEC/IEEE 12207, ISO/IEC 25010, C4, arc42, OpenAPI, SemVer, Google SRE und Diátaxis zugeordnet.
-
-### Das Setup validieren
-
-```bash
-truthmark check
-```
-
-Prüfe danach die generierten Dateien, bevor du committest.
-
-Die konkreten Dateien hängen von `.truthmark/config.yml` ab, aber die Installation hat immer dieselbe Form: Routing, Truth-Scaffolding, kompakte verwaltete Instruktionen und host-native Workflow-Schnittstellen für die aktivierten Plattformen.
-
-## Erste echte Nutzung
-
-Die meisten Repositories brauchen nach der Initialisierung einen Aufräumschritt.
-
-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:
-
-```text
-/truthmark-structure die breite repository-area in auth, billing und notifications aufteilen
-```
-
-Wenn das Projekt bereits implementierte Features hat, aber Truth-Dokumente fehlen oder schwach sind, bitte den installierten Truth-Document-Workflow, einen fokussierten Bereich zu dokumentieren:
-
-```text
-/truthmark-document dokumentiere das implementierte payment-retry-verhalten in src/billing/retry.ts und den zugehörigen tests
-```
-
-Truth Document ist der häufigste erste Workflow für bestehende Projekte. Er inspiziert Implementierung, Tests, Routen und vorhandene Dokumentation und erstellt oder repariert danach Truth-Dokumente und Routing, ohne funktionalen Code zu ändern.
-
-Danach nutzt du deinen KI-Coding-Agenten normal.
-
-Wenn der Agent funktionalen Code ändert, wirkt Truth Sync als Abschlusskontrolle und prüft vor der Übergabe, ob zugeordnete Truth-Dokumente geändert werden müssen.
-
-## Was du bekommst
-
-| Fähigkeit | Was sie tut |
-| --- | --- |
-| Git-native Repository-Truth | Hält Repository-Truth in versioniertem Markdown und Config. |
-| Branch-gebundene Dokumentation | Repository-Truth wandert mit dem Branch statt in einer privaten Sitzung zu leben. |
-| CLI für Menschen | Gibt Maintainern Befehle für Setup, Aktualisierung, Validierung und Inspektion. |
-| KI-seitige Workflows | Gibt Agenten host-native Workflows für Sync, Dokumentation, Struktur, Preview, Realisierung und Audit. |
-| Explizites Routing | Ordnet Codebereiche kanonischen Truth-Dokumenten zu. |
-| Prüffähige Übergaben | Erzeugt normale Git-Diffs für Code und Truth-Dokumente. |
-| Local-first-Betrieb | Benötigt keinen gehosteten Dienst, keinen Daemon, keine Datenbank und keinen MCP-Server. |
-| Sicherere Schreibgrenzen | Trennt code-first, doc-first, read-only und doc-only Workflows. |
-| Validierung | Meldet Probleme bei Routing, Autorität, Frontmatter, Links, generierten Schnittstellen, Branch-Scope, Freshness und Coverage. |
-| Optionales Portal | Erzeugt eine versionierte statische HTML-Präsentationssite aus Markdown-Truth-Dokumenten, wenn es ausdrücklich aktiviert und angefragt wird. |
-
-## Visueller Überblick
-
-![Truthmark-Funktionen](docs/assets/truthmark-features.png)
-
-**Funktionen:** was Truthmark installiert und wie die Workflow-Oberfläche aufgeteilt ist.
-
-![Truthmark-Positionierung](docs/assets/truthmark-position.png)
-
-**Positionierung:** wo Truthmark im Verhältnis zu Prompts, Memory und Spec-Workflows steht.
-
-![Truthmark-Sync-Ablauf](docs/assets/truthmark-syncflow.png)
-
-**Sync-Ablauf:** wie Truth Sync normale Codeänderungen vor der Übergabe abschließt.
-
-## Warum Teams es nutzen
-
-Truthmark ist für Teams, die bereits wissen, dass KI-Agenten Code erzeugen können.
-
-Das nächste Problem ist Governance.
-
-Nicht Governance als Zeremonie. Governance als einfache Frage:
-
-> Erzählt das Repository nach dieser KI-gestützten Änderung noch den aktuellen Stand?
-
-Truthmark hilft Teams, diese Frage mit versionierten Dateien, explizitem Routing und prüffähigen Diffs zu beantworten.
-
-Es ist nützlich, wenn du Folgendes brauchst:
-
- weniger Dokumentationsdrift
- bessere Übergaben
- branch-spezifische Produktwahrheit
- dauerhafte Architektur- und API-Dokumentation
- explizite Ownership zwischen Dokumentation und Code
- sicherere Schreibgrenzen für Agenten
- prüffähige Dokumentation statt verborgener Memory
- KI-Workflows, die weiterhin aus versionierten Repo-Dateien funktionieren
-
-## Wo Truthmark hineinpasst
-
-Truthmark ersetzt keine Prompts, Memory, Specs, Tests oder Code Review.
-
-Es gibt diesen Workflows einen dauerhaften Ort in Git.
-
-| Bedarf | Besser passend |
-| --- | --- |
-| Bessere Ausgabe aus einer Agentensitzung | Besserer Prompt |
-| Persönliche oder sitzungsbezogene Kontinuität | Memory-Tool |
-| Plan-first Feature-Arbeit | Spec-Workflow |
-| Branch-bezogene Repository-Truth, die mit dem Code mitwandert | Truthmark |
-| Korrektheit von Verhalten validieren | Tests und Review |
-| KI-gestützte Dokumentationsänderungen prüfen | Truthmark plus Git-Review |
-
-Truthmarks Spur ist absichtlich eng:
-
-```text
-Repository-Truth explizit machen
-sie zu Code routen
-Agenten-Workflows darum installieren
-das Ergebnis in Git prüffähig halten
-```
-
-## Wie Truthmark läuft
-
-Truthmark läuft lokal gegen den aktiven Git-Worktree.
-
-Die CLI für Menschen liest und schreibt Repository-Dateien und beendet sich danach.
-
-Die KI-seitigen Workflow-Schnittstellen sind versionierte Dateien, die Agenten-Hosts später laden können. Dadurch können Agenten dem installierten Workflow aus dem Repository-Zustand folgen, statt von einem Hintergrundprozess von Truthmark abzuhängen.
-
-Die Schichten greifen so ineinander:
-
-```mermaid
-flowchart LR
-  Human["Human / CI"] --> CLI["Truthmark CLI"]
-  CLI --> Config["Config und Routing"]
-  CLI --> Truth["Kanonische Truth-Dokumente"]
-  CLI --> Surfaces["Generierte host-native Workflows"]
-  Surfaces --> Hosts["Codex / Claude Code / Copilot / OpenCode / Gemini"]
-  Hosts --> Worktree["Aktiver Git-Worktree"]
-  Hosts -->|"helper checks / validate / index"| CLI
-  Worktree --> Truth
-```
-
-Agents sprechen nicht mit einem Truthmark-Daemon, können aber die installierte Truthmark CLI ausführen, wenn ein Workflow Validierung, Indexing oder Helper-Checks verlangt.
-
-Truthmark besitzt die generierten Workflow-Schnittstellen, aber der wichtige Vertrag ist architektonisch: repo-lokale Config und Routing zeigen Agents auf kanonische Truth-Dokumente, während host-native Workflows jedem unterstützten Agent einen eigenen Weg geben, dieselben Truthmark-Prozeduren auszuführen.
-
-Generierte Workflow-Schnittstellen enthalten Truthmark-Versionsmarker. Nach einem Upgrade von Truthmark erneut ausführen:
-
-```bash
-truthmark init
-```
-
-Prüfe danach die generierten Diffs.
-
-## Unterstützte Agentenplattformen
-
-Die Standardkonfiguration enthält jede unterstützte Plattform.
-
-Entferne Plattformen, die du nicht nutzt, aus `.truthmark/config.yml`, und führe danach erneut aus:
-
-```bash
-truthmark init
-```
-
-| Plattform-Configname | Generierte Oberfläche | Aufrufform |
-| --- | --- | --- |
-| `codex` | `.agents/skills/truthmark-*/`, `.codex/agents/` | `/truthmark-*` oder `$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-*` in unterstützten Copilot-IDEs; `@truth-*` Custom Agents in Copilot CLI |
-| `opencode` | `.opencode/skills/truthmark-*/`, `.opencode/agents/` | `/skill truthmark-*` |
-| `gemini-cli` | `.gemini/skills/truthmark-*/`, `.gemini/commands/truthmark/`, `.gemini/agents/`, `GEMINI.md` | `/truthmark:*` |
-
-Unbekannte Plattformnamen sind Config-Fehler.
-
-Das Entfernen einer Plattform stoppt künftige Aktualisierungen für diese Plattform. Es löscht zuvor generierte Dateien nicht.
-
-## KI-seitige Workflows
-
-Diese Workflows werden in unterstützte KI-Coding-Hosts installiert.
-
-Sie werden von Agenten oder Agenten-Hosts während der Repository-Arbeit genutzt. Sie sind keine Top-Level-Shell-Befehle.
-
-| Workflow | Richtung | Nutze ihn, wenn | Schreibgrenze |
-| --- | --- | --- | --- |
-| Truth Structure | topology-first | Die Standardroute zu breit ist, Ownership mehrere Bereiche umfasst oder Routendateien noch auf Platzhalter zeigen. | Erstellt oder repariert Routing und Starter-Truth-Dokumente. |
-| Truth Document | implementation-first | Verhalten bereits im Code existiert, aber kanonische Truth-Dokumente fehlen oder schwach sind. | Schreibt nur Truth-Dokumente und Routing. Funktionaler Code darf nicht geändert werden. |
-| Truth Sync | code-first | Funktionaler Code geändert wurde und zugeordnete Truth-Dokumente vor der Übergabe aktualisiert werden müssen könnten. | Aktualisiert Truth-Dokumente. Funktionaler Code darf von Truth Sync nicht umgeschrieben werden. |
-| Truth Realize | doc-first | Produkt- oder Architektur-Truth-Dokumente führen und Code daran angepasst werden soll. | Aktualisiert nur Code. Der Agent darf die Truth-Dokumente, die er realisiert, nicht bearbeiten. |
-| Truth Check | audit-first | Ein Reviewer oder Agent die Gesundheit der Repository-Truth auditieren muss. | Auditiert und berichtet. |
-| Truthmark Portal | presentation-only | Ein Mensch ausdrücklich eine durchsuchbare statische HTML-Portalansicht über Repository-Truth-Dokumente anfordert. | Schreibt generierte nicht-kanonische statische Dateien nur unter dem konfigurierten Portal-Ausgabeverzeichnis. |
-
-### Wichtige Unterscheidung
-
-Verwechsle diese zwei Schnittstellen nicht:
-
-| Schnittstelle | Genutzt von | Beispiel | Bedeutung |
-| --- | --- | --- | --- |
-| CLI für Menschen | Menschen, Skripte, CI-ähnliche Checks | `truthmark check` | Truth-Artefakte des Repositorys im Terminal validieren. |
-| KI-seitiger Workflow | Coding-Agenten und Agenten-Hosts | `/truthmark-check` | Einen Agenten bitten, den installierten Audit-Workflow auszuführen. |
-
-Die Namen sind absichtlich verwandt, aber die Schnittstellen sind unterschiedlich.
-
-## Normale KI-gestützte Codeänderung
-
-Die meisten Nutzer sollten Truth Sync nicht jedes Mal manuell aufrufen müssen.
-
-Truth Sync ist die installierte Abschlusskontrolle für funktionale Codeänderungen.
-
-```text
-agent ändert funktionalen Code
-agent führt relevante Tests aus oder fordert sie an
-installierter Workflow erkennt, dass funktionaler Code geändert wurde
-Truth Sync prüft zugeordnete Truth-Dokumente
-agent aktualisiert Truth-Dokumente bei Bedarf
-Mensch prüft Code-Diff + Truth-Diff
-```
-
-Der direkte Aufruf ist trotzdem nützlich für Fehlersuche, frühes Synchronisieren oder eine explizite Übergabe:
-
-```text
-/truthmark-sync die Repository-Truth jetzt vor der Übergabe synchronisieren
-```
-
-## Bestehendes Verhalten ohne Doku
-
-Nutze Truth Document, wenn die Implementierung bereits existiert, aber die Repository-Truth unvollständig ist. Das ist der normale Weg für etablierte Repositories, die Truthmark übernehmen, nachdem die Codebasis bereits existiert.
-
-```text
-/truthmark-document dokumentiere das implementierte session-timeout-verhalten über src/auth/session.ts, src/auth/middleware.ts und tests/auth/session.test.ts
-```
-
-Gib den Feature-Namen, Codepfade, Testpfade oder den gewünschten Truth-Doc-Bereich an. In OpenCode-ähnlichen Hosts rufst du denselben Workflow als `/skill truthmark-document ...` auf; in Gemini CLI nutzt du `/truthmark:doc ...`.
-
-Bei einem großen Repo, das noch eine breite Platzhalterroute hat, führe zuerst Truth Structure aus und rufe danach Truth Document für jeweils ein abgegrenztes Feature oder einen Bereich auf.
-
-Truth Document prüft Implementierung, Tests, Routendateien und vorhandene Dokumente als Evidenz.
-
-Es schreibt nur Truth-Dokumente und Routing.
-
-Es darf keinen funktionalen Code ändern.
-
-## Doc-first-Änderungen
-
-Nutze Truth Realize, wenn eine Produkt- oder Architekturentscheidung in Dokumenten beginnt und Code daran angepasst werden soll.
-
-```text
-/truthmark-realize docs/truthmark/product/capabilities/session-timeout.md in Code realisieren
-```
-
-Truth Realize ist doc-first.
-
-Die Truth-Dokumente führen. Der Code folgt.
-
-Der Agent darf die Truth-Dokumente, die er realisiert, nicht bearbeiten.
-
-## Read-only-Routing-Preview
-
-Nutze Truth Preview vor einer Änderung, wenn der Agent wahrscheinliches Routing verstehen muss.
-
-```text
-/truthmark-preview das wahrscheinliche Truth-Routing für Änderungen an der Billing-API prüfen (GitHub Copilot)
-/truthmark:preview das wahrscheinliche Truth-Routing für Änderungen an der Billing-API prüfen (Gemini CLI)
-```
-
-Truth Preview ist read-only.
-
-Es ist Auswahl- und Planungshilfe, keine Schreibautorisierung und kein Ersatz für Truth Check.
-
-## Repository-Truth-Audit
-
-Nutze Truth Check, wenn du einen agentenorientierten Audit-Workflow möchtest.
-
-```text
-/truthmark-check Routing und Truth-Coverage vor dem Review auditieren
-```
-
-Nutze die CLI für Menschen, wenn du Terminalvalidierung möchtest:
-
-```bash
-truthmark check
-```
-
-Beides ist nützlich. Es ist nicht dieselbe Oberfläche.
-
-## CLI-Befehle für Menschen
-
-Die meisten Maintainer beginnen mit drei Befehlen.
-
-| Befehl | Zweck |
-| --- | --- |
-| `truthmark config` | Erstellt `.truthmark/config.yml`. Schreibt nur diese Datei, außer `--stdout` wird verwendet. |
-| `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 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.
-
-| Befehl | Zweck |
-| --- | --- |
-| `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 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.
-
-## Truthmark Portal
-
-Truthmark Portal ist ein optionaler Präsentations-Workflow für Teams, die eine menschenlesbare Site über ihren versionierten Truth-Dokumenten möchten.
-
-Er ist bewusst vom Kern-Truth-Workflow getrennt:
-
- Markdown-Truth-Dokumente bleiben kanonisch.
- Generiertes Portal-HTML dient nur der Präsentation.
- Portal wird nur manuell ausgeführt; es läuft nicht als Completion-Gate, Truth-Sync-Schritt, `truthmark check`-Schritt oder automatischer Post-Change-Hook.
- Portal-Schreibzugriffe bleiben im konfigurierten Ausgabeverzeichnis, sofern der Nutzer den Scope nicht ausdrücklich ändert.
- Generierte Seiten sollten lokale Assets, Quellen-Provenance und einen sichtbaren Markdown-ist-kanonisch-Hinweis verwenden.
-
-Aktiviere es mit dem namespaced Config-Block:
-
-```yaml
-truthmark:
-  generated:
-    portal:
-      enabled: true
-```
-
-Dann erneut ausführen:
-
-```bash
-truthmark init
-```
-
-Wenn aktiviert, installiert Truthmark host-native Portal-Workflow-Schnittstellen für die konfigurierten Plattformen, etwa `/truthmark-portal` oder `/truthmark:portal` je nach Agenten-Host.
-
-## Konfiguration
-
-Truthmark ist config-first.
-
-Die wichtigste Config-Datei ist:
-
-```text
-.truthmark/config.yml
-```
-
-Neue Repositories sollten ausführen:
-
-```bash
-truthmark config
-```
-
-Prüfe danach die generierte Config, bevor du ausführst:
-
-```bash
-truthmark init
-```
-
-Wichtige Config-Bereiche sind:
-
-| Config-Bereich | Zweck |
-| --- | --- |
-| `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. |
-| 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. |
-| `frontmatter.recommended` | Metadatenfelder, die bei Fehlen Review-Diagnostik erzeugen. |
-| `ignore` | Glob-Muster, die von relevanten Checks und Routing-Logik ausgeschlossen sind. |
-
-## Repository-Truth-Routing
-
-Truthmark ordnet Codeoberflächen Truth-Dokumenten zu.
-
-Die wichtigsten Routendateien sind:
-
-```text
-docs/truthmark/routes/areas.md
-docs/truthmark/routes/areas/**/*.md
-```
-
-Eine Route sagt dem Agenten:
-
- welche Codeoberfläche zu einem Bereich gehört
- welche Truth-Dokumente diesen Bereich besitzen
- wann Truth aktualisiert werden sollte
- welche Art von Truth-Dokument beteiligt ist
-
-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:
-
-```text
-/truthmark-structure die breite repository-area in frontend, backend, billing und deployment aufteilen
-```
-
-Gutes Routing gibt Truth Sync präzise Ziele.
-
-Schlechtes Routing zwingt Agenten zum Raten.
-
-## Was Truthmark installiert
-
-Truthmark installiert eine kompakte, repository-native Truth-Schicht.
-
-Das geschieht in vier Schichten:
-
- Config und Routing für Ownership-Grenzen
- kanonische Truth-Dokumente und Starter-Templates
- kompakte verwaltete Instruction-Blöcke für repositoryweite Agent-Instruktionen
- host-native Workflow-Pakete, Commands, Prompts und Verifier-Agents für die in der Config aktivierten Plattformen
-
-Truthmark bewahrt manuellen Inhalt außerhalb verwalteter Instruktionsblöcke.
-
-Generierte Workflow-Schnittstellen werden von Truthmark verwaltet und können durch erneutes Ausführen aktualisiert werden:
-
-```bash
-truthmark init
-```
-
-## Subagents und begrenzte Evidenzprüfungen
-
-Wo der Host es unterstützt, kann Truthmark projektbezogene Prüf-Agenten und einen geleasten `truth-doc-writer` installieren.
-
-Diese helfen, große Truth-Aufgaben begrenzt zu halten:
-
- Route Auditors prüfen Route-Ownership
- Claim Verifiers prüfen, ob Dokumentclaims durch Evidenz gestützt sind
- Doc Reviewers prüfen Truth-Doc-Qualität
- geleaste Doc Writers bearbeiten begrenzte Truth-Doc-Schreib-Shards
-
-Der Parent-Workflow besitzt weiterhin finale Interpretation, Schreibgrenzen, Diff-Validierung und Abnahme.
-
-Das ist wichtig: Subagents helfen bei begrenzter Evidenzarbeit. Sie ersetzen den Haupt-Workflow-Vertrag nicht.
-
-## Review-Schleife
-
-Truthmark ist für normalen Git-Review entworfen.
-
-Eine gute KI-gestützte Übergabe sollte Folgendes zeigen:
-
-```text
-Code-Diff
-Test-Evidenz
-Truth-Doc-Diff, falls nötig
-Routing-Änderungen, falls nötig
-Agentenbericht
-```
-
-Der Reviewer sollte beantworten können:
-
- Welcher Code hat sich geändert?
- Welche Truth-Dokumente besitzen diesen Code?
- Mussten diese Dokumente aktualisiert werden?
- Falls nicht, warum nicht?
- Ist der Agent innerhalb der Workflow-Schreibgrenze geblieben?
- Sind Test- oder Verifikationsevidenz enthalten?
-
-## Beispiele
-
-### Ein Repository initialisieren
-
-```bash
-npm install -g truthmark
-truthmark config
-truthmark init
-truthmark check
-```
-
-### Unbenutzte Agentenplattformen entfernen
-
-Bearbeiten:
-
-```text
-.truthmark/config.yml
-```
-
-Danach erneut ausführen:
-
-```bash
-truthmark init
-truthmark check
-```
-
-### Breites Routing aufteilen
-
-```text
-/truthmark-structure die breite repository-area in auth, billing, notifications und deployment aufteilen
-```
-
-### Implementiertes Verhalten dokumentieren
-
-```text
-/truthmark-document den implementierten Password-Reset-Flow unter docs/truthmark/engineering/behaviors/authentication dokumentieren
-```
-
-### Nach Codeänderungen synchronisieren
-
-```text
-/truthmark-sync die Repository-Truth jetzt vor der Übergabe synchronisieren
-```
-
-### Eine doc-first Entscheidung realisieren
-
-```text
-/truthmark-realize docs/truthmark/product/capabilities/invoice-retry-policy.md in Code realisieren
-```
-
-### Truth-Gesundheit im Terminal auditieren
-
-```bash
-truthmark check
-```
-
-### Branch-Impact-Zusammenfassung erzeugen
-
-```bash
-truthmark impact --base main
-```
-
-### Workflow-Status prüfen
-
-```bash
-truthmark workflow status --workflow truthmark-sync --base main --json
-```
-
-### Optionalen Portal-Workflow aktivieren
-
-```yaml
-truthmark:
-  generated:
-    portal:
-      enabled: true
-```
-
-```bash
-truthmark init
-```
-
-Bitte den Agenten-Host anschließend ausdrücklich, den installierten Portal-Workflow auszuführen, wenn die statische Präsentationssite erzeugt oder aktualisiert werden soll.
-
-## Projektstatus
-
-Truthmark V1 bietet derzeit:
-
- `truthmark config`
- `truthmark init`
- `truthmark check`
- `truthmark index`
- `truthmark impact`
- `truthmark workflow status`
- Branch-Scope-Metadaten
- verwaltete Instruktionsblöcke
- generierte Truth-Structure-Workflow-Schnittstellen
- generierte Truth-Document-Workflow-Schnittstellen
- generierte Truth-Sync-Workflow-Schnittstellen
- generierte Truth-Preview-Workflow-Schnittstellen
- generierte Truth-Realize-Workflow-Schnittstellen
- 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 WorkflowState-Artefakte
- host-spezifische Schnittstellen für Codex, Claude Code, GitHub Copilot, OpenCode und Gemini CLI
-
-## Entwicklung
-
-Abhängigkeiten installieren:
-
-```bash
-npm install
-```
-
-Die lokale Entwicklungs-CLI ausführen:
-
-```bash
-npm run dev -- init
-npm run dev -- check
-```
-
-Den vollständigen Projektcheck ausführen:
-
-```bash
-npm run check
-```
-
-Nützliche Skripte:
-
-| Skript | Zweck |
-| --- | --- |
-| `npm run dev` | Führt den TypeScript-CLI-Einstiegspunkt mit `tsx` aus. |
-| `npm run build` | Baut das Paket. |
-| `npm run lint` | Führt ESLint aus. |
-| `npm run typecheck` | Führt TypeScript-Checks aus. |
-| `npm run test` | Führt Tests aus. |
-| `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 [CONTRIBUTING.md](CONTRIBUTING.md).
-
-## Dokumentation
-
-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/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
-
-Truthmark ist absichtlich klein.
-
-Es ist nicht:
-
- ein gehosteter Dienst
- ein MCP-Server
- eine Vektordatenbank
- ein kanonischer Dokumentations-Website-Generator oder eine gehostete Docs-Plattform
- ein CI- oder PR-Enforcement-Produkt
- ein Ersatz für Tests, Code Review oder technische Führung
- eine autonome Code-Rewrite-Engine
- ein Framework für Modelltraining oder Fine-Tuning
- eine verborgene Memory-Schicht
-
-Diese Grenzen sind Teil des Produkts.
-
-Truthmark hält den Workflow lokal, versioniert, branch-gebunden und prüffähig.
-
-## Sicherheit und Review-Disziplin
-
-Truthmark hilft dem Repository, ehrlich zu bleiben. Es beweist nicht, dass der Code korrekt ist.
-
-Teams sollten weiterhin:
-
- relevante Tests ausführen
- funktionale Codeänderungen prüfen
- Truth-Doc-Änderungen prüfen
- Secrets aus der Dokumentation heraushalten
- repository-spezifische Instruktionen außerhalb verwalteter Blöcke halten
- Diffs generierter Workflow-Schnittstellen nach Upgrades prüfen
- menschliche Ownership über Produkt- und Architekturentscheidungen behalten
-
-Truthmark macht agentenseitige Repository-Truth sichtbar. Es ersetzt menschliches Urteil nicht.
-
-## Roadmap-Richtung
-
-Die aktuelle Zukunftsrichtung betont:
-
- stärkere Evidenzberichte in `truthmark check`
- klarere Adoptionsbeispiele
- Beispiel-Repositories mit echten Truth-Sync-Zyklen
- Migrationsleitfäden für Teams, die bereits Agenten-Instruktionsdateien nutzen
- Konformitätstests für generierte Host-Schnittstellen
- route-aware Hinweise auf stale truth
- begrenzte Implementierungschecklisten für doc-first Arbeit
-
-Der Schwerpunkt bleibt gleich:
-
-```text
-Repository-Truth
-agent-native Workflows
-Git-Review
-branch-gebundene Dokumentation
-```
-
-## Lizenz
-
-MIT. Siehe [LICENSE](LICENSE).
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	0f048bf1de	chore(deps): bump the npm_and_yarn group across 1 directory with 2 updates (#40 ) Bumps the npm_and_yarn group with 2 updates in the / directory: [fast-uri](https://github.com/fastify/fast-uri) and [js-yaml](https://github.com/nodeca/js-yaml). Updates `fast-uri` from 3.1.4 to 3.1.5 - [Release notes](https://github.com/fastify/fast-uri/releases) - [Commits](https://github.com/fastify/fast-uri/compare/v3.1.4...v3.1.5) Updates `js-yaml` from 4.3.0 to 4.3.1 - [Changelog](https://github.com/nodeca/js-yaml/blob/4.3.1/CHANGELOG.md) - [Commits](https://github.com/nodeca/js-yaml/compare/4.3.0...4.3.1) --- updated-dependencies: - dependency-name: fast-uri dependency-version: 3.1.5 dependency-type: indirect dependency-group: npm_and_yarn - dependency-name: js-yaml dependency-version: 4.3.1 dependency-type: indirect dependency-group: npm_and_yarn ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2026-08-19 16:35:24 +10:00
MerlinH	5050eb0fb7	docs: replace README diagram with responsive visual	2026-08-02 03:25:27 +10:00
MerlinH	b1655b6e4a	docs: refresh README storefront	2026-08-02 03:25:27 +10:00
Merlin's Cat GitHub MerlinH	e3edcc8afa	feat: v2.3.0 add interactive platform selection to init (#38 ) * feat: add interactive platform selection to init * chore: remove completed OpenSpec artifacts * chore: remove implemented design note * fix: protect init lifecycle from unsafe config paths * fix: support clearing init platforms from CLI * docs: retire config command from repository rules * docs: align init lifecycle and clear-platform contracts * docs: keep repository guidance current-state focused * docs: limit cleanup to repository-native documents * docs: preserve historical version notes --------- Co-authored-by: MerlinH <merlinh221@gmail.com>	2026-07-31 18:54:10 +10:00
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	d88e4eb16d	chore(deps): bump the npm_and_yarn group across 1 directory with 2 updates (#35 ) Bumps the npm_and_yarn group with 2 updates in the / directory: [fast-uri](https://github.com/fastify/fast-uri) and [js-yaml](https://github.com/nodeca/js-yaml). Updates `fast-uri` from 3.1.2 to 3.1.4 - [Release notes](https://github.com/fastify/fast-uri/releases) - [Commits](https://github.com/fastify/fast-uri/compare/v3.1.2...v3.1.4) Updates `js-yaml` from 4.2.0 to 4.3.0 - [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md) - [Commits](https://github.com/nodeca/js-yaml/compare/4.2.0...4.3.0) --- updated-dependencies: - dependency-name: fast-uri dependency-version: 3.1.4 dependency-type: indirect dependency-group: npm_and_yarn - dependency-name: js-yaml dependency-version: 4.3.0 dependency-type: indirect dependency-group: npm_and_yarn ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2026-07-30 23:03:23 +10:00
MerlinH	c067e3e99f	feat(site): add responsive tabbed product guide	2026-07-28 09:27:55 +10:00
MerlinH	bfee763ab2	feat: compact workflow status context	2026-07-27 00:19:37 +10:00
dependabot[bot]andMerlinH	72e6117cf4	chore(deps-dev): bump brace-expansion Bumps the npm_and_yarn group with 1 update in the / directory: [brace-expansion](https://github.com/juliangruber/brace-expansion). Updates `brace-expansion` from 1.1.15 to 1.1.16 - [Release notes](https://github.com/juliangruber/brace-expansion/releases) - [Commits](https://github.com/juliangruber/brace-expansion/compare/v1.1.15...v1.1.16) --- updated-dependencies: - dependency-name: brace-expansion dependency-version: 1.1.16 dependency-type: indirect dependency-group: npm_and_yarn ... Signed-off-by: dependabot[bot] <support@github.com>	2026-07-25 23:06:59 +10:00
Merlin's Cat GitHub MerlinH	c92b46ad65	feat: harden init routing and generated lifecycle (#33 ) * feat: harden init routing and generated lifecycle * test: align restored coverage with platform routing * docs: translate localized uninstall guidance * test: complete init routing and lifecycle coverage * docs: record completed OpenSpec tasks * chore: archive implemented init lifecycle OpenSpec change * chore: remove OpenSpec configuration * docs: clarify platform omission reconciliation --------- Co-authored-by: MerlinH <merlinh221@gmail.com>	2026-07-12 20:48:09 +10:00
Merlin's Cat GitHubCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>MerlinHCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>	9fa9ac25a4	feat: add workflow eval framework (#32 ) * feat: add workflow eval framework Add workflow evaluation scenarios, rubrics, schemas, and runner scripts for installed Truthmark workflows. Move research notes under docs/research and migrate tests from Vitest to node:test. * Potential fix for pull request finding 'CodeQL / Replacement of a substring with itself' Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> --------- Co-authored-by: MerlinH <merlinh221@gmail.com> Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>	2026-06-30 20:57:55 +10:00
MerlinH	98061f7456	site: improve mobile layout	2026-06-27 01:47:11 +10:00
MerlinH	932a08ed93	ci: remove openssf scorecard	2026-06-27 01:23:24 +10:00
Merlin's Cat GitHub MerlinH	3c52f21d90	feat: add static introduction website (#29 ) * feat: add static introduction website * feat: expand static website positioning * feat: redesign site with original visuals * docs(readme): add package status badges * ci: add project readiness automation * ci: restrict scorecard workflow permissions * ci: remove duplicate readiness config * ci: pin workflow actions by sha * docs: add scorecard badge --------- Co-authored-by: MerlinH <merlinh221@gmail.com>	2026-06-27 01:15:39 +10:00
Merlin's Cat GitHub MerlinH	15b8bb94e9	chore: prepare Truthmark 2.2.6 (#28 ) * feat: add compact truth-doc prose guidance * chore: prepare Truthmark 2.2.6 * fix: preserve truth doc line discipline * docs: emphasize ongoing truth curation * docs(truth): add behavior scenarios to truth docs --------- Co-authored-by: MerlinH <merlinh221@gmail.com>	2026-06-27 00:05:15 +10:00
MerlinH	f599b15238	fix: publish npm from release tags	2026-06-22 18:07:08 +10:00
Merlin's Cat GitHub MerlinH	7e60fbce68	chore: prepare Truthmark 2.2.5 (#26 ) Co-authored-by: MerlinH <merlinh221@gmail.com>	2026-06-22 03:28:02 +10:00
MerlinH	07cbf9b003	chore: migrate pending README and agent rule updates	2026-06-21 01:53:40 +10:00
Merlin's Cat GitHub MerlinH	1ae5ee6d15	chore: refresh generated surfaces and release 2.2.4 (#24 ) * docs: move localized READMEs to docs and update packaging * chore: remove OpenSpec preview and Gemini artifacts * fix: resolve localized README merge artifacts * chore: rename pt-BR localized README to pt * chore: refresh generated surfaces and change log for release 2.2.4 * fix: reformat 2.2.4 change log entry * chore: rename 2.2.4 changelog note * fix: refresh localized README translations and links --------- Co-authored-by: MerlinH <merlinh221@gmail.com>	2026-06-21 01:16:10 +10:00
MerlinH	47989f2dc0	docs: move localized READMEs to docs and update packaging	2026-06-20 21:52:59 +10:00
Merlin's Cat GitHub MerlinH	c70b957149	docs: update README quick start and AI workflow examples (#22 ) * docs: update README quick start and quick-start workflows * docs: expand README language support list * docs: add missing localized README links and files * docs: update localized READMEs with complete synchronized content --------- Co-authored-by: MerlinH <merlinh221@gmail.com>	2026-06-20 20:59:05 +10:00
MerlinH	724f4aa60a	docs: cite docs/ai/repo-rules.md in local instruction files	2026-06-20 20:22:08 +10:00