Wiki Lint Workflow

Validate wiki structure, generated artifacts, routing integrity, stale claims, and agent-operational drift before declaring maintenance complete.

The canonical validator is now:

npx tsx scripts/doctor.ts --quiet

scripts/lint.ts is a compatibility alias for the wiki-structure doctor. Do not document new workflows around lint.ts as the primary command. Source: AGENTS.md Operations, 2026-06-18

What it catches

Missing or malformed frontmatter
Broken wikilinks and relationship targets
Manual ## Backlinks sections that pollute the graph
Orphan pages, islands, and suspiciously thin pages
Long unmarked pages that may need longform: true or splitting
Stale generated artifacts
Skill/catalog/config sync drift where doctor checks are enabled
Automation and state issues surfaced by the broader health stack

When to run

Run after:

a large docs or ingest pass
edits to resolver, meta, identity, skill, automation, or config docs
page moves, merges, or deletes
frontmatter schema changes
before committing wiki maintenance work
whenever check-freshness reports stale structural state

Companion commands

npm run wiki-quality
npx tsx scripts/wiki-status.ts
npx tsx scripts/wiki-breakdown.ts --threshold 3
npm run routing-doctor
npm run trigger-eval

Use wiki-quality for the broad corpus audit, wiki-status for category and graph shape, wiki-breakdown for missing entity candidates, routing-doctor for skill/resolver/tool pointers, and trigger-eval for routing behavior.

After validation

Fix errors before bulk operations. Warnings can be logged with rationale if they are intentional, but do not let warnings become wallpaper. Append meaningful results to wiki/log.md after large maintenance passes.

If doctor modifies wiki/meta/doctor-results.json or doctor-history.json, include those generated files with the maintenance change unless the run was exploratory and you are not committing.

The validation layer is a guardrail, not a merge queue. It catches structural drift; it does not decide content quality by itself. For broad article rewrites, pair the checks with a manual pass over the touched category README and a sample of representative pages.

Run Contract

This workflow follows Workflow Run Contract: name the sources, write output or no-op proof, promote only durable facts, update state only when the run really completed, refresh generated surfaces when durable pages or skills change, and log user-visible work.

Timeline

2026-07-01 | Added npm run wiki-quality, clarified generated doctor outputs, and tied validation to broad article rewrites rather than only script health. Source: User request, 2026-07-01
2026-06-18 | Updated workflow to make scripts/doctor.ts --quiet the canonical validator, with lint.ts documented as a compatibility alias and companion commands listed. Source: User request, 2026-06-18
2026-05-31 | Workflow page created from AGENTS.md lint operation. Source: AGENTS.md, 2026-05-31

Source: AGENTS.md Operations, 2026-06-18

Source: User request, 2026-07-01