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
parent 83a8d58096
commit 1ab84d8038
3 changed files with 285 additions and 0 deletions
@@ -1425,3 +1425,4 @@ evals
 коммитит
 инвокейшн
 парсимый
+парсится
@@ -0,0 +1,223 @@
+# CURRENT.md — активные Claude-сессии
+
+> Формат и жизненный цикл записей: [docs/sessions/README.md](README.md).
+> Pravila §15.2 — описание правила в нормативке.
+
+## session: 2026-05-18-parallel-sessions-coordination
+
+- branch: feat/parallel-sessions-coordination
+- worktree: c:/моя/проекты/портал crm/Документация
+- started: 2026-05-18T09:30+03:00
+- scope-files:
+  - docs/Pravila_raboty_Claude_v1_1.md §15 (new)
+  - CLAUDE.md §1 (cross-ref), §0 (Pravila version row)
+  - tools/subagent-prompt-prefix.mjs (new)
+  - .claude/settings.json (PreToolUse Task block)
+  - .claude/skills/subagent-driven-development/ (new wrapper-skill)
+  - docs/sessions/README.md, CURRENT.md (new — этот файл)
+- version-claims:
+  - Pravila: 1.26 → 1.27
+- status: in-progress
+- closes: docs/superpowers/plans/2026-05-18-parallel-sessions-coordination.md
+
+---
+
+## Retro-claim'ы активных worktrees (snapshot 2026-05-18)
+
+Per Pravila §15.2 — backfill для существующих параллельных сессий. Эти записи retroactive, scope/version-claims заполнены best-effort из последних коммитов worktree-веток. Активные сессии при возобновлении работы обновляют свой блок.
+
+## session: 2026-05-17-a11-ml-ai-tooling
+
+- branch: worktree-a11-ml-ai-tooling
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/a11-ml-ai-tooling
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/automation-graph.html [A11 section] [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-17-a3-integration-tooling
+
+- branch: feat/a3-integration-tooling
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/a3-integration-tooling
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - cspell-words.txt [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-17-adr006-icon-path-boundary
+
+- branch: worktree-adr006-icon-path-boundary
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/adr006-icon-path-boundary
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/adr/006-design-tooling-figma-universal-icons-design-plugin.md [best-effort]
+  - CLAUDE.md §3.3 (#45), §0 cross-ref Tooling v2.11 [best-effort]
+  - docs/Tooling_v8_3.md §4.20 [best-effort]
+- version-claims:
+  - Tooling: 2.10 → 2.11
+- status: closed-9cf0f0c (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-18-anthropic-dev-tooling
+
+- branch: feat/anthropic-dev-tooling
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/anthropic-dev-tooling
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/automation-graph.html [E5 discovery-tooling section] [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: closed-b40f2c8 (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-18-c10-business-process-tooling
+
+- branch: worktree-c10-business-process-tooling
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/c10-business-process-tooling
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/superpowers/specs/2026-05-17-c10-business-process-tooling-integration-design.md [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-17-c9-project-management-tooling
+
+- branch: worktree-c9-project-management-tooling
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/c9-project-management-tooling
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/automation-graph.html [C9 section] [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-18-discovery-interview
+
+- branch: worktree-discovery-interview
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/discovery-interview
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/automation-graph.html [E5 discovery-tooling section] [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: closed-b40f2c8 (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-16-iter6-automation-graph
+
+- branch: feat/rls-tooling-boundary
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/iter6-automation-graph
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/automation-graph.html [viewMode/usage/dupes UI] [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-15-plan-6-regions
+
+- branch: plan-6-regions
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/plan-6-regions
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - app/resources/js/components/projects/ProjectDetailsDrawer.vue [best-effort]
+  - app/resources/js/stores/projectsStore.ts [best-effort]
+  - app/resources/js/views/projects/NewProjectDialog.vue [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-16-ruflo-recollage
+
+- branch: worktree-ruflo-recollage
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/ruflo-recollage
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/superpowers/specs/2026-05-10-claude-brain-extraction-design.md [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-16-sprint4-historical-import
+
+- branch: worktree-sprint4-historical-import
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/sprint4-historical-import
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - app/routes/web.php [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-17-sprint5a-auth-polish
+
+- branch: worktree-sprint5a-auth-polish
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/sprint5a-auth-polish
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/superpowers/plans/2026-05-16-sprint5a-auth-polish.md [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: docs/superpowers/plans/2026-05-16-sprint5a-auth-polish.md
+
+## session: 2026-05-17-sprint5b-layout-views
+
+- branch: worktree-sprint5b-layout-views
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/sprint5b-layout-views
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/superpowers/plans/2026-05-17-sprint5b-layout-views.md [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: docs/superpowers/plans/2026-05-17-sprint5b-layout-views.md
+
+## session: 2026-05-17-sprint5c-billing-admin
+
+- branch: worktree-sprint5c-billing-admin
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/sprint5c-billing-admin
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - app/tests/Feature/Admin/AdminPricingTiersControllerTest.php [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
+
+## session: 2026-05-17-sprint5d-cleanup
+
+- branch: worktree-sprint5d-cleanup
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/sprint5d-cleanup
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - docs/superpowers/plans/2026-05-17-sprint5d-cleanup-mock-fallback.md [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: docs/superpowers/plans/2026-05-17-sprint5d-cleanup-mock-fallback.md
+
+## session: 2026-05-17-sprint6-p3-polish
+
+- branch: worktree-sprint6-p3-polish
+- worktree: C:/моя/проекты/портал crm/Документация/.claude/worktrees/sprint6-p3-polish
+- started: 2026-05-18T00:00+03:00 (backfill)
+- scope-files:
+  - app/resources/js/views/ProjectsView.vue [best-effort]
+- version-claims:
+  - none verified — backfill
+- status: in-progress (backfilled)
+- closes: unknown — backfill
@@ -0,0 +1,61 @@
+# 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)
+
+```bash
+# Перед нормативной правкой:
+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 — отдельная тема, не блокер.