Skip to content

DangQuangSE/team-development-skills / .agents/skills/problem-solving/simplification-cascades

Simplification Cascades

Verified

Find one insight that eliminates multiple components - "if this is true, we don't need X, Y, or Z"

Simplification Cascades

Overview

Sometimes one insight eliminates 10 things. Look for the unifying principle that makes multiple components unnecessary.

Core principle: "Everything is a special case of..." collapses complexity dramatically.

Quick Reference

SymptomLikely Cascade
Same thing implemented 5+ waysAbstract the common pattern
Growing special case listFind the general case
Complex rules with many exceptionsFind the rule that has no exceptions
Excessive config optionsFind defaults that work for 95%
Refactoring feels like whack-a-moleA deeper unifying model is missing

The Pattern

Look for:

  • Multiple implementations of similar concepts
  • Special case handling everywhere
  • "We need to handle A, B, C, D differently..."
  • Complex rules with many exceptions

Ask: "What if they're all the same thing underneath?"

Examples

Cascade 1: Stream Abstraction

Before: Separate handlers for batch/real-time/file/network data Insight: "All inputs are streams — just different sources" After: One stream processor, multiple stream sources Eliminated: 4 separate implementations

Cascade 2: Resource Governance

Before: Session tracking, rate limiting, file validation, connection pooling (all separate) Insight: "All are per-entity resource limits" After: One ResourceGovernor with 4 resource types Eliminated: 4 custom enforcement systems

Cascade 3: Immutability

Before: Defensive copying, locking, cache invalidation, temporal coupling Insight: "Treat everything as immutable data + transformations" After: Functional programming patterns Eliminated: Entire classes of synchronization problems

Cascade 4: Event Sourcing

Before: Audit log, undo history, cache invalidation, notification triggers (all wired separately) Insight: "Everything is an event — store events, derive state" After: Event store + projections replace all 4 systems

Process

  1. List the variations — What's implemented multiple ways?
  2. Find the essence — What's the same underneath?
  3. Extract abstraction — What's the domain-independent pattern?
  4. Test it — Do all cases fit cleanly?
  5. Measure cascade — How many things become unnecessary?

Red Flags You're Missing a Cascade

  • "We just need to add one more case..." (repeating forever)
  • "These are all similar but different" (maybe they're the same?)
  • Refactoring feels like whack-a-mole (fix one, break another)
  • Growing configuration file
  • "Don't touch that, it's complicated" (complexity hiding a pattern)

Remember

  • Simplification cascades = 10x wins, not 10% improvements
  • One powerful abstraction > ten clever hacks
  • The pattern is usually already there — it just needs recognition
  • Measure in "how many things can we delete?"
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 321kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall