Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Memory Bank — переносимый documentation-first шаблон для

## Как это работает

`dna/` задаёт governance-ядро: Single Source of Truth, зависимости между документами, lifecycle, frontmatter и правила навигации. Постоянный контекст проекта находится в `product/`, `domain/`, `engineering/` и `ops/`; инициативы, сценарии и решения — в PRD, epic, use case и ADR.
`dna/` задаёт governance-ядро: Single Source of Truth, зависимости между документами, lifecycle, frontmatter и правила навигации. Постоянный контекст проекта находится в `product/`, `domain/`, `engineering/` и `ops/`; research, инициативы, сценарии и решения — в Research, PRD, epic, use case и ADR.

Для значимой delivery-фичи контекст созревает поэтапно:

Expand All @@ -41,6 +41,7 @@ problem space solution space execution space
| [`engineering/`](memory-bank/engineering/README.md) | Архитектура, тестирование, coding style, git workflow и границы автономии агента |
| [`ops/`](memory-bank/ops/README.md) | Локальная разработка, окружения, конфигурация, релизы и runbooks |
| [`prd/`](memory-bank/prd/README.md) | Продуктовые инициативы между общим product context и отдельными фичами |
| [`research/`](memory-bank/research/README.md) | Evidence-backed market, product и technical research до решения о delivery |
| [`epics/`](memory-bank/epics/README.md) | Крупные инициативы с roadmap, рисками, решениями и delivery subissues |
| [`use-cases/`](memory-bank/use-cases/README.md) | Канонические пользовательские и операционные сценарии |
| [`features/`](memory-bank/features/README.md) | Пакеты отдельных delivery-фич |
Expand All @@ -65,7 +66,7 @@ problem space solution space execution space

## Выбор рабочего процесса

Каждая задача сначала проходит [Task Routing](memory-bank/flows/routing.md). Он направляет работу в Incident, Bug Fix, Small Change, Epic, Refactoring, Feature или на ручное решение.
Каждая задача сначала проходит [Task Routing](memory-bank/flows/routing.md). Он направляет работу в Incident, Bug Fix, Research & Discovery, Small Change, Epic, Refactoring, Feature или на ручное решение.

Корневой README даёт только обзор. Условия входа, lifecycle, обязательные артефакты и exit contract принадлежат каноническим документам в [`memory-bank/flows/`](memory-bank/flows/README.md) и не дублируются здесь.

