@dzhechkov/keysarium 1.0.0 → 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 (35) hide show
  1. package/README.md +36 -20
  2. package/package.json +1 -1
  3. package/src/cli.js +5 -5
  4. package/src/commands/doctor.js +13 -13
  5. package/src/commands/init.js +2 -2
  6. package/src/commands/list.js +3 -3
  7. package/src/commands/remove.js +2 -2
  8. package/src/commands/update.js +2 -2
  9. package/templates/.claude/commands/brain-export.md +121 -0
  10. package/templates/.claude/commands/brain-import.md +115 -0
  11. package/templates/.claude/rules/checkpoint-protocol.md +46 -0
  12. package/templates/.claude/rules/feedback-loops.md +113 -0
  13. package/templates/.claude/rules/model-routing.md +65 -0
  14. package/templates/.claude/rules/trust-tiers.md +36 -0
  15. package/templates/.claude/shards/phase-0-discovery.shard.md +45 -0
  16. package/templates/.claude/shards/phase-1-explore.shard.md +32 -0
  17. package/templates/.claude/shards/phase-2-research.shard.md +42 -0
  18. package/templates/.claude/shards/phase-25-cjm.shard.md +47 -0
  19. package/templates/.claude/shards/phase-3-solve.shard.md +47 -0
  20. package/templates/.claude/shards/phase-4-architecture.shard.md +41 -0
  21. package/templates/.claude/shards/phase-5-presentation.shard.md +56 -0
  22. package/templates/.claude/skills/explore/SKILL.md +7 -4
  23. package/templates/.claude/skills/frontend-design/SKILL.md +3 -0
  24. package/templates/.claude/skills/goap-research-ed25519/SKILL.md +3 -0
  25. package/templates/.claude/skills/presentation-storyteller/SKILL.md +5 -2
  26. package/templates/.claude/skills/problem-solver-enhanced/SKILL.md +3 -0
  27. package/templates/.claude/skills/reverse-engineering-unicorn/SKILL.md +3 -0
  28. package/templates/CLAUDE.md +55 -3
  29. package/templates/docs/improvement-directions.md +641 -0
  30. package/templates/docs/skills-bto/01-deployment-guide.md +33 -33
  31. package/templates/docs/skills-bto/02-admin-guide.md +13 -13
  32. package/templates/docs/skills-bto/03-user-guide.md +1 -1
  33. package/templates/docs/skills-bto/04-infrastructure-requirements.md +4 -4
  34. package/templates/docs/skills-bto/05-architecture.md +4 -4
  35. package/templates/docs/skills-bto/06-user-flows.md +1 -1
@@ -11,6 +11,8 @@
11
11
  /new-research [название] — Создать новое исследование
12
12
  /parallel-research кейс1 | кейс2 — Запустить несколько параллельно
13
13
  /harvest [путь или "all"] — Извлечь знания после проекта
14
+ /brain-export [путь или "all"] — Экспорт знаний в portable JSON
15
+ /brain-import [путь к JSON] — Импорт знаний из другого проекта
14
16
 
15
17
  /bto [путь или описание] — Build-Test-Optimize полный цикл
16
18
  /bto-build [описание] — Генерация нового скилла/команды
@@ -37,10 +39,21 @@ product-keysarium-2026/
37
39
  │ │ ├── architecture-phase.md ← /architecture-phase — Phase 4
38
40
  │ │ ├── presentation.md ← /presentation — Phase 5
39
41
  │ │ ├── harvest.md ← /harvest — извлечение знаний
42
+ │ │ ├── brain-export.md ← /brain-export — экспорт portable brain
43
+ │ │ ├── brain-import.md ← /brain-import — импорт знаний
40
44
  │ │ ├── bto.md ← /bto — Build-Test-Optimize pipeline
41
45
  │ │ ├── bto-build.md ← /bto-build — генерация артефактов
42
46
  │ │ ├── bto-test.md ← /bto-test — мульти-агентная оценка
43
47
  │ │ └── bto-optimize.md ← /bto-optimize — оптимизация промптов
