simplification cascades

Simplification Cascades

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "simplification cascades" with this command: npx skills add obra/superpowers-skills/obra-superpowers-skills-simplification-cascades

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 exceptions Find the rule that has no exceptions

Excessive config options Find defaults that work for 95%

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

Process

  • List the variations - What's implemented multiple ways?

  • Find the essence - What's the same underneath?

  • Extract abstraction - What's the domain-independent pattern?

  • Test it - Do all cases fit cleanly?

  • 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 pattern)

Remember

  • Simplification cascades = 10x wins, not 10% improvements

  • One powerful abstraction > ten clever hacks

  • The pattern is usually already there, just needs recognition

  • Measure in "how many things can we delete?"

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Repository SourceNeeds Review
31.3K85.6Kobra
General

executing-plans

Use when you have a written implementation plan to execute in a separate session with review checkpoints

Repository SourceNeeds Review
24.5K85.6Kobra
General

verification-before-completion

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

Repository SourceNeeds Review
18.9K85.6Kobra
General

writing-skills

Use when creating new skills, editing existing skills, or verifying skills work before deployment

Repository SourceNeeds Review
18.1K85.6Kobra