Fresh session each run. There is no ledger — the existing Linear issues in
{{linear_team}} are the running state to reconcile against.
Step 1 — Read the existing themes in Linear first
Before touching any source, pull the current state of {{linear_team}} so new
feedback is reconciled, not duplicated:
- List open issues in {{linear_team}}, with their title, description, and
current quote/count body.
- Note each issue's theme signature — the core request it represents — not
just its title text.
Step 2 — Gather support threads from Plain (read-only)
Pull recent threads (since the last run's approximate window, or the last
24–48h if that's unknown). For each thread, extract:
- The specific request or complaint, in the user's own words.
- A candidate quote — the clearest single sentence expressing it.
- Enough context (account, thread link) to trace it back later.
Ignore threads that are pure support (bug already fixed, question already
answered) with no underlying feature request or recurring complaint.
Step 3 — Gather public reviews (read-only)
Fetch the current reviews from {{review_sources}} (G2, app-store listings, or
whatever is configured). For each new review since the last visible one:
- Extract the specific ask or complaint, not star-rating alone.
- Take the reviewer's own phrase as the candidate quote.
- Skip pure praise with no actionable request, and skip reviews already
reflected in an existing Linear issue's quotes.
Step 4 — Gather messages from the feedback channel (read-only)
Read {{feedback_channel}} for messages where a team member is relaying
something they heard from a user (not internal chatter). Treat these the same
as a support thread: extract the request and a quote, with the relaying
message as the source.
Step 5 — Cluster into themes
Group everything gathered in Steps 2–4 into themes. Two mentions are the
same theme when they ask for the same underlying capability or fix, even
if:
- The wording is completely different ("can't bulk export" vs. "no way to
download everything at once").
- They come from different sources (a Plain thread and a G2 review can be the
same theme).
- One is more specific than the other (a general complaint and a precise
technical ask can still be the same root request — cluster on intent, not
surface detail).
Two mentions are different themes when they'd require different work to
resolve, even if they sound superficially similar (e.g. "slow page load" on
the dashboard vs. "slow page load" on export — different root cause, keep
separate unless you can confirm otherwise).
Step 6 — Pick the representative quote and title
For each theme:
- Quote — the clearest, most specific verbatim quote from any mention in
the theme. Prefer a quote that names the concrete capability over a vaguer
one.
- Title — a short, action-oriented issue title describing the requested
capability or fix, not the complaint's tone (e.g. "Bulk export for
workspace data", not "Users are annoyed about exporting").
Step 7 — Reconcile against Linear
For each theme from Step 5:
- Matches an existing issue (same theme signature from Step 1): add the
new quote(s) to its quote list, increment its mention count, and note the
new source(s). Don't create a duplicate.
- No match — create a new issue in {{linear_team}} with the title, an
opening set of quotes, a mention count, and the source(s) each quote came
from.
Every issue body should always show: representative quotes (a small curated
set, not every mention verbatim), a running mention count, and which sources
(Plain / reviews / Slack) contributed.
Step 8 — Stop
Report the set of Linear issues created or updated this run. Do not set
priority, assign an owner, or close any issue — even one that looks resolved
or clearly a duplicate of another; leave that judgment to a human.