# Методология

Начните с одного полезного сценария.\
Расширяйте применение, когда увидите результат.

Выберите небольшой участок работы для Umbra, проверьте пользу для команды и решите, куда двигаться дальше. У каждой команды может быть свой маршрут.

Карта AI SDLC Плавное внедрение Сценарии Контроль Оценка эффекта

## Карта AI SDLC

AI SDLC — жизненный цикл разработки с применением ИИ: от исследования проблемы до измеренного эффекта. Umbra можно поручать отдельные участки этого пути.

1. **Исследование** Какую проблему решаем?
2. **Определение** Что и зачем делаем?
3. **Проектирование** Как устроено решение?
4. **Реализация** Как воплотить решение?
5. **Проверка** Соответствует ли результат задаче?
6. **Развёртывание** Как доставить изменение?
7. **Эксплуатация и выводы** Какой эффект получили?

Факты из эксплуатации возвращаются в исследование и помогают выбрать следующую задачу.

## Плавное внедрение

Расширяйте набор сценариев внутри команды или переносите удачный сценарий в другие команды. Оба направления можно сочетать.

С какой задачи начать

Ревью кода Проектирование фичи Декомпозиция бизнес-задачи

Варианты расширения

Первый сценарий Связанные сценарии Другие команды Компания

### Карта охвата

Пример внедрения

Одна команда пробует один полезный сценарий. Рядом обозначена возможность расширения — её можно рассмотреть после оценки результата.

Выберите сценарий на карте. В описании под ней — вход, результат, ответственный и оценка пользы.

**Управление** Приоритеты · ответственность · допустимые действия · бюджет

Первый сценарий. Этапы жизненного цикла и сценарии условных команд. Выберите сценарий, чтобы прочитать о нём под картой.

| Команды / этапы | Исследование | Определение | Проектирование | Реализация | Проверка | Развёртывание | Эксплуатация и выводы |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Команда А | Без сценария в этом примере | Определение Декомпозиция Возможно | Без сценария в этом примере | Без сценария в этом примере | Проверка Ревью Применяется | Без сценария в этом примере | Без сценария в этом примере |

Выбранный сценарий: **Ревью кода**

К описанию сценария

**Среда** Контекст проекта · инструменты · проверки · история и расходы

Применяется в примере Возможное расширение Остальной процесс

Подсвечен отдельный сценарий, а не весь этап. Полное заполнение карты не является целью.

Выбранный сценарий

### Ревью кода

Дать команде дополнительную проверку конкретного изменения перед его принятием.

- **Что нужно на входе**: Изменения кода, контекст задачи, правила проекта и критерии проверки.
- **Что получает команда**: Замечания с указанием места, обоснованием и способом проверить проблему.
- **Кто принимает результат**: Разработчик или ревьюер проверяет замечания и принимает решение об изменении.
- **Как оценить пользу**: Какие замечания оказались полезными, сколько было ложных срабатываний и сколько времени заняла проверка.

Это примеры применения, а не каталог готовых процессов. Связь сценариев означает передачу принятых результатов; автоматический запуск следующего процесса из неё не следует.

## Одна задача — полезный результат

Начальная точка зависит от потребности команды. «Один шаг» для команды может включать несколько действий, проверок и попыток внутри процесса.

### Ревью кода

Дать команде дополнительную проверку конкретного изменения перед его принятием.

Показать на карте

### Проектирование фичи

Подготовить решение, которое команда сможет обсудить до начала реализации.

Показать на карте

### Декомпозиция бизнес-задачи

Превратить бизнес-цель в понятные участки работы для команды.

Показать на карте

## Контроль и ответственность

Охват применения и автономность — разные характеристики. Добавление сценария или команды само по себе не расширяет полномочия машины.

### До запуска

Человек задаёт цель, контекст, границы работы, бюджет и критерии проверки.

### Внутри процесса

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

### После результата

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

Вопрос человеку или исчерпание предела останавливает продвижение. Непринятый результат не объявляется готовым.

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

Сначала сравните несколько сопоставимых задач с привычным способом работы. Учитывайте проверку и доработки, а не только время генерации.

- **Качество проверяемо**: Есть критерии приёмки; команда понимает, какие ошибки и пропуски остались.
- **Польза повторяется**: Результат помогает на нескольких задачах, а объём ручных уточнений и переделок понятен.
- **Затраты понятны**: Учитываются расходы на прогон и время людей на подготовку, проверку и доработку.
- **Ответственность определена**: Известно, кто задаёт рамки, принимает результат и решает, стоит ли продолжать.

### Пример первого пилота: ревью кода

Команда хочет проверить, помогает ли дополнительное ревью находить полезные замечания. Это пример плана проверки, а не готовый процесс Umbra.

1. **Выберите изменение.** Подготовьте код, контекст задачи, правила проекта и критерии проверки.
2. **Назначьте ответственного.** Ревьюер проверяет замечания и решает, какие из них требуют исправления.
3. **Сравните с привычным ревью.** Отметьте полезные замечания и ложные срабатывания. Учтите расходы на прогон и время людей на подготовку, проверку и доработку.
4. **Примите решение.** Повторите сравнение на сопоставимых изменениях. Если польза повторяется, выберите следующий сценарий или другую команду для пилота.

Выберите следующий полезный участок.\
**Больше сценариев в команде или больше команд со знакомым сценарием.**

Вернуться к карте
