| name | ref-refresh |
| description | Mechanical staleness sweep over a reference scope. Scans every note's as_of age against the per-type Freshness SLA, builds an overdue-sorted refresh queue, then splits by scope — market/ stale items are handed to ref-ingest (the gate-free overwrite branch) for autonomous re-verification; CRM stale items are report-only (never auto-written). Safe to run unattended. Company is the default scope. |
| automation | autonomous |
| allowed-tools | ["Read","Write","Bash","Glob","Grep","Skill"] |
| user-invocable | true |
| argument-hint | [scope=Company] [--market-only] |
| metadata | {"version":"1.0","created":"2026-07-08T00:00:00.000Z","author":"Cornelius","changelog":["1.0: Initial version — as_of-vs-SLA staleness sweep → refresh queue; market→ref-ingest (ungated overwrite), CRM→report-only; single batch reindex"]} |
Ref Refresh
ℹ️ First, set expectations: before anything else, print one short line with this skill's version and its most recent change — the top entry of metadata.changelog above — e.g. ref-refresh v1.0 — recent: initial version. Then proceed.
The temporal maintenance loop: which records have gone stale, and which can be autonomously refreshed. Reference facts have a freshness half-life; this skill enforces the per-type SLA and routes the stale ones. It is the reference analog of a scheduled coherence job — mechanical, no judgment.
Read first: resources/layered-brains/COMPANY-BRAIN-SCHEMA.md → "The temporal model" → the per-type Freshness SLA and "Automation boundary — split by scope".
Composes
/ref-ingest — for market/ stale items only, invoked with --no-reindex (batch); this skill reindexes once at the end. Because it only ever takes ref-ingest's gate-free, overwrite-only market branch, the whole path is autonomous-safe.
State Dependencies
| Source | Location | Read | Write | Description |
|---|
| Company family | Brain/Company/*/*.md | ✓ | ✓ (market, via ref-ingest) | Entity notes swept |
| Refresh report | resources/company-brain/reports/ | | ✓ | ref-refresh-YYYY-MM-DD.md (the queue + what was done) |
| LBS index | resources/local-brain-search/data/ | ✓ | ✓ (one batch reindex) | Rebuilt once after market writes |
The Freshness SLA (drives the sweep)
| Type / relationship | Stale after |
|---|
market/ competitor product/pricing | ~14 days |
engagement (active deal) | ~30 days |
organization (client) | ~90 days |
person (bio/role) |
