Версия источника: 4880e8b4372c96001c2e052be28b68a95d31252b
Синхронизировано: 2026-11-09T11:15:07.649Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/4880e8b4372c96001c2e052be28b68a95d31252b

<a id="backend-readable-code"></a>

# Читаемость кода

## Коротко

Разделяйте независимые обязанности и сохраняйте объяснения неочевидных решений.

## Плохо

```text
Удалить полезные комментарии, чтобы уложиться в 5%.
```

## Хорошо

```text
Разделить независимые задачи.
Оставить комментарий о причине ограничения.
```

## Почему

Формальный лимит строк не доказывает простоту программы.

## Когда применять

Порог сложности может быть локальным сигналом ревью. Размер файла и доля комментариев не универсальные стандарты.

## Как проверить

- Можно ли назвать одну ответственность модуля и объяснить его зависимости?

## Человек

Проверяет понятность бизнес-смысла и согласует существенные изменения архитектуры.

## Агент

Реализует правило в коде сервиса и проверяет ошибку, отмену и граничные входные данные.

Контроль результата:

- Можно ли назвать одну ответственность модуля и объяснить его зависимости?

## Источники

- [Effective Go - The Go Programming Language](https://go.dev/doc/effective_go)

Уровень: Рекомендуется. Проверено: 2026-11-09. Изменено: 2026-11-09.

[Исходный файл](https://github.com/sergey-from-riders/vibecoding-base/blob/4880e8b4372c96001c2e052be28b68a95d31252b/registry/standards/backend/python/rules/readable-code.md)