Brain Lint

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.