Maintain a Yarbrain Wiki
Keep the vault trustworthy without optimizing for fewer files or rewriting it
for appearance.
Treat an audit request as read-only. Write a report, rebuild an index, or change
vault content only when the user also authorizes maintenance.
Workflow
- Resolve ../../scripts/yarbrain.py relative to this SKILL.md and run lint.
Record missing structure, duplicate IDs, missing provenance, and broken links
before using model judgment.
- Count pending session records and identify episodes with no semantic or
procedural consumer, notes past their freshness window, overlapping aliases,
disputed claims, oversized index content, and skills contradicted by newer
successful episodes.
- Classify each proposed change as fix-structure, merge, split, supersede,
archive, reverify, or promote-procedure. Route procedure work to
procedure-promote and semantic changes or disputes to wiki-reconcile. Leave
ineligible procedure candidates unchanged and report them as deferred.
- Present every proposed mutation for approval, including structural fixes,
semantic changes, index or report writes, and archival. Never delete the only
copy of evidence or choose between credible conflicts without support.
- Apply only approved changes. Read every changed file back, rerun lint, and
rebuild INDEX.md after canonical content is sound.
- Refresh reports/wiki-health.md with the check time, deterministic results,
approved changes, unresolved conflicts, stale items, and pending counts.
Indexes and caches are rebuildable. Episodes are evidence. Canonical notes can
evolve only through reconciliation. Keep those ownership rules intact during
cleanup.
This version does not define an episode archival operation. Report unreferenced
or old episodes as candidates, but do not move or delete them.
1---2name: wiki-maintain3description: Audit and conservatively maintain a configured Yarbrain vault for structural errors, stale knowledge, duplication, conflicts, unprocessed evidence, and skill drift. Use periodically or when recall quality declines; make deterministic checks first and require approval for semantic consolidation or archival.4---56# Maintain a Yarbrain Wiki78Keep the vault trustworthy without optimizing for fewer files or rewriting it9for appearance.1011Treat an audit request as read-only. Write a report, rebuild an index, or change12vault content only when the user also authorizes maintenance.1314## Workflow15161. Resolve ../../scripts/yarbrain.py relative to this SKILL.md and run lint.17 Record missing structure, duplicate IDs, missing provenance, and broken links18 before using model judgment.192. Count pending session records and identify episodes with no semantic or20 procedural consumer, notes past their freshness window, overlapping aliases,21 disputed claims, oversized index content, and skills contradicted by newer22 successful episodes.233. Classify each proposed change as fix-structure, merge, split, supersede,24 archive, reverify, or promote-procedure. Route procedure work to25 procedure-promote and semantic changes or disputes to wiki-reconcile. Leave26 ineligible procedure candidates unchanged and report them as deferred.274. Present every proposed mutation for approval, including structural fixes,28 semantic changes, index or report writes, and archival. Never delete the only29 copy of evidence or choose between credible conflicts without support.305. Apply only approved changes. Read every changed file back, rerun lint, and31 rebuild INDEX.md after canonical content is sound.326. Refresh reports/wiki-health.md with the check time, deterministic results,33 approved changes, unresolved conflicts, stale items, and pending counts.3435Indexes and caches are rebuildable. Episodes are evidence. Canonical notes can36evolve only through reconciliation. Keep those ownership rules intact during37cleanup.3839This version does not define an episode archival operation. Report unreferenced40or old episodes as candidates, but do not move or delete them.
yarlson