add documents and wiki

skills/wiki-lint/SKILL.md

@@ -40,6 +40,10 @@ Work through these in order:
 9. **Address validity** (DragonScale Mechanism 2). For every page that has an `address:` frontmatter field, validate the format. See the **Address Validation** section below.
 10. **Semantic tiling** (DragonScale Mechanism 3, opt-in). Flag candidate duplicate pages (across all scanned types, not just concepts) via embedding cosine similarity. See the **Semantic Tiling** section below.
 
+### Support-reference exclusions
+
+Files under `wiki/references/` are support documentation for skills and vault mechanics, not first-class wiki notes. Exclude `wiki/references/` from orphan-page checks, missing cross-reference checks, frontmatter-gap checks, empty-section checks, address enforcement, and semantic tiling. Still resolve any `[[wikilink]]` that appears inside those files so broken links are not hidden.
+
 ---
 
 ## Lint Report Format
@@ -100,6 +104,18 @@ Filenames must be unique across the vault. Wikilinks work without paths only if
 
 ---
 
+## Cross-Reference Heuristic
+
+Missing cross-reference detection is heuristic. To avoid noisy reports in product/manual-heavy vaults:
+
+- Scan prose body only. Ignore YAML frontmatter, aliases, title fields, headings, code blocks, inline code, and existing wikilinks.
+- Treat an entity as already linked if it appears in `related:` or `sources:` frontmatter as a wikilink.
+- Do not flag a page when the entity name is used as the page namespace or title prefix, such as `Abaqus ...`, `Midas FEA ...`, or `Midas Civil ...` concept pages.
+- Do not flag pages under `wiki/references/`, `wiki/meta/`, or `wiki/folds/`.
+- Report candidates as "needs review", not errors, unless a human has confirmed the missing link policy for that entity type.
+
+---
+
 ## Writing Style Check
 
 During lint, flag pages that violate the style guide:
@@ -194,7 +210,7 @@ Before validating anything, classify the page:
 
 | Classification | Criteria |
 |---|---|
-| **Meta / fold / excluded** | File is in `wiki/folds/` OR filename in `{_index.md, index.md, log.md, hot.md, overview.md, dashboard.md, dashboard.base, Wiki Map.md, getting-started.md}`. Address not required. |
+| **Meta / fold / support / excluded** | File is in `wiki/folds/` OR `wiki/references/` OR filename in `{_index.md, index.md, log.md, hot.md, overview.md, dashboard.md, dashboard.base, Wiki Map.md, getting-started.md}`. Address not required. |
 | **Post-rollout (must have address)** | `type` is not meta/fold AND frontmatter `created:` date is >= 2026-04-23 AND file path is NOT in the legacy baseline manifest. |
 | **Legacy (backfill-eligible)** | `type` is not meta/fold AND frontmatter `created:` date is < 2026-04-23 OR file path IS in the legacy baseline manifest. Address not required until backfill. |
 
@@ -223,7 +239,7 @@ Before validating anything, classify the page:
 - Pages that HAVE colliding addresses: **error**.
 - Pages classified **post-rollout** WITHOUT an address: **error**.
 - Pages classified **legacy** WITHOUT an address: **informational** (expected).
-- Meta and fold pages without `address`: **ignored** (not applicable).
+- Meta, fold, and support-reference pages without `address`: **ignored** (not applicable).
 - Counter drift (observed counter >= peek): **error**.
 - Address-map mismatch: **error**.
 
@@ -298,7 +314,7 @@ esac
 ### Scope (what the helper scans)
 
 - Includes: every `.md` under `wiki/` **except** the exclusion set below. The scope is "candidate tileable pages," not just `type: concept`.
-- Excludes (path): anything under `wiki/folds/` or `wiki/meta/`.
+- Excludes (path): anything under `wiki/folds/`, `wiki/meta/`, or `wiki/references/`.
 - Excludes (filename): `_index.md`, `index.md`, `log.md`, `hot.md`, `overview.md`, `dashboard.md`, `Wiki Map.md`, `getting-started.md`.
 - Excludes (frontmatter): `type: meta` or `type: fold`.
 - Excludes (security): symlinks. Any page file that is a symlink, or whose resolved path escapes the vault root, is skipped.