HN Showcase
Back to browse
GitHub Repository

Organizing and structuring software through patterns, decisions, and verified design rules

815 stars

Software Design – ADRs, arch tests, patterns

by qdenka·Feb 13, 2026·4 points·0 comments
Visit ProjectView on HN

AI Analysis

●MidNiche GemRabbit Hole
The Take

The repo shines by focusing on the rarely-curated, code-level side of architecture: 14 real ADR examples (Kubernetes KEPs, Rust RFCs, Spotify/Flutter docs) and a neat shortlist of architecture-verification tools (ArchUnit, Arkitect, Konsist, arch-go). It's a pragmatic, opinionated filter of 106 resources that will save time for teams hunting implementable patterns, but it remains a static list — no ranking, tagging, or runnable examples to speed adoption.

Category
Design
Target Audience

Software architects, senior/backend developers, engineering leads interested in design practices and enforceable architecture rules

Post Description

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.

Similar Projects

Developer Tools●Mid

List of Design Md Files

Curated design system docs for AI agents, but it's just markdown files with a pull command.

Ship It
elwingo1
101mo ago