brain-refresh

name	brain-refresh
description	Reconcile ontology-brain with a source set or maintenance window. Use when asked to refresh, sync, audit freshness, or bring the brain up to date across multiple pages.

Brain Refresh

Use this skill for multi-page reconciliation.

Workflow

1. Read AGENTS.md, ontology.md, and the latest entries in log.md.
2. Define the refresh scope: source set, object types, date window, or folders.
3. Read changed or relevant raw sources.
4. Update canonical pages only where facts changed.
5. Propagate references across related pages.
6. Regenerate index.md with python3 .claude/skills/brain-lint/scripts/build_index.py.
7. Append log.md with ## [YYYY-MM-DD] refresh | <title> when facts changed.
8. Run python3 .claude/skills/brain-lint/scripts/wiki_link_check.py.

Freshness Rules

• Do not refresh by rewriting everything.
• Do not invent missing facts.
• Keep unresolved claims labeled [UNVERIFIED].
• Replace [UNVERIFIED] only with a dated source-backed fact.
• Use relates_to for meaningful associations that do not deserve a sharper link.

Review Checklist

• New pages are reachable through generated index.md or typed links.
• Old links still resolve.
• Typed link properties use the vocabulary in ontology.md.
• Replacement links are mirrored.
• No page escapes the brain via local path links.
• The lint gate reports 0 problems.