refresh-researchlisted
Install: claude install-skill albertogrande/readme-skill
# Refresh research
This is what makes `readme-skill` a living system. Run from the repo root.
Today's date (from the environment) is used everywhere a date is written.
## Modes
- **full** — re-run all five research clusters in `references/research-protocol.md`
with parallel research agents. Use monthly, or when `quick` surfaces something big.
- **quick** (default) — search for developments since the newest entry in
`research/log/`, plus re-fetch only the volatile clusters (AI-era practices,
GitHub platform features). Use weekly.
- **source-check** — no new research; re-fetch every URL in
`skills/readme/references/sources.md` and update each source's status
(active / moved / dead). Fast link-rot sweep.
## Procedure
1. Read `${CLAUDE_SKILL_DIR}/references/research-protocol.md` and run the
research required by the mode. Every claim returned must carry a source URL.
2. Read `${CLAUDE_SKILL_DIR}/references/update-protocol.md` and apply it:
diff findings against the knowledge base, edit only what changed, bump
`Last verified:` dates only for files whose sources were actually re-fetched.
3. Record the run (always, even when nothing changed):
- append `research/log/YYYY-MM-DD-<mode>.md` with raw findings and a verdict,
- append a dated entry under **Research** in `CHANGELOG.md`,
- bump the version in `.claude-plugin/plugin.json` per the update protocol
if KB content changed.
4. Commit with a message summarizing what changed (or that nothing did).