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

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

**Вопрос спринта:** Как оценить чужой проект?

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

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

- Pull Request от каждой роли
- Ветка: `lab7-[role]-review`
- Заголовок PR: `Lab7: [Role] — Review Deliverables`

## Роли и шаги

### PRODUCT / VO — Ревью продукта и пакет для галереи

Отвечает за продуктовое ревью чужого проекта — и за то, что собственный проект красиво остаётся в истории курса.

#### Шаг 1. Ревью продуктовой части (4–5 часов)

_Смотреть чужие PRD и UC — быстрый способ улучшить свои._

- Сегмент и боли: правдоподобны ли, проверялись ли
- UC: проживаются ли по собственному критерию команды
- North Star: измерена ли тем способом, что записан

**Сдаёшь:** Продуктовая рецензия [документ] → `reviews/[team]/product-review.md`

#### Шаг 2. «Что бы я сделал иначе» (2–3 часа)

_Рецензия без альтернативы — просто мнение._

- 2–3 конкретных решения, которые принял бы иначе
- С обоснованием и ценой каждого

**Сдаёшь:** Альтернативные решения [документ] → `reviews/[team]/alternatives.md`

#### Шаг 3. Пакет для галереи выпуска (3–4 часа)

_Проект попадает в галерею сайта — это витрина и портфолио команды._

- Описание проекта по формату галереи
- Скриншоты с прода, ссылки на репо и демо
- Команда, роли, метрики — актуальные

**Сдаёшь:** Пакет для галереи [документ] → `docs/gallery-submission.md`

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

_Курс заканчивается выводами, а не последним коммитом._

- Что повторили бы, что никогда больше
- Главный урок каждой роли — по одному

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

**Советы:** Хвали конкретно, критикуй конструктивно · Альтернатива с ценой — вклад, а не наезд · Галерея — твоё портфолио на годы · Ретро пишется честно или не пишется

### AI ENGINEER — Ревью чужого AI-пайплайна

Отвечает за техническое ревью чужой AI-части: обоснованность решений, качество промптов, честность метрик.

#### Шаг 1. Ревью AI-пайплайна (4–5 часов)

_Чужой пайплайн — источник приёмов, до которых сам не додумался._

- Архитектура пайплайна против их ADR: сходится ли
- Промпты: находки и слабости
- Цена решений: оправдана ли выбранная модель

**Сдаёшь:** AI-рецензия [документ] → `reviews/[team]/ai-review.md`

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

_Метрика, которую нельзя воспроизвести, — не метрика._

- Воспроизвести финальные цифры по их документации
- Расхождения — зафиксировать без злорадства

**Сдаёшь:** Протокол воспроизведения метрик [документ] → `reviews/[team]/metrics-check.md`

#### Шаг 3. Разбор ablation (2–3 часа)

_Чужой ablation показывает, что реально двигает качество._

- Что дало прирост у них против вашего проекта
- Приём, который заберёшь себе, — минимум один

**Сдаёшь:** Разбор находок [документ] → `reviews/[team]/ablation-notes.md`

#### Шаг 4. Документация промптов — финал (2–3 часа)

_Свой проект тоже должен остаться воспроизводимым._

- Финальная версия документации AI-части
- Метрики воспроизводятся по шагам из доки

**Сдаёшь:** Финальная AI-документация [документ] → `docs/ml-documentation.md`

**Советы:** Ищи приёмы, а не только ошибки · Воспроизводи по их доке, не по догадкам · Расхождение метрик — вопрос, не приговор · Один украденный приём окупает всю лабу

### DELIVERY — Жёсткий тест воспроизводимости

Отвечает за главный экзамен чужой инфраструктуры: проект разворачивается по README на чистой машине — или нет.

#### Шаг 1. Развернуть по README (4–6 часов)

_README, по которому нельзя подняться, — художественная литература._

- Чистое окружение, только их README
- Каждый затык — с точным местом и ошибкой
- Время до работающей системы — засечь

**Сдаёшь:** Протокол развёртывания [документ] → `reviews/[team]/deploy-check.md`

#### Шаг 2. Ревью инфраструктуры (3–4 часа)

_Чужие compose и CI — учебник удачных и неудачных решений._

- Compose, CI/CD, мониторинг: что устроено умно
- Лимиты и деградация: есть ли, работают ли

**Сдаёшь:** Инфра-рецензия [документ] → `reviews/[team]/infra-review.md`

#### Шаг 3. PR с фиксом README (1–2 часа)

