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