Add OpenSpec system specification

openspec/changes/cherrypick-system-spec/design.md

@@ -0,0 +1,40 @@
+## Context
+
+CherryPick — монорепозиторий DI‑экосистемы для Dart/Flutter, включающий ядро рантайма, аннотации, генератор и Flutter‑интеграцию, а также адаптер логирования для Talker. Требуется системная спецификация модулей и их контрактов на русском языке.
+
+## Goals / Non-Goals
+
+**Goals:**
+- Зафиксировать архитектурные границы и контракты модулей.
+- Согласовать терминологию и жизненные циклы ключевых сущностей.
+- Дать проверяемые требования с однозначными сценариями.
+
+**Non-Goals:**
+- Изменение или рефакторинг кода.
+- Детализация низкоуровневых алгоритмов генератора.
+- Документация внешних библиотек (Flutter, Talker).
+
+## Decisions
+
+- Разбить спецификацию по четырем capability: `di-runtime`, `annotations-and-codegen`, `flutter-integration`, `talker-logging-adapter`.
+- Все требования формулировать нормативно (MUST) и снабжать сценариями WHEN/THEN.
+- Описывать сущности, жизненный цикл, ошибки и точки расширения в каждом capability.
+
+**Альтернативы:**
+- Единый монолитный spec.md: отклонено из-за ухудшения навигации и поддержки.
+- Использовать SHOULD/MAY: отклонено для уменьшения двусмысленности.
+
+## Risks / Trade-offs
+
+- [Risk] Спецификация может расходиться с фактическим поведением кода → Mitigation: привязка требований к публичным API и README, дальнейшая валидация при реализации.
+- [Risk] Перекрывающиеся требования между capability → Mitigation: строгие границы и минимальный повтор.
+
+## Migration Plan
+
+- Спецификация вводится как документ без влияния на runtime.
+- При необходимости последующих изменений — через отдельные change‑запросы OpenSpec.
+
+## Open Questions
+
+- Нужно ли фиксировать требования по производительности (O(1) lookup) как отдельный раздел?
+- Нужны ли отдельные сценарии для edge‑cases (например, singleton + params)?