refresh-research

<scope_args>$ARGUMENTS</scope_args>

Refresh Research

Orchestrate parallel research-curator agents to bulk-refresh research entries in ./research/. Detects staleness, skips fresh entries, updates only what qualifies. Safe to run repeatedly.

Arguments

<scope_args/> controls scope:

• --all — Refresh every entry regardless of staleness
• --stale (default) — Refresh entries past their review date
• --category <name> — Refresh all entries in one category (e.g., --category agent-frameworks)
• --layer <0|1|2> — Refresh entries with matching SDLC layer metadata (0=process, 1=language, 2=stack). See plugins/development-harness/docs/sdlc-layers/.
• --dry-run — Report what would be refreshed; do not spawn agents

Workflow

Step 1: Inventory and Staleness Detection

Glob ./research/**/*.md (exclude README.md). For each entry, parse:

1. YAML frontmatter — extract metadata.layer value (string "0", "1", or "2"; null if absent).
2. Freshness Tracking section — extract Last Verified and Next Review dates.

flowchart TD
    Start([Read entry]) --> ParseFM[Parse YAML frontmatter<br>Extract metadata.layer]
    ParseFM --> HasFreshness{Freshness Tracking section present?}
    HasFreshness -->|No| Stale1[STALE: no tracking]
    HasFreshness -->|Yes| ComputeDays[Compute Days Old = today minus Last Verified]
    ComputeDays --> PastDue{Next Review Recommended < today?}
    PastDue -->|Yes| Stale2[STALE: past review date]
    PastDue -->|No| TooOld{Last Verified > 6 months ago?}
    TooOld -->|Yes| Stale3[STALE: too old]
    TooOld -->|No| Fresh[FRESH: N days until next review]

Build inventory table: | File | Category | Layer | Last Verified | Next Review | Days Old | Stale? |

The Days Old column holds an integer: today's date minus the Last Verified date in days. If Last Verified is absent or unparseable, render as —.

The Layer column holds the metadata.layer value or — if absent.