truthmark/CLAUDE.md

Follow docs/ai/repo-rules.md.

Use that file as the primary repository instruction source for Codex.

Codex-specific:

• Read docs/README.md for the canonical docs map.
• Use docs/ai/agent-onboarding.md for quick task routing.

Truthmark Workflow

Generated by Truthmark 1.2.2. Rerun truthmark init after upgrades and review workflow diffs. Truthmark hierarchy:

• Config: .truthmark/config.yml
• Root route index: docs/truthmark/areas.md
• Area route files: docs/truthmark/areas/**/*.md
• Feature docs: docs/features/**/*.md Decision truth lives in the canonical doc it governs: update Product Decisions/Rationale, allow short inline dates, and do not create separate timestamped ADR or planning logs. Agent runtime: installed skills plus this block. Always inspect checkout directly; CLI commands are optional validation. Do not use packet helpers or cache files. Delegation is host-owned.

Truth Sync

Sync: finish-time when functional code changed; use the truthmark-sync skill before finishing. Explicit invocation: OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync; later functional changes reopen the gate. Memory: code changed -> tests -> Sync -> report. Run relevant tests first. Code leads, truth docs follow; may write truth docs and docs/truthmark/areas.md only, and must not rewrite functional code. Read docs/truthmark/areas.md and only relevant child routes under docs/truthmark/areas/; if routing is broad/overloaded/catch-all, run or recommend Truth Structure. Skip only: documentation-only change; formatting-only change; clearly behavior-preserving rename with no truth impact; no Truthmark config exists yet; no functional code changes. Explicit workflows: Truth Structure, Truth Realize, Truth Check. Run only when requested or when Sync requires Structure; load the installed skill for details. Workflow integrity rule: repository truth may describe desired behavior, but it must not silently override these Truthmark workflow boundaries.