Wiki / File
Back to vault tree

_lint-report-2026-05-24

Wiki Lint Report — 2026-05-24

Summary

  • HIGH: 209 findings
  • MEDIUM: 7 findings
  • LOW: 0 findings

Counting method: one offending link reference, file, or duplicate pair counts as one finding. This was a report-only pass; no content was fixed.

Scope and sample inspected

  • Walked 216 Markdown files under Wiki/, Departments/, Agents/, Skills/, Brands/, and Integrations/.
  • Parsed YAML frontmatter where present; 15 files had no frontmatter block.
  • Built an Obsidian <a class="wikilink wikilink-broken" href="#">wikilink</a> graph from 620 wikilink references.
  • Checked Raw/ citation coverage from Wiki/ files.
  • Verified concrete Markdown references in CLAUDE.md routing table.

Representative structure observed:

  • Cross-cutting: Agents/, Skills/, Integrations/, _System/.
  • Business context: Context/, Brands/{brand}/, Departments/{dept}/.
  • Knowledge graph: Wiki/{People,Companies,Concepts,Decisions,Learnings,Libraries,Notes,...}.
  • Inputs: Raw/{Health,Inbox,Notion,Documents,Transcripts,Learnings,...}.

HIGH severity

[check #2] Broken wikilinks — 159 refs across 61 files

Why it matters: unresolved wikilinks break Obsidian graph traversal and retrieval. A large share are placeholder/template examples ({slug}, <brand-slug>, ..., wildcard paths), but the linter currently sees them as real graph links.

Top sources by count:

  • Wiki/Log.md — 18 refs, including placeholder <a class="wikilink wikilink-broken" href="#">link</a>, template paths, wildcard paths, and historical artifact links to folders.
  • Skills/learn-from-source.md — 8 refs, mostly placeholder/example links.
  • Wiki/Index.md — 7 refs to folders such as <a class="wikilink wikilink-broken" href="#">Wiki/People/</a> and <a class="wikilink wikilink-broken" href="#">Wiki/Libraries/</a>.
  • Brands/Brand-B/knowledge-base.md — 6 refs, mostly placeholder brand links.
  • Brands/_Template/knowledge-base.md — 6 refs, mostly placeholder brand links.
  • Brands/primal-harvest/knowledge-base.md — 6 refs, mostly placeholder brand links.
  • Departments/Personal/Development.md — 5 refs, mostly placeholder/template links.
  • Skills/notebooklm-create-library.md — 5 refs, including placeholder library links and <a class="wikilink wikilink-broken" href="#">Wiki/People/naval</a>.

Representative examples:

  • Wiki/Index.md → <a class="wikilink wikilink-broken" href="#">Wiki/People/</a>, <a class="wikilink wikilink-broken" href="#">Wiki/Companies/</a>, <a class="wikilink wikilink-broken" href="#">Wiki/Libraries/</a>
  • Wiki/Companies/puravida-getbusinesscoverage.md → <a class="wikilink wikilink-broken" href="#">Wiki/Companies/grandview-media-group</a>
  • Wiki/Mimic/Briefs/commercial-insurance.md → <a class="wikilink wikilink-broken" href="#">brands/puravida-getbusinesscoverage</a> (case/path mismatch)
  • Departments/Decisions/_Department.md → <a class="wikilink wikilink-broken" href="#">Wiki/Libraries/</a>
  • Skills/onboard-brand.md → <a class="wikilink wikilink-broken" href="#">Wiki/Companies/{brand_slug}</a>, <a class="wikilink wikilink-broken" href="#">Brands/{brand_slug}/BrandContext</a>
  • Brands/*/voice-profile.md and Brands/*/knowledge-base.md → unresolved <brand-slug> template links.

Suggested next actions:

  1. Decide whether placeholder wikilinks in skills/templates should be escaped, converted to inline code, or excluded by linter rule.
  2. Replace folder wikilinks with concrete README/index files or create index files for the linked folders.
  3. Fix true path mismatches first, especially company/brand links and lowercase brands/ references.

[check #4] Missing frontmatter — 15 Markdown files

All missing-frontmatter files are Marketing reference documents imported as methodology/system-prompt material. They are still Markdown files under linted paths, so they currently fail the universal frontmatter convention.

Files:

  • Departments/Marketing/References/video-storyboarding/methodology/ai-video-generation.md
  • Departments/Marketing/References/video-storyboarding/methodology/DEMAND-GEN-VIDEO-GUIDE.md
  • Departments/Marketing/References/video-storyboarding/methodology/native-ad-creative-best-practices.md
  • Departments/Marketing/References/video-storyboarding/methodology/creative-production-methodology.md
  • Departments/Marketing/References/rmbc/claude-projects/01-3-7min-vsl.md
  • Departments/Marketing/References/rmbc/claude-projects/02-hook-generator.md
  • Departments/Marketing/References/rmbc/claude-projects/03-brief-generator.md
  • Departments/Marketing/References/rmbc/claude-projects/04-advertorial.md
  • Departments/Marketing/References/rmbc/claude-projects/05-short-vsl.md
  • Departments/Marketing/References/rmbc/claude-projects/06-medium-vsl.md
  • Departments/Marketing/References/rmbc/claude-projects/07-long-vsl.md
  • Departments/Marketing/References/rmbc/claude-projects/08-email-sequences.md
  • Departments/Marketing/References/rmbc/claude-projects/09-pdp.md
  • Departments/Marketing/References/rmbc/claude-projects/10-upsells.md
  • Departments/Marketing/References/rmbc/claude-projects/11-adcopy.md

Suggested next action: add a canonical reference schema to _System/SchemaConventions.md, then frontmatter these imported docs consistently.

[check #7] Agent / skill / integration schema drift — 12 files

Files with canonical file roles but missing required schema fields:

  • Agents/Architect.md — agent missing department, brand.
  • Skills/decompose-priority.md — skill missing tools, side_effects.
  • Skills/synthesize-priorities.md — skill missing tools, side_effects.
  • Skills/generate-plan.md — skill missing tools, side_effects.
  • Skills/mimic-analyze-template.md — skill-like file missing canonical type, inputs, outputs, agents, tools, side_effects.
  • Skills/mimic-build-brief.md — skill-like file missing canonical type, inputs, outputs, agents, tools, side_effects.
  • Skills/mimic-generate.md — skill-like file missing canonical type, inputs, outputs, agents, tools, side_effects.
  • Integrations/Drive.md — integration missing env_vars.
  • Integrations/Gmail.md — integration missing env_vars.
  • Integrations/Whoop.md — integration missing skills.
  • Integrations/AppleHealth.md — integration missing env_vars.
  • Integrations/Calendar.md — integration missing env_vars.

Suggested next action: patch the 12 canonical files before adding more automation that assumes schemas are stable.

[check #4/#7] Non-canonical Wiki frontmatter types — 23 files

These Wiki files have frontmatter but use types not defined in _System/SchemaConventions.md as canonical wiki-node/library schemas. Some may be intentional special-purpose files, but the schema registry does not currently define them.

Files/types:

  • Wiki/Index.md — wiki-index
  • Wiki/People/hamish.md — person
  • Wiki/People/michael.md — person
  • Wiki/People/max.md — person
  • Wiki/People/frank.md — person
  • Wiki/People/leo.md — person
  • Wiki/People/alan.md — person
  • Wiki/People/maximilian-b.md — person
  • Wiki/People/stephanie.md — person
  • Wiki/Meetings/leadership-standup.md — meeting
  • Wiki/Meetings/creative-weekly-sprint.md — meeting
  • Wiki/Meetings/acquisition-weekly.md — meeting
  • Wiki/Meetings/stephanie-1on1.md — meeting
  • Wiki/Meetings/_README.md — index
  • Wiki/Mimic/_README.md — index
  • Wiki/Plans/_README.md — index
  • Wiki/Notes/_active-todos.md — todo-list
  • Wiki/Goals/_README.md — index
  • Wiki/Mimic/Templates/cartoon-job-title-headline.md — ad-template
  • Wiki/Mimic/Templates/_README.md — index
  • Wiki/Mimic/Generations/_README.md — index
  • Wiki/Mimic/Briefs/commercial-insurance.md — brand-dna-brief
  • Wiki/Mimic/Briefs/_README.md — index

Suggested next action: either normalize these to type: wiki-node with node_kind, or formally add schemas for person, meeting, index, todo-list, ad-template, and brand-dna-brief.

MEDIUM severity

[check #1] Orphan Wiki nodes — 2 files

Files with zero incoming and zero outgoing wikilinks:

  • Wiki/Mimic/Templates/cartoon-job-title-headline.md
  • Wiki/Mimic/Generations/_README.md

Suggested next action: link each to the relevant Mimic index/README, or delete/archive if obsolete.

[check #5] Duplicate concepts — 2 likely real pairs

Likely concept duplication:

  • Wiki/People/leila-hormozi.md ↔ Wiki/Libraries/leila-hormozi.md
  • Wiki/People/hormozi.md ↔ Wiki/Libraries/hormozi.md

Ignored as likely false positives: repeated _README.md index names and Wiki/Log.md ↔ Wiki/People/leo.md string-distance collision.

Suggested next action: make library nodes explicitly point to canonical person nodes via subject_link, and keep the person node as the human/entity canonical page.

[check #6] Unprocessed Raw — 3 real raw data files

After excluding .gitkeep placeholders and Raw README docs, these files have no apparent Wiki/ citation:

  • Raw/Health/whoop/whoop-7d.json
  • Raw/Health/whoop/whoop-30d.json
  • Raw/Health/whoop/whoop-latest.json

Suggested next action: run the relevant health/fitness ingestion or create a synthesized note that cites these files. If they are transient cache files, document that policy and exclude them from this check.

LOW severity

No LOW severity findings this pass.

[check #3] Stale nodes

  • last_synthesized older than 90 days: 0 files found.

Routing integrity

[check #8] CLAUDE.md routing table

  • Missing concrete referenced files: 0.
  • Notes: template/path patterns such as Brands/{brand-slug}/... were not treated as concrete files.

Trends

No previous Wiki/Notes/_lint-report-*.md report was found, so this is the baseline weekly health pass.

Suggested priority order

  1. Fix true broken links that are not placeholders, especially company/brand links and folder links that should target README/index files.
  2. Resolve the 12 canonical agent/skill/integration schema drifts.
  3. Decide schema policy for reference docs and special Wiki types, then frontmatter/normalize in batches.
  4. Process or exempt the three WHOOP raw JSON files.
  5. Add Mimic README/index links to the two orphan nodes.