# Лабораторная 01: ИНИЦИАЦИЯ ПРОЕКТА

> Спринт 1 · Недели 1–2 · 14 дней · 10 баллов

**Вопрос спринта:** Какую проблему решаем?

Выбрать сегмент, понять его боли, договориться о словах и заложить фундамент: к концу спринта у команды общий язык, проверяемые гипотезы, работающий CI и прод с заглушкой.

## Формат сдачи

- Pull Request от каждой роли
- Ветка: `lab1-[role]-initiation`
- Заголовок PR: `Lab1: [Role] — Initiation Deliverables`

## Роли и шаги

### PRODUCT / VO — Сегмент, боли, общий язык и картинка результата

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

#### Шаг 1. Сегмент и боли (4–6 часов)

_Продукт без конкретного сегмента — продукт ни для кого._

- Выбрать один сегмент ЦА (узкий лучше широкого)
- Сформулировать 3–5 болей с обстоятельствами: когда и при чём болит
- Связать боли с возможностями команды

**Сдаёшь:** PRD: сегмент, боли, North Star [документ] → `docs/prd.md`

#### Шаг 2. Гипотезы (3–4 часа)

_Гипотеза без условия опровержения — лозунг, а не гипотеза._

- 3–5 гипотез в форме «мы считаем, что <сегмент> …; это неверно, если …»
- План проверки: кого спросим и какой ответ убьёт гипотезу

**Сдаёшь:** Фальсифицируемые гипотезы [документ] → `docs/hypotheses.md`

#### Шаг 3. Проблемные интервью (4–6 часов) ⭐ (бонус, не блокирует сдачу)

_Живые ответы бьют любые предположения — и синтетических респондентов._

- 3–5 интервью по Mom Test: про прошлое поведение, не про «нравится ли идея»
- Респонденты — другие команды курса: для студенческих тем это валидная ЦА
- Зафиксировать: что подтвердилось, что опровергнуто, что меняем

**Сдаёшь:** Инсайты интервью [документ] → `docs/insights.md`

#### Шаг 4. Глоссарий команды (2–3 часа)

_Словарь, как в DDD: термин звучит одинаково у всех — и у агентов._

- 15–30 терминов предметной области с определениями
- Согласовать вслух со всей командой
- Глоссарий живёт и пополняется весь курс

**Сдаёшь:** Глоссарий [документ] → `docs/glossary.md`

#### Шаг 5. Бриф итоговой картинки (2–3 часа)

_Одна страница о том, какой мир вы построите к декабрю._

- North Star в нарративной форме: что происходит, когда продукт работает
- Читается за 2 минуты
- Финал шага — презентация «Я понял проект как…» от каждого

**Сдаёшь:** Бриф «итоговая картинка» [документ] → `docs/brief.md`

**Советы:** Боль ищи в обстоятельствах, а не в демографии · Узкий сегмент проверяется, широкий — нет · Интервью — про прошлое поведение, не про мнения · Презентацию строй от боли, а не от фичи

### AI ENGINEER — Ресёрч, кандидаты моделей и первые эксперименты

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

#### Шаг 1. Ресёрч воронкой (4–6 часов)

_Узкий → широкий → узкий: сначала актуальность, потом аналоги, потом детали для решения._

- Узкий: жива ли проблема, кто её уже решает
- Широкий: аналоги, подходы, готовые решения — можно агентами
- Узкий: детали для выбора подхода
- Каждый вывод — со ссылкой; источники проверены руками

**Сдаёшь:** Ресёрч с верифицированными источниками [документ] → `docs/research.md`

#### Шаг 2. Кандидаты моделей и бюджет (3–4 часа)

_Токены кончаются быстрее, чем кажется, — считать надо до старта._

- 2–3 кандидата LLM: облако / российские / локальные
- Оценка стоимости одного сценария использования в токенах
- Лимиты и деградация: что делаем, когда бюджет кончился

**Сдаёшь:** Кандидаты моделей и токен-бюджет [документ] → `docs/model-candidates.md`

#### Шаг 3. Первые эксперименты (4–6 часов)

_Спайк на полдня даёт больше уверенности, чем неделя раздумий._

- Ноутбук с пробами промптов на 5–10 примерах из болей сегмента
- Что получилось, что нет — честно
- Черновой вывод: какой подход выглядит рабочим

**Сдаёшь:** Ноутбук первых экспериментов [ноутбук] → `notebooks/first_experiments.ipynb`

#### Шаг 4. ADR: выбор подхода (2–3 часа)

_Каждое решение — с понятной ценой, иначе долг неуправляем._

- Решение: прямые промпты / RAG / агент — и почему
- Альтернативы и причины отказа
- Обязательное поле «Цена решения»: какой долг берём

**Сдаёшь:** ADR-001 «Выбор подхода» [документ] → `docs/adr/001-approach.md`

**Советы:** Источник без ссылки не существует · Начни с самой простой модели, которая может сработать · Считай токены до того, как они кончатся · Эксперимент, который провалился, — тоже результат

### DELIVERY — Репозиторий, окружение, CI и прод с первой недели

Отвечает за то, что сделанное командой доезжает до прода. Принцип: прод существует с первой недели — дальше он только наращивается.

#### Шаг 1. Каркас репозитория (3–4 часа)

_Хорошая структура репо — это карта проекта для людей и агентов._

- Структура папок: docs/, backend/, frontend/, ml/, notebooks/
- README-скелет: что за проект, как поднять, кто в команде
- Шаблон PR и правила веток

**Сдаёшь:** Каркас репо с README [код] → `README.md + структура репозитория`

