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. -```