cless75/session-link

Навык session-link (старт сессии + фиксация результата)

Справочник: reference.md. Команды: .claude/commands/session-close.md, .claude/commands/session-start.md, .claude/commands/session-result.md.

Vault и пути (504-demo)

Vault root = 504-demo (C:\Obs-Vaults\504-demo). Ежедневные заметки: YYYY/01-Daily/YYYY-MM-DD.md. GTD-каталоги Master-Strategy2 недоступны — навыки project-management, refactoring-objective, rf, daily-productivity не импортированы. Session-handoff: .claude/session-handoff.md (единственный путь).

Handoff и session-link: одна цель, два уровня

Общая цель: зафиксиро��ать результат так, чтобы работу можно было продолжить, в том числе при обрыве сессии (краш, смена чата, новый диалог, исчерпание контекста в другом контуре).

| Уровень | Назначение | Когда | |--------|------------|--------| | GTD (vault) | Канон истины: ПЗ, ## Notes Objective, журнал сессий в ## Заметки в течение дня файла YYYY/01-Daily/…; опционально одна строка-индикатор в ## Ключевой файл сессии (ctx) | START / MID / CLOSE по подпротоколам ниже | | Чат-мост (session-handoff) | Сжатое резюме для следующего AI-чата без обязательного чтения всей ПЗ | По умолчанию пос��е успешного CLOSE (шаг CLOSE-5); путь — reference.md |

Жёсткое правило (канон журнала): подробная фиксация AI-сессии в дне — в секции ## Заметки в течени�� дня (заголовки ### HH:mm [[Objective]] (статус) и пункты под ними). Секция ## Ключевой файл сессии (ctx) — опциональный компактный индикатор (START-7c, CLOSE-7); она не заменяет журнал. Файл .claude/session-handoff.md не является ни журналом, ни ctx; не заменяет запись в vault.

Триггер слова «handoff» в контексте Objective/проекта ведёт на CLOSE (полная GTD-фиксация). Это не освобождает от записи в vault.

---

Когда применять

START — явный фокус на задаче в начале работы:

• «Работаем над …», «открой контекст проекта N», «начинаем сессию по задаче …», «session start», указан ProjectId / открыт файл Objective.
• В составе «Зафиксируй сессию»: если существенного итога ещё нет и пользователь подтверждает только старт — выполнять START (штамп + журнал START-7b; опционально START-7c), без обязательной строки в ПЗ «Ход работы».

MID — промежуточная фиксация: сессия продолжается, нужно зафиксировать состояние:

• «Промежуточный итог», «зафиксируй промежуток», «checkpoint», «сохрани состояние», «зафикси��уй сессию» + явно «промежуточно» / «пока не закрываем».
• ПЗ + Notes дополняются; в ## Заметки в течение дня дописываются строки промежуточного итога (MID-6); опциональная строка ctx (START-7c) остаётся - [ ]. CLOSE-4a не обязателен — по желанию один короткий вопрос о шагах или пропуск.

CLOSE — финал сессии или пауза с полной записью:

• «Зафиксируй результат», «фиксируем работу», «закрываем сессию с записью», «session result», «handoff» в контексте Objective/проекта, пересказ итога офлайн/устно текстом.
• В составе «Зафиксируй сессию»: если есть существенный итог или пользователь хочет закрыть сессию — CLOSE (ПЗ, Notes, обязательный CLOSE-4a, CLOSE-7 — смена статуса в заголовке журнала и при наличии строки ctx — [x]).

Одна фраза: старт, промежуток или финал

Если пользователь пишет только «зафиксиру�� сессию» / «фиксация сессии» без уточнения:

1. Явные сигналы к MID — «промежуточно», «checkpoint», «пока не закрываем», «сохрани как есть продолжим позже» (без закрытия чата как финала).
2. Явные сигналы к START — «только старт», «начали», «отметь открытие», «пока без итога»; или в треде нет итога и пользователь отвечает на уточнение «только старт в дне и карточке?» — да.
3. Явные сигналы к CLOSE — перечень сделанного, артефакты, «и��ог», «закрываем»; или в файле дня уже есть открытый блок по [[Objective]] в «Заметках» (🔵/🟡) / опционально - [ ] в ctx — и пользователь приносит итог — по умолчанию CLOSE (не плодить второй открытый блок без дискриминатора).
4. Неоднозначно — один вопрос: «Фиксируем только старт (карточка + журнал в дне), промежуточный итог (ПЗ/Notes + строки в журнале) или финал со сменой статуса в заголовке журнала?»

Запрет: не считать выполненной фиксацией сессии запись только в session-handoff без правок Objective и YYYY/01-Daily/YYYY-MM-DD.md (кроме явной просьбы пользователя только на текст моста). Журнал сессий — в ## Заметки в течение дня; session-handoff — только чат-мост после vault. Порядок: сначала vault (ПЗ, Objective, день), затем по умолчанию CLOSE-5 (чат-мост); см. CLOSE-6.

---

Сценарии (СИ)

| ID | Полюс | Триггер / вход | Итог | |----|--------|----------------|------| | СИ-A1 | START | Проект без явной Objective | Диалог → выбор Objective → штамп в карточке → контекст ПЗ | | СИ-A2 | START | Уже есть Objective (файл или ссыл��а) | Штамп → ПЗ, Notes | | СИ-M1 | MID | Есть открытая сессия или Objective, нужен checkpoint | Черновик ПЗ + Notes → опционально вопрос о шагах → запись; журнал MID-6; ctx без [x] если ведётся | | СИ-M2 | MID | Только текст от пользователя (офлайн) | Уточнить Objective/проект → как СИ-M1 | | СИ-B1 | CLOSE | Работа в IDE, есть изменения в контексте | Черновик ПЗ + Objective → явный вопрос о следующих шагах (CLOSE-4a) → подтверждение → запись | | СИ-B2 | CLOSE | Только текст от пользователя (офлайн) | Уточнить Objective/проект → как СИ-B1 | | СИ-C | оба | Несколько ПЗ в дереве проекта | Один вопрос: какая ПЗ (корень / подпапка-компонент) |

---

Режим диалога

• Один шаг за ответ там, где нужен выбор пользователя; ответ заканчивается вопросом или явным приглашением.
• Правки в vault (штамп в Objective, ПЗ, Notes) — только после подтверждения пользователем черновика (дата, путь к Objective, текст строк), либо по явному «да, запиши» / «зафиксируй ст��рт».
• Голос / сырая транскрипция: считать тем же вводом, что и текст: слегка нормализовать формулировку (без искажения смысла), не приписывать ProjectId или Objective при сомнении — переспросить одним коротким вопросом; в vault не писать до подтверждения черновика.

---

Разрешение пути файла дня (DAY-RESOLVE)

Общее для START и CLOSE. Пусть выбранная дата = YYYY-MM-DD, год = те же четыре символа, что в начале даты.

1. Канон (запись и главный файл дня): YYYY/01-Daily/YYYY-MM-DD.md (пример: 2026/01-Daily/2026-04-03.md).
2. Если файла нет — создать минимальный markdown с заголовком # YYYY-MM-DD и секцией ## Заметки в течение дня.

Таблица путей: reference.md.

---

Формат ссылок Obsidian (обязательно)

Все ссылки на файлы vault (Objective, ПЗ, артефакты, документы) в записях session-link — только Obsidian wikilinks:

