Cognitive Load Reduction

What problem does it solve?

This Skill reduces developer cognitive load by focusing changes on readability, control flow, and documentation so that newcomers can grasp the happy path in unfamiliar code without breaking behavior.

Core Features & Use Cases

• Local Readability keeps key logic understandable in one place, favors explicit flow, and protects the happy path from deep branching or obfuscation.
• Control Flow & Naming Simplification untangles nested conditionals, introduces guard clauses, and renames identifiers to signal intent rather than mechanics.
• Logical Grouping & State Clarity co-locates related behavior, highlights state ownership and transitions, and captures any needed explanations alongside the code it affects.
• Documentation Alignment uses knowledge-observatory-tools to read the target seams doc and records architecture clarity notes so the reduced cognitive load is preserved for future contributors.

Quick Start

Ask to simplify the target module for readability, adjust its naming and flow, and capture the results in the architecture clarity notes.