ADR — что это и зачем

Что это

ADR = Architecture Decision Record. Immutable-запись одного важного решения. Создаётся в момент принятия, потом не редактируется — только superseded-ится новым ADR если решение пересматривается.

Зачем нужно: через 6–12 месяцев новый член команды (или сам Jean) открывает эту папку и за час понимает почему проект устроен именно так. Без ADR решения живут в головах и теряются.

Формат

Используется MADR-like (Markdown ADR). Шаблон — ADR-template.md.

Каждый ADR имеет:

• Number (4-значный, начинается с 0001)
• Slug в имени файла: ADR-XXXX-short-decision-slug.md
• Status: Proposed / Accepted / Deprecated / Superseded-by-ADR-YYYY
• Deciders: кто принял решение (Jean + участники)
• Date в формате YYYY-MM-DD
• Context: что мы знаем, почему вопрос возник
• Decision: что решили (конкретно)
• Consequences: что это значит, что теперь делаем и не делаем
• Alternatives considered: что обсуждалось и почему не выбрали
• Related: ссылки на SOT, другие ADR, связанные спеки

Когда создавать ADR

• Создать: решение затрагивает несколько систем, меняет canonical doc, вводит новое правило, или может быть пересмотрено позже.
• Не создавать: мелкая правка одного файла, bug-fix, типографская правка, ежедневные решения в рамках существующих правил.

Типичные триггеры для ADR:

• «Выбрали стек X vs Y» (Netcode vs Mirror, Qwen3-Omni vs PersonaPlex)
• «Решили что MVP делает / не делает» (lootbox — earned-only, co-op — post-MVP)
• «Зафиксировали архитектурный принцип» (matrix orthogonal, level=quarter)
• «Приняли бизнес-решение» (Qtoys 40/60, Astana-Hub-first, V3 51,24 M)

Процесс

1. Автор (Jean или AI sub-сессия) создаёт ADR со статусом Proposed.
2. Автор ставит флаг DISCUSS с Jean (если автор не Jean).
3. Jean review — approve / request changes / reject.
4. После approval статус меняется на Accepted, date фиксируется.
5. SOT обновляется — в matrix добавляется ADR-ссылка + новый статус LOCKED.
6. ADR никогда не редактируется после Accepted. Только новый ADR может Supersede старый.

Index

№	Slug	Status	Date	Кратко
0001	world-design-v1-adopted	Accepted	2026-04-19	Принят world-design spec v1.0 как canonical для нарратива / хаба / фаз / биомов / прогрессии
0002	twelve-canonical-mechanics-mvp	Accepted	2026-04-19	MVP scope = 12 канон. механик. Расширенный пул 25 — STALE
0003	matrix-orthogonal-architecture	Accepted	2026-04-19	mech × biome × subject orthogonal. Unity код следует role-abstraction
0004	level-equals-school-quarter	Accepted	2026-04-19	Level = (class-1)*4 + quarter. MVP 16 уровней, post-MVP 44
0005	garysh-baza-orbital-hub	Accepted	2026-04-19	Ғарыш-база = орбитальная станция над Пішіндер-Әлемі, не планета
0006	horizontal-landscape-orientation	Accepted	2026-04-07	Игра — landscape. Лендинг — отдельный portrait web
0007	single-currency-plus-premium-no-p2w	Accepted	2026-04-19	Монеты (earned) + Кристаллы (premium IAP). Только косметика, no pay-to-win, no mode-lock
0008	v3-contract-5124m-anchor	Accepted	2026-04-22	V3 dev contract = 51,24 M ₸ (Jean × Ирлен × Кенжебаев), anchor line в Astana Hub 103,7 M
0009	gitex-2026-cancelled	Accepted	2026-04-22	GITEX 4-5 May 2026 снят с roadmap. Bracelet idёт в спокойном темпе
0010	astana-hub-first-priority	Accepted	2026-04-22	Подача в Astana Hub residency = critical path. VC / Danone / grants — после S4 business plan
0011	session-decomposition-methodology	Accepted	2026-04-22	5-step macro-flow + параллельные S1-a..g deepen-сессии. 13 self-contained prompts
0012	tokenomics-deferred-year-2	Accepted	2026-04-22	Токеномика вне MVP scope. Пересматриваем в Year 2+ только если base economy валидирована