Expand Down
16 changes: 16 additions & 0 deletions dependency-tree.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,11 +58,19 @@ memory-bank/dna/principles.md
├── memory-bank/flows/feature.md
├── memory-bank/flows/incident.md
├── memory-bank/flows/refactoring.md
├── memory-bank/flows/research.md
├── memory-bank/flows/routing.md
├── memory-bank/flows/small-change.md
├── memory-bank/flows/templates/README.md
├── memory-bank/flows/templates/adr/ADR-XXX.md
├── memory-bank/flows/templates/prd/PRD-XXX.md
├── memory-bank/flows/templates/research/README.md
├── memory-bank/flows/templates/research/package-README.md
├── memory-bank/flows/templates/research/brief.md
├── memory-bank/flows/templates/research/plan.md
├── memory-bank/flows/templates/research/evidence.md
├── memory-bank/flows/templates/research/synthesis.md
├── memory-bank/flows/templates/research/decision.md
├── memory-bank/flows/templates/use-case/UC-XXX.md
├── memory-bank/ops/README.md
├── memory-bank/ops/config.md
Expand All @@ -71,6 +79,7 @@ memory-bank/dna/principles.md
├── memory-bank/ops/runbooks/README.md
├── memory-bank/ops/stages.md
├── memory-bank/prd/README.md
├── memory-bank/research/README.md
├── memory-bank/use-cases/README.md
└── memory-bank/adr/README.md
```
Expand All @@ -84,6 +93,7 @@ memory-bank/dna/principles.md
- Этот файл `dependency-tree.md` зависит от [`memory-bank/dna/governance.md`](memory-bank/dna/governance.md), но сознательно живет вне `memory-bank/`.
- [`memory-bank/flows/routing.md`](memory-bank/flows/routing.md) зависит от governance и [`memory-bank/engineering/autonomy-boundaries.md`](memory-bank/engineering/autonomy-boundaries.md); branch flows используют его как upstream owner route selection.
- [`memory-bank/flows/feature.md`](memory-bank/flows/feature.md) зависит от governance, frontmatter и [`memory-bank/flows/routing.md`](memory-bank/flows/routing.md).
- [`memory-bank/flows/research.md`](memory-bank/flows/research.md) зависит от governance, frontmatter и [`memory-bank/flows/routing.md`](memory-bank/flows/routing.md); он определяет lifecycle research packages и их artifact ownership.
- [`memory-bank/flows/epic.md`](memory-bank/flows/epic.md) зависит от governance/frontmatter, [`memory-bank/flows/routing.md`](memory-bank/flows/routing.md) и [`memory-bank/flows/feature.md`](memory-bank/flows/feature.md); Epic Intake templates `package-README.md` и `brief.md` зависят от этого flow.
- [`memory-bank/flows/small-change.md`](memory-bank/flows/small-change.md), [`memory-bank/flows/bug-fix.md`](memory-bank/flows/bug-fix.md) и [`memory-bank/flows/refactoring.md`](memory-bank/flows/refactoring.md) зависят от routing, governance и [`memory-bank/engineering/testing-policy.md`](memory-bank/engineering/testing-policy.md).
- [`memory-bank/flows/incident.md`](memory-bank/flows/incident.md) зависит от routing, governance, testing policy и дополнительно от [`memory-bank/ops/runbooks/README.md`](memory-bank/ops/runbooks/README.md).
Expand All @@ -99,6 +109,12 @@ memory-bank/dna/principles.md
- [`memory-bank/flows/templates/feature/implementation-plan.md`](memory-bank/flows/templates/feature/implementation-plan.md) зависит от [`memory-bank/flows/feature.md`](memory-bank/flows/feature.md), [`memory-bank/dna/frontmatter.md`](memory-bank/dna/frontmatter.md) и [`memory-bank/engineering/testing-policy.md`](memory-bank/engineering/testing-policy.md).
- Feature-support templates [`runtime-surfaces.md`](memory-bank/flows/templates/feature/support/runtime-surfaces.md), [`ui-reference.md`](memory-bank/flows/templates/feature/support/ui-reference.md) и [`use-cases.md`](memory-bank/flows/templates/feature/support/use-cases.md) зависят от [`memory-bank/flows/feature.md`](memory-bank/flows/feature.md) и [`memory-bank/dna/frontmatter.md`](memory-bank/dna/frontmatter.md).

### Research-related Docs

- [`memory-bank/research/README.md`](memory-bank/research/README.md) зависит от [`memory-bank/dna/governance.md`](memory-bank/dna/governance.md) и [`memory-bank/flows/research.md`](memory-bank/flows/research.md).
- [`memory-bank/flows/templates/research/README.md`](memory-bank/flows/templates/research/README.md) зависит от [`memory-bank/flows/research.md`](memory-bank/flows/research.md) и [`memory-bank/dna/frontmatter.md`](memory-bank/dna/frontmatter.md).
- Research package templates [`package-README.md`](memory-bank/flows/templates/research/package-README.md), [`plan.md`](memory-bank/flows/templates/research/plan.md), [`evidence.md`](memory-bank/flows/templates/research/evidence.md), [`synthesis.md`](memory-bank/flows/templates/research/synthesis.md) и [`decision.md`](memory-bank/flows/templates/research/decision.md) зависят от [`memory-bank/flows/research.md`](memory-bank/flows/research.md); [`brief.md`](memory-bank/flows/templates/research/brief.md) дополнительно зависит от [`memory-bank/dna/frontmatter.md`](memory-bank/dna/frontmatter.md).

### Product And Domain Docs

- [`memory-bank/product/context.md`](memory-bank/product/context.md), [`memory-bank/product/vision.md`](memory-bank/product/vision.md), [`memory-bank/product/customers.md`](memory-bank/product/customers.md), [`memory-bank/product/metrics.md`](memory-bank/product/metrics.md), [`memory-bank/product/marketing.md`](memory-bank/product/marketing.md) и [`memory-bank/product/roadmap.md`](memory-bank/product/roadmap.md) зависят от [`memory-bank/dna/governance.md`](memory-bank/dna/governance.md) и product upstream-документов, указанных в их `derived_from`.
Expand Down
4 changes: 2 additions & 2 deletions docs/ownership.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@

| Класс | Текущая граница шаблона | Поведение update |
| --- | --- | --- |
| `managed` | `memory-bank/dna/`, `flows/`, `prompts/`, а также top-level template-индексы `prd/README.md`, `epics/README.md`, `use-cases/README.md`, `features/README.md`, `adr/README.md` | Проверяет текущий payload по digest. Чистый файл обновляется или удаляется; локальный drift становится conflict. |
| `managed` | `memory-bank/dna/`, `flows/`, `prompts/`, а также top-level template-индексы `prd/README.md`, `research/README.md`, `epics/README.md`, `use-cases/README.md`, `features/README.md`, `adr/README.md` | Проверяет текущий payload по digest. Чистый файл обновляется или удаляется; локальный drift становится conflict. |
| `adapted` | `memory-bank/README.md`, `product/`, `domain/`, `engineering/`, `ops/` | Хранит digest исходной template-base, но не требует совпадения текущего файла. Чистый файл может получить новую base; одновременные upstream и downstream изменения становятся conflict. |
| `user-owned` | Instantiated-документы в `prd/`, `epics/`, `use-cases/`, `features/`, `adr/` и неизвестные downstream paths | Никогда автоматически не перезаписывается и не удаляется. Неизвестный существующий файл получает этот класс по fail-safe правилу. |
| `user-owned` | Instantiated-документы в `prd/`, `research/`, `epics/`, `use-cases/`, `features/`, `adr/` и неизвестные downstream paths | Никогда автоматически не перезаписывается и не удаляется. Неизвестный существующий файл получает этот класс по fail-safe правилу. |
| `generated` | `memory-bank/.generated/` зарезервирован для будущих детерминированных генераторов; в текущем template таких файлов нет | Может быть пересоздан или удалён только детерминированным producer. |

`base_digest` и `base_mode` (`100644` или `100755`) описывают файл в зафиксированной template-base. `payload_digest` и `payload_mode` присутствуют только там, где текущий файл является проверяемым managed/generated contract. Поэтому обычная специализация adapted-документа не считается drift, а изменение executable bit managed-файла проверяется так же, как изменение его содержимого.
Expand Down
3 changes: 3 additions & 0 deletions memory-bank/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,9 @@ audience: humans_and_agents
- [`prd/README.md`](prd/README.md)
Читать, когда нужно: описать продуктовую инициативу между общим product context и downstream feature packages.

- [`research/README.md`](research/README.md)
Читать, когда нужно: провести evidence-backed market, product или technical research до коммита в delivery и передать вывод в подходящий canonical owner.

- [`epics/README.md`](epics/README.md)
Читать, когда нужно: вести крупную инициативу через roadmap, decision log, risks и набор связанных delivery subissues.

Expand Down
3 changes: 3 additions & 0 deletions memory-bank/dna/frontmatter.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ status: active
|---|---|---|
| `derived_from` | Есть upstream-документ | Прямые upstream-зависимости. Каждый элемент — строка (путь) или объект `{path, fit}`, где `fit` объясняет scope зависимости |
| `delivery_status` | Lifecycle-owning canonical `brief.md` | `planned` / `in_progress` / `done` / `cancelled` |
| `research_status` | Lifecycle-owning canonical research `brief.md` | `intake` / `framed` / `collecting` / `synthesizing` / `decision_ready` / `validated` / `invalidated` / `inconclusive` / `parked` / `cancelled` / `rerouted` |
| `decision_status` | ADR-документы | `proposed` / `accepted` / `superseded` / `rejected` |

## Дополнительные поля
Expand All @@ -30,6 +31,8 @@ Governed-документы могут содержать дополнитель

Для `doc_kind: feature-support` документ является reference / companion внутри feature package и не владеет `delivery_status`, canonical requirements, selected solution или execution sequencing.

Для `doc_kind: research` lifecycle owner-ом остается canonical `brief.md` research package. Его `research_status` описывает состояние исследования, включая terminal disposition, а не delivery. `plan.md`, `evidence.md`, `synthesis.md` и `decision.md` являются отдельными owner-ами метода, наблюдений, выводов, decision rationale и handoff; ни один из них не создаёт второй lifecycle state и не заменяет canonical downstream PRD, epic, feature, ADR или product document после handoff.

## Примеры

```yaml
Expand Down
2 changes: 1 addition & 1 deletion memory-bank/dna/governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Governance-документы (DNA, flows) используют дополнит

