The author reveals how elite programmers like nginx creator Igor Sysoev develop mastery through deliberate practice, learning from top engineers, contributing to open source, and tackling difficult valuable problems, noting that supporting diverse systems forces better design while modularity can hinder evolution.
Igor Sysoevcross-domain knowledgedeliberate practice
This article recounts the design decisions made during a chat assistant refactoring, covering naming consistency, UI component conventions, minimal abstraction boundaries, decoupling output language from UI language, and package structure organization, emphasizing that good refactoring is a series of well-reasoned trade-offs documented with clear rationales.
The article argues that software performance is primarily determined by architectural design rather than programming language speed, because most applications are I/O-bound and slow languages already delegate CPU-intensive work to optimized libraries; real speedups come from redesigning algorithms, caching, and query optimization, not from rewriting in faster languages like Rust.
A developer advocating simplicity builds a mood-tracking mini-program but gradually adds photos, location, weather, travel logs, and anniversaries, illustrating how personal needs drive feature creep and the difficulty of product restraint.
KISS principleWeChat Mini-Programdeveloper experience
The article explores naming as a fundamental abstraction mechanism in programming, drawing on SICP to show how naming enables modularity, controls complexity, creates vocabularies, and underpins environments, scope, and first-class functions, arguing naming is not mere labeling but a cognitive tool for building higher-level concepts.
Matt Pocock identifies six failure modes in AI-assisted programming — misaligned intent, verbose but unclear output, unrunnable code, shallow module proliferation, cognitive overload, and disinvestment in system design — and prescribes strategic remedies like Grill Me questioning, ubiquitous language glossaries, TDD feedback loops, deep module design, interface-first delegation, and daily design investment to keep AI as a tactical executor under human strategic command.
The article argues that truly good code is measured by how rarely developers need to revisit and modify it, emphasizing design and programming techniques that make systems resilient to exceptions and adaptable to business changes without frequent code changes.
The article walks through a real e‑commerce payment case, showing how Domain‑Driven Design models entities, uses two key questions to split responsibilities, and continuously evolves the model to accommodate discounts, VIP features, and new payment adapters, reducing code churn.
The article proposes a three‑step approach—study best‑practice designs, evaluate them against your specific context, and select the most suitable solution—illustrated with a comparison of using a message queue versus Spring’s event system for simple order‑notification needs.
The article analyzes nine pitfalls encountered while building a CLI tool for AI, derives a core principle of separating deterministic execution from ambiguous judgment, and presents concrete design rules, a skill‑packaging approach, and two real‑world case studies that illustrate the solution.
The article surveys classic definitions of software complexity from Ousterhout, Simon, Mitchell, Gall, Taleb, Tesler, Gurley, and Wolfram, then proposes three dimensions—structure, behavior, and evolution—for analyzing complex software systems.
This article walks through the evolution from direct object instantiation to Simple Factory and finally to the Factory Method pattern, explaining why scattering new statements is problematic, how Simple Factory centralizes creation but still violates the Open/Closed principle, and how the Factory Method delegates the decision to specialized factories, complete with code examples, role definitions, and guidance on when to apply each approach.
The article explains that beyond a rich ecosystem and job market, Java's enduring popularity stems from its core design principle of abstraction—embodied in bytecode—that isolates software from underlying hardware and platform changes.
The article compares traditional imperative sequencing of function calls with declarative workflow orchestration using state machines, highlighting how the latter separates business logic into data-driven transition tables to improve flexibility, observability, and error recovery in complex, mutable backend systems.
Although AI coding tools let Java developers generate DTOs, interfaces, tests and business logic faster, the resulting speed boost often leaves them uneasy because the reasoning and design decisions that used to be embedded in handwritten code disappear, leading to deeper doubts during review and deployment.
The article argues that excellent software design requires anticipating non‑functional issues—such as sudden database load, traffic spikes, or third‑party timeouts—by implementing retries, degradation, monitoring, and boundary checks early in the design phase, and by isolating core modules, exemplified by a micro‑service per payment channel architecture.
This article provides a comprehensive, step‑by‑step overview of system architecture design, covering definitions, quality attributes, architectural styles, design processes, decision‑making, validation methods, documentation practices, and core principles for building complex software systems.
architectural stylesarchitecture decision recorddesign process
This article distills the core concepts of Robert C. Martin’s Clean Architecture, covering layered design, SOLID principles, component cohesion and coupling rules, boundary strategies, the onion model, and why databases are merely infrastructure, all illustrated with concrete code examples and diagrams.
After years of writing code, the author shares three disciplined habits—anticipating non‑functional scenarios, structuring code to reflect business flow, and adopting spec‑driven development—to improve code quality and resilience in production systems.
The article explains how a system architect resolves conflicting stakeholder demands—such as simplicity for patients, strict security, rapid delivery, low cost, and high reliability—by translating them into documented, reviewable, implementable and evolvable architecture decisions and by continuously balancing business goals, quality attributes, technical constraints and cost.
The article argues that mastering Spec‑Driven Development, especially when collaborating with AI, solves most programming problems, improves code‑generation accuracy, and makes the overall development workflow smoother than chasing countless AI‑generated code tweaks.
This article explains why Architecture Decision Records (ADRs) are essential, defines them as a “black box” for recording decisions, outlines their value, formats, lifecycle, creation process, management tools, and provides concrete ADR examples such as using JWT for authentication and Kafka for messaging.
This article explains the meaning of each UML line style—solid, dashed, hollow triangle, hollow diamond, and solid diamond—covers class‑diagram relationships, use‑case include/extend, activity vs. state diagrams, component vs. deployment diagrams, and provides exam‑style practice questions with concrete examples.
This article explains why learning UML should begin with clarifying the system aspect you want to convey, outlines the five core activities of requirement engineering, and details the purpose and typical use cases of the seven most common UML diagram types with concrete e‑commerce examples.
This article explains what an architecture review is, outlines its types and value, details the preparation of documents and participants, provides a step‑by‑step review agenda—including opening, solution presentation, Q&A, and summary—offers tactics for handling challenges, supplies template materials, and defines acceptance criteria for a successful review.
The article explains why the guideline “favor composition over inheritance” is useful but not absolute, illustrates a fixed‑workflow scenario where inheritance simplifies implementation, and provides concrete code examples and decision criteria for choosing between the two approaches.
The article explains how a scenario view—acting as the dynamic "+1" in the 4+1 model—uses use‑case‑plus‑context scenarios to validate architecture, improve communication, guide testing, prioritize key business flows, and drive development through BDD and test case generation.
The article examines the drawbacks of deep if…else chains in Java business logic and introduces Easy Rules, a lightweight, annotation‑based rule engine that separates rules from code, improves readability, maintainability, testability, and supports multiple definition styles.
The article explains why adding a method directly to an existing Java interface can break all classes that already implement it and demonstrates the correct approach of creating a new interface that extends the original, preserving compatibility.
The article examines Bruce Eckel’s perspective on functions, tracing their origins from early assembly language to modern high‑level languages, highlighting practical motivations such as code reuse, debugging efficiency, and meaning‑driven design, while contrasting historical structured programming with contemporary polymorphic concepts.
The article examines how software architecture has progressed from the traditional DDD four‑layer structure through Hexagonal, Onion, and Clean architectures, explaining essential versus accidental complexity, layering principles, dependency inversion, and how each pattern refines modularity, testability, and dependency direction.
The article demonstrates how encapsulating each step of an order‑submission process into well‑named methods makes the core business flow instantly visible, lowers modification errors, and illustrates a coding habit of keeping all methods at the same abstraction level.
The author reflects on the rarity of encountering a truly skilled programmer and explains how such a colleague’s disciplined habits, thoughtful design choices, and thorough exception handling can dramatically improve code quality and accelerate a developer’s professional growth.
The article analyzes how the unchecked addition of configuration flags inflates code complexity, creates combinatorial testing burdens, and hides design flaws, while offering practical guidelines and community perspectives on managing flag debt responsibly.
The article explains that layered architecture is not just a formalism for code organization but a fundamental safeguard that isolates responsibilities, changes, and replacements, preventing large systems from collapsing and enabling maintainable, scalable development.
After three years of drawing architecture diagrams, the author realized that a single diagram cannot convey a whole system; instead, a set of purpose‑specific diagrams—business, application, system, technical, data, and deployment—must be used, each tailored to its audience and clarified with the C4 modeling approach.
The article argues that code cleanliness—careful naming, clear responsibilities, consistent abstraction levels, and purposeful design patterns—boosts maintainability and delivery efficiency, while warning against over‑formatting, premature abstraction, and needless refactoring of legacy code.
The article explains that Clean Architecture’s true essence lies in the immutable Dependency Rule—dependencies must always point inward—while the four‑layer diagram is merely a flexible skeleton, and it clarifies common misconceptions, ties to SOLID, and shows how to apply the rule across Hexagonal and Onion variants.
The article argues that merely knowing popular coding principles is insufficient, and it provides concrete decision frameworks, code examples, and trade‑off analyses for DRY, KISS, YAGNI, POLA, the Boy Scout Rule, Fail‑Fast, and Separation of Concerns so developers can choose when to abstract, simplify, defer implementation, ensure expected behavior, improve incrementally, expose errors early, and isolate change boundaries.
This article explains that architecture and design form a continuous spectrum distinguished by three dimensions—significance of trade-offs, investment level, and strategic vs tactical scope—helping engineers clarify decision impact and make wiser technical choices.
Martin Fowlerevent-driven architecturemicroservices
The reviewer argues that software design is fundamentally conceptual modeling, where naming concepts constitutes abstraction—a highly difficult process—and praises the book 'Semantic Software Design' for focusing on this core challenge.
The article explains how the pi agent’s extension system resolves the tension between core stability and capability extensibility by using inversion of control, dependency injection, adapter and event‑driven patterns, two‑phase initialization, and concrete Python implementations, while comparing it with other plugin architectures.
The article presents a Claude AI Skill that automatically creates detailed, color‑coded architecture diagrams as standalone HTML files, explains its design system, shows installation options via manual zip or Skills Hub, and demonstrates fast generation and iterative editing through simple prompts.
AI‑generated diagramsArchitecture DiagramClaude AI
The article explains why traditional diagram‑as‑code approaches fall short for AI agents, introduces Architecture as Code as a structured, version‑controlled alternative, discusses the role of interface contracts and narrative documentation, and outlines the need for deterministic context engineering to make design documents truly live for both humans and machines.
The article explains how the Composed Method Pattern (CMP) and the Single Level of Abstraction Principle (SLAP) can keep AI‑generated code readable, maintainable, and team‑friendly by structuring entry methods as narratives and ensuring each method stays at a single abstraction level.
This article examines the emerging "Harness Architecture" idea, arguing that constraints should be applied before AI code generation by leveraging stepwise refinement, modular contracts, and living design documents to improve precision, reduce token usage, and prevent architectural drift in large software projects.
AI EngineeringHarness ArchitectureStepwise Refinement
The article explains how an artifact layer—comprising specs, guidance files, skills, tests, and logs—preserves intent across AI agent sessions, enabling reliable, secure, and maintainable agent‑driven software development through spec‑first practices, bounded loops, and robust verification stacks.
The article explains how excessive, fake, or chaotic encapsulation creates hidden risks, reduces maintainability, and hampers extensibility, then provides concrete refactoring examples and practical principles to achieve clean, purposeful encapsulation in backend code.
A bloated utils.py quickly becomes a maintenance nightmare because it mixes unrelated logic, hides business rules, and creates tight coupling, but by reorganizing functions into domain‑specific modules, class methods, or tiny generic utility packages you can restore clarity, testability, and scalability.
Developers transitioning from Java or C# to Go or Rust often miss class inheritance, but both languages deliberately avoid it; this article explains the pitfalls of inheritance, the benefits of composition, interfaces, and traits, and offers practical guidance for designing maintainable, concurrent systems without inheritance.
This article explores software engineering as a progression of abstraction levels — from functions and classes to libraries, platforms, and AI-driven design primitives — arguing that each leap releases productivity by encoding structural 'genes' that enable building more complex systems.
AI in software engineeringabstraction levelscode genes
The article explains that a system architect functions like a film’s chief director—interpreting requirements, designing the overall structure, coordinating teams, ensuring delivery, and continuously improving the system—while highlighting common misconceptions, core responsibilities, required abilities, and exam‑focused pitfalls.
The article explains why high‑quality Javadoc is essential for enterprise‑level Java backend projects, walks through the most common Javadoc tags and HTML elements, provides concrete code examples—including @param, @return, @throws, @see, @deprecated—and shows how thorough comments improve readability, maintainability, and serve as a catalyst for refactoring.
The article examines software engineering's fundamental complexity laws, large language model limitations including context constraints and hallucination, Rice's Theorem implications, and questions the boundaries of AI agents in solving real software problems despite improved memory, tools, and context organization.
The article analyzes three harmful forms of improper encapsulation—over‑encapsulation, fake encapsulation, and chaotic encapsulation—illustrates each with Java code examples, explains the resulting development inefficiencies, extensibility issues, and debugging difficulties, and offers concrete principles to avoid these pitfalls.
The article analyzes three common forms of bad encapsulation in Java—over‑encapsulation, false encapsulation, and chaotic encapsulation—illustrates their hidden risks with concrete code examples, and offers practical principles to restore clear responsibilities, minimal interfaces, and flexible design.
This article clarifies the distinct concepts of concurrency, parallelism, and asynchrony, detailing their definitions, implementation mechanisms, resource needs, timing semantics, and ideal use‑cases to help developers choose the right model for high‑performance systems.
The article explains why clean, well‑named code is essential for productivity, outlines the hidden costs of messy naming, and provides concrete guidelines and examples—including variable, class, package, and method naming patterns—to help developers write code that communicates clearly with both machines and engineers.
The article explains the YAGNI principle, showing how focusing on current requirements, using simple solutions, and refactoring when real needs arise can prevent over‑engineering, reduce technical debt, and keep Java code clean and adaptable.
The article clarifies that the DRY principle targets hidden knowledge duplication rather than superficial code similarity, explains why over‑abstraction can be harmful, and provides concrete Java examples of both violations and correct applications, while also discussing how to balance DRY with YAGNI.
This article explains the core software design principles KISS, DRY, and SOLID, shows why they matter for readability and maintainability, provides concrete Java examples and step‑by‑step guidelines, and lists actionable rules developers can follow to write cleaner, more reusable code.
This article demystifies the concept of architecture by tracing its origins, explaining the 4+1 and C4 modeling approaches, introducing TOGAF‑4A, and clarifying the role of enterprise architecture in aligning people, processes, technology, and data to manage complexity across large organizations.
Claude Code redefines AI programming assistants by abandoning complex multi‑agent architectures in favor of a single‑loop, single‑file design, leveraging Unix‑style simplicity, LLM‑based search, and sophisticated context engineering to act as a collaborative partner rather than a mere code‑completion tool.
AI programming assistantClaude Codecontext engineering
This article explains UML class diagrams, covering their purpose, core elements, how classes, interfaces, and various relationships are represented, and provides a practical example of a simple music‑streaming system to illustrate the concepts.
This article explains the concept of strong and weak functions in C, shows how to declare them with GCC and other compilers, outlines the linker selection rules, and demonstrates practical uses such as library overrides, interrupt handlers, callbacks, test stubs, plugin systems, and related pitfalls.
This article explains why clean code is crucial for projects and developers, covering the importance of readable naming, single‑responsibility classes, well‑structured functions, and effective testing practices to boost productivity and reduce technical debt.
This comprehensive guide presents 50 practical Python coding best‑practice rules covering naming, function design, object‑oriented principles, exception handling, code style, and project structure, showing how to write self‑explanatory, reusable, and robust code that stands the test of time and team collaboration.
This comprehensive guide explores the evolution of object‑oriented programming, clarifies its core concepts, and walks readers through use‑case modeling, static and dynamic modeling, responsibility‑driven design patterns, and advanced modeling techniques, providing a complete knowledge framework for software engineers and architects.
The article explains why using the vague term “user” in software design creates hidden security flaws, illustrates the problem with examples from ticket booking, Unix, and SaaS systems, and urges early terminology planning to avoid costly redesigns.
This article explains the definition of application architecture, distinguishes enterprise‑level and system‑level designs, outlines its core components—application services, structure, and interaction—and illustrates layered architectures and service interactions with diagrams, helping readers understand how to translate business architecture into concrete IT solutions.
Linus Torvalds harshly criticized a Meta engineer's pull request as garbage, using the incident to illustrate how unnecessary abstractions increase cognitive load, why code should be clear and self‑contained, and how modern tools like IDEs and LLMs change the cost of refactoring.
The article argues that the vague term “user” misleads software design, illustrates the problem with airline reservation, Unix, and SaaS examples, shows how it creates security flaws like the Confused Deputy issue, and urges precise terminology early in projects to avoid costly rework.
This article explores what makes code truly good by examining functional, stability, user experience, efficiency, and cost dimensions, presenting the "Gold Code" evaluation criteria, discussing design principles, common code smells, practical examples, and how design patterns and layering affect readability and maintainability.
The article explains how the vague term “user” leads to flawed requirements, security vulnerabilities such as the Confused Deputy problem, and costly redesigns, urging developers to adopt precise terminology like “traveler”, “agent”, or “member” early in a project.
This article explores the Open‑Closed Principle (OCP) in depth, covering its definition, evolution, practical applications, common misconceptions, code comparisons, and best‑practice guidelines to help developers balance extensibility with simplicity in modern software design.
Object‑oriented programming, though often overlooked in data‑centric Python scripts, becomes essential for managing complexity, improving readability, and enabling collaboration, as this guide demonstrates eight core OOP concepts—classes, encapsulation, inheritance, polymorphism, composition, class/staticmethods, magic methods, and abstract base classes—through clear examples.
This article explains why unit testing is essential for code quality, API design, and documentation, then walks through Go's built‑in testing conventions, common *testing.T methods, table‑driven test patterns, mocking with gomonkey, and best practices for writing maintainable tests.
This tutorial introduces PlantUML, explains its core features, shows how to install plugins for popular IDEs, and provides detailed syntax examples for participants, messages, lifelines, activation bars, groups, notes, and colors, culminating in a complete login flow diagram.
This article introduces Self-Contained Systems (SCS) as an alternative to microservices, outlines SCS core characteristics, compares both approaches across granularity, communication, UI handling and integration, and concludes with practical insights for large‑scale, multi‑team projects.
This article outlines the definition, key design principles, and step‑by‑step process for creating robust application architecture, illustrated with a series of diagrams that guide developers through essential architectural decisions.
This article reveals how common bad coding practices such as over‑engineering, hidden business logic in utility classes, deep inheritance trees, excessive DTO layers, unnecessary interfaces, and contract‑less microservices degrade team efficiency and project quality, and offers concrete, principle‑driven remedies.
This article explains the evolution and benefits of layered software architecture—from early two‑layer designs to MVC, DDD, Clean Architecture, and the Monet framework—highlighting how clear responsibilities, adaptability, and proper dependency direction improve maintainability, scalability, and team collaboration.
This article examines the growing complexity of a points‑mall front‑end, identifies architectural and code‑organization pain points, and demonstrates how applying Clean Architecture together with Vue 3's Composition API can decouple business logic from UI, improve maintainability, and streamline development.
This article explains how detailed design documentation, the distinction between strategic and tactical design, and the CRC (Class‑Responsibility‑Collaborator) method together form a flexible, evolving blueprint that guides development without over‑prescribing implementation details.
This article explains why clean code is essential for productivity and team collaboration, outlines concrete guidelines for meaningful naming, single‑responsibility classes, concise functions, and effective testing, and shows how tools and refactoring can help maintain high code quality.
This article explains why thoughtful object naming—avoiding generic “er”/“or” suffixes and vague Service/Helper classes—improves code readability, maintainability, and AI‑assisted development, and demonstrates better designs with concrete C# examples that model real‑world business roles and adaptive behavior.
This article explains why clean code is essential for team development and provides practical guidelines on naming, class design, function composition, and testing—including SOLID principles, meaningful identifiers, single‑responsibility classes, short functions, and test‑driven development—to improve readability, extensibility, and overall software quality.
The article explains that while encapsulation, inheritance, and polymorphism are often highlighted, true software craftsmanship hinges on the ability to abstract—identifying essential features, discarding irrelevant details, and modeling problem domains through steps like analysis, concept extraction, and system design, supported by principles such as low coupling, high cohesion, sufficiency, and completeness.
The article explains how using a state‑machine approach in embedded C programs eliminates wasteful delay loops, improves CPU utilization, guarantees logical completeness for all event combinations, and produces clearer, more maintainable code structures.
This article compares Domain‑Driven Design and MVC, outlines the architectural changes such as dependency inversion and layer separation, examines common drawbacks in real projects, and offers concrete guidance on when to adopt DDD, blend it with MVC, or stick to a lightweight CRUD‑centric approach.
This article explains how to build a business model diagram for an SDK from a design perspective, covering the definition of business model diagrams, their purpose, expression methods, layered architecture, derivation principles, a six‑step modeling process, and evaluation criteria to ensure clarity, correctness, and extensibility.
The article explains why a scalable modular system architecture is essential, outlines its core concepts, detailed implementation steps, design principles, and real‑world case studies, and highlights technologies such as micro‑services, containers, and API gateways that enhance extensibility and maintainability.
This comprehensive guide outlines the essential technical, business, and leadership competencies—including programming, multi‑technology mastery, architectural principles, forward‑looking tech awareness, business understanding, and team management—that IT architects need to succeed in today’s fast‑evolving digital landscape.
The article reviews the main ideas of John Ousterhout's *A Philosophy of Software Design* (2nd edition), explaining how the book defines software complexity, proposes strategies such as eliminating or encapsulating complexity, and discusses deep classes, shallow interfaces, naming, strategic versus tactical programming, and practical warnings for developers.
The article argues that despite AI’s recent breakthroughs, it cannot solve the inherent complexity of software development, and revisits classic software design principles—from modularity and code design to maintenance and performance—presented in John Ousterhout’s “Software Design Philosophy (2nd edition)” as essential guidance for developers.
This article introduces the basics of software design documentation, explaining how software modeling and UML diagrams such as class, sequence, component, deployment, use case, state, and activity charts are used to capture domain problems and system architecture throughout requirement analysis, high‑level design, and detailed design phases.
The article highlights how fragmented, undocumented cross‑team communication creates fragile software, then advocates adopting contract‑based design—preconditions, postconditions, invariants—and AI‑assisted tooling to formalize API contracts throughout the development lifecycle, aligning teams, reducing errors, and improving system reliability.
The article explores whether great programmers can be cultivated by examining problem decomposition, the value of deep and generic class design, the pitfalls of tactical coding versus strategic programming, and lessons learned from the author’s CS190 software‑design workshop at Stanford.
deep class designgeneric vs specializedproblem decomposition
This article explores the essential role of technical architects, detailing their responsibilities, the challenges of traditional waterfall collaboration, and introducing a triangular collaboration model and a structured architecture design thinking framework to foster system thinking, proactive decision‑making, and effective team leadership.
Clean software architecture, built on principles like vertical and horizontal separation and proper module qualification, reduces complexity and technical debt, boosts scalability, flexibility, and reliability, and guides organizations in proactively managing architectural health through continuous assessment, AI-driven observability, and targeted team training.