This release includes 3 breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+5 more
Affected surfaces
Summary
AI summaryUpdates align truthmark-check, truthmark-document, and truthmark-realize with stricter ownership gates, evidence requirements, and clarified scopes for Truthmark 1.2.4.
Full changelog
Summary
This change updates the three Truthmark skill definitions to align behavior, boundaries, and safety gates with Truthmark 1.2.4 workflow expectations:
What changed
truthmark-check
- Reclassifies the skill purpose and clarifies scope exclusions (not for normal lint/test/typecheck or finish-time sync).
- Adds explicit ownership/topology checks (mixed-owner/index-like docs, route alignment).
- Expands evidence requirements and documents evidence-backed reporting format.
truthmark-document
- Tightens ownership gate before editing truth docs (prevents mixed-owner or broad doc in-place edits).
- Adds explicit Product Decisions / Rationale preservation/restructure rules.
- Upgrades doc-kind handling with
docs/templates/<kind>-doc.mdand adds evidence-first workflow. - Updates references from
docs/features/**/*.mdtodocs/truth/**/*.md. - Adds stronger reporting structure for routed behavior, restructuring, and evidence.
truthmark-realize
- Clarifies this skill is for doc-to-code realization only, excluding doc-first implementation, topological repair, or checks.
- Adds ownership gate with explicit blocking conditions (broad/mixed-owner/unrouteable/stale docs).
- Expands read scope to include area route files and tests before implementation updates.
Why this matters
These updates reduce accidental out-of-scope edits, prevent ownership-boundary violations, and force evidence-backed actions across check/document/realize workflows to keep truth and code alignment auditable.
Testing / validation
- Not run (documentation-only changes to skill definitions).
Notes
truthmark-versionwas incremented to1.2.4in all three updated skills.
Breaking Changes
- truthmark-check purpose reclassified; no longer used for normal lint/test/typecheck or finish‑time sync
- truthmark-document now enforces strict ownership gate before edits, preventing mixed‑owner or broad doc in‑place changes
- truthmark-realize clarified to be for doc‑to‑code realization only, excluding topological repair or checks
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About merlinhu1/truthmark
All releases →Related context
Related tools
Beta — feedback welcome: [email protected]