syncing-docslisted
Install: claude install-skill monte3l/m3l-automation
Reconcile all documentation metadata for `@m3l-automation/m3l-common`. This
task touches **only** docs metadata (provenance sidecars, count checks, markdown
lint) — never source code, tests, or barrel exports.
## Steps
### 0 — Preferred path: the composite entry point
```bash
pnpm sync:docs # or: node bin/sync-docs.mjs [--affected <path>] [--json]
```
`bin/sync-docs.mjs` (ADR-0030 Phase 4) runs steps 1–9 below as one
deterministic sequence: fail-fast ordering, re-stamp-before-verify (so a
staleness warning that the restamp itself would clear never aborts the run),
the gen:index-before-prettier rule baked in (it prettier-writes exactly the
artifacts `gen:index` regenerated), plus a machine check for the step-7 trap
(every barrel export must appear in a sidecar `sections[].sources[]`).
`--json` emits one aggregated payload; the human mode prints the summary
block below. When it passes, this skill is done — report its summary.
Fall back to the manual steps only when the composite itself is broken or you
need to isolate a single failing step.
### Manual sequence (fallback / reference)
Run in order. **Fail fast**: stop at the first failing step, report the full
error output, and tell the user what to fix before re-running.
### 1 — Re-stamp provenance to current HEAD
```bash
node bin/check-doc-provenance.mjs --update
```
`--update` validates sidecar structure first — headings exist in the sibling
`.md`, source files exist, symbols are exported — and exits 1 witho