| Поле | Значения | Назначение |
|-|-|-|
| `doc_kind` | `governance`, `project`, `product`, `domain`, `prd`, `use_case`, `epic`, `feature`, `feature-support`, `engineering`, `ops`, `adr`, `prompt`, `process` | Тип документа или артефакта |
| `doc_kind` | `governance`, `project`, `product`, `domain`, `prd`, `research`, `use_case`, `epic`, `feature`, `feature-support`, `engineering`, `ops`, `adr`, `prompt`, `process` | Тип документа или артефакта |
| `doc_function` | `canonical`, `index`, `template`, `derived`, `reference`, `convention`, `roadmap`, `decision_log`, `subissue_registry`, `risk_register` | Роль: canonical owner факта, навигационный индекс, шаблон, downstream artifact, reference companion, convention или specialized epic owner |

Эти поля обязательны для governance-документов и рекомендуются для product/domain/ops/engineering/project документов, чтобы агенты могли различать слой знания и роль файла.
2 changes: 1 addition & 1 deletion memory-bank/dna/lifecycle.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,5 +23,5 @@ status: active
Перед фиксацией изменений в governed-документации:

- [ ] frontmatter валиден, для `active` non-root задан `derived_from`
- [ ] для lifecycle-owning canonical `brief.md` задан `delivery_status`, для `adr` — `decision_status`
- [ ] для lifecycle-owning feature `brief.md` задан `delivery_status`, для lifecycle-owning research `brief.md` — `research_status`, для `adr` — `decision_status`
- [ ] parent `README.md` обновлён при изменении состава или reading order
2 changes: 2 additions & 0 deletions memory-bank/flows/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ purpose: Навигация по task routing, lifecycle flows и governed-ша
derived_from:
- ../dna/governance.md
- routing.md
- research.md
- incident.md
- bug-fix.md
- small-change.md
Expand All @@ -24,6 +25,7 @@ audience: humans_and_agents
Каталог `memory-bank/flows/` содержит reusable process-layer для шаблона: lifecycle rules, taxonomy стабильных идентификаторов и governed templates.

- [Task Routing](routing.md) — порядок выбора flow, routing predicates, повторный routing и Human Routing.
- [Research & Discovery Flow](research.md) — evidence-backed lifecycle research-задач, от question framing до decision и handoff без преждевременного delivery.
- [Incident And PIR Flow](incident.md) — containment, recovery, timeline, RCA, PIR и prevention work.
- [Bug Fix Flow](bug-fix.md) — reproduction, analysis, fix, regression coverage и closure.
- [Small Change Flow](small-change.md) — direct delivery без feature package, design и execution plan, но с обязательным routing record.
Expand Down
Loading
Loading