Harvest sources
Collect what the vetted sources have published since the last sweep, and update the opinions from it.
"This repository" in this skill means awesome-humans/rust. Run the skill in a checkout, where each path in it, such as opinions/ or templates/Cargo.toml, is relative to the repository's root.
Orchestration
As AGENTS.md: Orchestration and model economy describes, fan the per-source sweeps in step 3 out to worker agents. Only the editor triages their findings and edits opinions/ and templates/.
Steps
- Load the roster from AWESOME-HUMANS.md. Only sources in the Citable table feed opinions. Use watch-list sources for discovery and cross-checking only: what you find there needs a citable source, or a
vet-sourceadmission, before it can change an opinion. - Set the sweep window, from the most recent harvest entry in the
AWESOME-HUMANS.mddecision log to today in UTC. If there's no harvest entry, start from the newestlast-revieweddate inopinions/. - Sweep each source for posts in the window. A source marked
**Discovery-only.**only leads to primary posts: follow its links, and never cite it insources:, because CI rejects it. - Triage each notable post:
- Changes an existing opinion: It replaces or refines guidance in
opinions/. Queue an edit. - Suggests a new opinion: It's a recurring theme with no home yet. Create a stub opinion with metadata, the source link, and a
TODO. In the same commit, add it toREADME.mdas a Scope bullet and a Repository layout entry, or CI fails the pull request. - Noise: Release chatter, marketing, or a one-off tip that doesn't generalise. Skip it.
- Changes an existing opinion: It replaces or refines guidance in
- Edit in a worktree on the branch
harvest/<YYYY-MM-DD>, dated the day the sweep window ends, as AGENTS.md describes:- Keep one recommendation per opinion. If a post contradicts the current opinion, choose the position with the stronger sources or evidence, and note the change in one line.
- Never remove, weaken, or unmark a house block or region (awesome-humans/website: House opinions). Update the sourced text beside it as usual. When a source now agrees with a house opinion, add the citation inside its block.
- Add the post's source ID to the opinion's
sources:, and updatelast-reviewed:. - Add a reference where it confirms a specific behaviour. When an edit says how a named crate or tool behaves, or when a feature shipped, link its own material beside the roster citation: its documentation, changelog, an issue, a test, or a line of source. A repository named under AWESOME-HUMANS.md: Named references qualifies too, such as an RFC or a stabilization pull request. Look only in the repositories that section names, not elsewhere in their organisations. Link an RFC or a RustSec advisory by the published page that section gives. Let the admission criteria decide what qualifies. Read it first, and link it only if it says what the claim says. It never goes in
sources:, and never replaces the roster citation. Pin a link to a line of code to a commit. - Check a contradiction against the crate's own material. When a post contradicts an opinion about how something behaves, read the crate's documentation, tests, or source before you choose. If they settle it, correct the opinion, cite a roster source that agrees, and link the evidence in the pull request.
- Record the sweep in the
AWESOME-HUMANS.mddecision log: the date, the window, and what changed, as briefly as the existing entries. Per-source findings go in the pull request, not the table. - Open a pull request to the default branch, filling in the
opinion.mdtemplate, as AGENTS.md describes. Its Skill run section takes the findings per source, and the proposed opinion takes the changes per opinion. A person reviews it before it changes any opinion.- If an open
Harvest due: <Month> <Year>issue asked for this sweep, end the pull request description with aCloses: #<number>trailer. - The
Harvest reminderworkflow opens that issue on the 1st of each month, and skips the month while an issue with that title is open. An issue left open blocks the next reminder. - If another pull request replaces this one, copy the
Closes:trailer to it. The reference doesn't carry over.
- If an open
Edge cases
- Vetted sources disagree: Present both positions in the pull request, and choose one for the opinion, with the reason. Never leave a menu in the opinion.
- A source has gone quiet, or its quality has dropped: Note it in the pull request, and propose demotion through
vet-source. Don't edit the roster directly. - Nightly-only content: It can go in a "Coming next" note, never in the opinion itself.
- A linked issue has closed: If an opinion links a tracking issue or pull request as unstable or as an open limitation, and it has closed, update or drop the note in the same sweep. If the feature has shipped in a stable Rust release, leave it to
refresh-rust-versions.audit-freshnessfinds both kinds, and names the skill for each. - Nothing notable found: Record the sweep in the decision log anyway, on the default branch or in a small pull request, so the next window starts from the right date. Close the reminder issue either way, or next month's reminder doesn't open.