Files

T

Дмитрий 781a59cbf6 chore(sessions): release parallel-sessions-coordination session

status: in-progress → closed-b1765e9
+version-claim CLAUDE.md 2.13 → 2.14 (был пропущен в initial claim)

Все 8 task'ов плана исполнены и merged в origin/main FF
(b40f2c8..b1765e9, 10 commits). Pre-push регрессия GREEN (gitleaks
full-history 0 leaks / 5/5 hook tests / lychee 0 errors на моих файлах).

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

2026-05-18 10:47:27 +03:00

CURRENT.md

chore(sessions): release parallel-sessions-coordination session

2026-05-18 10:47:27 +03:00

README.md

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

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

README.md

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 — отдельная тема, не блокер.