From 75d70f3a4c662005b7007d53bdd58dadf7463bc0 Mon Sep 17 00:00:00 2001
From: vitya <vitya.kuznetsov@gmail.com>
Date: Sun, 24 May 2026 23:43:55 +0300
Subject: [PATCH] wiki(claude): add session-handoff trigger line + close
 existing-projects-upgrade
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

claude-skills/CLAUDE.md gains `session handoff: read on start, write on end`
between `pull remote before work` and `follow project discipline` — mirrors
the canonical project-bootstrap template (v1.12.0) and .admin/CLAUDE.md.

Existing-projects-upgrade partial close (2/7):
- ✓ cwd (this commit)
- ✓ .admin/  (separate repo commit 29724d41, NOT pushed)
- ⏭ .workshop  skip (workspace-contract prose, flat trigger doesn't fit)
- ⏭ victor/books, pilorama98.ru, pilonuxt, OpeItcLoc03/common, board-viewer
  deferred — not on this machine, per-machine upgrade in respective sessions

Closes [session-handoff-existing-projects-upgrade] (partial — pattern mirrors
using-yt-tools-test-trigger split-out).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .tasks/STATUS.md                              |  4 +--
 ...ssion-handoff-existing-projects-upgrade.md | 32 +++++++++++++++++++
 CLAUDE.md                                     |  1 +
 3 files changed, 35 insertions(+), 2 deletions(-)
 create mode 100644 .tasks/session-handoff-existing-projects-upgrade.md

diff --git a/.tasks/STATUS.md b/.tasks/STATUS.md
index 5131eb8..f94fea7 100644
--- a/.tasks/STATUS.md
+++ b/.tasks/STATUS.md
@@ -1,5 +1,5 @@
 # Task Board
-_Updated: 2026-05-24 (session-handoff: 4 закрыто 🟢 (install/template-extend/hermes/posttooluse-hook); existing-projects-upgrade → 🔴.)_
+_Updated: 2026-05-24 (session-handoff: 5/7 кластера закрыто 🟢 — install/template-extend/hermes/posttooluse-hook/existing-projects-upgrade; review 🔵 still blocked by test-trigger.)_
 
 <!--
   Canonical layout. One block per task. Per-task deep context lives in
@@ -1468,7 +1468,7 @@ Findings → follow-up tasks через tasks_create в claude-skills (slug `ses
 
 ---
 
-## ⚪ [session-handoff-existing-projects-upgrade] — Добавить trigger-line `session handoff: read on start, write on end` в CLAUDE.md уже инициализированных проектов (которые не получат строку через bootstrap, потому что инициализированы до session-handoff-bootstrap-template-extend).
+## 🟢 [session-handoff-existing-projects-upgrade] — Добавить trigger-line `session handoff: read on start, write on end` в CLAUDE.md уже инициализированных проектов (которые не получат строку через bootstrap, потому что инициализированы до session-handoff-bootstrap-template-extend).
 
 **Reason:** `session-handoff-bootstrap-template-extend` решает проблему только для **новых** проектов (greenfield bootstrap). Существующие проекты — `~/projects/.workshop/`, `~/projects/.admin/`, `victor/books`, `victor/pilorama98.ru`, `OpeItcLoc03/admin`, `OpeItcLoc03/common`, `OpeItcLoc03/board-viewer`, и прочие — handoff не подхватят, пока строка не появится в их CLAUDE.md вручную.
 
diff --git a/.tasks/session-handoff-existing-projects-upgrade.md b/.tasks/session-handoff-existing-projects-upgrade.md
new file mode 100644
index 0000000..5dd3b25
--- /dev/null
+++ b/.tasks/session-handoff-existing-projects-upgrade.md
@@ -0,0 +1,32 @@
+# session-handoff-existing-projects-upgrade
+
+## Goal
+Добавить trigger-line `session handoff: read on start, write on end` в CLAUDE.md уже-инициализированных проектов, которые не получат строку через `[session-handoff-bootstrap-template-extend]` (тот template работает только для greenfield bootstrap).
+
+## Key files
+- `~/projects/claude-skills/CLAUDE.md:10` — добавлена строка после `pull remote before work` (cwd, commit'ится в кластере closure commit'а)
+- `~/projects/.admin/CLAUDE.md:10` — добавлена аналогично; committed в .admin repo (commit `29724d41`); push deferred per Rule 4 (separate repo, separate approval)
+
+## Decisions log
+- 2026-05-24: **Path A — manual edit-pass** (per task description recommendation). Path B (project-bootstrap upgrade-режим per project) сложнее и требует проверки идемпотентности на тестовом проекте — overkill для 2-project pass.
+- 2026-05-24: **.workshop — SKIP**. CLAUDE.md в `.workshop` это **workspace-contract prose**, не flat trigger-line list (структурированный markdown с табличками, `## Жёсткие правила`, `## Override project-discipline`). Adding flat trigger line в неё нарушает project-discipline Rule 1 (project conventions override). Workshop session-mode — brainstorm-dominant; может не benefit от session-handoff design'а который calibrated на code-impl сессии. Если в будущем понадобится — добавлять в `## Триггеры скилов v1` табличку как новый row.
+- 2026-05-24: **5 проектов deferred — не на этой машине**: `victor/books`, `victor/pilorama98.ru`, `victor/pilonuxt`, `OpeItcLoc03/common`, `OpeItcLoc03/board-viewer`. Их upgrade per-machine — каждый где живёт.
+- 2026-05-24: **Cross-repo commits** через `git -C <path>` (без cd, чтобы cwd shell state не drift'нул). Push deferred per Rule 4 — each separate repo нужен отдельный approval, не покрыт grant'ом текущей сессии.
+
+## Open questions
+- [ ] Push в .admin/ — не сделан в этой сессии (cross-repo push needs separate approval per Rule 4)
+- [ ] 5 victor/* и OpeItcLoc03/* — upgrade per-machine; backlog для следующих заходов в каждый
+
+## Completed steps
+- [x] inventory: проверены 7 high/medium-pri проектов, локально присутствуют 2 (.workshop, .admin) + claude-skills cwd
+- [x] edit claude-skills/CLAUDE.md — added line
+- [x] edit .admin/CLAUDE.md — added line + commit (29724d41 in .admin repo, NOT pushed)
+- [x] skip .workshop — CLAUDE.md format mismatch (workspace-contract, не flat trigger list)
+- [x] document 5 deferred projects (not on this machine)
+- [ ] STATUS.md → 🟢 (partial)
+- [ ] commit closure in claude-skills
+
+## Notes
+**Partial close**: 2/7 priority projects upgraded в этой сессии (claude-skills + .admin). 1 skipped (.workshop — design decision). 4 deferred (not on this machine). Pattern совпадает с `using-yt-tools-test-trigger` (closed partial, splits-out the per-machine рестарт).
+
+Cross-project pushes намеренно не сделаны — каждый repo это separate decision; не аккумулирую в одну "большой push" approval.
diff --git a/CLAUDE.md b/CLAUDE.md
index 829cbb7..ee458ee 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -7,6 +7,7 @@ use project wiki
 use task management system
 check across all projects
 pull remote before work
+session handoff: read on start, write on end
 follow project discipline
 follow tdd-criteria
 delegate to interns when allowed