AutomationNewFreeWorks in Claude Code · Claude app · Codex
A Philosophy of Software Design
Tame complexity with deep modules and information hiding. (For developers.)
Part of Book skills by @wondelai ↗Applies John Ousterhout's principles — deep modules, information hiding, strategic programming — to manage complexity.
What it does
- Designs deep modules that hide complexity.
- Trades tactical hacks for strategic design.
When it kicks in
Manage software complexity through deep modules, information hiding, and strategic programming. Use when the user mentions "module design", "API too complex", "shallow class", "complexity budget", "strategic vs tactical", "deep module", "information leakage", "pass-through method", "this code is over-engineered", or "simplify this design".
Topics the skill covers
- Core Principle
- Complexity and Its Causes
- Deep vs Shallow Modules
- Information Hiding and Leakage
- General-Purpose vs Special-Purpose Modules
- Comments as Design Documentation
- Strategic vs Tactical Programming
- Common Mistakes
What's inside the download
7 files in the .zip:
- Skill InstructionsSKILL.md15.9 KB
- Comments as Designreferences/comments-as-design.md16.3 KB
- Complexity Symptomsreferences/complexity-symptoms.md11.7 KB
- Deep Modulesreferences/deep-modules.md13.3 KB
- General vs Specialreferences/general-vs-special.md13.2 KB
- Information Hidingreferences/information-hiding.md12 KB
- Strategic Programmingreferences/strategic-programming.md13.4 KB
How to install (2 minutes)
Same download for Claude Code, Claude app, Codex — follow the step for the tool you use.
- 1Download the .zip and unzip it — you’ll get a folder called software-design-philosophy.
- 2In the Claude app: open Settings → Capabilities → Skills, choose Add / Upload, and select the folder (or the .zip).
- 3In Claude Code: drop the folder into your project’s .claude/skills/ directory, then type /skills to confirm it loaded.
- 4In Codex: drop the folder into ~/.agents/skills/ (or your project’s .agents/skills/), then type /skills — or call it directly with $software-design-philosophy.
- 5That’s it — the skill activates on its own when it fits what you’re doing.
New to skills? Our Claude Cowork beginner's guide shows how they work inside Claude.
Want to get the most out of your new skill?
Inside Hands-On AI Club we show you exactly how to use skills like this in real work — with step-by-step courses that show every move.
