markdown-asset-doctor

---
name: markdown-asset-doctor
description: Zero-dependency markdown asset auditor. Detects broken local image links, missing relative paths, and unreferenced orphaned assets across project documentation.
---

# Markdown Asset Doctor

Deterministic documentation and asset validator. Verifies that all relative markdown image and file references resolve to existing files on disk, and flags orphaned images consuming repository space.

## Execution Procedure

Execute the verification script via terminal:

```bash
bash scripts/doctor.sh
```

Flags:

- `--orphans`: Scan asset directories for unreferenced files.
- `--fail-on-broken`: Return exit code 1 if broken links are discovered (ideal for CI/CD checks).