#### Шаг 2. Dev-окружение (3–4 часа)

_«Работает у меня» лечится одним compose-файлом._

- compose.dev.yml с заглушками сервисов
- .env.example со всеми переменными
- Подъём окружения — одна команда, меньше 10 минут

**Сдаёшь:** Dev-окружение [конфиг] → `compose.dev.yml + .env.example`

#### Шаг 3. CI-скелет (3–4 часа)

_Зелёный CI на пустом проекте — фундамент, на который встанет всё._

- Workflow на PR: lint, format, build
- Бейдж статуса в README
- CI обязателен для мёржа

**Сдаёшь:** CI-пайплайн [конфиг] → `.github/workflows/ci.yml`

#### Шаг 4. Hello-world в прод (3–4 часа)

_Прод с недели 1: стена интеграции ломается, пока она маленькая._

- Заглушка приложения задеплоена на хостинг
- Публичный URL открывается у любого члена команды
- Как деплоить — задокументировано

**Сдаёшь:** Работающий прод-URL [прод-URL] → `docs/deploy.md + URL в README`

**Советы:** Прод с первой недели — потом только наращиваешь · Окружение дольше 10 минут — это баг · Секреты в .env, .env — в .gitignore · Агент разворачивает проект по твоему README — проверь

### QUALITY & SAFETY — Критерии успеха, метрики и план датасета

Отвечает за то, что «работает» — это измеренный факт, а не ощущение. Evals-first: сначала договариваемся, как меряем, потом строим.

#### Шаг 1. Критерии успеха (3–4 часа)

_Критерий успеха пишется до кода — иначе успех назначается задним числом._

- Для каждой боли из PRD: что значит «продукт её решает»
- Каждый критерий измерим: число + способ подсчёта
- Согласовано с Product/VO

**Сдаёшь:** Критерии успеха продукта [документ] → `docs/quality/success-criteria.md`

#### Шаг 2. Метрики качества (3–4 часа)

_Метрика без способа подсчёта — пожелание._

- Качество ответов: как оцениваем (точность, полнота, тон)
- Инженерные: латентность, стоимость запроса
- Что меряем с лабы 3 автоматически

**Сдаёшь:** Карта метрик [документ] → `docs/quality/metrics.md`

#### Шаг 3. План golden dataset (3–4 часа)

_Эталонные примеры — топливо для evals; без плана их не соберёшь._

- Источник примеров: откуда возьмём 30–50 пар вход→эталон
- Формат записи и владелец датасета
- Первые 10 примеров — прямо сейчас, из болей сегмента

**Сдаёшь:** План golden dataset + первые примеры [документ] → `docs/quality/golden-dataset-plan.md`

#### Шаг 4. Черновик DoD команды (2–3 часа)

_DoD — спека для автопроверки: что проверит judge, решаете вы._

- Черновые DoD-критерии артефактов команды к лабе 2
- Каждый критерий проверяем: есть/нет, число, ссылка
- Согласовано с командой

**Сдаёшь:** Черновик DoD [документ] → `docs/quality/dod-draft.md`

**Советы:** Критерий успеха пишется до кода · Golden dataset начинается с 10 примеров, а не с идеала · Метрика без способа подсчёта — пожелание · DoD — это спека для автопроверки

## Definition of Done

Те же критерии видит автопроверка. Лаба сдана, когда выполнены все группы.

### Продукт

- [ ] PRD содержит сегмент, ≥3 боли с обстоятельствами и North Star с целевым значением
- [ ] glossary.md: ≥15 терминов, у каждого — определение
- [ ] brief.md — одна страница, читается за 2 минуты
- [ ] Каждая гипотеза в hypotheses.md имеет условие опровержения

### Инженерия

- [ ] Репозиторий соответствует структуре, описанной в README
- [ ] docker compose -f compose.dev.yml up поднимается без ошибок
- [ ] CI зелёный на открытом PR
- [ ] Hello-world доступен по публичному URL из README

### Качество и ресёрч

- [ ] Каждый вывод research.md подкреплён ссылкой на источник
- [ ] Каждый критерий успеха измерим: число + способ подсчёта
- [ ] План golden dataset называет источник, формат и объём; есть ≥10 примеров
- [ ] ADR-001 содержит заполненное поле «Цена решения»

## Чек-лист перед PR

### Продукт и ресёрч

- [ ] PRD прочитан всей командой
- [ ] Термины глоссария согласованы вслух
- [ ] Каждая гипотеза фальсифицируема
- [ ] Выводы ресёрча имеют проверенные ссылки
- [ ] Бриф читается за 2 минуты
- [ ] Готова презентация «Я понял проект как…»

### Инженерия и качество

- [ ] Репо клонируется и поднимается по README
- [ ] CI проходит на открытом PR
- [ ] Hello-world открывается по публичному URL
- [ ] Критерии успеха измеримы
- [ ] Есть первые 10 примеров golden dataset
- [ ] ADR-001 — с ценой решения

## Материалы к лабе

- [РАБОТА С АГЕНТОМ](/materials/agent/workflow) — Цикл агентной разработки
- [USE CASES](/materials/use-cases/writing) — Формат и проживаемость
- [ОЦЕНИВАНИЕ](/materials/labs/grading-system) — Как считаются баллы
- [ВСЕ МАТЕРИАЛЫ](/materials) — База материалов курса

---

_К концу спринта у команды есть общий язык, проверяемые гипотезы, работающий CI и прод с заглушкой. Это фундамент, на котором стоит весь семестр._

Человеческая версия: /labs/lab1