DangQuangSE/team-development-skills / .agents/skills/problem-solving/simplification-cascades
Simplification Cascades
VerifiedFind one insight that eliminates multiple components - "if this is true, we don't need X, Y, or Z"
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.1 KB |
SKILL.md
View on GitHub---
name: Simplification Cascades
description: Find one insight that eliminates multiple components - "if this is true, we don't need X, Y, or Z"
when_to_use: when implementing the same concept multiple ways, accumulating special cases, or complexity is spiraling
version: 1.1.0
---
# 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
| Symptom | Likely Cascade |
|---------|----------------|
| Same thing implemented 5+ ways | Abstract the common pattern |
| Growing special case list | Find the general case |
| Complex rules with many exceptions | Find the rule that has no exceptions |
| Excessive config options | Find defaults that work for 95% |
| Refactoring feels like whack-a-mole | A 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?"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |