How It Works

The Challenge

Hacker News discussions aren't simple comment lists — they're deeply nested, branching conversations where context matters. A reply five levels deep might reference something from the original post, and the most insightful comment might be buried in a side thread. Traditional summarization tools miss these nuances entirely.

Thread-Aware Representation

HN Companion preserves the hierarchical structure of conversations using a path-based notation. Each comment maintains its relationship to parents and siblings, so the AI understands not just what was said, but where in the conversation it fits.

[1] alice: First reply to the post
[1.1] bob: Reply to alice's comment
[1.1.1] charlie: Going deeper into this thread
[1.2] david: Another reply to alice
[2] eve: Second top-level comment

This structure lets the AI track conversation branches, identify sub-discussions, and understand which comments are direct responses vs. new threads.

What We Capture

Our summarization is designed specifically for technical discussions. The AI is prompted to:

• Identify main topics — Extract the key themes and arguments being discussed
• Capture diverse viewpoints — Surface different perspectives and notable opinions, not just the most upvoted takes
• Track conversation shifts — Note where discussions pivot to new topics or important tangents emerge
• Include relevant quotes — Pull brief, impactful quotes with references back to the original comments
• Maintain objectivity — Present information neutrally without editorializing

Smart Prioritization

Not all branches are equal. Before summarization, comments are sorted by relevance and engagement, with the most active conversation branches weighted higher. This means the AI focuses on what the community found most interesting, while still capturing valuable insights from quieter threads.

Adaptive Summaries

Summary length scales with thread complexity. A quick 20-comment discussion gets a brief overview, while a sprawling 500-comment debate receives a more comprehensive breakdown. The goal is always to give you just enough context to decide what's worth reading in full.

The Result

Instead of generic bullet points, you get summaries that actually reflect how HN discussions work:

• Context preserved — replies make sense without reading parents
• Side discussions surfaced — valuable tangents don't get lost
• Debate captured — disagreements and different viewpoints included
• Actionable — jump directly to interesting comments from the summary