Can this skill help with error handling?

Yes, it provides principles for 'defining errors out of existence' by changing method semantics so that common edge cases are handled internally rather than thrown as exceptions.

What are 'Deep Modules' in software design?

A deep module is an abstraction that provides a lot of functionality through a very simple interface, like the Unix I/O system, as opposed to shallow modules where the interface is as complex as the implementation.

How does this skill help with technical debt?

It promotes 'Strategic Programming' over 'Tactical Programming,' encouraging a 10-20% time investment in design improvements to prevent change amplification and high cognitive load.

What is the core philosophy behind this System Design skill?

It is based on 'A Philosophy of Software Design' by John Ousterhout, which posits that complexity is the root of most software problems and focuses on creating 'deep' modules that hide complexity behind simple interfaces.

System Design Principles

Name: System Design Principles
Author: primeinc

byprimeinc

Desarrollo de API

Applies high-level architectural principles to create deep modules, reduce system complexity, and build maintainable software interfaces.

Acerca de

The System Design skill equips Claude with the architectural framework established in John Ousterhout’s 'A Philosophy of Software Design.' It helps developers move beyond simply writing 'working code' toward building 'great design' by focusing on deep modules with simple interfaces, aggressive information hiding, and the elimination of unnecessary complexity. Whether you are designing a new API, refactoring a monolithic service, or building a CLI tool, this skill provides actionable guidance on reducing cognitive load and change amplification through strategic programming and better abstraction boundaries.

Características Principales

0 GitHub stars
Strategic vs. Tactical programming analysis for long-term project health
Error-elimination techniques to simplify API surfaces and internal logic
Identification of shallow modules and refactoring patterns for deep modules
Information hiding strategies to prevent implementation leakage and coupling
Red flag detection for common architectural pitfalls like temporal decomposition

Casos de Uso

Designing a new library or API with a clean, minimal interface for high reusability
Refactoring complex legacy codebases to reduce cognitive load and technical debt
Building CLI tools with sensible defaults and progressive disclosure for better UX

Acerca de

Características Principales

0 GitHub stars
Strategic vs. Tactical programming analysis for long-term project health
Error-elimination techniques to simplify API surfaces and internal logic
Identification of shallow modules and refactoring patterns for deep modules
Information hiding strategies to prevent implementation leakage and coupling
Red flag detection for common architectural pitfalls like temporal decomposition

Casos de Uso

Designing a new library or API with a clean, minimal interface for high reusability
Refactoring complex legacy codebases to reduce cognitive load and technical debt
Building CLI tools with sensible defaults and progressive disclosure for better UX