Back to browse
I built a reference site for the recurring hard problems in software

I built a reference site for the recurring hard problems in software

by ludovicianul·Apr 27, 2026·9 points·3 comments

AI Analysis

●●●BangerDark HorseSolve My ProblemCrowd Pleaser

151 interconnected failure patterns with AI-era distortions already included.

Strengths
  • Cross-linked entries show how red flags precede failure modes and force decisions
  • Includes AI-specific patterns like Autocomplete Architecture nobody consciously made
  • Structured for actual use in retros, reviews, and team decision discussions
Weaknesses
  • Content maintenance burden to keep 151 entries current as patterns evolve
  • No submission mechanism for community-contributed patterns or corrections
Category
Target Audience

Software engineers, engineering managers, teams conducting retrospectives

Similar To

Refactoring Guru · Software Engineering Body of Knowledge

Post Description

Hi HN, I've been working on this for a while and it was hard to decide when to stop, either on the way information is presented or when to stop with adding entries. It's not meant as a blog, but rather as a reference that keeps growing.

Link: https://thehardparts.dev

Currently I've created 4 main section:

- Failure Modes: ways project go wrong - Red Flags: early signals that are worth taking seriously - Tech Decisions: common and not so common trade-offs for hard choices - Playbooks - guided approach for situations that repeat

I've also focused on creating links between them to show how connected many things are: a red flag usually precedes a failure mode, which might connect to a forced decision, etc.

Some entry points to give you an idea:

- The Invisible Deadline: a date that exists socially but not explicitly enough to manage honestly - Eveyone Asks The Same Person: when one person becomes the default source of truth - Build a Practical Rollback Strategy: how to build a reliable rollback strategy

It has 151 entries across the 4 sections.

Curious what you think about the content, format, grouping.

Similar Projects

Developer Tools●●Solid

Promo-kit – Receipt-backed promotion engine for tool catalogs

Receipt-backed promotion decisions with SHA-256 hashes and commit linkage is a practical, low-ceremony way to make spotlight selections auditable. The zero-dependency CLI, freeze modes and drift reports show this was designed for governance-first catalogs rather than casual lists — useful and sensible, but narrowly aimed.

Niche GemShip It
mikeyfrilot
124mo ago
AI/ML●●Solid

STAR prompting fixes Car Wash Problem on Sonnet 4.5 (0%->85%)

They ran a variable-isolation study across five prompt layers with 20 runs per condition and shipped experiment.py and results so you can reproduce which layer actually supplies the missing implicit fact. It’s a focused, practical read for anyone designing layered system prompts, but it feels niche and would be more persuasive with cross-model baselines and clearer statistical reporting.

Big BrainNiche Gem
midmost44
204mo ago
AI/ML●●Solid

An adversarial reasoning engine for scientific progress

Catches LLMs cheating on evals with a 9-pattern catalog nobody else documents.

Big BrainNiche Gem
Sparckix
2015d ago