truthmark AGENTS.md

Repository rule source of truth: docs/repo/ai/repo-rules.md. Follow repository instruction files that are present in this checkout; do not assume optional policy docs exist.

Use explicitly configured repository policy docs only when they exist in this checkout.

Agent-specific:

• Read the configured Truthmark routing files when choosing or updating canonical docs.
• Use repository onboarding or docs-map files only when present and needed for unclear or cross-area routing.

Authority

Conflict order:

1. this file (docs/repo/ai/repo-rules.md)
2. .truthmark/config.yml
3. docs/truthmark/routes/areas.md and docs/truthmark/routes/areas/**/*.md
4. docs/repo/standards/**/*.md
5. docs/repo/architecture/**/*.md
6. docs/truthmark/product/**/*.md and docs/truthmark/engineering/**/*.md

Authoritative context is the current checkout plus user-provided session context; chat, external notes, and off-repo memory are non-authoritative unless committed or supplied now.

Code is the implementation. On code/doc conflict, inspect code, decide whether code is intentional or docs are stale, update stale docs for intentional behavior, and change code to match docs only when requested or required.

Documentation Scope

Everything under docs/repo/** is repo-local policy for developing Truthmark itself. It ships to nobody, src/** never references it, and it is not a downstream scaffold, generated surface, or required artifact for repositories that install Truthmark. Repo-local docs declare scope: repo-local and use doc_type, never truth_kind.

Everything else under docs/** describes the installed product. docs/truthmark/** is this repository dogfooding the same truth schema truthmark init scaffolds downstream, so it is evidence about the product; docs/repo/** is not.