48
+ │ ├── shards/ ← Governance shards (per-phase rules)
49
+ │ │ ├── phase-0-discovery.shard.md
50
+ │ │ ├── phase-1-explore.shard.md
51
+ │ │ ├── phase-2-research.shard.md
52
+ │ │ ├── phase-25-cjm.shard.md
53
+ │ │ ├── phase-3-solve.shard.md
54
+ │ │ ├── phase-4-architecture.shard.md
55
+ │ │ ├── phase-5-presentation.shard.md
56
+ │ │ └── bto-evaluation.shard.md
44
57
  │ └── skills/ ← Навыки (building blocks)
45
58
  │ ├── bto/ ← Build-Test-Optimize (мульти-агентная оценка)
46
59
  │ ├── explore/ ← Адаптивная кларификация задач
@@ -93,8 +106,47 @@ DISCOVERY → EXPLORE → RESEARCH → CJM PROTO → SOLVE → ARCHITECTU
93
106
  3. **08_executive_summary.md — ОБЯЗАТЕЛЕН**
94
107
  4. **Research в PARANOID mode** — ноль непроверенных утверждений
95
108
  5. **{CHOSEN_CJM} передаётся** из Phase 2.5 в Phase 3-5
96
- 6. **Checkpoint после каждой фазы** — ждём "ок" от пользователя
109
+ 6. **Checkpoint после каждой фазы** — ждём "ок" от пользователя + `<promise>` тег
97
110
  7. **Всё в researches/<slug>/** — не засоряем корень
111
+ 8. **Governance shards** — каждая фаза загружает свой shard из `.claude/shards/`
112
+ 9. **Model routing** — haiku для Layer 0-1, sonnet для research/judges, opus для creative work
113
+ 10. **Trust tiers** — скиллы классифицированы (Tier 0-3), повышение через `/bto-test`
114
+
115
+ ## Governance System
116
+
117
+ ### Shards
118
+ Каждая фаза загружает свой governance shard из `.claude/shards/`:
119
+ - Shard содержит: time budget, skill to load, prerequisites, quality gates, promise tag
120
+ - Решает проблему context drift при длинных сессиях
121
+ - Агент перечитывает shard перед началом работы фазы
122
+
123
+ ### Semantic Completion Promises
124
+ Каждый checkpoint включает `<promise>` тег:
125
+ - `DISCOVERY_COMPLETE`, `CASE_EXPLORED`, `RESEARCH_PARANOID_PASSED`
126
+ - `CJM_VALIDATED`, `SOLUTION_DESIGNED`, `ARCHITECTURE_DEFINED`, `PRESENTATION_READY`
127
+ - Downstream фазы проверяют upstream promises перед стартом
128
+
129
+ ### Trust Tiers
130
+ | Tier | Label | Требования |
131
+ |------|-------|-----------|
132
+ | 3 | Verified | Eval test suites + deterministic validation |
133
+ | 2 | Validated | /bto-test Layer 2 score >= 7.0 |
134
+ | 1 | Structured | SKILL.md + references/ or modules/ |
135
+ | 0 | Advisory | Только SKILL.md |
136
+
137
+ ### Cross-Phase Feedback Loops
138
+ 6 именованных loops формализуют передачу данных между фазами.
139
+ См. `.claude/rules/feedback-loops.md` для Variable Registry.
140
+
141
+ ## Portable Brain
142
+
143
+ ```
144
+ /brain-export [путь или "all"] — Экспорт знаний в JSON контейнер
145
+ /brain-import [файл.json] — Импорт знаний из другого проекта
146
+ ```
147
+
148
+ Brain container включает: skill metadata, domain patterns, research summaries,
149
+ harvest patterns, pipeline metrics. Selective import с merge-not-overwrite стратегией.
98
150
 
99
151
  ## Domain Templates
100
152
 
@@ -168,8 +220,8 @@ bto (Build-Test-Optimize)
168
220
  ### Standalone пакет
169
221
 
170
222
  ```bash
171
- npx @dzhechko/skills-bto init # Установить BTO в любой проект
172
- npx @dzhechko/skills-bto doctor # Проверить здоровье установки
223
+ npx @dzhechkov/skills-bto init # Установить BTO в любой проект
224
+ npx @dzhechkov/skills-bto doctor # Проверить здоровье установки
173
225
  ```
174
226
 
175
227
  ## Anti-Patterns