Back to browse
GitHub Repository

Documentation hub for my SRA software architecture

6 stars

SRA – A new architectural pattern for modern product engineering

by FelixZY·Mar 7, 2026·5 points·1 comment

AI Analysis

MidBig Brain

Well-reasoned three-tier architecture, but lacks reference implementations and adoption proof.

Strengths
  • Thoughtfully critiques real pain points in DDD/hexagonal (coupling, UI bias, cross-platform brittleness).
  • Clear separation of concerns: Specification→Realization→Assembly flow prevents circular dependencies.
  • Compilation-enforced guardrails reduce discipline-dependent mistakes.
Weaknesses
  • Pure documentation with zero reference code; unclear how it survives contact with real projects.
  • No examples in multiple languages, frameworks, or domains—claims universality without proof.
  • Unproven adoption; single-author framework against entrenched patterns (Clean Arch, DDD, hexagonal).
Target Audience

Generalist engineers building multi-platform applications; teams evaluating architectural frameworks.

Similar To

Clean Architecture · Domain-Driven Design · Hexagonal Architecture

Post Description

I have spent years trying to understand and follow established software architectures - and wound up writing my own at the end: SRA (Specification - Realization - Assembly). Please do check it out and let me know what you think!

Background:

Whenever I would learn a new architecture, the initial ideas seemed interesting but the implementation almost always ended up with my autistic sense of detail screaming loudly about one or more shortcomings and even inconsistencies.

For example, a lot of architectures rely on human discipline, give certain aspects of the software - such as the UI - an unproportional amount of power, or promote coupling despite claiming otherwise.

As a programming generalist, I also found certain architectures hard to transfer between platforms and project types, especially in multiplatform code bases.

In the end I started from the basics; What is good code? What principles are common regardless of language? How can we make good code easier to write than bad code? What makes code adaptable to evolving technology and changing requirements?

The result: SRA. Enjoy!

Similar Projects

DesignMid

Software Design – ADRs, arch tests, patterns

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.

Niche GemRabbit Hole
qdenka
404mo ago
AI/ML●●Solid

I Stopped Writing Code – The 60/40 Rule for AI-Native Engineering

This is an architecture-first manifesto that treats diagrams and schemas as the true source of code and then uses LLMs to align implementations. The author backs the theory with a concrete solo-built stack (Cloudflare Workers edge, Fly.io core, LLM agents and a large AI-maintained MDX knowledge base), which makes the 60/40 rule feel actionable. Good as a strategic playbook; it needs more reusable infra templates or scripts to move from clever idea to something you'd copy into a new project.

Big BrainNiche Gem
madawei2699
203mo ago