_Лучшая рецензия — та, что чинит._

- Найденные затыки — правками в их README
- PR в их репозиторий, вежливый и конкретный

**Сдаёшь:** PR с фиксами [прод-URL] → `ссылка на PR в reviews/[team]/`

#### Шаг 4. Финальный тег и архив (2–3 часа)

_Свой проект замораживается воспроизводимым — навсегда._

- Финальный релизный тег курса
- Прод живёт до конца семестра
- Инструкция «поднять через год» проверена

**Сдаёшь:** Финальный релиз [конфиг] → `git tag final + README`

**Советы:** Чистая машина не прощает «у меня работало» · Засечённое время развёртывания — метрика зрелости · PR-фикс запомнят лучше любой рецензии · Проект, который поднимется через год, — редкость и гордость

### QUALITY & SAFETY — Чужие evals и последний red team

Отвечает за независимую проверку чужого качества: прогнать их evals, атаковать их продукт, сверить заявленное с фактическим.

#### Шаг 1. Прогнать чужие evals (4–5 часов)

_Заявленные метрики проверяются чужими руками — это и есть независимость._

- Их golden dataset через их прогон — на их релизном теге
- Сверка с цифрами из их отчёта качества
- Качество самого датасета: честные ли эталоны

**Сдаёшь:** Независимый eval-прогон [документ] → `reviews/[team]/evals-check.md`

#### Шаг 2. Red team чужого продукта (4–5 часов)

_Свежий взгляд находит дыры, к которым команда привыкла._

- Prompt injection по их точкам входа
- Сверка с их threat model: что они не учли
- Этика: только их прод, только письменно

**Сдаёшь:** Отчёт red team [документ] → `reviews/[team]/redteam-report.md`

#### Шаг 3. Ревью quality-практик (2–3 часа)

_Чужие quality-gates — зеркало для своих._

- Их DoD, пороги в CI, регрессия: что перенять
- Практика, которую заберёшь в следующий проект

**Сдаёшь:** Рецензия quality-практик [документ] → `reviews/[team]/quality-review.md`

#### Шаг 4. Финальный отчёт качества курса (2–3 часа)

_Своя история качества закрывается последней точкой._

- Сводка: качество и безопасность за весь курс
- Что нашли рецензенты у вас — с ответами

**Сдаёшь:** Закрывающий quality-отчёт [документ] → `docs/quality/course-final.md`

**Советы:** Прогоняй на их теге, не на их main · Дыра в чужом — урок для своего · Red team — письменно и уважительно · Плохой эталон в их датасете — тоже находка

## Definition of Done

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

### Рецензии

- [ ] Все четыре ролевых рецензии сданы по рубрике
- [ ] Каждое замечание — с местом, примером и предложением
- [ ] Блок «что бы сделал иначе» — с ценой альтернатив
- [ ] PR с фиксом README отправлен рецензируемой команде

### Независимая проверка

- [ ] Чужой проект развёрнут по README, затыки запротоколированы
- [ ] Чужие evals прогнаны на их релизном теге, сверка с отчётом
- [ ] Red team проведён по их точкам входа письменно
- [ ] Расхождения заявленного и фактического зафиксированы

### Наследие

- [ ] Пакет для галереи выпуска собран по формату
- [ ] Финальный тег: проект поднимается по README на чистой машине
- [ ] Ретроспектива команды написана
- [ ] Закрывающий quality-отчёт сведён

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

### Чужой проект

- [ ] Развернул по их README на чистой машине
- [ ] Прогнал их evals на их теге
- [ ] Провёл red team их прода
- [ ] Сдал рецензию своей дисциплины
- [ ] Предложил альтернативы с ценой
- [ ] Отправил PR с фиксом README

### Свой проект

- [ ] Пакет для галереи готов
- [ ] Финальный тег зафиксирован
- [ ] Ответили на находки рецензентов
- [ ] Ретроспектива проведена
- [ ] Закрывающий отчёт качества сведён
- [ ] Прод доживёт до конца семестра

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

- [AACT](/materials/architecture/aact) — Чем мерить чужую архитектуру
- [USE CASES](/materials/use-cases/writing) — По чему судить требования
- [ОЦЕНИВАНИЕ](/materials/labs/grading-system) — Как считаются баллы
- [ВСЕ МАТЕРИАЛЫ](/materials) — База материалов курса

---

_Курс закрывается насмотренностью: вы увидели, как ту же задачу решили другие, проверили их цифры своими руками — и оставили свой проект в галерее выпуска._

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