Software Design Philosophy
by wondelaic172996495beMIT2.3K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 4 weeks ago
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". Also trigger when reviewing an interface for simplicity, evaluating whether an abstraction is pulling its weight, deciding whether a comment is worth writing, or choosing between general-purpose and special-purpose approaches. Covers deep vs shallow modules, red flags for complexity, and comments as design documentation. For code quality, see clean-code. For architecture boundaries, see clean-architecture.
Only the file list is public. File contents are available once the skill is installed in a workspace.
| Path | Size | Type |
|---|---|---|
| references/comments-as-design.md | 16.3 KB | text/markdown |
| references/complexity-symptoms.md | 11.7 KB | text/markdown |
| references/deep-modules.md | 13.3 KB | text/markdown |
| references/general-vs-special.md | 13.2 KB | text/markdown |
| references/information-hiding.md | 12 KB | text/markdown |
| references/strategic-programming.md | 13.4 KB | text/markdown |
| SKILL.md | 15.9 KB | text/markdown |
Source and attribution
Source:wondelai/skillsinsoftware-design-philosophyat commitc172996
License: MIT
Content belongs to its original authors. SourceWeft indexes it from a public repository.
More from wondelai/skills
System Design
wondelai
Structured framework for designing scalable distributed systems, covering estimation, building blocks, database scaling, common designs, and operations.
Web Typography
wondelai
Guides selecting, pairing, and implementing web typefaces, covering readability, CSS, and font loading.
Top Design
wondelai
Guides creation of award-winning, immersive web experiences with dramatic typography, purposeful motion, and scroll-based design.
Ux Heuristics
wondelai
Evaluates interface usability using Nielsen's heuristics, Krug's principles, severity ratings and accessibility checks.
Traction Eos
wondelai
Guides a leadership team through implementing the Entrepreneurial Operating System (EOS) to align vision and execution.
Team Topologies
wondelai
Guides engineering org design using Team Topologies: team types, interaction modes, cognitive load and fracture planes.
More in Software Development
Playground
anthropics
Builds self-contained interactive HTML playgrounds with controls, live preview, and copyable prompt output.
M5 Onboard
anthropics
Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.
Cardputer Buddy
anthropics
Guides iterating on a Cardputer-Adv MicroPython app bundle: adding apps, pushing files over USB-serial, tailing logs, and running REPL commands.
Web Design Guidelines
vercel-labs
Reviews UI code against Web Interface Guidelines fetched from a remote source and reports findings as file:line entries.
Vercel React Native Skills
vercel-labs
React Native and Expo best-practice rules covering list performance, animation, navigation, UI patterns, state, and monorepo setup.
Vercel React Best Practices
vercel-labs
Vercel's React and Next.js performance guidelines, organized as 70 rules for writing, reviewing, and refactoring code.