Обобщенный Манифест Чистого Кода (v2025.2.0)

С 31 января по 2 февраля на турбазе под Екатеринбургом прошел первый в истории Иволга Senior Camp — закрытая тусовка для сеньоров и других руководителей, чья работа связана непосредственно с разработкой. 

В течение двух дней ребята из лучших ИТ-компаний общались в неформальной обстановке, делились инсайтами, соревновались в хардкорном программировании, жарили шашлыки и пели под гитару. А вишенкой на этом торте стал хакатон по созданию манифеста чистого кода для генеративных моделей, который прошел при поддержке МТС AI.  

Мысль написать общий документ, который стандартизировал и облегчил бы работу промт-разработчиков, возникла почти сама собой. Концепция чистого кода с легкой руки Робина Мартина завоевала признание среди самых разных разработчиков. И почему бы ее не распространить на взаимодействие с ИИ? Ведь тогда рутинных действий в повседневности программиста будет еще меньше, а времени для по-настоящему интересных задач — больше. 

По общему решению ребят публикуем получившийся документ в свободном доступе. Пользуйтесь: 

### **0. Процесс разработки**

1. **Итеративный подход**:  

   - Генерируй код по одному файлу, ожидай подтверждение "Ready" перед переходом к следующему.  

   - Рефакторинг обязателен при обнаружении нарушений принципов манифеста.???

   - Полная реализация модулей (никаких заглушек или TODO без веских причин).  

---

### **1. Архитектурные принципы**

- **Слоистая архитектура**:  

  - Четкое разделение: API → Domain ← Infrastructure  

  - Запрещено:  

    - Вызов Infrastructure-сервисов напрямую из API слоя.  

    - Размещение бизнес-логики в контроллерах.  

    - Анемичные модели (если у модели нет методов - создай entity).  

- **DDD & Clean Architecture**:  

  - Строгие bounded contexts для доменных моделей.  

  - Пример