Discourse

Discourse Search

When To Use

• Gathering community opinions on a technology or approach
• Finding experience reports from HN, Reddit, or Lobsters

When NOT To Use

• Academic research (use /tome:papers)
• Code examples (use /tome:code-search)

Scan community channels for discussions on a topic.

Channels

• Hacker News: Algolia API at hn.algolia.com
• Lobsters: WebSearch with site:lobste.rs
• Reddit: JSON API (append .json to URLs)
• Tech blogs: WebSearch targeting curated domains

Workflow

• Build search URLs/queries per channel using

tome.channels.discourse.* functions

• Execute via WebFetch (APIs) or WebSearch (fallback)
• Parse responses into Finding objects
• Merge across sources with source attribution

Exit Criteria

• [ ] At least two community channels (HN, Lobsters, Reddit, or

tech blogs) queried per invocation

• [ ] HN results fetched via Algolia API at hn.algolia.com

(WebFetch); WebSearch used as fallback if the API is

unreachable

• [ ] Each Finding object includes a source field identifying

which channel (HN, Lobsters, Reddit, or blog) it came from

• [ ] If all WebFetch and WebSearch calls fail for every channel,

the failure is reported explicitly rather than returning

fabricated or empty findings