2.3 KiB
Follow docs/ai/repo-rules.md.
Use that file as the primary repository instruction source for this agent.
Agent-specific:
- Read
docs/README.mdfor the canonical docs map. - Use
docs/ai/agent-onboarding.mdfor quick task routing.
Truthmark Workflow
Generated by Truthmark 1.2.3. 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, date active decisions inline when added or changed, 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 missing/stale/broad/overloaded/catch-all or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when safe and in scope; otherwise block and 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 Document, Truth Realize, Truth Check. Run only when requested or when Sync requires Structure or Document; 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.