
Software Design Philosophy
Design principles from John Ousterhout's book, distilled into a guide for reviews, module splits, and API design.
- skills.sh installs
- 261
- GitHub stars
- 359
- last updated
- Aug 21, 2026
What it does
- Covers complexity analysis, strategic versus tactical programming, and deep versus shallow module design
- Includes checklists for information leakage, pass-through methods and variables, and pulling complexity downward
- Provides a strategy for defining errors out of existence, plus guidance on designing two alternatives before committing
- Designed for code reviews, architecture discussions, and refactoring where design quality feedback is requested
Install
$ npx -y skills add luoling8192/software-design-philosophy-skill --skill software-design-philosophy -yInstalls into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.
Files
A Philosophy of Software Design — Distilled Guide
Source: John Ousterhout, A Philosophy of Software Design Central thesis: The core challenge of software design is managing complexity.
I. Complexity: Know the Enemy
Definition
Complexity is anything related to the structure of a software system that makes it hard to understand and modify. Complexity is not the same as system size — a small system can be complex, and a large well-designed system can be manageable.
Three Symptoms of Complexity
- Change Amplification: A seemingly simple change requires code modifications in many different places.
- Cognitive Load: Developers must absorb a large amount of information to complete a task safely. Note: fewer lines of code ≠ simpler — sometimes more code is actually simpler because it reduces cognitive load.
- Unknown Unknowns: It's unclear which code must be modified or what information is needed to complete a task. This is the most dangerous symptom.
Two Root Causes
Details
- Repository
- github.com/luoling8192/software-design-philosophy-skill
- Categories
- Backend & APIs, Git & Pull Requests, Documentation, Code Review & Quality, Debugging, Design & UI/UX
- First seen
- Jun 3, 2026
Similar to Software Design Philosophy
More Backend & APIs
alicloud-security-center-sascinience/alicloud-skills260 installsManage Alibaba Cloud Security Center (Sas) via OpenAPI/SDK. Use whenever the user needs Security Center resource operations, configuration updates, status queri
zustand-stateexistential-birds/beagle260 installsZustand state management for React and vanilla JavaScript. Use when creating stores, using selectors, persisting state to localStorage, integrating devtools, or
godot-3d-materialsthedivergentai/gd-agentic-skills260 installsExpert patterns for Godot 3D PBR materials using StandardMaterial3D including albedo, metallic/roughness workflows, normal maps, ORM texture packing, transparen
alicloud-ai-contactcenter-aicinience/alicloud-skills259 installsManage Alibaba Cloud Contact Center AI (ContactCenterAI) via OpenAPI/SDK. Use whenever the task involves Contact Center AI resource lifecycle operations, config
alicloud-data-lake-dlfcinience/alicloud-skills259 installsManage Alibaba Cloud Data Lake Formation (DataLake) via OpenAPI/SDK. Use whenever the user asks for DataLake catalog resource operations, configuration updates,
ggetdavila7/claude-code-templates259 installsCLI/Python toolkit for rapid bioinformatics queries. Preferred for quick BLAST searches. Access to 20+ databases: gene info (Ensembl/UniProt), AlphaFold, ARCHS4