brain-lint

name	brain-lint
description	Health-check ontology-brain. Use before shipping any brain change, when asked to lint or audit the brain, or when pages may have broken links, stale index entries, duplicated facts, relationship drift, or ontology anti-patterns.

Brain Lint

Use this skill as the gate for every ontology-brain/ change.

Mechanical Gate

Run from anywhere inside ontology-brain/:

python3 .claude/skills/brain-lint/scripts/wiki_link_check.py

The script locates the brain root by walking upward to ontology.md plus objects/. It accepts an explicit root path when needed.

It checks:

• relative links resolve and stay inside the brain;
• no absolute local links or file: URIs;
• no Obsidian wikilinks inside the brain;
• heading anchors exist;
• non-meta pages have inbound links;
• frontmatter keys are known shared properties or typed link properties;
• supersedes and superseded_by are mirrored;
• index.md matches regeneration from build_index.py.

Fix the brain first. Change the checker only when the checker is demonstrably wrong, and keep schema documentation aligned.

Generated Index

index.md is derived. Do not hand-edit it. Regenerate with:

python3 .claude/skills/brain-lint/scripts/build_index.py

Use summary: in page frontmatter for the optional one-line hook on index rows.

Semantic Audit

When asked for a full health check, also inspect:

• duplicated facts that should have one canonical home;
• stale copied values;
• vague object types or premature folders;
• links that answer no domain question;
• missing source provenance;
• [UNVERIFIED] claims that can now be verified;
• relationships with their own dates, status, or evidence that should be promoted to pages.

Record meaningful audit work in log.md with a lint entry.