Читаемость кода
Разделяйте независимые обязанности и сохраняйте объяснения неочевидных решений.
Проверено Изменено
Плохо
Удалить полезные комментарии, чтобы уложиться в 5%.
Хорошо
Разделить независимые задачи.
Оставить комментарий о причине ограничения.
Почему это важно
Формальный лимит строк не доказывает простоту программы.
Когда применять
Порог сложности может быть локальным сигналом ревью. Размер файла и доля комментариев не универсальные стандарты.
Кто что делает
Человек
Проверяет понятность бизнес-смысла и согласует существенные изменения архитектуры.
AI-агент
Реализует правило в коде сервиса и проверяет ошибку, отмену и граничные входные данные.
Контроль результата:
- Можно ли назвать одну ответственность модуля и объяснить его зависимости?
Как проверить у себя
- Можно ли назвать одну ответственность модуля и объяснить его зависимости?
Первоисточники
История изменений на GitHubДата проверки отражает содержательную сверку. Синхронизация сайта не обновляет её автоматически.