Files

T

Дмитрий 1ab84d8038 feat(sessions): CURRENT.md + README — заявочный лог параллельных Claude-сессий

Создаём docs/sessions/ — координация per Pravila §15.2 (claim/check/release
жизненный цикл, конфликт-резолюция). CURRENT.md содержит текущую сессию
parallel-sessions-coordination + retro-claim записи для существующих
активных worktrees (16 user-sessions на 2026-05-18; 2 locked agent-* worktrees
исключены — не user-сессии).

Backfill scope/version-claims заполнен best-effort; активные сессии
обновят свой блок при возобновлении работы.

+cspell-words: парсится (валидная транслитерация).

Spec: docs/superpowers/specs/2026-05-18-parallel-sessions-coordination-design.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-18 10:08:51 +03:00

4.0 KiB

Raw Blame History

docs/sessions/ — координация параллельных Claude-сессий

Источник правила: Pravila §15.2 (раздел про CURRENT.md в конце текста §15.2).

Назначение

docs/sessions/CURRENT.md — заявочный лог активных параллельных Claude-сессий проекта. Решает класс инцидентов «нормативка/MEMORY дрейфует» (см. spec — docs/superpowers/specs/2026-05-18-parallel-sessions-coordination-design.md).

Когда писать в CURRENT.md

Перед первой нормативной правкой в сессии (правки файлов из списка §15.2 — Pravila, CLAUDE.md, Tooling, PSR_v1, MEMORY.md, Открытые_вопросы, docs/adr/*, db/schema.sql). Запись добавляется отдельным атомарным коммитом sessions: claim <topic> — до plan-документа и до первой содержательной правки.

Формат записи

## session: YYYY-MM-DD-<topic-kebab>
- branch: <git branch --show-current>
- worktree: <git rev-parse --show-toplevel>
- started: <ISO 8601 with timezone>
- scope-files:
  - <relative path> [§/раздел/строка]
  - ...
- version-claims:
  - <file-or-topic>: <from> → <to>
  - ...
- status: in-progress | closed-<commit-sha>
- closes: <relative path к plan-документу>

scope-files — какие нормативные файлы и в каких секциях правит сессия. version-claims — какие новые версии (Tooling 2.X, Pravila 1.Y и т.п.) или номера (ADR-NNN) сессия резервирует.

Жизненный цикл

claim — добавить запись со status: in-progress + атомарный коммит sessions: claim <topic>.
check — pre-flight перед нормативной правкой: Read docs/sessions/CURRENT.md + проверить пересечение scope-files / version-claims с активными записями.
release — на закрытии (после push на main) изменить status: closed-<commit-sha> (запись остаётся в CURRENT.md — append-only-вариант).

Closed-записи переезжают в docs/sessions/archive/YYYY-MM.md через ≥30 дней после закрытия (ручная архивация раз в месяц, не cron).

Конфликт-резолюция

Тип пересечения	Реакция
Файловое пересечение (одинаковый файл, разные секции)	soft-warn — продолжать можно, но pre-flight fetch перед каждым коммитом обязателен (§15.2).
Section-пересечение (одна и та же секция §X.Y)	hard-stop — координация с заказчиком до начала правки.
Version-claim collision (две сессии заявили один номер)	hard-stop — кто claim'нул раньше (по `started`-timestamp), тот его и берёт. Вторая сессия сдвигается на +1.

Pre-flight snippet (для plan-документов и скила subagent-driven-development)

# Перед нормативной правкой:
git fetch origin && git log HEAD..origin/main --oneline
grep -A 20 'status: in-progress' docs/sessions/CURRENT.md

Что мы НЕ делаем (явный YAGNI)

Pre-commit hook на CURRENT.md — добавим только если будут зафиксированы инциденты игнорирования.
TTL / auto-expire записей — добавим, если файл реально засорится.
Machine-readable JSON-формат — markdown достаточен, парсится grep/sed.
Интеграция с GitHub Issues — отдельная тема, не блокер.

4.0 KiB Raw Blame History