@dzhechkov/keysarium 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.md +21 -5
  2. package/package.json +1 -1
  3. package/templates/.claude/commands/brain-export.md +121 -0
  4. package/templates/.claude/commands/brain-import.md +115 -0
  5. package/templates/.claude/rules/checkpoint-protocol.md +46 -0
  6. package/templates/.claude/rules/feedback-loops.md +113 -0
  7. package/templates/.claude/rules/model-routing.md +65 -0
  8. package/templates/.claude/rules/trust-tiers.md +36 -0
  9. package/templates/.claude/shards/phase-0-discovery.shard.md +45 -0
  10. package/templates/.claude/shards/phase-1-explore.shard.md +32 -0
  11. package/templates/.claude/shards/phase-2-research.shard.md +42 -0
  12. package/templates/.claude/shards/phase-25-cjm.shard.md +47 -0
  13. package/templates/.claude/shards/phase-3-solve.shard.md +47 -0
  14. package/templates/.claude/shards/phase-4-architecture.shard.md +41 -0
  15. package/templates/.claude/shards/phase-5-presentation.shard.md +56 -0
  16. package/templates/.claude/skills/explore/SKILL.md +7 -4
  17. package/templates/.claude/skills/frontend-design/SKILL.md +3 -0
  18. package/templates/.claude/skills/goap-research-ed25519/SKILL.md +3 -0
  19. package/templates/.claude/skills/presentation-storyteller/SKILL.md +5 -2
  20. package/templates/.claude/skills/problem-solver-enhanced/SKILL.md +3 -0
  21. package/templates/.claude/skills/reverse-engineering-unicorn/SKILL.md +3 -0
  22. package/templates/CLAUDE.md +55 -3
  23. package/templates/docs/improvement-directions.md +641 -0
  24. package/templates/docs/skills-bto/01-deployment-guide.md +33 -33
  25. package/templates/docs/skills-bto/02-admin-guide.md +13 -13
  26. package/templates/docs/skills-bto/03-user-guide.md +1 -1
  27. package/templates/docs/skills-bto/04-infrastructure-requirements.md +4 -4
  28. package/templates/docs/skills-bto/05-architecture.md +4 -4
  29. package/templates/docs/skills-bto/06-user-flows.md +1 -1
@@ -1,4 +1,4 @@
1
- # Руководство по развёртыванию @dzhechko/skills-bto
1
+ # Руководство по развёртыванию @dzhechkov/skills-bto
2
2
 
3
3
  ## Содержание
4
4
 
