ousterhout-principles

What problem does it solve?

Shallow modules, information leakage, and generic naming conventions lead to complex, hard-to-maintain software. This Skill applies Ousterhout's principles to help you design "deep" modules with simple interfaces and powerful implementations, drastically reducing complexity.

Core Features & Use Cases

• Deep vs. Shallow Module Check: Guides you to identify modules that hide significant complexity behind a simple interface, maximizing their value.
• Information Leakage Detection: Helps you prevent callers from depending on internal implementation details, ensuring refactoring freedom.
• Red Flag Scanner: Automatically flags generic names (Manager, Helper, Util) and temporal decomposition, pushing for more specific and functional designs.
• Use Case: During a design review, activate this Skill to automatically analyze module interfaces, identify potential information leakage, and suggest ways to deepen shallow modules, leading to a more robust architecture.

Quick Start

Apply the ousterhout-principles skill to review the attached module design. Identify any shallow modules or information leakage.