Fix the 12 relative links broken since before this branch (defunct
docs/truth/workflows/ paths, moved .codex/skills/ -> .agents/skills/
paths, and one link to a test file that was never created) and correct
a stale generated-surfaces list in the same research note.
Remove "Maintaining repository truth" from all 16 READMEs and the user
guide's documentation list. It links docs/repo/standards/maintaining-
repository-truth.md, which states it is for Truthmark's own maintainers
and carries scope: repo-local, but sat in storefront lists next to
product-facing docs as if it were guidance for people installing
Truthmark.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Repository policy lived only in docs/repo/ai/repo-rules.md, which an
agent reads once via a tool call and a summarizer drops first. The
instruction files are injected as session context instead, so they
survive compaction.
Generate a repo-rules region into both files from the source doc's
always-on section rather than moving or symlinking policy there. The doc
stays the authority and the region is generated output under rule 8, so
no second file claims authority. Symlinks were rejected: sync/classify.ts
already treats these files as derived, Git on Windows materializes
symlinks as text when core.symlinks is off, and init and uninstall write
each path independently.
Marker names are referenced without comment syntax in the source doc
because a literal marker inside the rendered region duplicates it in the
instruction files and makes the Truthmark managed block unparseable.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Drop github-copilot from .truthmark/config.yml and let the init lifecycle
prune the 29 generated surfaces it owned, then remove the leftover
.github/copilot-instructions.md preamble.
Copilot remains a supported platform of the product. Only this
repository's installation changed, so allPlatforms render assertions keep
their Copilot coverage; the checked-in path lists in
tests/templates/generated-surfaces.test.ts follow what this repository
actually installs and drop their .github entries.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Repo-local policy docs (ai, standards, architecture, research) sat as
siblings of the dogfooded product truth tree, so the only signal that
they ship to nobody was one sentence inside repo-rules.md. Agents reason
from paths continuously and read prose once, which made it easy to cite
repo-local policy as evidence about the installed product.
Move them under docs/repo/, declare scope: repo-local in frontmatter,
and enforce four invariants in tests/doc-scope.test.ts. The check is a
repo-local test rather than a src/checks diagnostic because truthmark
check runs in downstream repositories, which have no such boundary.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* feat(workflows): add verifier agent surfaces
Generate project-scoped read-only verifier agents for Codex, Claude Code, GitHub Copilot, and OpenCode.
Wire workflow manifests, generated surfaces, init diagnostics, sync classification, docs, and tests through the new subagent contract.
* feat(workflows): add leased truth doc writer agents
Add write-capable truth-doc-writer generated surfaces for Codex, Claude, Copilot, and OpenCode, guarded by explicit write leases. Tighten Truth Sync and Truth Document subagent contracts so parents validate leases, changed files, and worker reports before accepting doc updates.
* feat(workflows): add Truth Preview and workflow support files
Add the explicit read-only Truth Preview workflow across the manifest, generated host surfaces, docs, and tests.
Move generated skill hosts to compact SKILL.md entrypoints with support procedure, report, and lease files, and add write-worker report acceptance validation against actual lease diffs.