CLAUDE.md - Hacker News Story Selection Guidelines

Overview

This document specifies how to select Hacker News stories for the OHGOD Philosophy website’s problem cards. Each problem card has a flip animation that reveals 4 HN stories on the back.

Requirements for HN Stories

Minimum Engagement

Story Selection Criteria

  1. First Story Must Support the Stat
    • The statistic shown on the front of the card must be directly mentioned or supported by the first story
    • Example: If stat is “$100M+”, the first story should discuss GPT-4 training costs of $100M
  2. Variety of Sources
    • Avoid multiple stories about the same company incident (e.g., don’t use 3 Samsung stories)
    • Mix different angles: research papers, news, lawsuits, Ask HN discussions
  3. Landmark/Viral Stories Preferred
    • Major product announcements (GPT-4, GPT-4o, Mamba)
    • Viral incidents (Samsung data leak)
    • Major lawsuits (NY Times vs OpenAI)
    • Research papers that went viral
  4. Recency
    • Prefer stories from 2023-2025
    • Older stories acceptable if they’re landmark discussions

How to Find High-Engagement Stories

Search Strategy

site:news.ycombinator.com [topic] [year]

Verify Comment Count

Popular Story Indicators

Current Problem Cards and Their Stories (Updated Dec 2024)

Problem 1: Power Concentrated ($10B)

Problem 2: Planet Can’t Afford (900k tons CO₂)

Problem 3: Data Isn’t Yours (20M+ conversations)

Problem 4: Nobody Knows Inside (0%)

Problem 5: Illusion of Intelligence (covers sycophancy + hallucination + memorization)

Problem 6: Architecture Barely Changes (8 yrs)

Story Format in HTML

story1_url="https://news.ycombinator.com/item?id=XXXXXXXX"
story1_title="Title (max ~50 chars)"
story1_summary="One-line summary (max ~50 chars)"

Updating Stories

When updating stories:

  1. Search for high-engagement HN discussions on the topic
  2. Verify 100+ comments
  3. Ensure first story supports the card’s statistic
  4. Maintain variety across the 4 stories
  5. Keep titles and summaries concise for card display

Git Commit Rules (MANDATORY)

  1. NEVER add “Co-Authored-By:” lines to commits
  2. NEVER add “🤖 Generated with [Claude Code]” to commits
  3. Keep commit messages simple and descriptive
  4. Just describe what changed - no AI attribution footer