← ClaudeAtlas

syncing-docslisted

Reconciles doc metadata after a submodule/script ships or before release: re-stamps provenance sidecars, regenerates "N of 22" doc-count sites, confirms exports documented, verifies script conformance, regenerates the reference index, runs markdown lint. Use for /syncing-docs, "sync docs", "reconcile docs", "stamp provenance", or after implementing pipelines finish. m3l MCP stance: adr_query (ADR-0096).
monte3l/m3l-automation · ★ 0 · Data & Documents · score 56
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