diff --git a/cspell-words.txt b/cspell-words.txt index 526d535b..fdaa932d 100644 --- a/cspell-words.txt +++ b/cspell-words.txt @@ -1425,3 +1425,4 @@ evals коммитит инвокейшн парсимый +парсится diff --git a/docs/sessions/CURRENT.md b/docs/sessions/CURRENT.md new file mode 100644 index 00000000..2ee04b88 --- /dev/null +++ b/docs/sessions/CURRENT.md @@ -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 diff --git a/docs/sessions/README.md b/docs/sessions/README.md new file mode 100644 index 00000000..8d5c0f0b --- /dev/null +++ b/docs/sessions/README.md @@ -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 ` — до plan-документа и до первой содержательной правки. + +## Формат записи + +``` +## session: YYYY-MM-DD- +- branch: +- worktree: +- started: +- scope-files: + - [§/раздел/строка] + - ... +- version-claims: + - : → + - ... +- status: in-progress | closed- +- closes: +``` + +`scope-files` — какие нормативные файлы и в каких секциях правит сессия. `version-claims` — какие новые версии (Tooling 2.X, Pravila 1.Y и т.п.) или номера (ADR-NNN) сессия резервирует. + +## Жизненный цикл + +- **claim** — добавить запись со `status: in-progress` + атомарный коммит `sessions: claim `. +- **check** — pre-flight перед нормативной правкой: `Read docs/sessions/CURRENT.md` + проверить пересечение `scope-files` / `version-claims` с активными записями. +- **release** — на закрытии (после push на main) изменить `status: closed-` (запись остаётся в 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 — отдельная тема, не блокер.