Source map для системного аналитика: как собрать System Context Pack за час

К вам приходит задача: продуктовая команда собрала POC интеграции с внешним провайдером год назад, теперь нужно вывести его в production. Провайдер выпустил новую версию API, часть договоренностей лежит в почте PM, автор POC уволился, а Confluence-страница написана до релиза новой версии.

К концу дня у аналитика часто есть примерная картина в голове, но структурировано только частично. Через месяц разработчик спрашивает: «А почему Idempotency-Key не передается?» — и начинается повторный поиск по PDF, письмам и коду.

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

Метод называется System Context Pack. На практике это связка из четырех последовательных артефактов.

Метод не про AI. Его можно вести руками в Confluence-таблицах и Markdown-файлах. AI ускоряет сборку, но методологический слой первичен.

Продуктовая команда год назад собрала POC с эквайрингом Acme Pay на v1 API. К июлю 2026 нужен production-релиз. За это время Acme выпустил v2.1, поменял auth-схему, сделал Idempotency-Key и customer_id обязательными, добавил webhook signature и новые способы оплаты.

В наследство у аналитика четыре источника: PDF официального контракта v2.1, Confluence-страница «Acme Pay v1», репозиторий POC и email-тред с account manager Acme. Их можно скачать одним архивом: klub-2026-06-28-acme-pay-inputs.zip.

Первое действие — таблица источников. Пять столбцов, ничего лишнего.

Статус — обязательное поле. S02 устарел, но не выбрасывается: там есть контакты, дизайн-решения предыдущей команды и история компромиссов. Он не мусор, он архив.

SCP — markdown-файл с блоками по функциональным областям: authentication, создание платежа, webhooks, rate limits, chargebacks, PCI, валюты, tokenization, Apple Pay / SBP, sunset v1.

## 1. Authentication

### 1.2 Auth token lifetime — конфликт источников

Утверждение: Auth token действует 4 часа.

Источники в конфликте:
- S01 §2.1: "expires_in": 86400 (24 часа).
- S04 письмо Сергея 11.03: "Auth token lifetime изменили
  с 24 часов до 4 часов с релиза 2.1".

Resolution: запросить письменное подтверждение Acme.
Передано как RF-01.

Каждое утверждение — отдельный блок. «Источник» — не общее «см. PDF», а конкретное место: S01 §2.1, письмо от 11.03 или файл в Git.

Каждый маркер противоречия в SCP порождает запись в Review Findings. По кейсу Acme Pay вышло 10 находок, пять из них — HIGH severity, то есть blockers для production.

Аналитик не обязан единолично выбирать правду. Его задача — показать источники, классифицировать противоречие и принести PM и tech lead конкретный список решений.

Task Pack — заготовка постановки для PM и разработки. В него входят scope, requirements с цитатами, non-functional requirements, open questions, risks, assumptions и acceptance criteria.

• Какой максимальный срок жизни checkout session устраивает бизнес?
• Кто отвечает за PCI compliance процедурно?
• Какие валюты включаем в текущую итерацию?
• Что делаем при недоступности Acme: ручной fallback или автоматика?
• Можно ли получить письменное подтверждение auth token lifetime за неделю?

Это вопросы, которые нельзя выудить ни из PDF, ни из Confluence, ни из POC. Они живут на пересечении бизнес-контекста и технического решения.

На руках: Source map, SCP на 10 функциональных областей, Review Findings с 10 находками и Task Pack draft. Не сняты open questions, не проведен sanity check с tech lead, не согласованы scope и estimation — это следующая работа.

Часовой Task Pack — не финальный документ. Это фундамент, стоя на котором можно вести разговоры без иллюзии, что информация уже полностью есть.

Подмастерье аналитика берет на себя механическую часть: локальную индексацию источников, первичный черновик SCP, обнаружение противоречий и approval gate перед отправкой фрагментов во внешнюю модель.

Оно не принимает решения по противоречиям, не пишет финальную постановку и не заменяет диалог с PM и разработкой. Экономия времени появляется только если у вас уже есть метод и критерии проверки.

1. Начинайте с source map.
2. Каждое утверждение фиксируйте с явной цитатой источника.
3. Противоречия не сглаживайте, а выносите в Review Findings.
4. Open questions собирайте отдельно.
5. Не пишите SDD на всякий случай: Task Pack на 5 страниц с цитатами полезнее 30 страниц без них.