📼 Agentic Engineering: Подготовка репозитория для агента

Попробую сделать серию постов как бы я делал мобильное приложение в 2026. Как бы настраивал сразу рельсы для агентов: ревью, генерация, база знаний, эталоны.

Первая тема будет как подготовить iOS-репозиторий для AI-агента

Принято, что хороший AGENTS.md это не про "пиши чистый код и используй MVVM". Агенту нужны конкретные правила работы с проектом:

1. Карта репозитория. Где лежат фичи, домены, нетворк, хранилище и эталонный модуль.

2. Единые команды. Агент не должен угадывать схему и симулятор. Должны быть настройки запуска, теста и тп для бутстрапа

3. Архитектурные границы. Например шаблоны, принципы, паттерны.

4. Quality гейты. Это может быть SwiftFormat, линтер, билдер, тесты и проверка диффов. Если что-то не запускалось, агент обязан это явно указать. Должен быть полный прогон

5. Запретные зоны. Signing, энвы, миграции БД и всякие лишние сущности

6. Эталонные примеры. Нужно в стиле "новые фичи делай по образцу Features/Profile".

Главный критерий готовности: агент должен суметь понять проект, внести изменение и доказать его корректность без ручных действий в Xcode и устных знаний команды.

AGENTS.md только инструкция. Но агентная инфра уже начинается с воспроизводимых команд, тестов и CI.

Список эталонных примеров:
• Windscribe
• Официальный шаблон