convention-tell-dont-ask

The Tell, Don't Ask principle in object-oriented design prevents external code from querying object state to make decisions, instead pushing decisions and behavior into self-contained objects to enforce encapsulation.

Refactor code to improve encapsulation by moving decision logic into domain objects, invoking behavior on them directly rather than inspecting their state to drive workflow state transitions and command handling.

Move decision logic into domain objects during a refactor when modeling domain behaviors, ensuring objects encapsulate their own logic for workflow state transitions instead of their containers deciding the flows.

Violating encapsulation reduces code maintainability in workflow state transitions by increasing external state checks, which makes the workflow logic harder to manage and forces containers to decide flows.

The best way to handle command logic without exposing internal object state is to encourage methods that perform actions on self-contained objects, aligning with the Tell, Don't Ask principle to push decisions into the objects.