@@ -9,7 +9,7 @@
9
9
  5. [Установка рядом с Keysarium](#5-установка-рядом-с-keysarium)
10
10
  6. [Проверка установки](#6-проверка-установки)
11
11
  7. [Первый запуск BTO — пошаговое руководство](#7-первый-запуск-bto--пошаговое-руководство)
12
- 8. [Интеграция с @dzhechko/keysarium](#8-интеграция-с-dzhechkokeysarium)
12
+ 8. [Интеграция с @dzhechkov/keysarium](#8-интеграция-с-dzhechkokeysarium)
13
13
  9. [Обновление и удаление](#9-обновление-и-удаление)
14
14
  10. [Устранение неполадок](#10-устранение-неполадок)
15
15
 
@@ -21,7 +21,7 @@
21
21
 
22
22
  ### 1.1. Node.js 16+
23
23
 
24
- `@dzhechko/skills-bto` требует Node.js версии 16 или выше. Рекомендуется использовать Node.js 20 LTS.
24
+ `@dzhechkov/skills-bto` требует Node.js версии 16 или выше. Рекомендуется использовать Node.js 20 LTS.
25
25
 
26
26
  ```bash
27
27
  # Проверка установленной версии
@@ -57,7 +57,7 @@ winget install OpenJS.NodeJS.LTS
57
57
 
58
58
  ### 1.2. Claude Code CLI
59
59
 
60
- `@dzhechko/skills-bto` устанавливает скиллы и команды в проект Claude Code. Сам Claude Code CLI должен быть установлен и настроен.
60
+ `@dzhechkov/skills-bto` устанавливает скиллы и команды в проект Claude Code. Сам Claude Code CLI должен быть установлен и настроен.
61
61
 
62
62
  ```bash
63
63
  # Установка Claude Code CLI глобально
@@ -123,13 +123,13 @@ git config --global user.email "your@email.com"
123
123
 
124
124
  ## 2. Методы установки
125
125
 
126
- Пакет `@dzhechko/skills-bto` можно установить тремя способами в зависимости от вашего сценария использования:
126
+ Пакет `@dzhechkov/skills-bto` можно установить тремя способами в зависимости от вашего сценария использования:
127
127
 
128
128
  | Метод | Когда использовать | Команда |
129
129
  |-------|-------------------|---------|
130
- | **npx (разовая установка)** | Быстрый старт без глобальной установки | `npx @dzhechko/skills-bto init` |
131
- | **Глобальная установка** | Частое использование в нескольких проектах | `npm install -g @dzhechko/skills-bto` |
132
- | **Рядом с Keysarium** | Уже установлен `@dzhechko/keysarium` | `npx @dzhechko/skills-bto init` (определяет keysarium автоматически) |
130
+ | **npx (разовая установка)** | Быстрый старт без глобальной установки | `npx @dzhechkov/skills-bto init` |
131
+ | **Глобальная установка** | Частое использование в нескольких проектах | `npm install -g @dzhechkov/skills-bto` |
132
+ | **Рядом с Keysarium** | Уже установлен `@dzhechkov/keysarium` | `npx @dzhechkov/skills-bto init` (определяет keysarium автоматически) |
133
133
 
134
134
  Во всех случаях команда `init` копирует одни и те же файлы в проект. Разница только в том, как запускается CLI.
135
135
 
@@ -155,7 +155,7 @@ ls
155
155
  ### 3.2. Запустите установку
156
156
 
157
157
  ```bash
158
- npx @dzhechko/skills-bto init
158
+ npx @dzhechkov/skills-bto init
159
159
  ```
160
160
 
161
161
  CLI отобразит баннер и план установки:
@@ -201,7 +201,7 @@ CLI отобразит баннер и план установки:
201
201
  Если хотите узнать, что именно будет установлено, не записывая файлы:
202
202
 
203
203
  ```bash
204
- npx @dzhechko/skills-bto init --dry-run
204
+ npx @dzhechkov/skills-bto init --dry-run
205
205
  ```
206
206
 
207
207
  Команда покажет план установки и завершится без изменений.
@@ -211,7 +211,7 @@ npx @dzhechko/skills-bto init --dry-run
211
211
  Если BTO уже установлен и вы хотите заменить файлы свежими из пакета:
212
212
 
213
213
  ```bash
214
- npx @dzhechko/skills-bto init --force
214
+ npx @dzhechkov/skills-bto init --force
215
215
  ```
216
216
 
217
217
  > **Внимание:** `--force` перезапишет существующие файлы BTO. Ваши пользовательские модификации будут утеряны. Сначала сделайте бэкап или зафиксируйте изменения в git.
@@ -225,12 +225,12 @@ npx @dzhechko/skills-bto init --force
225
225
  ### 4.1. Глобальная установка
226
226
 
227
227
  ```bash
228
- npm install -g @dzhechko/skills-bto
228
+ npm install -g @dzhechkov/skills-bto
229
229
 
230
230
  # Проверка установки
231
231
  skills-bto --version
232
232
  # или
233
- npx @dzhechko/skills-bto --version
233
+ npx @dzhechkov/skills-bto --version
234
234
  ```
235
235
 
236
236
  ### 4.2. Инициализация в проекте
@@ -245,7 +245,7 @@ skills-bto init
245
245
  Или по-прежнему через npx (будет использована кешированная локальная версия):
246
246
 
247
247
  ```bash
248
- npx @dzhechko/skills-bto init
248
+ npx @dzhechkov/skills-bto init
249
249
  ```
250
250
 
251
251
  ### 4.3. Структура установленных файлов
@@ -287,7 +287,7 @@ your-project/
287
287
 
288
288
  ## 5. Установка рядом с Keysarium
289
289
 
290
- `@dzhechko/skills-bto` разработан для совместной работы с `@dzhechko/keysarium`. При установке в проект, где уже есть Keysarium, BTO автоматически определяет это и интегрируется.
290
+ `@dzhechkov/skills-bto` разработан для совместной работы с `@dzhechkov/keysarium`. При установке в проект, где уже есть Keysarium, BTO автоматически определяет это и интегрируется.
291
291
 
292
292
  ### 5.1. Определение Keysarium
293
293
 
@@ -295,7 +295,7 @@ your-project/
295
295
 
296
296
  ```
297
297
  ┌──────────────────────────────────────────────────┐
298
- │ @dzhechko/keysarium detected! │
298
+ │ @dzhechkov/keysarium detected! │
299
299
  │ Version: 1.0.0 │
300
300
  │ BTO will integrate with existing Keysarium setup.│
301
301
  │ Shared directories: .claude/commands, rules, agents│
@@ -308,10 +308,10 @@ your-project/
308
308
 
309
309
  ```bash
310
310
  # Шаг 1: Установите Keysarium первым
311
- npx @dzhechko/keysarium init
311
+ npx @dzhechkov/keysarium init
312
312
 
313
313
  # Шаг 2: Установите BTO поверх
314
- npx @dzhechko/skills-bto init
314
+ npx @dzhechkov/skills-bto init
315
315
  ```
316
316
 
317
317
  BTO добавит свои файлы в уже существующие директории `.claude/commands/`, `.claude/rules/` и `.claude/agents/`, не затрагивая файлы Keysarium.
@@ -354,13 +354,13 @@ BTO добавит свои файлы в уже существующие дир
354
354
  Запустите `doctor` для проверки здоровья установки сразу после `init`:
355
355
 
356
356
  ```bash
357
- npx @dzhechko/skills-bto doctor
357
+ npx @dzhechkov/skills-bto doctor
358
358
  ```
359
359
 
360
360
  Пример вывода при здоровой установке:
361
361
 
362
362
  ```
363
- Running health checks for @dzhechko/skills-bto v1.0.0...
363
+ Running health checks for @dzhechkov/skills-bto v1.0.0...
364
364
 
365
365
  ✓ Files exist — All 18 manifest files present
366
366
  ✓ BTO skill pack — SKILL.md present, 4 file(s) in skill pack
@@ -377,7 +377,7 @@ npx @dzhechko/skills-bto doctor
377
377
  Для просмотра установленных компонентов с детальным перечнем файлов:
378
378
 
379
379
  ```bash
380
- npx @dzhechko/skills-bto list
380
+ npx @dzhechkov/skills-bto list
381
381
  ```
382
382
 
383
383
  ### 6.3. Проверка в Claude Code
@@ -605,16 +605,16 @@ Backup saved: SKILL.md.pre-optimize.bak
605
605
 
606
606
  ---
607
607
 
608
- ## 8. Интеграция с @dzhechko/keysarium
608
+ ## 8. Интеграция с @dzhechkov/keysarium
609
609
 
610
610
  ### 8.1. Автоматическое определение
611
611
 
612
- При запуске `npx @dzhechko/skills-bto init` в директории, где уже установлен Keysarium (есть файл `.keysarium.json`), BTO автоматически выводит сообщение об интеграции и настраивается соответствующим образом.
612
+ При запуске `npx @dzhechkov/skills-bto init` в директории, где уже установлен Keysarium (есть файл `.keysarium.json`), BTO автоматически выводит сообщение об интеграции и настраивается соответствующим образом.
613
613
 
614
614
  Проверить интеграцию можно через `doctor`:
615
615
 
616
616
  ```bash
617
- npx @dzhechko/skills-bto doctor
617
+ npx @dzhechkov/skills-bto doctor
618
618
  ```
619
619
 
620
620
  Строка `Keysarium integration` в выводе покажет статус:
@@ -667,7 +667,7 @@ DEEP mode запустит интерактивное уточнение тре
667
667
  Для обновления BTO до последней версии:
668
668
 
669
669
  ```bash
670
- npx @dzhechko/skills-bto update
670
+ npx @dzhechkov/skills-bto update
671
671
  ```
672
672
 
673
673
  Команда `update`:
@@ -678,7 +678,7 @@ npx @dzhechko/skills-bto update
678
678
 
679
679
  ```bash
680
680
  # Предпросмотр изменений без записи
681
- npx @dzhechko/skills-bto update --dry-run
681
+ npx @dzhechkov/skills-bto update --dry-run
682
682
  ```
683
683
 
684
684
  > **Рекомендация:** Перед обновлением зафиксируйте текущее состояние в git:
@@ -690,7 +690,7 @@ npx @dzhechko/skills-bto update --dry-run
690
690
  ### 9.2. Удаление установки
691
691
 
692
692
  ```bash
693
- npx @dzhechko/skills-bto remove
693
+ npx @dzhechkov/skills-bto remove
694
694
  ```
695
695
 
696
696
  Команда `remove` удаляет только файлы, перечисленные в манифесте. Файлы Keysarium (если они есть в тех же директориях) не затрагиваются. После удаления манифест `.bto-skills.json` также удаляется.
@@ -703,7 +703,7 @@ npx @dzhechko/skills-bto remove
703
703
 
704
704
  ```
705
705
  WARN BTO skill pack is already installed in this directory.
706
- Run @dzhechko/skills-bto update to update, or use --force to overwrite.
706
+ Run @dzhechkov/skills-bto update to update, or use --force to overwrite.
707
707
  ```
708
708
 
709
709
  **Причина:** Файл `.bto-skills.json` уже существует в директории.
@@ -711,10 +711,10 @@ WARN BTO skill pack is already installed in this directory.
711
711
  **Решение:**
712
712
  ```bash
713
713
  # Вариант 1: обновить существующую установку
714
- npx @dzhechko/skills-bto update
714
+ npx @dzhechkov/skills-bto update
715
715
 
716
716
  # Вариант 2: принудительно перезаписать
717
- npx @dzhechko/skills-bto init --force
717
+ npx @dzhechkov/skills-bto init --force
718
718
  ```
719
719
 
720
720
  ### 10.2. Ошибка: "Path not found" при запуске /bto-test
@@ -790,13 +790,13 @@ Optimization produced minimal improvement. Consider original.
790
790
  Запустите `doctor` для диагностики:
791
791
 
792
792
  ```bash
793
- npx @dzhechko/skills-bto doctor
793
+ npx @dzhechkov/skills-bto doctor
794
794
  ```
795
795
 
796
796
  Для каждого провалившегося чека будет показана подсказка `Fix:`. Большинство проблем решаются командой `update`:
797
797
 
798
798
  ```bash
799
- npx @dzhechko/skills-bto update
799
+ npx @dzhechkov/skills-bto update
800
800
  ```
801
801
 
802
802
  ### 10.8. Ошибка прав доступа при записи файлов
@@ -815,7 +815,7 @@ sudo chown -R $(whoami) .
815
815
  # Либо создайте директорию вручную с правильными правами
816
816
  mkdir -p .claude/skills .claude/commands .claude/rules .claude/agents
817
817
  chmod 755 .claude .claude/skills .claude/commands .claude/rules .claude/agents
818
- npx @dzhechko/skills-bto init
818
+ npx @dzhechkov/skills-bto init
819
819
  ```
820
820
 
821
821
  ### 10.9. Таблица кодов выхода CLI
@@ -1,4 +1,4 @@
1
- # Руководство администратора @dzhechko/skills-bto
1
+ # Руководство администратора @dzhechkov/skills-bto
2
2
 
3
3
  Это руководство описывает управление, настройку и обслуживание BTO skill pack. Предназначено для администраторов, которые управляют компонентами BTO, настраивают quality gates, конфигурируют панели судей и контролируют качество оценки.
4
4
 
@@ -48,10 +48,10 @@
48
48
 
49
49
  ```bash
50
50
  # Полная диагностика установки
51
- npx @dzhechko/skills-bto doctor
51
+ npx @dzhechkov/skills-bto doctor
52
52
 
53
53
  # Листинг установленных файлов
54
- npx @dzhechko/skills-bto list
54
+ npx @dzhechkov/skills-bto list
55
55
  ```
56
56
 
57
57
  ### 1.3. Обновление отдельных компонентов
@@ -60,11 +60,11 @@ npx @dzhechko/skills-bto list
60
60
 
61
61
  ```bash
62
62
  # Шаг 1: просмотрите diff без применения
63
- npx @dzhechko/skills-bto update --dry-run
63
+ npx @dzhechkov/skills-bto update --dry-run
64
64
 
65
65
  # Шаг 2: при необходимости обновите один файл вручную из шаблона пакета
66
66
  # Шаблоны доступны в локальном кеше пакета:
67
- node -e "console.log(require.resolve('@dzhechko/skills-bto/package.json').replace('package.json', 'templates/'))"
67
+ node -e "console.log(require.resolve('@dzhechkov/skills-bto/package.json').replace('package.json', 'templates/'))"
68
68
 
69
69
  # Шаг 3: скопируйте нужный файл из templates/ в .claude/
70
70
  ```
@@ -957,10 +957,10 @@ tar -czf bto-backup-$(date +%Y%m%d).tar.gz .claude/skills/bto/ .claude/commands/
957
957
 
958
958
  ```bash
959
959
  # Вариант 1: обновление вернёт файлы из последней версии пакета
960
- npx @dzhechko/skills-bto update
960
+ npx @dzhechkov/skills-bto update
961
961
 
962
962
  # Вариант 2: принудительная переустановка
963
- npx @dzhechko/skills-bto init --force
963
+ npx @dzhechkov/skills-bto init --force
964
964
  ```
965
965
 
966
966
  `update` обновляет только файлы BTO, не затрагивая Keysarium-файлы в тех же директориях.
@@ -980,7 +980,7 @@ git checkout "2026-02-15" -- .claude/skills/bto/SKILL.md
980
980
  git checkout abc1234 -- .claude/skills/bto/
981
981
 
982
982
  # Проверить, что восстановлено корректно
983
- npx @dzhechko/skills-bto doctor
983
+ npx @dzhechkov/skills-bto doctor
984
984
  ```
985
985
 
986
986
  ### 9.5. Манифест как инвентаризация
@@ -992,7 +992,7 @@ npx @dzhechko/skills-bto doctor
992
992
  cat .bto-skills.json
993
993
 
994
994
  # Проверить наличие всех файлов из манифеста
995
- npx @dzhechko/skills-bto doctor
995
+ npx @dzhechkov/skills-bto doctor
996
996
  ```
997
997
 
998
998
  Структура манифеста:
@@ -1032,7 +1032,7 @@ echo "!.claude/" >> .gitignore # убрать из исключений, есл
1032
1032
 
1033
1033
  # Зафиксировать базовую установку
1034
1034
  git add .claude/ .bto-skills.json
1035
- git commit -m "add @dzhechko/skills-bto v1.0.0"
1035
+ git commit -m "add @dzhechkov/skills-bto v1.0.0"
1036
1036
  ```
1037
1037
 
1038
1038
  **Обновление в команде:**
@@ -1041,12 +1041,12 @@ git commit -m "add @dzhechko/skills-bto v1.0.0"
1041
1041
 
1042
1042
  ```bash
1043
1043
  # Администратор:
1044
- npx @dzhechko/skills-bto update
1044
+ npx @dzhechkov/skills-bto update
1045
1045
  git add .claude/ .bto-skills.json
1046
- git commit -m "update @dzhechko/skills-bto to v1.x.x"
1046
+ git commit -m "update @dzhechkov/skills-bto to v1.x.x"
1047
1047
  git push
1048
1048
 
1049
1049
  # Остальные разработчики:
1050
1050
  git pull
1051
- npx @dzhechko/skills-bto doctor # проверить здоровье после pull
1051
+ npx @dzhechkov/skills-bto doctor # проверить здоровье после pull
1052
1052
  ```
@@ -1,4 +1,4 @@
1
- # BTO User Guide — @dzhechko/skills-bto
1
+ # BTO User Guide — @dzhechkov/skills-bto
2
2
 
3
3
  This guide covers everything you need to use the BTO (Build-Test-Optimize) skill pack for Claude Code. It is intended for developers and prompt engineers who want to create, evaluate, and iteratively improve Claude Code artifacts — skills, commands, rules, and agent templates.
4
4
 
@@ -1,4 +1,4 @@
1
- # Infrastructure Requirements — @dzhechko/skills-bto
1
+ # Infrastructure Requirements — @dzhechkov/skills-bto
2
2
 
3
3
  ## Contents
4
4
 
@@ -17,7 +17,7 @@
17
17
 
18
18
  ## 1. Overview
19
19
 
20
- @dzhechko/skills-bto is a lightweight Claude Code skill pack. It has no server component, no database, no persistent process, and no binary dependencies beyond Node.js and the Claude Code CLI. All computation is delegated to the Anthropic API via HTTPS.
20
+ @dzhechkov/skills-bto is a lightweight Claude Code skill pack. It has no server component, no database, no persistent process, and no binary dependencies beyond Node.js and the Claude Code CLI. All computation is delegated to the Anthropic API via HTTPS.
21
21
 
22
22
  ### Architecture
23
23
 
@@ -120,7 +120,7 @@ npm install -g @anthropic-ai/claude-code
120
120
  claude --version
121
121
  ```
122
122
 
123
- ### 3.4. Installing @dzhechko/skills-bto
123
+ ### 3.4. Installing @dzhechkov/skills-bto
124
124
 
125
125
  ```bash
126
126
  # In your project directory
@@ -556,7 +556,7 @@ Use this checklist before your first BTO run to confirm the environment is prope
556
556
  - [ ] npm 9+ installed (`npm --version` returns 9.x.x or higher)
557
557
  - [ ] Claude Code CLI installed (`claude --version` succeeds)
558
558
  - [ ] git installed (`git --version` succeeds)
559
- - [ ] @dzhechko/skills-bto initialized (`npx dz-skills-bto init` completed)
559
+ - [ ] @dzhechkov/skills-bto initialized (`npx dz-skills-bto init` completed)
560
560
 
561
561
  ### Files
562
562
 
@@ -1,4 +1,4 @@
1
- # 05. Архитектура @dzhechko/skills-bto
1
+ # 05. Архитектура @dzhechkov/skills-bto
2
2
 
3
3
  ## Содержание
4
4
 
@@ -19,7 +19,7 @@
19
19
 
20
20
  ## Обзор системы и философия проектирования
21
21
 
22
- `@dzhechko/skills-bto` — это **Build-Test-Optimize (BTO)** скилл-пак для Claude Code, реализующий полный цикл создания, оценки и итеративного улучшения Claude Code артефактов. Система работает как standalone-инструмент и как интегрированный компонент пайплайна `@dzhechko/keysarium`.
22
+ `@dzhechkov/skills-bto` — это **Build-Test-Optimize (BTO)** скилл-пак для Claude Code, реализующий полный цикл создания, оценки и итеративного улучшения Claude Code артефактов. Система работает как standalone-инструмент и как интегрированный компонент пайплайна `@dzhechkov/keysarium`.
23
23
 
24
24
  ### Фундаментальная идея
25
25
 
@@ -61,7 +61,7 @@ BTO изолирует эти три режима в отдельные моду
61
61
  ### Текстовая карта компонентов
62
62
 
63
63
  ```
64
- @dzhechko/skills-bto
64
+ @dzhechkov/skills-bto
65
65
  ├── SKILL.md ← Точка входа, оркестратор пайплайна
66
66
  │
67
67
  ├── modules/ ← Три основных модуля
@@ -970,7 +970,7 @@ BTO имеет двухуровневую систему обнаружения
970
970
 
971
971
  ## Интеграция с Keysarium
972
972
 
973
- BTO разработан как standalone-система, но имеет готовые точки интеграции с `@dzhechko/keysarium`:
973
+ BTO разработан как standalone-система, но имеет готовые точки интеграции с `@dzhechkov/keysarium`:
974
974
 
975
975
  ### Точки применения в Keysarium пайплайне
976
976
 
@@ -1,4 +1,4 @@
1
- # 06. Пользовательские и административные flow @dzhechko/skills-bto
1
+ # 06. Пользовательские и административные flow @dzhechkov/skills-bto
2
2
 
3
3
  ## Содержание
4
4