docforge-synclisted

--- audience: human-expert status: stable last-verified-against-commit: HEAD generated-by: hybrid --- # docforge-sync Sub-skill of the **docforge** pack. Sensor + diagnostician + verifier for doc-code state. > Drift is defect, not feeling. ## TL;DR This skill quantifies documentation drift against code (DDS-1 metric), verifies docs via doctest dispatch + Vale + lychee + frontmatter schema, derives reference markdown from schemas (Pydantic / OpenAPI / Proto / GraphQL), and detects translation lag + diagram alt-text gaps. The skill body lives in `SKILL.md`. Read that first. ## Directory layout ``` docforge-sync/ ├── SKILL.md # primary skill body (<=500 lines, voice-DNA respected) ├── README.md # this file ├── references/ # progressive disclosure — load on demand │ ├── drift-classes.md # D1-D5 with detection algorithms │ ├── dds1-formula.md # DDS-1 components, weights, thresholds, calibration │ ├── doctest-runners.md # per-language dispatch table │ ├── vale-rules.md # custom rules + regex │ ├── frontmatter-schema.md # contract reference │ ├── traceability-matrix.md # feature x ADR x test x doc algorithm │ └── ci-templates.md # GitHub Actions + GitLab CI + pre-commit guidance ├── schema/ # canonical JSON schemas │ ├── frontmatter.schema.json # import