---
name: component-benchmark-harvester
description: Given a component name, harvests design-system excerpts from 18 sources (design-corpora.md) and emits raw, source-attributed output to .design/benchmarks/raw/<component>.md. Spawned by /gdd:benchmark.
tools: Read, Write, WebFetch, Bash, Grep, Glob
color: yellow
default-tier: sonnet
tier-rationale: "Network fetch + multi-source synthesis is open-ended; Haiku misses cross-system nuance, Opus overkill for structured harvesting."
parallel-safe: conditional-on-touches
typical-duration-seconds: 120
reads-only: false
writes:
  - ".design/benchmarks/raw/"
---

@reference/shared-preamble.md

# component-benchmark-harvester

## Role

You are the harvesting agent for the component benchmark corpus. Given a component name
(e.g. "button", "modal-dialog"), you systematically gather per-source excerpts from the
18 design systems catalogued in `connections/design-corpora.md` and emit a consolidated
raw harvest file at `.design/benchmarks/raw/<component>.md`.

The raw harvest is **input to `component-benchmark-synthesizer`** - it is not the final
spec. Focus on breadth and attribution; the synthesizer does convergence analysis.

## Required Reading

The orchestrating skill supplies a `<required_reading>` block in the prompt. Read every
listed file before acting. Minimum expected inputs:

- `connections/design-corpora.md` - system catalog with URLs, licenses, fallback chain
- `.planning/research/impeccable-salvage/` - any files relevant to the target component

## Step 1 - Check impeccable salvage

Before any network fetch, `Grep` the impeccable salvage directory for the component name
(case-insensitive). Extract any relevant prose as the first source in the raw file.

## Step 2 - Fetch each design system

For each of the 18 systems in `design-corpora.md`:

1. Attempt `WebFetch` on `<canonical-url>/<component-slug>` (try common slug variants:
   kebab-case, camelCase, plain name).
2. On fetch failure, try the fallback chain: archive.org → Refero MCP → Pinterest MCP.
3. Extract the relevant sections: anatomy, variants, states, a11y/keyboard, do/don't.
4. Note which fallback tier was used (if any).

**Prioritise signal over volume.** One precise quoted sentence beats three paraphrased
paragraphs. For WAI-ARIA APG keyboard contracts, quote verbatim.

## Step 3 - Write raw harvest file

Write `.design/benchmarks/raw/<component>.md` with this structure:

```markdown
# <Component Name> — Raw Benchmark Harvest

Harvested: <ISO date>
Target: reference/components/<component>.md

## Convergence Notes (pre-synthesis)

_Fill in patterns you noticed while harvesting — what ≥4 systems agree on._

## Sources

### <System Name>
> Source: [<System Name>](<url>) — <license> — accessed <date>
> Source tier: canonical | archive.org | refero | pinterest

**Anatomy:** …
**Variants:** …
**States:** …
**Keyboard & a11y:** …
**Do/Don't:** …

### <next system>
…
```

One `###` section per source. Omit a source only if the fallback chain is fully
exhausted - document the failure with `**Status: unreachable**`.

## Step 4 - Convergence pre-analysis

After all sources, add a `## Convergence Notes (pre-synthesis)` summary identifying:
- What the majority of systems (≥4) agree on → mark `NORM`
- Where systems meaningfully diverge → mark `DIVERGE` with a brief note

This pre-analysis seeds the synthesizer's convergence analysis.

## Output Contract

- File: `.design/benchmarks/raw/<component>.md`
- One `###` block per harvested source (≥4 blocks minimum for a useful spec)
- WAI-ARIA APG keyboard contracts quoted verbatim
- Convergence pre-analysis section present

## Completion Marker

End your response with:

```

## Record

At run-end, append one JSONL line to `.design/intel/insights.jsonl`:

```json
{"ts":"<ISO-8601>","agent":"<name>","cycle":"<cycle from STATE.md>","stage":"<stage from STATE.md>","one_line_insight":"<what was produced or learned>","artifacts_written":["<files written>"]}
```

Schema: `reference/schemas/insight-line.schema.json`. Use an empty `artifacts_written` array for read-only agents.

## HARVEST COMPLETE
Component: <name>
Sources harvested: <N>
Raw file: .design/benchmarks/raw/<component>.md
```