• Формат: [[path/to/file]] или [[path/to/file|алиас]], для блоков: [[path#заголовок|алиас]]
• Не использовать: Markdown [текст](url), HTML <a>, inline code `path`

---

Журнал се��сий в дне: ## Заметки в течение дн��

Назначение: одним взглядом видеть, над какой задачей шла работа, в каком состоянии сессия и когда был последний заход.

Карта статусов (circle-эмодзи в скобках заголовка ### HH:mm … (…))

| Эмодзи | Статус | Когда ставить | |--------|--------|----------------| | 🔵 | Старт | Первый заход по этой Objective в этот календарный день | | 🟡 | Продолжение | Повторны�� заход по той же Objective в тот же день (новый заголовок ### с новым HH:mm) | | 🟢 | Выполнена Objective | Пользователь подтвердил закрытие / выполнение Objective | | 🟣 | DoD на сегодня завершен | На сегодня закрыт DoD, сама Objective может оставаться открытой | | ⚪ | Отложена (на будущее) | Осознанная пауза, перенос фокуса | | 🔴 | Не сработало | Попытка не дала результата; в Notes/ПЗ — что пробовали и смена курса |

Резюме сессии: «продолжаем» vs «работаем с другой задаче��»

• Продолжаем ту же Objective (тот же день, новый заход в чате): новый заголовок ### HH:mm [[та же Objective]] (🟡 Продолжение) или (если открыт блок 🔵/🟡 без финала) дописать под ним промежуточные строки по MID-6 без нового ###.
• Переключаемся на другую Objective: новый заголовок ### HH:mm [[другая Objective]] (🔵 Старт) — отдельный блок; предыдущую при CLOSE закрыть смено�� статуса в скобках (CLOSE-7).

---

Подпротокол START (инициализ��ция)

START-1. Дата сессии

Спросить: «На какую дату фиксируем старт? (сегодня / YYYY-MM-DD)». Канон файла дня: YYYY/01-Daily/YYYY-MM-DD.md (см. DAY-RESOLVE выше).

START-2. Разрешение Objective и проекта

• Из открытых файлов / сообщения: прочитать ProjectId, ObjectiveId, путь к .md.
• Иначе: поиск по vault (#objective, ProjectId:) или уточняющий вопрос.

START-2b. Ценность / желаемый результат сессии

После того как Objective согласована или однозначно выбрана (START-2), до черновика записи в vault задать один вопрос:

«Какую ценность или какой результат вы хотите из этой сессии?» — одно короткое предложение от пользователя; допустимы ответы «пока неясно», «пропуск», «разберёмся по ходу».

• В черновике для подтверждения включить: дату, Objective, формулировку ценности (или пометку «не зафиксировано»).
• После п��дтверждения записи: в журнал START-7b при непустой ценности добавить строку: · ценность: <краткий текст>.
• Если ценность не задана (пропуск) — не добавлять пустой блок.

START-3. Файл дня существует

Если файла по канону DAY-RESOLVE нет — создать минимальный markdown в YYYY/01-Daily/ с заголовком # YYYY-MM-DD и секцией ## Заметки в течение дня.

START-4. Открытие в редакторе

Если среда — Cursor и доступен shell: выполнить cursor "<абсолютный-путь-к-файлу-Objectives.md>". При ошибке — вывести полный путь и инструкцию открыть файл вручную.

START-5. Claude Code (CC)

Нет вкладки редактора: вывести абсолютный путь и напомнить включить файл в контекст следующего сообщения.

START-6. Obsidian

Если vault совпадает с воркспейсом и доступен CLI: obsidian open "<путь-к-Objectives.md>". Иначе одна строка: открыть вручную по [[имя заметки]] или Quick switcher. URI: obsidian://open?vault=504-demo&file=<путь-от-корня-vault>.

START-7. Штамп в карточке Objective (после подтверждения)

Дописать в файл Objective устойчивую секцию (создать при отсутствии):

• Заголовок: ### Сессии (или ### Работа по дням).

• Строка (пример — точный формат в reference.md):

  - YYYY-MM-DD HH:mm — старт (Cursor) → [[YYYY-MM-DD]]

  или (CC) вместо (Cursor).

START-7b. Журнал сессии в ## Заметки в течение дня (после подтверждения)

В том же цикле, после записи в Objective, дописать в YYYY/01-Daily/YYYY-MM-DD.md (DAY-RESOLVE) ��лок журнала:

1. Найти секцию ## Заметки в течение дня. Если её нет — вставить.
2. З��головок сессии:
   • ### HH:mm [[<wikilink Objective>]] (🔵 Старт) — если это первый заход по этой Objective в этот день.
   • ### HH:mm [[<wikilink Objective>]] (🟡 Продолжение) — если по этой Objective уже был блок с 🔵/🟡 сегодня.
3. Под заголовком сразу строка старта: - [ ] Начало работы · <ИмяАгента> (Cursor|CC)
4. Ценность (START-2b): если зафиксирова��а — отдельной строкой: Ценность: ….

START-7c. Опционально: индикатор в ## Ключевой файл сессии (ctx)

Если секция ctx присутствует в файле дня — по желанию пользователя:

• Одна строка: - [ ] [[<wikilink Objective>]] — открыто YYYY-MM-DD HH:mm (Cursor|CC) · журнал: § Заметк�� в течение дня

START-8. Контекст ПЗ и проекта

Кратко: путь к карточке проекта (#project), при необходимости последние строки «Ход работы» ПЗ. Выбор ПЗ при нескольких файлах — glob ПЗ*.md, *-п-*.md в папке проекта.

START-9. Завершение первого ответа

Краткое резюме: какая Objective, ценность сессии (или «не зафиксировано»), день, что открыто, что будет записано после «да». Один вопрос: «Подтверждаете штамп в карточку и блок в Заметки в течение дня?»

---

Подпротокол MID (промежуточная фиксация)

Сессия не считается закрытой: чекбокс в дне остаётся - [ ]. Итог позже — CLOSE.

MID-1. Привязка

Как CLOSE-1: Objective, ProjectId, ПЗ при необходимости.

MID-2. Проект и ПЗ

Как CLOSE-2. Если ПЗ нет и пользователь не хочет создавать — только MID-3 (Notes).

MID-3. Черновик ПЗ

В ## Ход работы одна или несколько строк с явной пометкой (промежуточно, YYYY-MM-DD HH:mm) — что сделано; среда Cursor/CC/офлайн; артефакты — wikilinks [[…]]. При значимых решениях можно кратко дублировать смысл в ## Ключевые решения с той же пометкой.

MID-4. Черновик Objective

В ## Notes дописать подзаголовок ### Промежуточно (YYYY-MM-DD HH:mm) или маркированный пункт с тем же ярлыком — краткое резюме; только wikilinks на артефакты.

MID-5. Вопрос о следующих шагах (опционально)

Не обязателен. По желанию одно короткое предложение: «Записать 1–3 следующих шага в Notes/ПЗ? (или „нет")». При «нет» — не добавлять пустой блок.

MID-6. Ежедневная заметка: промежуточно в журнале (сессия открыта)

1. Дата и файл дня — как START-1, DAY-RESOLVE; при отсутствии файла — создать минимальный markdown.

2. В ## Заметки в тече��ие дня найти последний блок по этой [[Objective]], у которого в заголовке ### статус 🔵 Старт или 🟡 Продолжение.

3. Под этим заголовком дописать две строки:

   - [x] <краткое резюме промежутка>
   - [ ] Следующая задача: <кратко>
   

4. Если открытого блока нет — выполнить START-7b в режиме 🟡 Продолжение и затем пункты 3.

5. Опционально ctx: если есть строка START-7c — оставить - [ ].

MID-7. Подтверждение и запись

Показать черновик (ПЗ, Notes, предлагаемые строки в журнале дня). После «да» / «запиши» — порядок: ПЗ → Objective → файл дня (только MID-6 в ## Заметки в течение дня). Не выполнять CLOSE-7. CLOSE-8 — только если пользователь явно просит.

MID-8. Файл session-handoff (MID)

По умолчанию при MID — не писать чат-мост. По явной просьбе пользователя — краткий блок по тому же шаблону, что CLOSE-5, в .claude/session-handoff.md.

---

Подпротокол CLOSE (фиксация результата)

CLOSE-1. Привязка

Определить Objective и ProjectId (как START-2): открытые файлы, сообщение пользователя, grep.

CLOSE-2. Проект и ПЗ

Загрузить карточку проекта; найти кандидатов ПЗ в папке проекта. При >1 файле — выбор пользователя. ПЗ нет — предложить создать.

CLOSE-3. Черновик ПЗ

Минимум строка в ## Ход работы (дата, что сделано, среда Cursor/CC/офлайн). При значимых решениях — ## Ключевые решения. Созданные/изменённые файлы — ## Артефакты или список wikilinks [[путь/к/файлу]]; не backticks.

CLOSE-4. Черновик Objective

Блок ## Notes (или согласованный раздел): резюме сессии, ссылки на артефакты — только wikilinks [[…]].

CLOSE-4a. Следующие шаги — обязательный явный вопрос

Всегда перед финальным подтверждением записи (CLOSE-6) нужно зафиксировать намерение по продолжению работы:

1. После предъявления черновиков CLOSE-3 и CLOSE-4 отдельным в��просом спросить: «Какие следующие шаги (1–3) записать в ## Notes этой Objective и при необходимости в ПЗ? Если не фиксируем — ответьте «нет» или «пропуск».»
2. Ждать ответа. Если пользователь дал шаги — дополнить черновик:
   • в Objective: подзаголовок ### Следующие шаги (зафиксировано YYYY-MM-DD) и маркированный список;
   • в ПЗ: строка в ## Ход работы и/или ## Открытые вопросы.
3. Если ответ «нет» / «пропуск» — не добавлять пустой блок.

CLOSE-5. Чат-мост: session-handoff (по умолчанию)

По умолчанию после записи в vault дописать в .claude/session-handoff.md краткий блок:

1. Заголовок с датой: ## Session handoff YYYY-MM-DD
2. Строка Objective (имя файла / wiki-имя как текст).
3. 2–3 маркера «что сделано» (сжато).
4. 1–3 следующих шага.
5. При наличии ПЗ — одна строка с именем/путём ПЗ.

Opt-out: если пользователь сказал «только vault», «без session-handoff» — пропустить CLOSE-5.

CLOSE-6. Подтверждение и запись

Показать итоговый черновик, предлагаемую смену статуса в заголовке журнала (CLOSE-7).

После «да» / «запиши» — правки строго в порядке:

1. ПЗ (CLOSE-3);
2. Objective (CLOSE-4);
3. YYYY/01-Daily/YYYY-MM-DD.md — CLOSE-7 (журнал в «Заметки в течение дня»), затем при необходимости CLOSE-8;
4. CLOSE-5 — дописать/обновить блок в .claude/session-handoff.md (если нет opt-out).

CLOSE-7. Ежедневная заметка: финал в журнале + опционально ctx

Порядок: смена статуса в заголовке и [x] в ctx только после записи в ПЗ и Objective.

1. Дата файла дня — как в START-1.
2. Если файла дня нет — создать минимальный markdown.
3. В ## Заметки в течение дня найти последний блок по [[Objective]], где в ### HH:mm … (…) ещё 🔵 Старт или 🟡 П��одолжение.
4. Обновить заголовок — заменить текст в скобках на финальный статус:
   • 🟢 Выполнена Objective или
   • 🟣 DoD на сегодн�� завершен или
   • ⚪ Отложена (на будущее) или
   • 🔴 Не сработало
5. Опционально под заголовком: - [x] Итог: <одна строка>.
6. Секция ctx (если ведётся START-7c): найти - [ ] [[Objective]] → заменить на - [x] и суффикс — итог зафиксирован (Notes).

CLOSE-8. Ежедневная заметка: внеплановые задачи

Когда в итоге сессии есть действия на текущий день — предложить пользователю дописать в файл дня:

1. Найти или создать секцию ## Objectives на сегодня.
2. Под ней — подсекция ### Внеплановые задачи.
3. Дописать пункты с wiki-ссылками на карточки Objective ([[���]]).

Если пользователь отказывается или внеплановых пунктов нет — файл дня не менять.

---

Делегирование

• Рефакторинг формулировки Objective параллельно с итогом сессии — сначала согласовать с пользователем.
• Навыки project-management, refactoring-objective, rf не импортированы в 504-demo.