Модульная структура Python-кода

engineering

modular-code — это скилл для Claude Code, который помогает организовывать Python-код по принципу модульности с оптимальным размером файлов 150–500 строк для удобства AI-редакторов и человеческого восприятия. Скилл описывает четыре ступени: 150–500 строк — оптимум, 500–1000 — искать точки разделения, 1000–2000 — рефакторинг, 2000+ — критично и требует обязательного разбиения. Для разделения предлагаются четыре подхода: по доменной концепции, по слою абстракции, по типу данных и по границе ввода-вывода, а также рекомендованная структура пакета с файлами core.py, models.py, handlers.py и utils.py. Скилл также включает пошаговый процесс рефакторинга существующих больших файлов: выделение кластеров, инкрементальный перенос, обновление импортов и проверка тестов. Подходит разработчикам, которые хотят избежать проблем с контекстом AI-инструментов и упростить поддержку кодовой базы.