Skip to main content
skill CX Codex

a-philosophy-of-software-design — Claude Code skill: install

The a-philosophy-of-software-design Claude Code skill applies software design principles to complexity, module boundaries, APIs, and abstractions. It activates during design reviews or refactoring of shallow interfaces.

MIT 643 installs ★ 3,328 updated 2026-09-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a claude-code
Open on GitHub

What a-philosophy-of-software-design does

The skill uses John Ousterhout-inspired design principles to guide code and architecture decisions. It focuses on reducing complexity, shaping module boundaries, and evaluating information hiding and abstraction depth.

Start with a-philosophy-of-software-design.mini.md before making a design or code decision. When its rules do not resolve a particular tradeoff, consult the fuller reference in a-philosophy-of-software-design.md.

The guidance also covers cognitive load and refactoring shallow interfaces. The longer reference is for cases the short rules cannot settle.

What it helps with

  • reduce complexity in a module
  • define boundaries between modules
  • assess abstraction depth
  • review an API design
  • refactor a shallow interface

Example prompts for the agent

  • Review these module boundaries and apply information-hiding principles.
  • Assess this API design and suggest a deeper abstraction.
  • Help simplify this module and reduce its cognitive load.

How to install a-philosophy-of-software-design

1Skills CLI (Vercel)

npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a claude-code

2Manually: put the files in place

~/.claude/skills/a-philosophy-of-software-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/a-philosophy-of-software-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about a-philosophy-of-software-design

How do I install a-philosophy-of-software-design in Claude Code?

Run npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a claude-code. The skill file is placed at ~/.claude/skills/a-philosophy-of-software-design/SKILL.md.

What does a-philosophy-of-software-design do?

It applies software design principles to code complexity, module boundaries, APIs, and abstractions. It starts with a concise set of rules and uses a longer reference when a design tradeoff needs more detail.

Which files does a-philosophy-of-software-design use?

Read a-philosophy-of-software-design.mini.md first. The fuller guide, a-philosophy-of-software-design.md, covers tradeoffs the short rules do not resolve.

Source text

SKILL.md · MIT
---
name: a-philosophy-of-software-design
description: Apply John Ousterhout-inspired software design rules when reducing complexity, designing module boundaries, or reviewing APIs and abstractions.
license: MIT
---

# A Philosophy of Software Design Skill

Use this skill when a task involves module design, API design, information hiding, abstraction depth, cognitive load, or refactoring shallow interfaces.

Before making design or code decisions, read and apply [a-philosophy-of-software-design.mini.md](a-philosophy-of-software-design.mini.md). Use [a-philosophy-of-software-design.md](a-philosophy-of-software-design.md) only as a deeper reference when the mini rules are not enough for the current design tradeoff.

© ciembor · MIT · ciembor/agent-rules-books

Similar skills

SKILL.md skills catalog →
software-design-philosophy wondelai software-design-philosophy — a design-review skill that rates module depth, information leakage and comment quality, then names the fix for each failed check. CX Codex +1 6,600installs software-design-principles databricks-solutions software-design-principles — a Markdown engineering guide for code review, module planning, and refactoring. It enforces clean boundaries, non-functional requirements, and layered design across pull requests. CX Codex +1 ★ 38repo stars finding-software-engineers-on-twitter apidojo finding-software-engineers-on-twitter — a skill that hunts for engineers and developers on Twitter/X by tech stack and open-to-work signals. Built for technical recruiters and hiring managers. CX Codex +1 909installs software-engineer siviter-xyz software-engineer — a skill that gives the agent rules for code style, documentation and workflow: no filler comments, no git commits on its own, questions when something is unclear. CX Codex +1 637installs nestjs-professional-software-engineering amirtaherkhani nestjs-professional-software-engineering — a skill for Claude Code and Cursor designs, implements, refactors, and tests production-quality NestJS and TypeScript software. Runs during feature development, API creation, and bug fixes. CX Codex +1 556installs software-patterns bobmatnyc software-patterns compares tradeoffs between architectural patterns and points to the one that fits your problem: coupling, resilience, service boundaries. Useful when code resists testing. CX Codex +1 390installs

From the same set14

The whole set →
clean-code This Claude Code skill applies clean-code guidance to readability, naming, and function design. It activates during everyday coding and test-related tasks. CX Codex +1 683installs refactoring This Claude Code skill applies Martin Fowler-inspired rules to refactoring. It activates for code-structure changes that preserve observable behavior. CX Codex +1 670installs clean-architecture This Claude Code skill applies clean architecture principles to decisions about separating business policy from implementation details. It activates for work on dependency direction, use cases, and application boundaries. CX Codex +1 645installs code-complete The code-complete Claude Code skill applies software construction rules to routines, classes, control flow, defensive code, and tests. It activates for implementation and design tasks. CX Codex +1 611installs release-it The release-it Claude Code skill applies production reliability rules to failure handling, timeouts and retries. It activates on tasks involving integration failures, deployment or operational readiness. CX Codex +1 607installs the-pragmatic-programmer the-pragmatic-programmer — a skill for Claude Code and Codex applying Hunt and Thomas-inspired engineering guidelines. Triggers during architecture decisions, automation work, and code refactoring. CX Codex +1 603installs working-effectively-with-legacy-code working-effectively-with-legacy-code — a skill for Claude Code and Codex that enforces Michael Feathers' legacy code techniques. Activates during risky refactoring, missing test coverage, and dependency breaking. CX Codex +1 602installs refactoring-guru refactoring-guru — a skill for Claude Code helps diagnose code smells and choose focused refactoring techniques. The agent applies its rules to code changes while preserving behavior. CX Codex +1 598installs

Project sponsors

Companies that keep this analytics open