Yasen — Product Artifacts (Discovery → Delivery)

Этот репозиторий — source of truth для продуктовых артефактов (discovery) и связок с delivery.

Принцип:

• Знание и доказательства (Goals / Hypotheses / Evidence / Steps / Decisions / Value Chain) — в Markdown в Git (через PR).
• Работа (Tasks) — в Forgejo Issues/Projects.

---

Структура

research/
  personas/        # персоны (P*) — кого обслуживаем
  evidence/        # факты/наблюдения (E*) — доказательства для гипотез
  hypotheses/      # гипотезы (H*) — проверяемые предположения о решении
  interviews/      # конспекты/цитаты/ссылки на записи
  materials/       # исходники (скрины, ссылки, выгрузки) — по возможности ссылками
  competitive_*/   # конкурентный анализ

value_chain/       # цепочка ценности (VC*) и capabilities с maturity/confidence

gist/
  goals/           # цели (G*) — зачем мы здесь
    G0_global.md   # ЕДИНЫЙ файл с навигацией по VC
  initiatives/     # инициативы (INIT-*) — значимые блоки работ (1-3 активных)
  steps/           # шаги (S*) — релиз/поставка/единица проверки

decisions/         # product ADR: что решили и почему

delivery/
  specs/           # эпики/спеки для реализации
  outcomes/        # post‑launch оценка эффекта

templates/         # шаблоны артефактов

---

Сущности и их назначение

Сущность	ID	Вопрос на который отвечает	Пример
Goal	G0	Зачем мы здесь?	"Заработать на оптимизации рекламы"
Persona	P-0001	Кого обслуживаем?	"Крупный WB-селлер, 8000+ SKU"
Evidence	E-0001	Что мы узнали?	"Менеджер тратит 2ч/день на перебор"
Hypothesis	H-0001	Что предполагаем сработает?	"Bulk сократит время в 2x"
Value Chain	VC1.C2	Что должен уметь продукт?	"Приоритизация по ущербу"
Initiative	INIT-001	Какой блок работ делаем?	"Валидация MVP"
Step	S-0001	Что поставляем?	"Triage dashboard"
Decision	ADR-0001	Почему так?	"Отказ от per-tenant provisioning"
Outcome	O-0001	Что узнали из релиза?	"Bulk работает, но нужен preview"

---

Связи между сущностями

Persona (P-*)──подтверждает──→ Hypothesis (H-*)
    │                               │
    │                               │ проверяется через
    │                               ↓
Evidence (E-*)──подтверждает──→ Step (S-*)
                                    │
                                    │ входит в
                                    ↓
                              Initiative (INIT-*)
                                    │
                                    │ двигает к
                                    ↓
Value Chain (VC*.C*)←──реализует── Goal (G0)

---

Шкалы оценки

Maturity (0–2) — зрелость реализации

• 0 — не реализовано
• 1 — есть, но ограничено (MVP/частично)
• 2 — хорошо работает, покрывает основные сценарии

Confidence (High/Medium/Low) — уверенность в ценности

• High — подтверждено evidence (цитаты, кейсы, числа)
• Medium — есть 1 источник, но остаются вопросы
• Low — гипотеза без надёжного подтверждения

Важно: Confidence ≠ "готовность фичи". Confidence = "мы уверены, что это нужно".

---

ID и cross-linking

Конвенция ID

• Goal: G0
• Persona: P-0001, P-0002…
• Evidence: E-0001, E-0002…
• Hypothesis: H-0001, H-0002…
• Value chain capability: VC1.C1, VC3.C2…
• Initiative: INIT-001, INIT-002…
• Step: S-0001, S-0002…
• Decision: ADR-0001…
• Outcome: O-0001…

Правило cross-linking

Каждый артефакт ссылается на:

• Upstream: откуда взяли (persona → evidence → hypothesis)
• Downstream: куда ведёт (hypothesis → initiative → steps → outcomes)

---

Где живут Tasks (Forgejo Issues)

Правило: issue создаётся в репозитории, где будет основной результат.

• Discovery-tasks (собрать evidence, уточнить hypothesis) → yasen-product-artifacts
• Delivery-tasks (код/инфра) → yasen или сервис-репозиторий

Связка:

• В Step: список ссылок на issues
• В issue: ссылка на Step

---

Рабочий процесс

1) Research → Evidence

1. Интервью/наблюдение → research/interviews/
2. Выделить факты/цитаты → research/evidence/E-*.md
3. Привязать к persona → P-*

2) Evidence → Hypothesis

1. Сформулировать предположение → research/hypotheses/H-*.md
2. Связать с evidence (за/против)
3. Оценить Impact/Effort/Confidence

3) Hypothesis → Initiative

1. Гипотеза с высоким Impact → инициатива
2. Определить scope (какие steps)
3. Зафиксировать success criteria

4) Initiative → Steps

1. Декомпозировать на deliverable-шаги
2. Каждый step = Thin Spec (что делаем, acceptance criteria, метрики)

5) Step → Tasks (Forgejo)

1. Завести issues
2. Реализовать
3. Поставить

6) Step → Outcome

1. Измерить эффект
2. Зафиксировать delivery/outcomes/O-*.md
3. Обновить Confidence гипотез

---

Рекомендуемые labels в Forgejo

• type:task, type:bug, type:research
• stage:discovery, stage:delivery
• init:INIT-001 (какой инициативе принадлежит)
• vc:VC3.C2 (какую capability двигает)