Tend Docs — the loremaster

Dogfood-only. This skill assumes the repo already has an explicit doc-reference convention to audit against — a components/API reference doc, an API-contract/collection directory, or paired flow docs describing the same feature from different angles. It's shipped in this pack because it's genuinely useful once a repo has grown that convention, but it's less broadly applicable out of the box than the other tend-* skills — there may be nothing for it to check on a fresh repo.

Find the single highest-priority drift between documentation and real code — a stale doc entry, an undocumented artifact, or an API-contract mismatch — fix it minimally, verify against the ground-truth source, hand back the diff for review. One drift per run.

0. Load config

• Read .claude/tend/config.yaml if present. Per the config schema, tend-docs has no skills.docs entry — there is nothing repo-specific to read from skills.*. Off-limits are entirely built-in for this skill: the docs tree (and an API-contract directory, if one exists) are the only safe write targets; source/logic directories are never touched, regardless of config presence or content. This skill has no capability modules — skip module-gating entirely.
• No config file at all changes nothing here — this skill already runs at a fixed, conservative tier by design, not as a fallback.

1. Triage

MANDATORY READ references/scan-core.md.

• Identify the reference doc(s) that claim to be a source of truth for some set of code artifacts (e.g. a components/API reference file).
• Identify the real code artifacts to diff against — glob actual files/exports, recursing into subdirectories (the most common blind spot).
• Identify whether the repo has an API-contract/collection format (Bruno .bru, a Postman collection, an OpenAPI spec, an Insomnia export, etc.) alongside real route/endpoint handlers.
• Identify any pair or set of docs that describe the same user-facing flow from different angles, and the ground-truth source file that would resolve a contradiction between them.