refactoring/simplifying-method-calls

What problem does it solve?

Cleaning up overloaded, stateful, or confusing method signatures so callers do not have to guess intent, struggle with mixed responsibilities, or wrestle with bloated parameter lists.

Core Features & Use Cases

• Signature Refinement: Rename unclear methods, add only necessary parameters, and hide helpers to reduce the public surface area.
• Responsibility Separation: Split combined query-modifier methods so one path reads state and another mutates it, supporting CQRS principles.
• Parameter Simplification: Group related parameters into explicit objects, preserve whole domain objects, or swap flag signals for dedicated methods to clarify calls.
• Use Case: When a TypeScript domain service exposes calculateTotalsAndSave() with excess flags, rename it, break apart the query and modifier, and introduce a DateRange parameter object to summarize the shared arguments.

Quick Start

Ask to rename unclear service methods, split state-changing logic from queries, and wrap recurring parameter sets in objects to simplify the interface.