Show HN: Software Design – ADRs, arch tests, patterns

4 points

4 months ago

I kept collecting software design bookmarks for years — repos, articles, books — but never organized them. Most "awesome" lists for architecture cover the "monolith vs microservices" debate. I wanted something focused on the code-level side: how to actually structure modules, enforce design rules in CI, and document decisions. I went through ~300 resources and kept 106 across 9 categories. A few sections I haven't seen elsewhere:

Architecture Decision Records — 14 real-world examples (Kubernetes KEPs, Rust RFCs, Spotify's practice, Flutter design docs)

Design Verification — tools that enforce architecture rules as tests: ArchUnit (Java), Arkitect (PHP), Konsist (Kotlin), arch-go

Real-World Architecture — case studies from Discord, Shopify, Figma, Stripe, not just theory

I also wrote a longer breakdown of what I filtered out and why: https://dev.to/qdenka/i-curated-106-software-design-resource... Feedback and PRs welcome.