Trend / Best-Practices Poller — spec (for task #106)
Marita's requirements (2026-05-26). Build on the Optiplex (deterministic-first, free, always-on). Feeds the per-editor glossary (#105), the playbooks, and LEARNINGS. Surfaces "emulate this" recommendations inside the editors.
Sources to poll
Reddit (tips, tricks, suggestions)
- MUST route through the gaming desktop residential IP (the VPS/Optiplex get 403 from Reddit — see
reference_gaming_desktop_reddit_fetch). Reuse the job-scraper residential pattern. - Subreddits: r/emailmarketing, r/marketing, r/socialmedia, r/PPC, r/digital_marketing, r/web_design, r/graphic_design, r/motiongraphics, r/Frontend, r/css, r/web_design, r/Entrepreneur (filtered). Pull top/hot + high-engagement comments.
LinkedIn + Instagram (what's working socially)
- HONEST CONSTRAINT: neither has a public content-search/trend API. LinkedIn content API scopes were not granted; IG Graph only exposes owned/business accounts, not general trend search. So trend-polling these = scraping via the logged-in Chrome profiles on the gaming desktop (same approach as the job scrapers), which is fragile + ban-prone. Scope conservatively (own feed + a small watchlist of accounts/hashtags), gentle rate limits, and flag if blocked. Do not over-promise broad LinkedIn/IG trend coverage.
Coding sites / repositories (what's trending technically)
- Free, no-ban sources (preferred): GitHub Trending (daily/weekly, topics: email, html-email, motion, animation, gsap, remotion, design-systems), Hacker News (Algolia API), dev.to (API, tags: webdev, css, design, marketing), CodePen trending/picks (CSS/animation/effects), Product Hunt (design/marketing tools), npm trends for relevant libs, Awesome- lists*. Awwwards / Dribbble are scrape-limited — best-effort, flag if blocked.
- Map findings to disciplines: email (plain-text vs HTML vs design-first), social media, ads, plus effects / motion graphics.
Output / cadence
- Per-discipline trend digest written to
Playbooks/KnowledgeBase/*+ the per-editor glossary (#105), with "what's working + emulate this" notes (prefer items backed by real engagement/metrics). - At least 4 new effects / motion-graphics / use-cases / combinations PER MONTH — a monthly synthesis step that turns the polled trends into >=4 concrete new recipes added to
effects_matrix.mdAND wired into the editors (image/video/banner/etc.), each with a short how-to + example. This is a hard cadence requirement. - Recommendations surfaced inside editors (via the chat dock #104) as suggestions Marita can accept.
Architecture notes
- Deterministic ingestion + dedup + scoring; LLM only to distill/summarize trends and draft the new effect recipes (Sonnet tier).
- Reddit + LinkedIn + IG via gaming desktop; coding/free APIs from the Optiplex directly.
- Append every validated trend-to-recipe to
LEARNINGS.md(Tried / Result / Reuse). - Respect
feedback_no_driftbymar_in_client_systemsand never test-post to shared systems.