Files
truthmark/.opencode/skills/truthmark-document/SKILL.md
T
452f5eeafc refactor: simplify Truthmark workflow surfaces (#20)
* refactor: simplify Truthmark workflow surfaces

* fix: limit Preview workflow surfaces to supported hosts

* docs(truthmark): sync diff-friendly truth docs

* fix: prune retired generated surfaces

* fix: prune retired generated workflow surfaces

* docs: update truthmark architecture and runtime behavior notes

* chore: bump version to 2.2.3

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-06-20 20:14:07 +10:00

1.7 KiB

name, description, argument-hint, user-invocable
name description argument-hint user-invocable
truthmark-document 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. Optional implemented behavior, API endpoint, route, controller, package, or truth-doc area to document true

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.

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