Сталкивался ли с непониманием что делает код

Да, сталкивался. Чаще всего это происходит, когда код плохо документирован, использует "магические" числа или сложные цепочки методов без пояснений.

Пример плохого кода:

const result = data.filter(x => x > 5).map(y => y * 2).reduce((a, b) => a + b, 0);

Лучше разбить на понятные шаги с комментариями:

// Фильтруем значения больше 5
const filtered = data.filter(value => value > 5);

// Удваиваем каждое значение
const doubled = filtered.map(value => value * 2);

// Суммируем результаты
const total = doubled.reduce((sum, value) => sum + value, 0);

Чтобы избежать непонимания:

1. Использую осмысленные названия переменных
2. Разбиваю сложные операции на шаги
3. Добавляю комментарии к неочевидной логике
4. Пишу юнит-тесты как документацию поведения