Files
truthmark/docs/standards/pre-completion-checklist.md
a083b703fa feat: add Truthmark health scorecard and bounded workflow contracts (#13)
* feat: add OpenSpec-driven workflow state

* docs: plan generated playbooks workflow contract

* feat: add truth health scorecard

Release Truthmark 2.1.0 with check JSON scorecard output.

Archive the completed OpenSpec pass 4 scorecard change and update generated truth surfaces.

* fix: unblock truthmark scorecard review

- restore and update coverage for scorecard/evidence/workflow behavior
- make truthmark-sync select a cheap local base when --base is omitted
- report malformed evidence YAML blocks as diagnostics instead of throwing

* fix: tighten workflow boundaries

* fix: fail closed when sync has no comparison base

* fix: tighten truth health review coverage

- only parse fenced YAML evidence blocks with top-level evidence markers
- convert coverage fixtures to valid v2 config and assert non-vacuous diagnostics
- update Truthmark truth docs for source traceability and workflow-state tests

* docs: clarify source traceability diagnostics

* docs: harden optional CLI workflow boundary

* docs: clarify product boundary is repo-local

* fix: bound truthmark workflow fallback behavior

- make live workflow preflight use the one-call instructions contract
- keep missing-CLI fallback bounded for Sync, Document, Structure, and Realize
- add routing and generated-surface coverage plus refreshed host surfaces

* test: cover no-cli workflow fallback bounds

- assert route-first fallback wording in generated workflow surfaces
- clarify progressive-disclosure support files are conditional
- align overview docs with bounded no-CLI behavior

* docs: route workflow eval coverage

* fix: remove workflow instructions preflight

* fix: remove stale workflow preflight wording

* fix: remove generic workflow validation blocks

* fix: avoid duplicated markdown context JSON

* fix: keep workflow status manifest-only

* docs: align truth docs with v2 hierarchy

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-13 04:09:45 +10:00

1.8 KiB

status, doc_type, last_reviewed, source_of_truth
status doc_type last_reviewed source_of_truth
active standard 2026-05-13
testing-and-verification.md
documentation-governance.md
versioning.md
change-notes.md

Pre-Completion Checklist

Scope

Use this checklist before declaring Truthmark work complete.

Checklist

  • Did the change stay within the requested scope?
  • If behavior, contracts, or workflow text changed, did the nearest canonical docs change in the same working change?
  • If this was a major product, onboarding, install, command, positioning, or workflow change, did you review the root README.md and update stale user-facing claims, examples, or command sequences?
  • If the root README changed materially, did the localized README variants change in the same working change? If not, stop unless you have an explicit repo-authorized reason they intentionally remain different, and state that reason. A passing verification command does not waive this gate.
  • If canonical routing changed, did docs/truthmark/routes/areas.md change too?
  • If the change is PR-worthy, release-worthy, or changes the package version, did you add or update a changes/ note using docs/standards/change-notes.md?
  • If any package version or release/version policy changed, did you apply docs/standards/versioning.md before accepting the version?
  • If AGENTS.md changed, did manual edits stay outside the managed Truthmark block?
  • Did you run the narrowest meaningful verification command from docs/standards/testing-and-verification.md?
  • If a normally expected verification step was skipped, did you state the reason explicitly?
  • If the task was documentation-only, did you confirm whether Truth Sync should be skipped rather than run?