Files

T

Дмитрий 66ca57f187 sessions: claim supplier-project-channel-failover

Per Pravila §15.2: pre-flight `git fetch origin && git log HEAD..origin/main` clean
after rebase onto d484e60. Worktree env restored (composer install + npm ci
--legacy-peer-deps + npm run build + storage/framework dirs); Pest baseline
GREEN 937/934 / 0 failed / 3 skipped / 2756 assertions / 51.7s.

Scope: 17 files (interface + 3 channels + 2 exceptions + 2 jobs + DI + migration
+ schema/CHANGELOG + node script + controller + view + console route).
Version-claim: db/schema.sql v8.21 → v8.22 (Task 3 +supplier_manual_sync_queue).
Closes: docs/superpowers/plans/2026-05-19-supplier-project-channel-failover.md

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

2026-05-19 12:55:04 +03:00

CURRENT.md

sessions: claim supplier-project-channel-failover

2026-05-19 12:55:04 +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 — отдельная тема, не блокер.