From a12203b4d968fe020d70444f0b16f098a1964b65 Mon Sep 17 00:00:00 2001 From: Danil Pismenny Date: Sat, 5 Sep 2026 23:22:15 +0300 Subject: [PATCH 1/3] docs: drop unreachable process template subsystem MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Подсистема `flows/templates/process/` не была достижима штатным путём: decision tree в `flows/routing.md` содержит 8 веток и ветки Process среди них нет, а ни один flow-документ не ссылается на process-card или lifecycle-protocol как на шаг своего lifecycle. Инстанцированных артефактов она тоже не породила — каталога `processes/` и файлов `PROCESS-*` в репозитории нет. Ссылки на неё существовали только в индексах шаблонов и priming-манифестов. Отдельно `process/session-handoff.md` дублировал `flows/execution-handoff.md`: оба решают задачу «зафиксировать состояние, чтобы безопасно продолжить прерванную работу», но с разными схемами полей и без перекрёстных ссылок. Из двух остаётся `execution-handoff.md` — он wired в систему через корневой README, `flows/feature.md` и priming. Удалено в обеих копиях дерева (шаблон и project-local инстанс), ссылки подчищены в `flows/templates/README.md` и `flows/priming/README.md`. `doc_kind: process` в схеме `dna/governance.md` сохранён: им пользуется `flows/execution-handoff.md`. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_014HazPfqSjJ288za5J7XEme --- memory-bank/flows/priming/README.md | 1 - memory-bank/flows/priming/process.yaml | 11 -- memory-bank/flows/templates/README.md | 8 -- memory-bank/flows/templates/process/README.md | 82 ----------- .../templates/process/lifecycle-protocol.md | 134 ------------------ .../flows/templates/process/priming.yaml | 7 - .../flows/templates/process/process-card.md | 101 ------------- .../templates/process/session-handoff.md | 108 -------------- template/memory-bank/flows/priming/README.md | 1 - .../memory-bank/flows/priming/process.yaml | 11 -- .../memory-bank/flows/templates/README.md | 8 -- .../flows/templates/process/README.md | 82 ----------- .../templates/process/lifecycle-protocol.md | 134 ------------------ .../flows/templates/process/priming.yaml | 7 - .../flows/templates/process/process-card.md | 101 ------------- .../templates/process/session-handoff.md | 108 -------------- 16 files changed, 904 deletions(-) delete mode 100644 memory-bank/flows/priming/process.yaml delete mode 100644 memory-bank/flows/templates/process/README.md delete mode 100644 memory-bank/flows/templates/process/lifecycle-protocol.md delete mode 100644 memory-bank/flows/templates/process/priming.yaml delete mode 100644 memory-bank/flows/templates/process/process-card.md delete mode 100644 memory-bank/flows/templates/process/session-handoff.md delete mode 100644 template/memory-bank/flows/priming/process.yaml delete mode 100644 template/memory-bank/flows/templates/process/README.md delete mode 100644 template/memory-bank/flows/templates/process/lifecycle-protocol.md delete mode 100644 template/memory-bank/flows/templates/process/priming.yaml delete mode 100644 template/memory-bank/flows/templates/process/process-card.md delete mode 100644 template/memory-bank/flows/templates/process/session-handoff.md diff --git a/memory-bank/flows/priming/README.md b/memory-bank/flows/priming/README.md index 2e6a9f4..91192a6 100644 --- a/memory-bank/flows/priming/README.md +++ b/memory-bank/flows/priming/README.md @@ -36,5 +36,4 @@ audience: humans_and_agents - [PRD manifest](prd.yaml) — PRD creation and update. - [ADR manifest](adr.yaml) — ADR creation and update. - [Operations manifest](ops.yaml) — operations and release work. -- [Process Documentation manifest](process.yaml) — process creation and update. - [Governance manifest](governance.yaml) — Memory Bank governance work. diff --git a/memory-bank/flows/priming/process.yaml b/memory-bank/flows/priming/process.yaml deleted file mode 100644 index d04f6ee..0000000 --- a/memory-bank/flows/priming/process.yaml +++ /dev/null @@ -1,11 +0,0 @@ -version: 1 -process: process_documentation -stages: - create_update: - - memory-bank/flows/templates/process/process-card.md - - memory-bank/flows/templates/process/lifecycle-protocol.md - - memory-bank/flows/templates/process/session-handoff.md - - memory-bank/flows/templates/process/priming.yaml - - memory-bank/dna/governance.md - - memory-bank/dna/lifecycle.md - - memory-bank/dna/frontmatter.md diff --git a/memory-bank/flows/templates/README.md b/memory-bank/flows/templates/README.md index 662df8d..7733fd1 100644 --- a/memory-bank/flows/templates/README.md +++ b/memory-bank/flows/templates/README.md @@ -32,10 +32,6 @@ derived_from: - feature/support/ui-reference.md - feature/support/use-cases.md - adr/ADR-XXX.md - - process/README.md - - process/process-card.md - - process/session-handoff.md - - process/lifecycle-protocol.md status: active audience: humans_and_agents --- @@ -72,7 +68,3 @@ audience: humans_and_agents - [FT-XXX: Feature Use Cases Template](feature/support/use-cases.md) — optional support template для derived use cases, BDD example map, test candidates и `FUC → SC/NEG → REQ → CHK` review mapping без нового acceptance owner. - [ADR-XXX: Short Decision Name](adr/ADR-XXX.md) — шаблон ADR. Отвечает на вопрос: как зафиксировать архитектурное решение. - [PROMPT-XXX: Reusable Prompt Name](prompt/PROMPT-XXX.md) — шаблон reusable prompt-документа. Отвечает на вопрос: как сохранить исходную формулировку в frontmatter и улучшенный prompt в copyable body-блоке. -- [PROC-XXX: Process Documentation Index](process/README.md) — шаблон индекса процесс-документов. Отвечает на вопрос: как собрать routing-layer для reusable process cards, session handoff и lifecycle protocol. -- [PROC-XXX: Compact Process Card](process/process-card.md) — шаблон короткого reusable workflow. Отвечает на вопрос: как зафиксировать процесс с одним trigger, шагами и exit criteria. -- [PROC-XXX: Session Handoff](process/session-handoff.md) — шаблон передачи состояния между сессиями. Отвечает на вопрос: как продолжить процесс без потери assumptions, risks и next checks. -- [PROC-XXX: Lifecycle Protocol](process/lifecycle-protocol.md) — шаблон полного lifecycle protocol. Отвечает на вопрос: как вести multi-phase process с gates, verification и rollback. diff --git a/memory-bank/flows/templates/process/README.md b/memory-bank/flows/templates/process/README.md deleted file mode 100644 index 40f9ce4..0000000 --- a/memory-bank/flows/templates/process/README.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: "PROC-XXX: Process Documentation Index" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для `processes/README.md`. Читать, чтобы собрать каталог процесс-документов проекта без смешения wrapper-метаданных и frontmatter будущего index-документа. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/README.md -canonical_for: - - process_template_index ---- - -# PROC-XXX: Process Documentation Index - -Этот файл описывает wrapper-template. Инстанцируемый `processes/README.md` живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Priming Inputs - -Прочитай [`process.yaml`](../../priming/process.yaml) и выполни source set -`create_update`. - -## Wrapper Notes - -Каталог `processes/` нужен для reusable process-documents, которые живут между ad-hoc заметкой и feature package. Он помогает держать процесс отдельно от продуктового scope: сюда попадают повторяемые workflows, session handoff, lifecycle protocols и другие управляемые последовательности действий. - -Этот index-шаблон предназначен для навигации по трехуровневой process-линейке: - -- компактная карточка процесса; -- session handoff для продолжения работы между сессиями; -- lifecycle protocol для длинных delivery-процессов с gates и verification. - -Для каждого concrete process создай отдельный -`memory-bank/processes/.priming.yaml` из -[`priming.yaml`](priming.yaml). Process document в `Priming Inputs` указывает -этот manifest и нужные stage keys. Пути и bounded masks живут только в -manifest и разрешаются по -[`Context Priming Contract`](../../priming/context-priming.md). - -Если проекту достаточно одного процесса, всё равно оставь `README.md` как routing-layer: он фиксирует, какие process-documents существуют, что они покрывают и когда их открывать. - -## Instantiated Frontmatter - -```yaml -title: "Process Documentation Index" -doc_kind: process -doc_function: index -purpose: "Навигация по reusable process-документам проекта и выбор правильного шаблона для конкретного workflow." -derived_from: - - ../flows/routing.md -status: active -audience: humans_and_agents -``` - -## Instantiated Body - -```markdown -# Process Documentation Index - -## О каталоге - -Каталог `processes/` хранит reusable процесс-документы: компактные карточки процессов, session handoff для продолжения работы между сессиями и lifecycle protocol для сложных delivery-flow с проверками и gates. - -## Аннотированный индекс - -- [`process-card.md`](process-card.md) - Читать, когда нужен компактный, повторяемый процесс без большой state machine. - Отвечает на вопрос: как зафиксировать короткий workflow, который можно выполнять по одной карточке. - -- [`session-handoff.md`](session-handoff.md) - Читать, когда работа переносится между сессиями или компьютерами и нужно сохранить current state, assumptions, risks и next checks. - Отвечает на вопрос: как безопасно продолжить уже начатый процесс без потери контекста. - -- [`lifecycle-protocol.md`](lifecycle-protocol.md) - Читать, когда процесс состоит из фаз, human gates, verification и rollback и должен переживать длинный delivery-cycle. - Отвечает на вопрос: как управлять полным жизненным циклом изменения от старта до handoff или closure. -``` diff --git a/memory-bank/flows/templates/process/lifecycle-protocol.md b/memory-bank/flows/templates/process/lifecycle-protocol.md deleted file mode 100644 index 4e015cb..0000000 --- a/memory-bank/flows/templates/process/lifecycle-protocol.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "PROC-XXX: Lifecycle Protocol" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для полного lifecycle protocol. Читать, когда процесс проходит через фазы, gates, verification и rollback. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md - - ../../feature.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/PROCESS-XXX-lifecycle-protocol.md -canonical_for: - - process_template_lifecycle_protocol ---- - -# PROC-XXX: Lifecycle Protocol - -Этот файл описывает wrapper-template. Инстанцируемый lifecycle protocol живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Wrapper Notes - -Это heavyweight-вариант для длинных изменений и управляемых delivery-processes: здесь процесс разбивается на фазы, а каждая фаза имеет свои exit criteria, checks, evidence и human gates. - -Используй этот шаблон, когда: - -- есть несколько фаз работы; -- нужен явный owner и approval flow; -- важно разделить implementation, verification и handoff; -- требуется rollback или stop conditions; -- процесс должен переживать не одну сессию. - -Этот шаблон ближе всего к `brief -> optional design -> plan -> implement -> verify -> ship`, а не к короткой рутине. - -## Instantiated Frontmatter - -```yaml -title: "PROC-XXX: Lifecycle Protocol" -doc_kind: process -doc_function: canonical -purpose: "Описывает полный процесс изменения с фазами, gates, verification и rollback." -derived_from: - - README.md - - ../flows/feature.md -status: draft -audience: humans_and_agents -must_not_define: - - product_strategy - - domain_model -``` - -## Instantiated Body - -```markdown -# PROC-XXX: Lifecycle Protocol - -## Goal - -Какой результат должен быть достигнут и почему этот процесс вообще нужен. - -## Scope - -### In Scope - -- Что входит в этот lifecycle. - -### Out Of Scope - -- Что исключено из процесса. - -## Baseline Facts - -- Что уже известно. -- На каких проверенных фактах держится старт процесса. - -## Priming Inputs - -Прочитай `memory-bank/processes/.priming.yaml`. Выполни source set -`entry`, затем добавляй source sets перед соответствующими фазами. - -## Phases - -### Phase 1: Prepare - -- Подготовить входные данные. -- Уточнить неизвестности. -- Зафиксировать стартовый state. - -### Phase 2: Execute - -- Выполнить основную работу. -- Двигаться по step-by-step plan. - -### Phase 3: Verify - -- Прогнать проверки. -- Зафиксировать evidence. - -### Phase 4: Hand Off or Close - -- Передать следующий state или закрыть процесс. - -## Human Gates - -### H1 - -- Что можно делать только после явного одобрения. - -### H2 - -- Что требует commit point или acceptance. - -### H3 - -- Что является destructive / irreversible action. - -## Verification - -- Какие проверки обязательны. -- Какой evidence должен остаться. - -## Rollback - -- Что делать, если процесс нужно откатить. -- Где проходит точка невозврата. - -## Stop Conditions - -- Что заставляет немедленно остановиться, включая missing или conflicting - priming input. -``` diff --git a/memory-bank/flows/templates/process/priming.yaml b/memory-bank/flows/templates/process/priming.yaml deleted file mode 100644 index 39228e8..0000000 --- a/memory-bank/flows/templates/process/priming.yaml +++ /dev/null @@ -1,7 +0,0 @@ -version: 1 -process: -stages: - entry: - - memory-bank/path/to/document.md - continuation: - - memory-bank/path/to/current-state.md diff --git a/memory-bank/flows/templates/process/process-card.md b/memory-bank/flows/templates/process/process-card.md deleted file mode 100644 index 8524801..0000000 --- a/memory-bank/flows/templates/process/process-card.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "PROC-XXX: Compact Process Card" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для компактной process-card. Читать, чтобы зафиксировать короткий reusable workflow без тяжёлого lifecycle-каркаса. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/PROCESS-XXX-process-card.md -canonical_for: - - process_template_card ---- - -# PROC-XXX: Compact Process Card - -Этот файл описывает wrapper-template. Инстанцируемый process-card живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Wrapper Notes - -Этот вариант нужен, когда процесс повторяется часто, но не требует полноценного protocol: один trigger, понятный owner, короткий список шагов и ясные exit criteria. - -Хороший кандидат для этого шаблона: - -- короткий ручной workflow; -- операционная рутина; -- повторяемый internal step без сложных gates; -- процесс, который удобно описывать на одной странице. - -Если процесс начинает требовать handoff state, approval gates, rollback или явные verification phase, это сигнал перейти к `session-handoff.md` или `lifecycle-protocol.md`. - -## Instantiated Frontmatter - -```yaml -title: "PROC-XXX: Compact Process Card" -doc_kind: process -doc_function: canonical -purpose: "Фиксирует короткий reusable workflow с одним trigger, owner, шагами и exit criteria." -derived_from: - - README.md -status: draft -audience: humans_and_agents -must_not_define: - - full_delivery_lifecycle - - approval_gates - - rollback_protocol -``` - -## Instantiated Body - -```markdown -# PROC-XXX: Compact Process Card - -## Purpose - -Коротко опиши, зачем этот процесс существует и какой результат он должен стабильно давать. - -## Trigger - -- Что запускает процесс. -- Кто его инициирует. -- Какие входные данные нужны перед стартом. - -## Priming Inputs - -Прочитай `memory-bank/processes/.priming.yaml` и выполни source -set `entry`. - -## Scope - -### In Scope - -- Что этот workflow делает. - -### Out Of Scope - -- Что он сознательно не покрывает. - -## Steps - -1. Шаг 1. -2. Шаг 2. -3. Шаг 3. - -## Exit Criteria - -- Что должно быть истинно, чтобы процесс считался завершенным. - -## Evidence - -- Какой артефакт, лог, ссылка или статус подтверждает выполнение. - -## Escalation - -- Когда процесс нужно остановить и поднять к человеку, включая missing или - conflicting priming input. -``` diff --git a/memory-bank/flows/templates/process/session-handoff.md b/memory-bank/flows/templates/process/session-handoff.md deleted file mode 100644 index deda354..0000000 --- a/memory-bank/flows/templates/process/session-handoff.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: "PROC-XXX: Session Handoff" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для session handoff. Читать, чтобы сохранять состояние процесса между сессиями без потери assumptions, risks и next checks. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/PROCESS-XXX-session-handoff.md -canonical_for: - - process_template_session_handoff ---- - -# PROC-XXX: Session Handoff - -Этот файл описывает wrapper-template. Инстанцируемый session handoff живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Wrapper Notes - -Это шаблон для случаев, когда работа прерывается и должна быть продолжена позже: новая сессия, другой компьютер, другой оператор или long-running workflow с паузами между шагами. - -Ключевая идея: в handoff попадают не все детали подряд, а только то, что реально нужно для безопасного продолжения. - -Обязательно фиксируй: - -- текущий выполненный шаг; -- текущий шаг, на котором остановились; -- рабочие допущения; -- открытые риски; -- ближайшие проверки; -- следующую конкретную action. - -Если процесс начинает требовать формальных gates, rollback и multi-phase verification, используй `lifecycle-protocol.md`. - -## Instantiated Frontmatter - -```yaml -title: "PROC-XXX: Session Handoff" -doc_kind: process -doc_function: canonical -purpose: "Фиксирует состояние незавершенного процесса так, чтобы следующая сессия могла продолжить работу без потери контекста." -derived_from: - - README.md -status: draft -audience: humans_and_agents -must_not_define: - - long_term_project_policy - - product_scope -``` - -## Instantiated Body - -```markdown -# PROC-XXX: Session Handoff - -## Current State - -- Что уже сделано. -- Где именно остановились. -- Какой артефакт является актуальным. - -## Continuation Priming Inputs - -Прочитай `memory-bank/processes/.priming.yaml` и выполни source -set `continuation`. - -## Completed - -- Список завершенных шагов или проверок. - -## Current Step - -- Один конкретный шаг, который выполняется сейчас или должен быть выполнен следующим. - -## Assumptions - -- Какие допущения были приняты по ходу работы. - -## Open Risks - -- Какие риски еще не сняты. - -## Next Checks - -- Что нужно проверить перед продолжением. - -## Evidence Log - -| Time | Fact / action | Evidence | -|---|---|---| -| `` | `` | `` | - -## Next Action - -- Кто действует. -- Что именно он делает. -- Когда останавливаемся. - -## Stop Conditions - -- Когда нельзя продолжать без человека, включая divergence между priming input - и handoff state. -``` diff --git a/template/memory-bank/flows/priming/README.md b/template/memory-bank/flows/priming/README.md index 2e6a9f4..91192a6 100644 --- a/template/memory-bank/flows/priming/README.md +++ b/template/memory-bank/flows/priming/README.md @@ -36,5 +36,4 @@ audience: humans_and_agents - [PRD manifest](prd.yaml) — PRD creation and update. - [ADR manifest](adr.yaml) — ADR creation and update. - [Operations manifest](ops.yaml) — operations and release work. -- [Process Documentation manifest](process.yaml) — process creation and update. - [Governance manifest](governance.yaml) — Memory Bank governance work. diff --git a/template/memory-bank/flows/priming/process.yaml b/template/memory-bank/flows/priming/process.yaml deleted file mode 100644 index d04f6ee..0000000 --- a/template/memory-bank/flows/priming/process.yaml +++ /dev/null @@ -1,11 +0,0 @@ -version: 1 -process: process_documentation -stages: - create_update: - - memory-bank/flows/templates/process/process-card.md - - memory-bank/flows/templates/process/lifecycle-protocol.md - - memory-bank/flows/templates/process/session-handoff.md - - memory-bank/flows/templates/process/priming.yaml - - memory-bank/dna/governance.md - - memory-bank/dna/lifecycle.md - - memory-bank/dna/frontmatter.md diff --git a/template/memory-bank/flows/templates/README.md b/template/memory-bank/flows/templates/README.md index 662df8d..7733fd1 100644 --- a/template/memory-bank/flows/templates/README.md +++ b/template/memory-bank/flows/templates/README.md @@ -32,10 +32,6 @@ derived_from: - feature/support/ui-reference.md - feature/support/use-cases.md - adr/ADR-XXX.md - - process/README.md - - process/process-card.md - - process/session-handoff.md - - process/lifecycle-protocol.md status: active audience: humans_and_agents --- @@ -72,7 +68,3 @@ audience: humans_and_agents - [FT-XXX: Feature Use Cases Template](feature/support/use-cases.md) — optional support template для derived use cases, BDD example map, test candidates и `FUC → SC/NEG → REQ → CHK` review mapping без нового acceptance owner. - [ADR-XXX: Short Decision Name](adr/ADR-XXX.md) — шаблон ADR. Отвечает на вопрос: как зафиксировать архитектурное решение. - [PROMPT-XXX: Reusable Prompt Name](prompt/PROMPT-XXX.md) — шаблон reusable prompt-документа. Отвечает на вопрос: как сохранить исходную формулировку в frontmatter и улучшенный prompt в copyable body-блоке. -- [PROC-XXX: Process Documentation Index](process/README.md) — шаблон индекса процесс-документов. Отвечает на вопрос: как собрать routing-layer для reusable process cards, session handoff и lifecycle protocol. -- [PROC-XXX: Compact Process Card](process/process-card.md) — шаблон короткого reusable workflow. Отвечает на вопрос: как зафиксировать процесс с одним trigger, шагами и exit criteria. -- [PROC-XXX: Session Handoff](process/session-handoff.md) — шаблон передачи состояния между сессиями. Отвечает на вопрос: как продолжить процесс без потери assumptions, risks и next checks. -- [PROC-XXX: Lifecycle Protocol](process/lifecycle-protocol.md) — шаблон полного lifecycle protocol. Отвечает на вопрос: как вести multi-phase process с gates, verification и rollback. diff --git a/template/memory-bank/flows/templates/process/README.md b/template/memory-bank/flows/templates/process/README.md deleted file mode 100644 index 40f9ce4..0000000 --- a/template/memory-bank/flows/templates/process/README.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: "PROC-XXX: Process Documentation Index" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для `processes/README.md`. Читать, чтобы собрать каталог процесс-документов проекта без смешения wrapper-метаданных и frontmatter будущего index-документа. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/README.md -canonical_for: - - process_template_index ---- - -# PROC-XXX: Process Documentation Index - -Этот файл описывает wrapper-template. Инстанцируемый `processes/README.md` живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Priming Inputs - -Прочитай [`process.yaml`](../../priming/process.yaml) и выполни source set -`create_update`. - -## Wrapper Notes - -Каталог `processes/` нужен для reusable process-documents, которые живут между ad-hoc заметкой и feature package. Он помогает держать процесс отдельно от продуктового scope: сюда попадают повторяемые workflows, session handoff, lifecycle protocols и другие управляемые последовательности действий. - -Этот index-шаблон предназначен для навигации по трехуровневой process-линейке: - -- компактная карточка процесса; -- session handoff для продолжения работы между сессиями; -- lifecycle protocol для длинных delivery-процессов с gates и verification. - -Для каждого concrete process создай отдельный -`memory-bank/processes/.priming.yaml` из -[`priming.yaml`](priming.yaml). Process document в `Priming Inputs` указывает -этот manifest и нужные stage keys. Пути и bounded masks живут только в -manifest и разрешаются по -[`Context Priming Contract`](../../priming/context-priming.md). - -Если проекту достаточно одного процесса, всё равно оставь `README.md` как routing-layer: он фиксирует, какие process-documents существуют, что они покрывают и когда их открывать. - -## Instantiated Frontmatter - -```yaml -title: "Process Documentation Index" -doc_kind: process -doc_function: index -purpose: "Навигация по reusable process-документам проекта и выбор правильного шаблона для конкретного workflow." -derived_from: - - ../flows/routing.md -status: active -audience: humans_and_agents -``` - -## Instantiated Body - -```markdown -# Process Documentation Index - -## О каталоге - -Каталог `processes/` хранит reusable процесс-документы: компактные карточки процессов, session handoff для продолжения работы между сессиями и lifecycle protocol для сложных delivery-flow с проверками и gates. - -## Аннотированный индекс - -- [`process-card.md`](process-card.md) - Читать, когда нужен компактный, повторяемый процесс без большой state machine. - Отвечает на вопрос: как зафиксировать короткий workflow, который можно выполнять по одной карточке. - -- [`session-handoff.md`](session-handoff.md) - Читать, когда работа переносится между сессиями или компьютерами и нужно сохранить current state, assumptions, risks и next checks. - Отвечает на вопрос: как безопасно продолжить уже начатый процесс без потери контекста. - -- [`lifecycle-protocol.md`](lifecycle-protocol.md) - Читать, когда процесс состоит из фаз, human gates, verification и rollback и должен переживать длинный delivery-cycle. - Отвечает на вопрос: как управлять полным жизненным циклом изменения от старта до handoff или closure. -``` diff --git a/template/memory-bank/flows/templates/process/lifecycle-protocol.md b/template/memory-bank/flows/templates/process/lifecycle-protocol.md deleted file mode 100644 index 4e015cb..0000000 --- a/template/memory-bank/flows/templates/process/lifecycle-protocol.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "PROC-XXX: Lifecycle Protocol" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для полного lifecycle protocol. Читать, когда процесс проходит через фазы, gates, verification и rollback. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md - - ../../feature.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/PROCESS-XXX-lifecycle-protocol.md -canonical_for: - - process_template_lifecycle_protocol ---- - -# PROC-XXX: Lifecycle Protocol - -Этот файл описывает wrapper-template. Инстанцируемый lifecycle protocol живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Wrapper Notes - -Это heavyweight-вариант для длинных изменений и управляемых delivery-processes: здесь процесс разбивается на фазы, а каждая фаза имеет свои exit criteria, checks, evidence и human gates. - -Используй этот шаблон, когда: - -- есть несколько фаз работы; -- нужен явный owner и approval flow; -- важно разделить implementation, verification и handoff; -- требуется rollback или stop conditions; -- процесс должен переживать не одну сессию. - -Этот шаблон ближе всего к `brief -> optional design -> plan -> implement -> verify -> ship`, а не к короткой рутине. - -## Instantiated Frontmatter - -```yaml -title: "PROC-XXX: Lifecycle Protocol" -doc_kind: process -doc_function: canonical -purpose: "Описывает полный процесс изменения с фазами, gates, verification и rollback." -derived_from: - - README.md - - ../flows/feature.md -status: draft -audience: humans_and_agents -must_not_define: - - product_strategy - - domain_model -``` - -## Instantiated Body - -```markdown -# PROC-XXX: Lifecycle Protocol - -## Goal - -Какой результат должен быть достигнут и почему этот процесс вообще нужен. - -## Scope - -### In Scope - -- Что входит в этот lifecycle. - -### Out Of Scope - -- Что исключено из процесса. - -## Baseline Facts - -- Что уже известно. -- На каких проверенных фактах держится старт процесса. - -## Priming Inputs - -Прочитай `memory-bank/processes/.priming.yaml`. Выполни source set -`entry`, затем добавляй source sets перед соответствующими фазами. - -## Phases - -### Phase 1: Prepare - -- Подготовить входные данные. -- Уточнить неизвестности. -- Зафиксировать стартовый state. - -### Phase 2: Execute - -- Выполнить основную работу. -- Двигаться по step-by-step plan. - -### Phase 3: Verify - -- Прогнать проверки. -- Зафиксировать evidence. - -### Phase 4: Hand Off or Close - -- Передать следующий state или закрыть процесс. - -## Human Gates - -### H1 - -- Что можно делать только после явного одобрения. - -### H2 - -- Что требует commit point или acceptance. - -### H3 - -- Что является destructive / irreversible action. - -## Verification - -- Какие проверки обязательны. -- Какой evidence должен остаться. - -## Rollback - -- Что делать, если процесс нужно откатить. -- Где проходит точка невозврата. - -## Stop Conditions - -- Что заставляет немедленно остановиться, включая missing или conflicting - priming input. -``` diff --git a/template/memory-bank/flows/templates/process/priming.yaml b/template/memory-bank/flows/templates/process/priming.yaml deleted file mode 100644 index 39228e8..0000000 --- a/template/memory-bank/flows/templates/process/priming.yaml +++ /dev/null @@ -1,7 +0,0 @@ -version: 1 -process: -stages: - entry: - - memory-bank/path/to/document.md - continuation: - - memory-bank/path/to/current-state.md diff --git a/template/memory-bank/flows/templates/process/process-card.md b/template/memory-bank/flows/templates/process/process-card.md deleted file mode 100644 index 8524801..0000000 --- a/template/memory-bank/flows/templates/process/process-card.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: "PROC-XXX: Compact Process Card" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для компактной process-card. Читать, чтобы зафиксировать короткий reusable workflow без тяжёлого lifecycle-каркаса. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/PROCESS-XXX-process-card.md -canonical_for: - - process_template_card ---- - -# PROC-XXX: Compact Process Card - -Этот файл описывает wrapper-template. Инстанцируемый process-card живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Wrapper Notes - -Этот вариант нужен, когда процесс повторяется часто, но не требует полноценного protocol: один trigger, понятный owner, короткий список шагов и ясные exit criteria. - -Хороший кандидат для этого шаблона: - -- короткий ручной workflow; -- операционная рутина; -- повторяемый internal step без сложных gates; -- процесс, который удобно описывать на одной странице. - -Если процесс начинает требовать handoff state, approval gates, rollback или явные verification phase, это сигнал перейти к `session-handoff.md` или `lifecycle-protocol.md`. - -## Instantiated Frontmatter - -```yaml -title: "PROC-XXX: Compact Process Card" -doc_kind: process -doc_function: canonical -purpose: "Фиксирует короткий reusable workflow с одним trigger, owner, шагами и exit criteria." -derived_from: - - README.md -status: draft -audience: humans_and_agents -must_not_define: - - full_delivery_lifecycle - - approval_gates - - rollback_protocol -``` - -## Instantiated Body - -```markdown -# PROC-XXX: Compact Process Card - -## Purpose - -Коротко опиши, зачем этот процесс существует и какой результат он должен стабильно давать. - -## Trigger - -- Что запускает процесс. -- Кто его инициирует. -- Какие входные данные нужны перед стартом. - -## Priming Inputs - -Прочитай `memory-bank/processes/.priming.yaml` и выполни source -set `entry`. - -## Scope - -### In Scope - -- Что этот workflow делает. - -### Out Of Scope - -- Что он сознательно не покрывает. - -## Steps - -1. Шаг 1. -2. Шаг 2. -3. Шаг 3. - -## Exit Criteria - -- Что должно быть истинно, чтобы процесс считался завершенным. - -## Evidence - -- Какой артефакт, лог, ссылка или статус подтверждает выполнение. - -## Escalation - -- Когда процесс нужно остановить и поднять к человеку, включая missing или - conflicting priming input. -``` diff --git a/template/memory-bank/flows/templates/process/session-handoff.md b/template/memory-bank/flows/templates/process/session-handoff.md deleted file mode 100644 index deda354..0000000 --- a/template/memory-bank/flows/templates/process/session-handoff.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: "PROC-XXX: Session Handoff" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для session handoff. Читать, чтобы сохранять состояние процесса между сессиями без потери assumptions, risks и next checks. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/PROCESS-XXX-session-handoff.md -canonical_for: - - process_template_session_handoff ---- - -# PROC-XXX: Session Handoff - -Этот файл описывает wrapper-template. Инстанцируемый session handoff живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Wrapper Notes - -Это шаблон для случаев, когда работа прерывается и должна быть продолжена позже: новая сессия, другой компьютер, другой оператор или long-running workflow с паузами между шагами. - -Ключевая идея: в handoff попадают не все детали подряд, а только то, что реально нужно для безопасного продолжения. - -Обязательно фиксируй: - -- текущий выполненный шаг; -- текущий шаг, на котором остановились; -- рабочие допущения; -- открытые риски; -- ближайшие проверки; -- следующую конкретную action. - -Если процесс начинает требовать формальных gates, rollback и multi-phase verification, используй `lifecycle-protocol.md`. - -## Instantiated Frontmatter - -```yaml -title: "PROC-XXX: Session Handoff" -doc_kind: process -doc_function: canonical -purpose: "Фиксирует состояние незавершенного процесса так, чтобы следующая сессия могла продолжить работу без потери контекста." -derived_from: - - README.md -status: draft -audience: humans_and_agents -must_not_define: - - long_term_project_policy - - product_scope -``` - -## Instantiated Body - -```markdown -# PROC-XXX: Session Handoff - -## Current State - -- Что уже сделано. -- Где именно остановились. -- Какой артефакт является актуальным. - -## Continuation Priming Inputs - -Прочитай `memory-bank/processes/.priming.yaml` и выполни source -set `continuation`. - -## Completed - -- Список завершенных шагов или проверок. - -## Current Step - -- Один конкретный шаг, который выполняется сейчас или должен быть выполнен следующим. - -## Assumptions - -- Какие допущения были приняты по ходу работы. - -## Open Risks - -- Какие риски еще не сняты. - -## Next Checks - -- Что нужно проверить перед продолжением. - -## Evidence Log - -| Time | Fact / action | Evidence | -|---|---|---| -| `` | `` | `` | - -## Next Action - -- Кто действует. -- Что именно он делает. -- Когда останавливаемся. - -## Stop Conditions - -- Когда нельзя продолжать без человека, включая divergence между priming input - и handoff state. -``` From 9bf7f84b31d30f51db2084ed93bdb8d2c5c2114a Mon Sep 17 00:00:00 2001 From: Danil Pismenny Date: Sun, 6 Sep 2026 21:39:25 +0300 Subject: [PATCH 2/3] Revert "docs: drop unreachable process template subsystem" This reverts commit a12203b4d968fe020d70444f0b16f098a1964b65. --- memory-bank/flows/priming/README.md | 1 + memory-bank/flows/priming/process.yaml | 11 ++ memory-bank/flows/templates/README.md | 8 ++ memory-bank/flows/templates/process/README.md | 82 +++++++++++ .../templates/process/lifecycle-protocol.md | 134 ++++++++++++++++++ .../flows/templates/process/priming.yaml | 7 + .../flows/templates/process/process-card.md | 101 +++++++++++++ .../templates/process/session-handoff.md | 108 ++++++++++++++ template/memory-bank/flows/priming/README.md | 1 + .../memory-bank/flows/priming/process.yaml | 11 ++ .../memory-bank/flows/templates/README.md | 8 ++ .../flows/templates/process/README.md | 82 +++++++++++ .../templates/process/lifecycle-protocol.md | 134 ++++++++++++++++++ .../flows/templates/process/priming.yaml | 7 + .../flows/templates/process/process-card.md | 101 +++++++++++++ .../templates/process/session-handoff.md | 108 ++++++++++++++ 16 files changed, 904 insertions(+) create mode 100644 memory-bank/flows/priming/process.yaml create mode 100644 memory-bank/flows/templates/process/README.md create mode 100644 memory-bank/flows/templates/process/lifecycle-protocol.md create mode 100644 memory-bank/flows/templates/process/priming.yaml create mode 100644 memory-bank/flows/templates/process/process-card.md create mode 100644 memory-bank/flows/templates/process/session-handoff.md create mode 100644 template/memory-bank/flows/priming/process.yaml create mode 100644 template/memory-bank/flows/templates/process/README.md create mode 100644 template/memory-bank/flows/templates/process/lifecycle-protocol.md create mode 100644 template/memory-bank/flows/templates/process/priming.yaml create mode 100644 template/memory-bank/flows/templates/process/process-card.md create mode 100644 template/memory-bank/flows/templates/process/session-handoff.md diff --git a/memory-bank/flows/priming/README.md b/memory-bank/flows/priming/README.md index 91192a6..2e6a9f4 100644 --- a/memory-bank/flows/priming/README.md +++ b/memory-bank/flows/priming/README.md @@ -36,4 +36,5 @@ audience: humans_and_agents - [PRD manifest](prd.yaml) — PRD creation and update. - [ADR manifest](adr.yaml) — ADR creation and update. - [Operations manifest](ops.yaml) — operations and release work. +- [Process Documentation manifest](process.yaml) — process creation and update. - [Governance manifest](governance.yaml) — Memory Bank governance work. diff --git a/memory-bank/flows/priming/process.yaml b/memory-bank/flows/priming/process.yaml new file mode 100644 index 0000000..d04f6ee --- /dev/null +++ b/memory-bank/flows/priming/process.yaml @@ -0,0 +1,11 @@ +version: 1 +process: process_documentation +stages: + create_update: + - memory-bank/flows/templates/process/process-card.md + - memory-bank/flows/templates/process/lifecycle-protocol.md + - memory-bank/flows/templates/process/session-handoff.md + - memory-bank/flows/templates/process/priming.yaml + - memory-bank/dna/governance.md + - memory-bank/dna/lifecycle.md + - memory-bank/dna/frontmatter.md diff --git a/memory-bank/flows/templates/README.md b/memory-bank/flows/templates/README.md index 7733fd1..662df8d 100644 --- a/memory-bank/flows/templates/README.md +++ b/memory-bank/flows/templates/README.md @@ -32,6 +32,10 @@ derived_from: - feature/support/ui-reference.md - feature/support/use-cases.md - adr/ADR-XXX.md + - process/README.md + - process/process-card.md + - process/session-handoff.md + - process/lifecycle-protocol.md status: active audience: humans_and_agents --- @@ -68,3 +72,7 @@ audience: humans_and_agents - [FT-XXX: Feature Use Cases Template](feature/support/use-cases.md) — optional support template для derived use cases, BDD example map, test candidates и `FUC → SC/NEG → REQ → CHK` review mapping без нового acceptance owner. - [ADR-XXX: Short Decision Name](adr/ADR-XXX.md) — шаблон ADR. Отвечает на вопрос: как зафиксировать архитектурное решение. - [PROMPT-XXX: Reusable Prompt Name](prompt/PROMPT-XXX.md) — шаблон reusable prompt-документа. Отвечает на вопрос: как сохранить исходную формулировку в frontmatter и улучшенный prompt в copyable body-блоке. +- [PROC-XXX: Process Documentation Index](process/README.md) — шаблон индекса процесс-документов. Отвечает на вопрос: как собрать routing-layer для reusable process cards, session handoff и lifecycle protocol. +- [PROC-XXX: Compact Process Card](process/process-card.md) — шаблон короткого reusable workflow. Отвечает на вопрос: как зафиксировать процесс с одним trigger, шагами и exit criteria. +- [PROC-XXX: Session Handoff](process/session-handoff.md) — шаблон передачи состояния между сессиями. Отвечает на вопрос: как продолжить процесс без потери assumptions, risks и next checks. +- [PROC-XXX: Lifecycle Protocol](process/lifecycle-protocol.md) — шаблон полного lifecycle protocol. Отвечает на вопрос: как вести multi-phase process с gates, verification и rollback. diff --git a/memory-bank/flows/templates/process/README.md b/memory-bank/flows/templates/process/README.md new file mode 100644 index 0000000..40f9ce4 --- /dev/null +++ b/memory-bank/flows/templates/process/README.md @@ -0,0 +1,82 @@ +--- +title: "PROC-XXX: Process Documentation Index" +doc_kind: process +doc_function: template +purpose: Governed wrapper-шаблон для `processes/README.md`. Читать, чтобы собрать каталог процесс-документов проекта без смешения wrapper-метаданных и frontmatter будущего index-документа. +derived_from: + - ../../../dna/governance.md + - ../../../dna/frontmatter.md + - ../../routing.md + - ../../priming/context-priming.md +status: active +audience: humans_and_agents +template_for: process +template_target_path: ../../../processes/README.md +canonical_for: + - process_template_index +--- + +# PROC-XXX: Process Documentation Index + +Этот файл описывает wrapper-template. Инстанцируемый `processes/README.md` живет ниже как embedded contract и копируется без wrapper frontmatter и history. + +## Priming Inputs + +Прочитай [`process.yaml`](../../priming/process.yaml) и выполни source set +`create_update`. + +## Wrapper Notes + +Каталог `processes/` нужен для reusable process-documents, которые живут между ad-hoc заметкой и feature package. Он помогает держать процесс отдельно от продуктового scope: сюда попадают повторяемые workflows, session handoff, lifecycle protocols и другие управляемые последовательности действий. + +Этот index-шаблон предназначен для навигации по трехуровневой process-линейке: + +- компактная карточка процесса; +- session handoff для продолжения работы между сессиями; +- lifecycle protocol для длинных delivery-процессов с gates и verification. + +Для каждого concrete process создай отдельный +`memory-bank/processes/.priming.yaml` из +[`priming.yaml`](priming.yaml). Process document в `Priming Inputs` указывает +этот manifest и нужные stage keys. Пути и bounded masks живут только в +manifest и разрешаются по +[`Context Priming Contract`](../../priming/context-priming.md). + +Если проекту достаточно одного процесса, всё равно оставь `README.md` как routing-layer: он фиксирует, какие process-documents существуют, что они покрывают и когда их открывать. + +## Instantiated Frontmatter + +```yaml +title: "Process Documentation Index" +doc_kind: process +doc_function: index +purpose: "Навигация по reusable process-документам проекта и выбор правильного шаблона для конкретного workflow." +derived_from: + - ../flows/routing.md +status: active +audience: humans_and_agents +``` + +## Instantiated Body + +```markdown +# Process Documentation Index + +## О каталоге + +Каталог `processes/` хранит reusable процесс-документы: компактные карточки процессов, session handoff для продолжения работы между сессиями и lifecycle protocol для сложных delivery-flow с проверками и gates. + +## Аннотированный индекс + +- [`process-card.md`](process-card.md) + Читать, когда нужен компактный, повторяемый процесс без большой state machine. + Отвечает на вопрос: как зафиксировать короткий workflow, который можно выполнять по одной карточке. + +- [`session-handoff.md`](session-handoff.md) + Читать, когда работа переносится между сессиями или компьютерами и нужно сохранить current state, assumptions, risks и next checks. + Отвечает на вопрос: как безопасно продолжить уже начатый процесс без потери контекста. + +- [`lifecycle-protocol.md`](lifecycle-protocol.md) + Читать, когда процесс состоит из фаз, human gates, verification и rollback и должен переживать длинный delivery-cycle. + Отвечает на вопрос: как управлять полным жизненным циклом изменения от старта до handoff или closure. +``` diff --git a/memory-bank/flows/templates/process/lifecycle-protocol.md b/memory-bank/flows/templates/process/lifecycle-protocol.md new file mode 100644 index 0000000..4e015cb --- /dev/null +++ b/memory-bank/flows/templates/process/lifecycle-protocol.md @@ -0,0 +1,134 @@ +--- +title: "PROC-XXX: Lifecycle Protocol" +doc_kind: process +doc_function: template +purpose: Governed wrapper-шаблон для полного lifecycle protocol. Читать, когда процесс проходит через фазы, gates, verification и rollback. +derived_from: + - ../../../dna/governance.md + - ../../../dna/frontmatter.md + - ../../routing.md + - ../../priming/context-priming.md + - ../../feature.md +status: active +audience: humans_and_agents +template_for: process +template_target_path: ../../../processes/PROCESS-XXX-lifecycle-protocol.md +canonical_for: + - process_template_lifecycle_protocol +--- + +# PROC-XXX: Lifecycle Protocol + +Этот файл описывает wrapper-template. Инстанцируемый lifecycle protocol живет ниже как embedded contract и копируется без wrapper frontmatter и history. + +## Wrapper Notes + +Это heavyweight-вариант для длинных изменений и управляемых delivery-processes: здесь процесс разбивается на фазы, а каждая фаза имеет свои exit criteria, checks, evidence и human gates. + +Используй этот шаблон, когда: + +- есть несколько фаз работы; +- нужен явный owner и approval flow; +- важно разделить implementation, verification и handoff; +- требуется rollback или stop conditions; +- процесс должен переживать не одну сессию. + +Этот шаблон ближе всего к `brief -> optional design -> plan -> implement -> verify -> ship`, а не к короткой рутине. + +## Instantiated Frontmatter + +```yaml +title: "PROC-XXX: Lifecycle Protocol" +doc_kind: process +doc_function: canonical +purpose: "Описывает полный процесс изменения с фазами, gates, verification и rollback." +derived_from: + - README.md + - ../flows/feature.md +status: draft +audience: humans_and_agents +must_not_define: + - product_strategy + - domain_model +``` + +## Instantiated Body + +```markdown +# PROC-XXX: Lifecycle Protocol + +## Goal + +Какой результат должен быть достигнут и почему этот процесс вообще нужен. + +## Scope + +### In Scope + +- Что входит в этот lifecycle. + +### Out Of Scope + +- Что исключено из процесса. + +## Baseline Facts + +- Что уже известно. +- На каких проверенных фактах держится старт процесса. + +## Priming Inputs + +Прочитай `memory-bank/processes/.priming.yaml`. Выполни source set +`entry`, затем добавляй source sets перед соответствующими фазами. + +## Phases + +### Phase 1: Prepare + +- Подготовить входные данные. +- Уточнить неизвестности. +- Зафиксировать стартовый state. + +### Phase 2: Execute + +- Выполнить основную работу. +- Двигаться по step-by-step plan. + +### Phase 3: Verify + +- Прогнать проверки. +- Зафиксировать evidence. + +### Phase 4: Hand Off or Close + +- Передать следующий state или закрыть процесс. + +## Human Gates + +### H1 + +- Что можно делать только после явного одобрения. + +### H2 + +- Что требует commit point или acceptance. + +### H3 + +- Что является destructive / irreversible action. + +## Verification + +- Какие проверки обязательны. +- Какой evidence должен остаться. + +## Rollback + +- Что делать, если процесс нужно откатить. +- Где проходит точка невозврата. + +## Stop Conditions + +- Что заставляет немедленно остановиться, включая missing или conflicting + priming input. +``` diff --git a/memory-bank/flows/templates/process/priming.yaml b/memory-bank/flows/templates/process/priming.yaml new file mode 100644 index 0000000..39228e8 --- /dev/null +++ b/memory-bank/flows/templates/process/priming.yaml @@ -0,0 +1,7 @@ +version: 1 +process: +stages: + entry: + - memory-bank/path/to/document.md + continuation: + - memory-bank/path/to/current-state.md diff --git a/memory-bank/flows/templates/process/process-card.md b/memory-bank/flows/templates/process/process-card.md new file mode 100644 index 0000000..8524801 --- /dev/null +++ b/memory-bank/flows/templates/process/process-card.md @@ -0,0 +1,101 @@ +--- +title: "PROC-XXX: Compact Process Card" +doc_kind: process +doc_function: template +purpose: Governed wrapper-шаблон для компактной process-card. Читать, чтобы зафиксировать короткий reusable workflow без тяжёлого lifecycle-каркаса. +derived_from: + - ../../../dna/governance.md + - ../../../dna/frontmatter.md + - ../../routing.md + - ../../priming/context-priming.md +status: active +audience: humans_and_agents +template_for: process +template_target_path: ../../../processes/PROCESS-XXX-process-card.md +canonical_for: + - process_template_card +--- + +# PROC-XXX: Compact Process Card + +Этот файл описывает wrapper-template. Инстанцируемый process-card живет ниже как embedded contract и копируется без wrapper frontmatter и history. + +## Wrapper Notes + +Этот вариант нужен, когда процесс повторяется часто, но не требует полноценного protocol: один trigger, понятный owner, короткий список шагов и ясные exit criteria. + +Хороший кандидат для этого шаблона: + +- короткий ручной workflow; +- операционная рутина; +- повторяемый internal step без сложных gates; +- процесс, который удобно описывать на одной странице. + +Если процесс начинает требовать handoff state, approval gates, rollback или явные verification phase, это сигнал перейти к `session-handoff.md` или `lifecycle-protocol.md`. + +## Instantiated Frontmatter + +```yaml +title: "PROC-XXX: Compact Process Card" +doc_kind: process +doc_function: canonical +purpose: "Фиксирует короткий reusable workflow с одним trigger, owner, шагами и exit criteria." +derived_from: + - README.md +status: draft +audience: humans_and_agents +must_not_define: + - full_delivery_lifecycle + - approval_gates + - rollback_protocol +``` + +## Instantiated Body + +```markdown +# PROC-XXX: Compact Process Card + +## Purpose + +Коротко опиши, зачем этот процесс существует и какой результат он должен стабильно давать. + +## Trigger + +- Что запускает процесс. +- Кто его инициирует. +- Какие входные данные нужны перед стартом. + +## Priming Inputs + +Прочитай `memory-bank/processes/.priming.yaml` и выполни source +set `entry`. + +## Scope + +### In Scope + +- Что этот workflow делает. + +### Out Of Scope + +- Что он сознательно не покрывает. + +## Steps + +1. Шаг 1. +2. Шаг 2. +3. Шаг 3. + +## Exit Criteria + +- Что должно быть истинно, чтобы процесс считался завершенным. + +## Evidence + +- Какой артефакт, лог, ссылка или статус подтверждает выполнение. + +## Escalation + +- Когда процесс нужно остановить и поднять к человеку, включая missing или + conflicting priming input. +``` diff --git a/memory-bank/flows/templates/process/session-handoff.md b/memory-bank/flows/templates/process/session-handoff.md new file mode 100644 index 0000000..deda354 --- /dev/null +++ b/memory-bank/flows/templates/process/session-handoff.md @@ -0,0 +1,108 @@ +--- +title: "PROC-XXX: Session Handoff" +doc_kind: process +doc_function: template +purpose: Governed wrapper-шаблон для session handoff. Читать, чтобы сохранять состояние процесса между сессиями без потери assumptions, risks и next checks. +derived_from: + - ../../../dna/governance.md + - ../../../dna/frontmatter.md + - ../../routing.md + - ../../priming/context-priming.md +status: active +audience: humans_and_agents +template_for: process +template_target_path: ../../../processes/PROCESS-XXX-session-handoff.md +canonical_for: + - process_template_session_handoff +--- + +# PROC-XXX: Session Handoff + +Этот файл описывает wrapper-template. Инстанцируемый session handoff живет ниже как embedded contract и копируется без wrapper frontmatter и history. + +## Wrapper Notes + +Это шаблон для случаев, когда работа прерывается и должна быть продолжена позже: новая сессия, другой компьютер, другой оператор или long-running workflow с паузами между шагами. + +Ключевая идея: в handoff попадают не все детали подряд, а только то, что реально нужно для безопасного продолжения. + +Обязательно фиксируй: + +- текущий выполненный шаг; +- текущий шаг, на котором остановились; +- рабочие допущения; +- открытые риски; +- ближайшие проверки; +- следующую конкретную action. + +Если процесс начинает требовать формальных gates, rollback и multi-phase verification, используй `lifecycle-protocol.md`. + +## Instantiated Frontmatter + +```yaml +title: "PROC-XXX: Session Handoff" +doc_kind: process +doc_function: canonical +purpose: "Фиксирует состояние незавершенного процесса так, чтобы следующая сессия могла продолжить работу без потери контекста." +derived_from: + - README.md +status: draft +audience: humans_and_agents +must_not_define: + - long_term_project_policy + - product_scope +``` + +## Instantiated Body + +```markdown +# PROC-XXX: Session Handoff + +## Current State + +- Что уже сделано. +- Где именно остановились. +- Какой артефакт является актуальным. + +## Continuation Priming Inputs + +Прочитай `memory-bank/processes/.priming.yaml` и выполни source +set `continuation`. + +## Completed + +- Список завершенных шагов или проверок. + +## Current Step + +- Один конкретный шаг, который выполняется сейчас или должен быть выполнен следующим. + +## Assumptions + +- Какие допущения были приняты по ходу работы. + +## Open Risks + +- Какие риски еще не сняты. + +## Next Checks + +- Что нужно проверить перед продолжением. + +## Evidence Log + +| Time | Fact / action | Evidence | +|---|---|---| +| `` | `` | `` | + +## Next Action + +- Кто действует. +- Что именно он делает. +- Когда останавливаемся. + +## Stop Conditions + +- Когда нельзя продолжать без человека, включая divergence между priming input + и handoff state. +``` diff --git a/template/memory-bank/flows/priming/README.md b/template/memory-bank/flows/priming/README.md index 91192a6..2e6a9f4 100644 --- a/template/memory-bank/flows/priming/README.md +++ b/template/memory-bank/flows/priming/README.md @@ -36,4 +36,5 @@ audience: humans_and_agents - [PRD manifest](prd.yaml) — PRD creation and update. - [ADR manifest](adr.yaml) — ADR creation and update. - [Operations manifest](ops.yaml) — operations and release work. +- [Process Documentation manifest](process.yaml) — process creation and update. - [Governance manifest](governance.yaml) — Memory Bank governance work. diff --git a/template/memory-bank/flows/priming/process.yaml b/template/memory-bank/flows/priming/process.yaml new file mode 100644 index 0000000..d04f6ee --- /dev/null +++ b/template/memory-bank/flows/priming/process.yaml @@ -0,0 +1,11 @@ +version: 1 +process: process_documentation +stages: + create_update: + - memory-bank/flows/templates/process/process-card.md + - memory-bank/flows/templates/process/lifecycle-protocol.md + - memory-bank/flows/templates/process/session-handoff.md + - memory-bank/flows/templates/process/priming.yaml + - memory-bank/dna/governance.md + - memory-bank/dna/lifecycle.md + - memory-bank/dna/frontmatter.md diff --git a/template/memory-bank/flows/templates/README.md b/template/memory-bank/flows/templates/README.md index 7733fd1..662df8d 100644 --- a/template/memory-bank/flows/templates/README.md +++ b/template/memory-bank/flows/templates/README.md @@ -32,6 +32,10 @@ derived_from: - feature/support/ui-reference.md - feature/support/use-cases.md - adr/ADR-XXX.md + - process/README.md + - process/process-card.md + - process/session-handoff.md + - process/lifecycle-protocol.md status: active audience: humans_and_agents --- @@ -68,3 +72,7 @@ audience: humans_and_agents - [FT-XXX: Feature Use Cases Template](feature/support/use-cases.md) — optional support template для derived use cases, BDD example map, test candidates и `FUC → SC/NEG → REQ → CHK` review mapping без нового acceptance owner. - [ADR-XXX: Short Decision Name](adr/ADR-XXX.md) — шаблон ADR. Отвечает на вопрос: как зафиксировать архитектурное решение. - [PROMPT-XXX: Reusable Prompt Name](prompt/PROMPT-XXX.md) — шаблон reusable prompt-документа. Отвечает на вопрос: как сохранить исходную формулировку в frontmatter и улучшенный prompt в copyable body-блоке. +- [PROC-XXX: Process Documentation Index](process/README.md) — шаблон индекса процесс-документов. Отвечает на вопрос: как собрать routing-layer для reusable process cards, session handoff и lifecycle protocol. +- [PROC-XXX: Compact Process Card](process/process-card.md) — шаблон короткого reusable workflow. Отвечает на вопрос: как зафиксировать процесс с одним trigger, шагами и exit criteria. +- [PROC-XXX: Session Handoff](process/session-handoff.md) — шаблон передачи состояния между сессиями. Отвечает на вопрос: как продолжить процесс без потери assumptions, risks и next checks. +- [PROC-XXX: Lifecycle Protocol](process/lifecycle-protocol.md) — шаблон полного lifecycle protocol. Отвечает на вопрос: как вести multi-phase process с gates, verification и rollback. diff --git a/template/memory-bank/flows/templates/process/README.md b/template/memory-bank/flows/templates/process/README.md new file mode 100644 index 0000000..40f9ce4 --- /dev/null +++ b/template/memory-bank/flows/templates/process/README.md @@ -0,0 +1,82 @@ +--- +title: "PROC-XXX: Process Documentation Index" +doc_kind: process +doc_function: template +purpose: Governed wrapper-шаблон для `processes/README.md`. Читать, чтобы собрать каталог процесс-документов проекта без смешения wrapper-метаданных и frontmatter будущего index-документа. +derived_from: + - ../../../dna/governance.md + - ../../../dna/frontmatter.md + - ../../routing.md + - ../../priming/context-priming.md +status: active +audience: humans_and_agents +template_for: process +template_target_path: ../../../processes/README.md +canonical_for: + - process_template_index +--- + +# PROC-XXX: Process Documentation Index + +Этот файл описывает wrapper-template. Инстанцируемый `processes/README.md` живет ниже как embedded contract и копируется без wrapper frontmatter и history. + +## Priming Inputs + +Прочитай [`process.yaml`](../../priming/process.yaml) и выполни source set +`create_update`. + +## Wrapper Notes + +Каталог `processes/` нужен для reusable process-documents, которые живут между ad-hoc заметкой и feature package. Он помогает держать процесс отдельно от продуктового scope: сюда попадают повторяемые workflows, session handoff, lifecycle protocols и другие управляемые последовательности действий. + +Этот index-шаблон предназначен для навигации по трехуровневой process-линейке: + +- компактная карточка процесса; +- session handoff для продолжения работы между сессиями; +- lifecycle protocol для длинных delivery-процессов с gates и verification. + +Для каждого concrete process создай отдельный +`memory-bank/processes/.priming.yaml` из +[`priming.yaml`](priming.yaml). Process document в `Priming Inputs` указывает +этот manifest и нужные stage keys. Пути и bounded masks живут только в +manifest и разрешаются по +[`Context Priming Contract`](../../priming/context-priming.md). + +Если проекту достаточно одного процесса, всё равно оставь `README.md` как routing-layer: он фиксирует, какие process-documents существуют, что они покрывают и когда их открывать. + +## Instantiated Frontmatter + +```yaml +title: "Process Documentation Index" +doc_kind: process +doc_function: index +purpose: "Навигация по reusable process-документам проекта и выбор правильного шаблона для конкретного workflow." +derived_from: + - ../flows/routing.md +status: active +audience: humans_and_agents +``` + +## Instantiated Body + +```markdown +# Process Documentation Index + +## О каталоге + +Каталог `processes/` хранит reusable процесс-документы: компактные карточки процессов, session handoff для продолжения работы между сессиями и lifecycle protocol для сложных delivery-flow с проверками и gates. + +## Аннотированный индекс + +- [`process-card.md`](process-card.md) + Читать, когда нужен компактный, повторяемый процесс без большой state machine. + Отвечает на вопрос: как зафиксировать короткий workflow, который можно выполнять по одной карточке. + +- [`session-handoff.md`](session-handoff.md) + Читать, когда работа переносится между сессиями или компьютерами и нужно сохранить current state, assumptions, risks и next checks. + Отвечает на вопрос: как безопасно продолжить уже начатый процесс без потери контекста. + +- [`lifecycle-protocol.md`](lifecycle-protocol.md) + Читать, когда процесс состоит из фаз, human gates, verification и rollback и должен переживать длинный delivery-cycle. + Отвечает на вопрос: как управлять полным жизненным циклом изменения от старта до handoff или closure. +``` diff --git a/template/memory-bank/flows/templates/process/lifecycle-protocol.md b/template/memory-bank/flows/templates/process/lifecycle-protocol.md new file mode 100644 index 0000000..4e015cb --- /dev/null +++ b/template/memory-bank/flows/templates/process/lifecycle-protocol.md @@ -0,0 +1,134 @@ +--- +title: "PROC-XXX: Lifecycle Protocol" +doc_kind: process +doc_function: template +purpose: Governed wrapper-шаблон для полного lifecycle protocol. Читать, когда процесс проходит через фазы, gates, verification и rollback. +derived_from: + - ../../../dna/governance.md + - ../../../dna/frontmatter.md + - ../../routing.md + - ../../priming/context-priming.md + - ../../feature.md +status: active +audience: humans_and_agents +template_for: process +template_target_path: ../../../processes/PROCESS-XXX-lifecycle-protocol.md +canonical_for: + - process_template_lifecycle_protocol +--- + +# PROC-XXX: Lifecycle Protocol + +Этот файл описывает wrapper-template. Инстанцируемый lifecycle protocol живет ниже как embedded contract и копируется без wrapper frontmatter и history. + +## Wrapper Notes + +Это heavyweight-вариант для длинных изменений и управляемых delivery-processes: здесь процесс разбивается на фазы, а каждая фаза имеет свои exit criteria, checks, evidence и human gates. + +Используй этот шаблон, когда: + +- есть несколько фаз работы; +- нужен явный owner и approval flow; +- важно разделить implementation, verification и handoff; +- требуется rollback или stop conditions; +- процесс должен переживать не одну сессию. + +Этот шаблон ближе всего к `brief -> optional design -> plan -> implement -> verify -> ship`, а не к короткой рутине. + +## Instantiated Frontmatter + +```yaml +title: "PROC-XXX: Lifecycle Protocol" +doc_kind: process +doc_function: canonical +purpose: "Описывает полный процесс изменения с фазами, gates, verification и rollback." +derived_from: + - README.md + - ../flows/feature.md +status: draft +audience: humans_and_agents +must_not_define: + - product_strategy + - domain_model +``` + +## Instantiated Body + +```markdown +# PROC-XXX: Lifecycle Protocol + +## Goal + +Какой результат должен быть достигнут и почему этот процесс вообще нужен. + +## Scope + +### In Scope + +- Что входит в этот lifecycle. + +### Out Of Scope + +- Что исключено из процесса. + +## Baseline Facts + +- Что уже известно. +- На каких проверенных фактах держится старт процесса. + +## Priming Inputs + +Прочитай `memory-bank/processes/.priming.yaml`. Выполни source set +`entry`, затем добавляй source sets перед соответствующими фазами. + +## Phases + +### Phase 1: Prepare + +- Подготовить входные данные. +- Уточнить неизвестности. +- Зафиксировать стартовый state. + +### Phase 2: Execute + +- Выполнить основную работу. +- Двигаться по step-by-step plan. + +### Phase 3: Verify + +- Прогнать проверки. +- Зафиксировать evidence. + +### Phase 4: Hand Off or Close + +- Передать следующий state или закрыть процесс. + +## Human Gates + +### H1 + +- Что можно делать только после явного одобрения. + +### H2 + +- Что требует commit point или acceptance. + +### H3 + +- Что является destructive / irreversible action. + +## Verification + +- Какие проверки обязательны. +- Какой evidence должен остаться. + +## Rollback + +- Что делать, если процесс нужно откатить. +- Где проходит точка невозврата. + +## Stop Conditions + +- Что заставляет немедленно остановиться, включая missing или conflicting + priming input. +``` diff --git a/template/memory-bank/flows/templates/process/priming.yaml b/template/memory-bank/flows/templates/process/priming.yaml new file mode 100644 index 0000000..39228e8 --- /dev/null +++ b/template/memory-bank/flows/templates/process/priming.yaml @@ -0,0 +1,7 @@ +version: 1 +process: +stages: + entry: + - memory-bank/path/to/document.md + continuation: + - memory-bank/path/to/current-state.md diff --git a/template/memory-bank/flows/templates/process/process-card.md b/template/memory-bank/flows/templates/process/process-card.md new file mode 100644 index 0000000..8524801 --- /dev/null +++ b/template/memory-bank/flows/templates/process/process-card.md @@ -0,0 +1,101 @@ +--- +title: "PROC-XXX: Compact Process Card" +doc_kind: process +doc_function: template +purpose: Governed wrapper-шаблон для компактной process-card. Читать, чтобы зафиксировать короткий reusable workflow без тяжёлого lifecycle-каркаса. +derived_from: + - ../../../dna/governance.md + - ../../../dna/frontmatter.md + - ../../routing.md + - ../../priming/context-priming.md +status: active +audience: humans_and_agents +template_for: process +template_target_path: ../../../processes/PROCESS-XXX-process-card.md +canonical_for: + - process_template_card +--- + +# PROC-XXX: Compact Process Card + +Этот файл описывает wrapper-template. Инстанцируемый process-card живет ниже как embedded contract и копируется без wrapper frontmatter и history. + +## Wrapper Notes + +Этот вариант нужен, когда процесс повторяется часто, но не требует полноценного protocol: один trigger, понятный owner, короткий список шагов и ясные exit criteria. + +Хороший кандидат для этого шаблона: + +- короткий ручной workflow; +- операционная рутина; +- повторяемый internal step без сложных gates; +- процесс, который удобно описывать на одной странице. + +Если процесс начинает требовать handoff state, approval gates, rollback или явные verification phase, это сигнал перейти к `session-handoff.md` или `lifecycle-protocol.md`. + +## Instantiated Frontmatter + +```yaml +title: "PROC-XXX: Compact Process Card" +doc_kind: process +doc_function: canonical +purpose: "Фиксирует короткий reusable workflow с одним trigger, owner, шагами и exit criteria." +derived_from: + - README.md +status: draft +audience: humans_and_agents +must_not_define: + - full_delivery_lifecycle + - approval_gates + - rollback_protocol +``` + +## Instantiated Body + +```markdown +# PROC-XXX: Compact Process Card + +## Purpose + +Коротко опиши, зачем этот процесс существует и какой результат он должен стабильно давать. + +## Trigger + +- Что запускает процесс. +- Кто его инициирует. +- Какие входные данные нужны перед стартом. + +## Priming Inputs + +Прочитай `memory-bank/processes/.priming.yaml` и выполни source +set `entry`. + +## Scope + +### In Scope + +- Что этот workflow делает. + +### Out Of Scope + +- Что он сознательно не покрывает. + +## Steps + +1. Шаг 1. +2. Шаг 2. +3. Шаг 3. + +## Exit Criteria + +- Что должно быть истинно, чтобы процесс считался завершенным. + +## Evidence + +- Какой артефакт, лог, ссылка или статус подтверждает выполнение. + +## Escalation + +- Когда процесс нужно остановить и поднять к человеку, включая missing или + conflicting priming input. +``` diff --git a/template/memory-bank/flows/templates/process/session-handoff.md b/template/memory-bank/flows/templates/process/session-handoff.md new file mode 100644 index 0000000..deda354 --- /dev/null +++ b/template/memory-bank/flows/templates/process/session-handoff.md @@ -0,0 +1,108 @@ +--- +title: "PROC-XXX: Session Handoff" +doc_kind: process +doc_function: template +purpose: Governed wrapper-шаблон для session handoff. Читать, чтобы сохранять состояние процесса между сессиями без потери assumptions, risks и next checks. +derived_from: + - ../../../dna/governance.md + - ../../../dna/frontmatter.md + - ../../routing.md + - ../../priming/context-priming.md +status: active +audience: humans_and_agents +template_for: process +template_target_path: ../../../processes/PROCESS-XXX-session-handoff.md +canonical_for: + - process_template_session_handoff +--- + +# PROC-XXX: Session Handoff + +Этот файл описывает wrapper-template. Инстанцируемый session handoff живет ниже как embedded contract и копируется без wrapper frontmatter и history. + +## Wrapper Notes + +Это шаблон для случаев, когда работа прерывается и должна быть продолжена позже: новая сессия, другой компьютер, другой оператор или long-running workflow с паузами между шагами. + +Ключевая идея: в handoff попадают не все детали подряд, а только то, что реально нужно для безопасного продолжения. + +Обязательно фиксируй: + +- текущий выполненный шаг; +- текущий шаг, на котором остановились; +- рабочие допущения; +- открытые риски; +- ближайшие проверки; +- следующую конкретную action. + +Если процесс начинает требовать формальных gates, rollback и multi-phase verification, используй `lifecycle-protocol.md`. + +## Instantiated Frontmatter + +```yaml +title: "PROC-XXX: Session Handoff" +doc_kind: process +doc_function: canonical +purpose: "Фиксирует состояние незавершенного процесса так, чтобы следующая сессия могла продолжить работу без потери контекста." +derived_from: + - README.md +status: draft +audience: humans_and_agents +must_not_define: + - long_term_project_policy + - product_scope +``` + +## Instantiated Body + +```markdown +# PROC-XXX: Session Handoff + +## Current State + +- Что уже сделано. +- Где именно остановились. +- Какой артефакт является актуальным. + +## Continuation Priming Inputs + +Прочитай `memory-bank/processes/.priming.yaml` и выполни source +set `continuation`. + +## Completed + +- Список завершенных шагов или проверок. + +## Current Step + +- Один конкретный шаг, который выполняется сейчас или должен быть выполнен следующим. + +## Assumptions + +- Какие допущения были приняты по ходу работы. + +## Open Risks + +- Какие риски еще не сняты. + +## Next Checks + +- Что нужно проверить перед продолжением. + +## Evidence Log + +| Time | Fact / action | Evidence | +|---|---|---| +| `` | `` | `` | + +## Next Action + +- Кто действует. +- Что именно он делает. +- Когда останавливаемся. + +## Stop Conditions + +- Когда нельзя продолжать без человека, включая divergence между priming input + и handoff state. +``` From 9d9440044a3ead86987713550c2ab3709b677df9 Mon Sep 17 00:00:00 2001 From: Danil Pismenny Date: Sun, 6 Sep 2026 22:02:45 +0300 Subject: [PATCH 3/3] docs: consolidate process handoff under execution contract --- .../templates/process/session-handoff.md | 1 - .../memory-bank/flows/priming/process.yaml | 2 +- .../memory-bank/flows/templates/README.md | 8 +- .../flows/templates/process/README.md | 30 +++-- .../templates/process/lifecycle-protocol.md | 14 +++ .../flows/templates/process/process-card.md | 14 ++- .../templates/process/session-handoff.md | 108 ------------------ 7 files changed, 55 insertions(+), 122 deletions(-) delete mode 120000 memory-bank/flows/templates/process/session-handoff.md delete mode 100644 template/memory-bank/flows/templates/process/session-handoff.md diff --git a/memory-bank/flows/templates/process/session-handoff.md b/memory-bank/flows/templates/process/session-handoff.md deleted file mode 120000 index 4667d0d..0000000 --- a/memory-bank/flows/templates/process/session-handoff.md +++ /dev/null @@ -1 +0,0 @@ -../../../../template/memory-bank/flows/templates/process/session-handoff.md \ No newline at end of file diff --git a/template/memory-bank/flows/priming/process.yaml b/template/memory-bank/flows/priming/process.yaml index d04f6ee..889d86b 100644 --- a/template/memory-bank/flows/priming/process.yaml +++ b/template/memory-bank/flows/priming/process.yaml @@ -4,7 +4,7 @@ stages: create_update: - memory-bank/flows/templates/process/process-card.md - memory-bank/flows/templates/process/lifecycle-protocol.md - - memory-bank/flows/templates/process/session-handoff.md + - memory-bank/flows/execution-handoff.md - memory-bank/flows/templates/process/priming.yaml - memory-bank/dna/governance.md - memory-bank/dna/lifecycle.md diff --git a/template/memory-bank/flows/templates/README.md b/template/memory-bank/flows/templates/README.md index 662df8d..20a6b43 100644 --- a/template/memory-bank/flows/templates/README.md +++ b/template/memory-bank/flows/templates/README.md @@ -34,7 +34,6 @@ derived_from: - adr/ADR-XXX.md - process/README.md - process/process-card.md - - process/session-handoff.md - process/lifecycle-protocol.md status: active audience: humans_and_agents @@ -72,7 +71,10 @@ audience: humans_and_agents - [FT-XXX: Feature Use Cases Template](feature/support/use-cases.md) — optional support template для derived use cases, BDD example map, test candidates и `FUC → SC/NEG → REQ → CHK` review mapping без нового acceptance owner. - [ADR-XXX: Short Decision Name](adr/ADR-XXX.md) — шаблон ADR. Отвечает на вопрос: как зафиксировать архитектурное решение. - [PROMPT-XXX: Reusable Prompt Name](prompt/PROMPT-XXX.md) — шаблон reusable prompt-документа. Отвечает на вопрос: как сохранить исходную формулировку в frontmatter и улучшенный prompt в copyable body-блоке. -- [PROC-XXX: Process Documentation Index](process/README.md) — шаблон индекса процесс-документов. Отвечает на вопрос: как собрать routing-layer для reusable process cards, session handoff и lifecycle protocol. +- [PROC-XXX: Process Documentation Index](process/README.md) — шаблон индекса процесс-документов. Отвечает на вопрос: как собрать routing-layer для reusable process cards и lifecycle protocol. - [PROC-XXX: Compact Process Card](process/process-card.md) — шаблон короткого reusable workflow. Отвечает на вопрос: как зафиксировать процесс с одним trigger, шагами и exit criteria. -- [PROC-XXX: Session Handoff](process/session-handoff.md) — шаблон передачи состояния между сессиями. Отвечает на вопрос: как продолжить процесс без потери assumptions, risks и next checks. - [PROC-XXX: Lifecycle Protocol](process/lifecycle-protocol.md) — шаблон полного lifecycle protocol. Отвечает на вопрос: как вести multi-phase process с gates, verification и rollback. + +Для передачи состояния одной конкретной задачи используй +[Execution Handoff Contract](../execution-handoff.md) — единый контракт +проверяемой read-only проекции исполнения с первичными источниками. diff --git a/template/memory-bank/flows/templates/process/README.md b/template/memory-bank/flows/templates/process/README.md index 40f9ce4..ad8b5e4 100644 --- a/template/memory-bank/flows/templates/process/README.md +++ b/template/memory-bank/flows/templates/process/README.md @@ -8,6 +8,7 @@ derived_from: - ../../../dna/frontmatter.md - ../../routing.md - ../../priming/context-priming.md + - ../../execution-handoff.md status: active audience: humans_and_agents template_for: process @@ -27,14 +28,18 @@ canonical_for: ## Wrapper Notes -Каталог `processes/` нужен для reusable process-documents, которые живут между ad-hoc заметкой и feature package. Он помогает держать процесс отдельно от продуктового scope: сюда попадают повторяемые workflows, session handoff, lifecycle protocols и другие управляемые последовательности действий. +Каталог `processes/` нужен для reusable process-documents, которые живут между ad-hoc заметкой и feature package. Он помогает держать процесс отдельно от продуктового scope: сюда попадают повторяемые workflows, lifecycle protocols и другие управляемые последовательности действий. -Этот index-шаблон предназначен для навигации по трехуровневой process-линейке: +Этот index-шаблон предназначен для навигации по двум форматам описания процесса: - компактная карточка процесса; -- session handoff для продолжения работы между сессиями; - lifecycle protocol для длинных delivery-процессов с gates и verification. +Для передачи состояния одной конкретной задачи используй +[Execution Handoff Contract](../../execution-handoff.md). Карточка и protocol +задают процедуру; handoff передаёт derived, read-only снимок её исполнения с +первичными источниками, не становясь владельцем состояния или правил процесса. + Для каждого concrete process создай отдельный `memory-bank/processes/.priming.yaml` из [`priming.yaml`](priming.yaml). Process document в `Priming Inputs` указывает @@ -42,6 +47,10 @@ canonical_for: manifest и разрешаются по [`Context Priming Contract`](../../priming/context-priming.md). +Для продолжения задачи process document указывает source set `continuation` +того же manifest. Выполни его до чтения handoff; canonical inputs и проверка +их актуальности остаются обязательными по Execution Handoff Contract. + Если проекту достаточно одного процесса, всё равно оставь `README.md` как routing-layer: он фиксирует, какие process-documents существуют, что они покрывают и когда их открывать. ## Instantiated Frontmatter @@ -53,6 +62,7 @@ doc_function: index purpose: "Навигация по reusable process-документам проекта и выбор правильного шаблона для конкретного workflow." derived_from: - ../flows/routing.md + - ../flows/execution-handoff.md status: active audience: humans_and_agents ``` @@ -64,7 +74,7 @@ audience: humans_and_agents ## О каталоге -Каталог `processes/` хранит reusable процесс-документы: компактные карточки процессов, session handoff для продолжения работы между сессиями и lifecycle protocol для сложных delivery-flow с проверками и gates. +Каталог `processes/` хранит reusable процесс-документы: компактные карточки процессов и lifecycle protocol для сложных delivery-flow с проверками и gates. ## Аннотированный индекс @@ -72,11 +82,15 @@ audience: humans_and_agents Читать, когда нужен компактный, повторяемый процесс без большой state machine. Отвечает на вопрос: как зафиксировать короткий workflow, который можно выполнять по одной карточке. -- [`session-handoff.md`](session-handoff.md) - Читать, когда работа переносится между сессиями или компьютерами и нужно сохранить current state, assumptions, risks и next checks. - Отвечает на вопрос: как безопасно продолжить уже начатый процесс без потери контекста. - - [`lifecycle-protocol.md`](lifecycle-protocol.md) Читать, когда процесс состоит из фаз, human gates, verification и rollback и должен переживать длинный delivery-cycle. Отвечает на вопрос: как управлять полным жизненным циклом изменения от старта до handoff или closure. + +## Продолжение конкретной задачи + +Выполни source set `continuation` из manifest, указанного в process document, +затем прочитай handoff по +[Execution Handoff Contract](../flows/execution-handoff.md). +Он передаёт наблюдаемое состояние одной задачи с первичными источниками; +правила процедуры и canonical owners сохраняют свою роль. ``` diff --git a/template/memory-bank/flows/templates/process/lifecycle-protocol.md b/template/memory-bank/flows/templates/process/lifecycle-protocol.md index 4e015cb..5192ded 100644 --- a/template/memory-bank/flows/templates/process/lifecycle-protocol.md +++ b/template/memory-bank/flows/templates/process/lifecycle-protocol.md @@ -9,6 +9,7 @@ derived_from: - ../../routing.md - ../../priming/context-priming.md - ../../feature.md + - ../../execution-handoff.md status: active audience: humans_and_agents template_for: process @@ -35,6 +36,10 @@ canonical_for: Этот шаблон ближе всего к `brief -> optional design -> plan -> implement -> verify -> ship`, а не к короткой рутине. +При передаче конкретной задачи между сессиями или исполнителями используй +[Execution Handoff Contract](../../execution-handoff.md). Protocol задаёт фазы +и gates; handoff передаёт наблюдаемое состояние одной задачи и сам gate не закрывает. + ## Instantiated Frontmatter ```yaml @@ -45,6 +50,7 @@ purpose: "Описывает полный процесс изменения с derived_from: - README.md - ../flows/feature.md + - ../flows/execution-handoff.md status: draft audience: humans_and_agents must_not_define: @@ -103,6 +109,14 @@ must_not_define: - Передать следующий state или закрыть процесс. +## Continuation + +Перед продолжением выполни source set `continuation` из +`memory-bank/processes/.priming.yaml`, затем прочитай handoff по +[Execution Handoff Contract](../flows/execution-handoff.md). +При передаче работы используй этот контракт; evidence прохождения gates +остаётся у владельца соответствующего lifecycle. + ## Human Gates ### H1 diff --git a/template/memory-bank/flows/templates/process/process-card.md b/template/memory-bank/flows/templates/process/process-card.md index 8524801..7956d79 100644 --- a/template/memory-bank/flows/templates/process/process-card.md +++ b/template/memory-bank/flows/templates/process/process-card.md @@ -8,6 +8,7 @@ derived_from: - ../../../dna/frontmatter.md - ../../routing.md - ../../priming/context-priming.md + - ../../execution-handoff.md status: active audience: humans_and_agents template_for: process @@ -31,7 +32,10 @@ canonical_for: - повторяемый internal step без сложных gates; - процесс, который удобно описывать на одной странице. -Если процесс начинает требовать handoff state, approval gates, rollback или явные verification phase, это сигнал перейти к `session-handoff.md` или `lifecycle-protocol.md`. +Для продолжения конкретной задачи между сессиями используй +[Execution Handoff Contract](../../execution-handoff.md); карточка по-прежнему +задаёт процедуру. Если сама процедура требует approval gates, rollback или +явных verification phases, используй [`lifecycle-protocol.md`](lifecycle-protocol.md). ## Instantiated Frontmatter @@ -42,6 +46,7 @@ doc_function: canonical purpose: "Фиксирует короткий reusable workflow с одним trigger, owner, шагами и exit criteria." derived_from: - README.md + - ../flows/execution-handoff.md status: draft audience: humans_and_agents must_not_define: @@ -98,4 +103,11 @@ set `entry`. - Когда процесс нужно остановить и поднять к человеку, включая missing или conflicting priming input. + +## Continuation + +Перед продолжением выполни source set `continuation` из +`memory-bank/processes/.priming.yaml`, затем прочитай handoff по +[Execution Handoff Contract](../flows/execution-handoff.md). +Передавай состояние одной задачи с первичными источниками по этому контракту. ``` diff --git a/template/memory-bank/flows/templates/process/session-handoff.md b/template/memory-bank/flows/templates/process/session-handoff.md deleted file mode 100644 index deda354..0000000 --- a/template/memory-bank/flows/templates/process/session-handoff.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: "PROC-XXX: Session Handoff" -doc_kind: process -doc_function: template -purpose: Governed wrapper-шаблон для session handoff. Читать, чтобы сохранять состояние процесса между сессиями без потери assumptions, risks и next checks. -derived_from: - - ../../../dna/governance.md - - ../../../dna/frontmatter.md - - ../../routing.md - - ../../priming/context-priming.md -status: active -audience: humans_and_agents -template_for: process -template_target_path: ../../../processes/PROCESS-XXX-session-handoff.md -canonical_for: - - process_template_session_handoff ---- - -# PROC-XXX: Session Handoff - -Этот файл описывает wrapper-template. Инстанцируемый session handoff живет ниже как embedded contract и копируется без wrapper frontmatter и history. - -## Wrapper Notes - -Это шаблон для случаев, когда работа прерывается и должна быть продолжена позже: новая сессия, другой компьютер, другой оператор или long-running workflow с паузами между шагами. - -Ключевая идея: в handoff попадают не все детали подряд, а только то, что реально нужно для безопасного продолжения. - -Обязательно фиксируй: - -- текущий выполненный шаг; -- текущий шаг, на котором остановились; -- рабочие допущения; -- открытые риски; -- ближайшие проверки; -- следующую конкретную action. - -Если процесс начинает требовать формальных gates, rollback и multi-phase verification, используй `lifecycle-protocol.md`. - -## Instantiated Frontmatter - -```yaml -title: "PROC-XXX: Session Handoff" -doc_kind: process -doc_function: canonical -purpose: "Фиксирует состояние незавершенного процесса так, чтобы следующая сессия могла продолжить работу без потери контекста." -derived_from: - - README.md -status: draft -audience: humans_and_agents -must_not_define: - - long_term_project_policy - - product_scope -``` - -## Instantiated Body - -```markdown -# PROC-XXX: Session Handoff - -## Current State - -- Что уже сделано. -- Где именно остановились. -- Какой артефакт является актуальным. - -## Continuation Priming Inputs - -Прочитай `memory-bank/processes/.priming.yaml` и выполни source -set `continuation`. - -## Completed - -- Список завершенных шагов или проверок. - -## Current Step - -- Один конкретный шаг, который выполняется сейчас или должен быть выполнен следующим. - -## Assumptions - -- Какие допущения были приняты по ходу работы. - -## Open Risks - -- Какие риски еще не сняты. - -## Next Checks - -- Что нужно проверить перед продолжением. - -## Evidence Log - -| Time | Fact / action | Evidence | -|---|---|---| -| `` | `` | `` | - -## Next Action - -- Кто действует. -- Что именно он делает. -- Когда останавливаемся. - -## Stop Conditions - -- Когда нельзя продолжать без человека, включая divergence между priming input - и handoff state. -```