Skip to content

docs: consolidate process handoff under execution contract - #135

Open
dapi wants to merge 4 commits into
mainfrom
chore/drop-process-subsystem
Open

docs: consolidate process handoff under execution contract#135
dapi wants to merge 4 commits into
mainfrom
chore/drop-process-subsystem

Conversation

@dapi

@dapi dapi commented Sep 5, 2026

Copy link
Copy Markdown
Owner

Что и почему

Шаблон process/session-handoff.md и Execution Handoff предлагали два формата передачи состояния одной задачи. Теперь карточка процесса и lifecycle protocol используют существующий flows/execution-handoff.md: процедура остаётся у process document, а передаваемый снимок исполнения содержит ссылки на первичные источники.

Изменения

  • Удалены только конкурирующий process/session-handoff.md и его project-local симлинк.
  • Сохранены process-card.md, lifecycle-protocol.md, индекс процессов и оба process priming-манифеста.
  • Индексы, wrapper-документы, embedded templates и flows/priming/process.yaml ссылаются на единый Execution Handoff Contract. Его схема и правила не меняются.
  • Оба шаблона сохраняют continuation priming перед чтением handoff. Пауза между сессиями сама по себе не требует перехода с карточки на lifecycle protocol; handoff не закрывает lifecycle gates.

Routing и проверка

  • Workflow: Small Change. Задача полностью задаёт scope и acceptance; меняются только шаблоны документации и их навигация по существующему контракту.
  • Design: not required — reference pattern: template/memory-bank/flows/execution-handoff.md.
  • Plan: not required — локальный атомарный change set; отдельные этапы миграции не нужны.
  • Validation profile: documentation. Runtime, canonical handoff schema, конфигурация и release path не меняются. Downgrade approval: none.
  • Verify: priming manifest validation, template/project-local lint, template doctor, projection check, git diff --check, semantic/simplify review и required CI.
  • Independent review: code-converge --document-review --max-cycles 0; structured verdict и CI должны относиться к одной revision.

Результаты

Revision: 9d9440044a3ead86987713550c2ab3709b677df9.

  • ruby tools/validate-priming-manifests-test.rb — 1 test, 3 assertions, 0 failures.
  • ruby tools/validate-priming-manifests.rb template/memory-bank — 16 manifests validated.
  • Template lint и project-local lint — OK; битых ссылок и нарушений индексов нет.
  • memory-bank-cli doctor --profile template — 0 errors, 0 warnings.
  • Projection check и git diff --check — OK; semantic/simplify review выполнен.
  • Независимая проверка: code-converge --document-review --max-cycles 0 --max-ci-recoveries 0 --review-base f1f04de843aef45a2425d4a7351d577bbf89e940 --log-format kv. Структурированный результат: review_completed status=clean, findings_total=0; run_completed status=success exit_code=0.
  • CI / validate-template — SUCCESS на той же revision; включает smoke-test downstream init.

Подсистема `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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014HazPfqSjJ288za5J7XEme
@dapi dapi changed the title docs: drop unreachable process template subsystem docs: consolidate process handoff under execution contract Sep 6, 2026
dapi added 3 commits September 6, 2026 21:39
…bsystem

* origin/main:
  docs: make the review mechanism an explicit, verifiable choice (#139)
  docs: add WAIT status for external events without a human gate (#138)
  docs: bound review convergence across delivery flows (#137)
  chore: pin memory-bank-cli v2.3.0 in CI (#136)
  refactor: make project-local memory bank a projection of the payload (#134)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant