Артефакт уменьшает потерю контекста
Встреча заканчивается, а решение должно остаться доступным. Артефакт не обязан быть большим документом: это может быть таблица, прототип, схема или запись решения. Его ценность в использовании.
Файл без потребителя и обновления является ритуалом. Уточните, кто читает и какое действие выполняет.
Discovery
| Артефакт | Потребитель | Критерий |
|---|---|---|
| Карта целей | Владелец продукта | Цели связаны с действиями и метриками |
| Реестр требований | Дизайн, разработка, QA | Есть приоритет и источник |
| Риск-реестр | Менеджер и спонсор | Есть владелец и действие |
| Scope релиза | Вся команда | Включённое и исключённое ясны |
UX и архитектура
- Карта сайта и URL.
- Модель типов контента и связей.
- Пользовательские потоки.
- Прототипы ключевых шаблонов.
- Матрица состояний.
Карта без владельцев контента неполна, а прототип без ошибки формы не описывает весь сценарий.
Дизайн
Передаются визуальная концепция, токены, компоненты, варианты, адаптивные шаблоны и спецификация поведения. Включите длинный контент, пустые данные, ошибку, загрузку и фокус.
Статический скрин не объясняет, что происходит после клика. Критический интерактив получает прототип или текстовое правило.
Разработка
- Репозиторий и правила веток.
- Контракты API и модели данных.
- Конфигурация окружений без секретов.
- Миграции базы и импорт.
- Автоматические проверки.
- Короткие архитектурные решения.
Документация должна позволить воспроизвести важную операцию другой командой.
Контент
| Артефакт | Что содержит |
|---|---|
| Контент-матрица | Страницы, владелец, статус, срок |
| Шаблон материала | Поля, требования, примеры |
| Медиа-реестр | Файл, право, alt, формат |
| SEO-карта | Интент, H1, Title, URL, связи |
| Карта миграции | Старый URL, новый URL, действие |
QA и приёмка
Требования связываются с тестами. Отчёт содержит окружение, версию, статус, блокирующие дефекты и известные ограничения. Скриншот ошибки без шагов не является полноценным дефектом.
- Тест-план и матрица.
- Тестовые данные.
- Реестр дефектов.
- Отчёт регресса.
- Протокол пользовательской приёмки.
Запуск
- Runbook переключения.
- План отката.
- Резервная копия и проверка.
- Карта DNS, HTTPS и редиректов.
- Smoke-чек-лист.
- Контакты дежурных.
- План мониторинга первых дней.
Передача
Реестр доступов, лицензий, исходников, дизайна, данных и документации сопровождается актом. Инструкция редактора и эксплуатации проверяется контрольной операцией. Известный технический долг передаётся явно.
Версионирование и решения
У артефакта есть дата, версия, статус и владелец. Утверждённая версия не переписывается без истории. Короткая запись решения содержит контекст, варианты, выбор и последствия.
Не храните единственную истину одновременно в чате, таблице и макете. Определите профильное место и ставьте ссылки.
Минимальный пакет по масштабу
Лендинг может объединить цели, требования и структуру в одном документе, но не пропустить смысл. Каталог потребует отдельной модели данных и импорта. Кабинет: роли, безопасность, API и операционные инструкции.
Самопроверка
- У каждого файла есть потребитель.
- Понятно, кто утверждает.
- Версия связана с реализацией.
- Открытые вопросы видны.
- Артефакт помогает проверить результат.
- Нет документа ради процесса.
Правильный набор не максимален. Он достаточен, чтобы команда принимала решения, передавала работу и воспроизводила запуск без устных догадок.
Как связать артефакты между собой
Артефакты образуют цепочку доказательств: цель связывается со сценарием, сценарий — с экраном, экран — с компонентом, компонент — с задачей разработки, а задача — с тестом. Если связь теряется, команда может качественно изготовить элемент, который не решает исходную задачу.
Используйте устойчивые идентификаторы и версионность. В протоколе решения указывайте, какие страницы, требования и критерии оно изменяет. Это позволяет обновлять документы выборочно, видеть последствия правки и не поддерживать несколько противоречащих копий.