From 6d71f1a28df311d9663cdd92a68188df9dd9fe50 Mon Sep 17 00:00:00 2001 From: Danil Pismenny Date: Sun, 6 Sep 2026 22:13:43 +0300 Subject: [PATCH] docs: remove process template subsystem --- memory-bank/flows/priming/process.yaml | 1 - memory-bank/flows/templates/process/README.md | 1 - .../templates/process/lifecycle-protocol.md | 1 - .../flows/templates/process/priming.yaml | 1 - .../flows/templates/process/process-card.md | 1 - .../templates/process/session-handoff.md | 1 - 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 -------------- 14 files changed, 458 deletions(-) delete mode 120000 memory-bank/flows/priming/process.yaml delete mode 120000 memory-bank/flows/templates/process/README.md delete mode 120000 memory-bank/flows/templates/process/lifecycle-protocol.md delete mode 120000 memory-bank/flows/templates/process/priming.yaml delete mode 120000 memory-bank/flows/templates/process/process-card.md delete mode 120000 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/process.yaml b/memory-bank/flows/priming/process.yaml deleted file mode 120000 index 84f3bec..0000000 --- a/memory-bank/flows/priming/process.yaml +++ /dev/null @@ -1 +0,0 @@ -../../../template/memory-bank/flows/priming/process.yaml \ No newline at end of file diff --git a/memory-bank/flows/templates/process/README.md b/memory-bank/flows/templates/process/README.md deleted file mode 120000 index 1f4e190..0000000 --- a/memory-bank/flows/templates/process/README.md +++ /dev/null @@ -1 +0,0 @@ -../../../../template/memory-bank/flows/templates/process/README.md \ No newline at end of file diff --git a/memory-bank/flows/templates/process/lifecycle-protocol.md b/memory-bank/flows/templates/process/lifecycle-protocol.md deleted file mode 120000 index 813e2cf..0000000 --- a/memory-bank/flows/templates/process/lifecycle-protocol.md +++ /dev/null @@ -1 +0,0 @@ -../../../../template/memory-bank/flows/templates/process/lifecycle-protocol.md \ No newline at end of file diff --git a/memory-bank/flows/templates/process/priming.yaml b/memory-bank/flows/templates/process/priming.yaml deleted file mode 120000 index 3ff8d62..0000000 --- a/memory-bank/flows/templates/process/priming.yaml +++ /dev/null @@ -1 +0,0 @@ -../../../../template/memory-bank/flows/templates/process/priming.yaml \ No newline at end of file diff --git a/memory-bank/flows/templates/process/process-card.md b/memory-bank/flows/templates/process/process-card.md deleted file mode 120000 index 6071648..0000000 --- a/memory-bank/flows/templates/process/process-card.md +++ /dev/null @@ -1 +0,0 @@ -../../../../template/memory-bank/flows/templates/process/process-card.md \ No newline at end of file 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/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. -```