@dzhechkov/keysarium 1.0.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.
- package/README.md +289 -0
- package/bin/cli.js +5 -0
- package/package.json +43 -0
- package/src/cli.js +157 -0
- package/src/commands/doctor.js +469 -0
- package/src/commands/init.js +171 -0
- package/src/commands/list.js +147 -0
- package/src/commands/remove.js +197 -0
- package/src/commands/update.js +191 -0
- package/src/utils.js +274 -0
- package/templates/.claude/agents/cjm-variant-worker.md +60 -0
- package/templates/.claude/agents/discovery-worker.md +45 -0
- package/templates/.claude/agents/parallel-research-orchestrator.md +70 -0
- package/templates/.claude/agents/presentation-worker.md +55 -0
- package/templates/.claude/agents/research-worker.md +43 -0
- package/templates/.claude/commands/architecture-phase.md +37 -0
- package/templates/.claude/commands/casarium.md +163 -0
- package/templates/.claude/commands/cjm-prototype.md +42 -0
- package/templates/.claude/commands/discovery.md +34 -0
- package/templates/.claude/commands/explore-case.md +22 -0
- package/templates/.claude/commands/harvest.md +67 -0
- package/templates/.claude/commands/new-research.md +69 -0
- package/templates/.claude/commands/parallel-research.md +45 -0
- package/templates/.claude/commands/presentation.md +49 -0
- package/templates/.claude/commands/research.md +32 -0
- package/templates/.claude/commands/solve.md +36 -0
- package/templates/.claude/rules/agent-swarm.md +31 -0
- package/templates/.claude/rules/anti-patterns.md +19 -0
- package/templates/.claude/rules/checkpoint-protocol.md +23 -0
- package/templates/.claude/rules/domain-specific.md +32 -0
- package/templates/.claude/rules/file-conventions.md +38 -0
- package/templates/.claude/rules/modular-reuse.md +35 -0
- package/templates/.claude/rules/research-quality.md +20 -0
- package/templates/.claude/settings.json +37 -0
- package/templates/.claude/skills/explore/SKILL.md +215 -0
- package/templates/.claude/skills/explore/references/questioning-techniques.md +151 -0
- package/templates/.claude/skills/explore/references/task-brief-templates.md +355 -0
- package/templates/.claude/skills/frontend-design/LICENSE.txt +177 -0
- package/templates/.claude/skills/frontend-design/SKILL.md +42 -0
- package/templates/.claude/skills/goap-research-ed25519/SKILL.md +415 -0
- package/templates/.claude/skills/goap-research-ed25519/references/ed25519-verification.md +658 -0
- package/templates/.claude/skills/goap-research-ed25519/references/research-actions.md +544 -0
- package/templates/.claude/skills/goap-research-ed25519/references/source-evaluation.md +560 -0
- package/templates/.claude/skills/goap-research-ed25519/scripts/ed25519_verifier.py +662 -0
- package/templates/.claude/skills/goap-research-ed25519/scripts/goap_planner.py +720 -0
- package/templates/.claude/skills/presentation-storyteller/SKILL.md +371 -0
- package/templates/.claude/skills/presentation-storyteller/references/example-presentation.md +273 -0
- package/templates/.claude/skills/presentation-storyteller/references/slide-types.md +426 -0
- package/templates/.claude/skills/presentation-storyteller/references/sources-index-template.md +213 -0
- package/templates/.claude/skills/presentation-storyteller/references/speaker-script-patterns.md +324 -0
- package/templates/.claude/skills/presentation-storyteller/references/storytelling-frameworks.md +270 -0
- package/templates/.claude/skills/problem-solver-enhanced/SKILL.md +562 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/SKILL.md +194 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/examples/noom-cjm-example.md +100 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/examples/noom-module1-example.md +88 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/modules/01-intelligence.md +328 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/modules/02-product-customers.md +221 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/modules/025-cjm-prototype.md +206 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/modules/03-market-competition.md +402 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/modules/04-business-finance.md +287 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/modules/05-growth-engine.md +290 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/modules/06-playbook-synthesis.md +286 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/references/blue-ocean-canvas.md +39 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/references/industry-benchmarks.md +67 -0
- package/templates/.claude/skills/reverse-engineering-unicorn/references/jtbd-canvas.md +48 -0
- package/templates/CLAUDE.md +185 -0
- package/templates/TOOLKIT_HARVEST.md +29 -0
- package/templates/docs/keysarium/01-deployment-guide.md +768 -0
- package/templates/docs/keysarium/02-admin-guide.md +1170 -0
- package/templates/docs/keysarium/03-user-guide.md +884 -0
- package/templates/docs/keysarium/04-infrastructure-requirements.md +967 -0
- package/templates/docs/keysarium/05-architecture.md +706 -0
- package/templates/docs/keysarium/06-user-flows.md +925 -0
- package/templates/docs/skills-bto/01-deployment-guide.md +828 -0
- package/templates/docs/skills-bto/02-admin-guide.md +1052 -0
- package/templates/docs/skills-bto/03-user-guide.md +960 -0
- package/templates/docs/skills-bto/04-infrastructure-requirements.md +610 -0
- package/templates/docs/skills-bto/05-architecture.md +1112 -0
- package/templates/docs/skills-bto/06-user-flows.md +977 -0
- package/templates/lib/agent-patterns.md +115 -0
- package/templates/lib/domain-templates.md +172 -0
- package/templates/lib/phase-utils.md +107 -0
- package/templates/lib/skill-loader.md +78 -0
- package/templates/researches/.gitkeep +0 -0
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
# Casarium — Полный пайплайн AI-кейса
|
|
2
|
+
|
|
3
|
+
## Роль
|
|
4
|
+
Координатор решения AI-кейсов на Кейсариумах и хакатонах. Помогаешь команде за ограниченное время проработать продуктовый кейс и подготовить защиту.
|
|
5
|
+
|
|
6
|
+
## Использование
|
|
7
|
+
```
|
|
8
|
+
/casarium [текст кейса или ссылка]
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## КРИТИЧЕСКОЕ ПРАВИЛО: ФАЙЛЫ СОЗДАЮТСЯ В МОМЕНТ ФАЗЫ
|
|
12
|
+
В конце каждой фазы **немедленно создай** файл. Не откладывай.
|
|
13
|
+
|
|
14
|
+
## Режим работы
|
|
15
|
+
Аргумент: $ARGUMENTS
|
|
16
|
+
|
|
17
|
+
Если аргумент содержит текст кейса — начинай работу. Если аргумент пустой — спроси текст кейса, тайминг, домен.
|
|
18
|
+
|
|
19
|
+
## Инициализация
|
|
20
|
+
|
|
21
|
+
1. Определи название кейса → `CASE_NAME`
|
|
22
|
+
2. Создай рабочую директорию: `researches/CASE_NAME/`
|
|
23
|
+
3. Определи тайминг (часов на кейс, по умолчанию 4)
|
|
24
|
+
4. Кратко объясни 7 фаз + ожидаемые артефакты
|
|
25
|
+
5. Распредели время:
|
|
26
|
+
- Phase 0: 15% | Phase 1: 5% | Phase 2: 15% | Phase 2.5: 10% ⭐ | Phase 3: 15% | Phase 4: 15% | Phase 5: 20% | Buffer: 5%
|
|
27
|
+
|
|
28
|
+
## Tracker артефактов (обновляй в конце каждой фазы)
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
ARTIFACTS (researches/CASE_NAME/):
|
|
32
|
+
[ ] 00_product_discovery.md ← Phase 0
|
|
33
|
+
[ ] 01_case_brief.md ← Phase 1
|
|
34
|
+
[ ] 02_research_findings.md ← Phase 2
|
|
35
|
+
[ ] 02.5_trend_brief.md ← Phase 2.5 (Variant D research)
|
|
36
|
+
[ ] 03_solution_strategy.md ← Phase 3
|
|
37
|
+
[ ] 04_architecture.md ← Phase 4
|
|
38
|
+
[ ] 05_presentation_content.md ← Phase 5
|
|
39
|
+
[ ] 06_speaker_script.md ← Phase 5
|
|
40
|
+
[ ] 07_qa_preparation.md ← Phase 5
|
|
41
|
+
[ ] 08_executive_summary.md ← Phase 5
|
|
42
|
+
[ ] prototype/cjm-prototype.jsx ← Phase 2.5
|
|
43
|
+
[ ] diagrams/architecture-c4.mermaid ← Phase 4
|
|
44
|
+
[ ] diagrams/sequence-main-flow.mermaid ← Phase 4
|
|
45
|
+
[ ] diagrams/process-as-is.mermaid ← Phase 3
|
|
46
|
+
[ ] diagrams/process-to-be.mermaid ← Phase 3
|
|
47
|
+
[ ] README.md ← Phase 6
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## Pipeline
|
|
51
|
+
|
|
52
|
+
```
|
|
53
|
+
INPUT → DISCOVERY → EXPLORE → RESEARCH → CJM PROTO → SOLVE → ARCHITECTURE → PRESENTATION → OUTPUT
|
|
54
|
+
(кейс) Phase 0 Phase 1 Phase 2 Phase 2.5 Phase 3 Phase 4 Phase 5 архив
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Загрузка скиллов
|
|
58
|
+
|
|
59
|
+
Перед каждой фазой ОБЯЗАТЕЛЬНО прочитай соответствующий SKILL.md:
|
|
60
|
+
- Phase 0: `.claude/skills/reverse-engineering-unicorn/SKILL.md` → модули M2-M5
|
|
61
|
+
- Phase 1: `.claude/skills/explore/SKILL.md`
|
|
62
|
+
- Phase 2: `.claude/skills/goap-research-ed25519/SKILL.md`
|
|
63
|
+
- Phase 2.5: `.claude/skills/reverse-engineering-unicorn/SKILL.md` → M2.5 + `.claude/skills/frontend-design/SKILL.md`
|
|
64
|
+
- Phase 3: `.claude/skills/problem-solver-enhanced/SKILL.md`
|
|
65
|
+
- Phase 4: Встроенные шаблоны архитектуры
|
|
66
|
+
- Phase 5: `.claude/skills/presentation-storyteller/SKILL.md`
|
|
67
|
+
|
|
68
|
+
## Стратегия параллелизации (Agent Swarm)
|
|
69
|
+
|
|
70
|
+
Для ускорения используй Agent tool для параллельных задач:
|
|
71
|
+
|
|
72
|
+
### Параллельные фазы:
|
|
73
|
+
- **Phase 0 + Phase 2 (Research):** Запусти 2 агента параллельно:
|
|
74
|
+
- Agent 1: Product Discovery (JTBD, конкуренты, ROI)
|
|
75
|
+
- Agent 2: Предварительный research по технологиям и аналогам
|
|
76
|
+
- **Phase 2.5:** Запусти 2-3 агента для вариантов CJM:
|
|
77
|
+
- Agent A: Вариант A CJM
|
|
78
|
+
- Agent B: Вариант B CJM
|
|
79
|
+
- Agent C: Trend Research для Variant D
|
|
80
|
+
- **Phase 3 + Phase 4:** Можно частично параллелить:
|
|
81
|
+
- Agent 1: Solution Strategy + Process Design
|
|
82
|
+
- Agent 2: Mermaid диаграммы
|
|
83
|
+
- **Phase 5:** Запусти 3 агента:
|
|
84
|
+
- Agent 1: Контент презентации
|
|
85
|
+
- Agent 2: Speaker Script
|
|
86
|
+
- Agent 3: Q&A + Executive Summary
|
|
87
|
+
|
|
88
|
+
### Сборка результатов:
|
|
89
|
+
После каждого параллельного этапа — синтезируй результаты агентов в единый документ.
|
|
90
|
+
|
|
91
|
+
## Execution: Фазы
|
|
92
|
+
|
|
93
|
+
Последовательно выполняй фазы, в каждой:
|
|
94
|
+
1. Прочитай соответствующий SKILL.md
|
|
95
|
+
2. Выполни фазу, создай артефакт
|
|
96
|
+
3. Покажи Checkpoint
|
|
97
|
+
4. Дождись "ок" или корректировки от пользователя
|
|
98
|
+
5. Перейди к следующей фазе
|
|
99
|
+
|
|
100
|
+
## Phase 0-6: Детали
|
|
101
|
+
|
|
102
|
+
Детальные инструкции для каждой фазы находятся в CLAUDE.md проекта и в SKILL.md соответствующих скиллов. Следуй им строго.
|
|
103
|
+
|
|
104
|
+
## Checkpoint формат
|
|
105
|
+
|
|
106
|
+
После каждой фазы покажи:
|
|
107
|
+
```
|
|
108
|
+
═══════════════════════════════════════════════════════
|
|
109
|
+
⏸️ CHECKPOINT N: [Phase Name] Complete
|
|
110
|
+
[Краткая сводка результатов]
|
|
111
|
+
Файл: [filename] ✅
|
|
112
|
+
• "ок" — следующая фаза
|
|
113
|
+
• "углуби [раздел]" — доработать
|
|
114
|
+
═══════════════════════════════════════════════════════
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## Финальная сборка (Phase 6)
|
|
118
|
+
|
|
119
|
+
```
|
|
120
|
+
researches/CASE_NAME/
|
|
121
|
+
├── 00_product_discovery.md
|
|
122
|
+
├── 01_case_brief.md
|
|
123
|
+
├── 02_research_findings.md
|
|
124
|
+
├── 02.5_trend_brief.md
|
|
125
|
+
├── 03_solution_strategy.md
|
|
126
|
+
├── 04_architecture.md
|
|
127
|
+
├── 05_presentation_content.md
|
|
128
|
+
├── 06_speaker_script.md
|
|
129
|
+
├── 07_qa_preparation.md
|
|
130
|
+
├── 08_executive_summary.md
|
|
131
|
+
├── prototype/
|
|
132
|
+
│ └── cjm-prototype.jsx
|
|
133
|
+
├── diagrams/
|
|
134
|
+
│ ├── architecture-c4.mermaid
|
|
135
|
+
│ ├── sequence-main-flow.mermaid
|
|
136
|
+
│ ├── process-as-is.mermaid
|
|
137
|
+
│ └── process-to-be.mermaid
|
|
138
|
+
└── README.md
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
## Commands
|
|
142
|
+
|
|
143
|
+
| Cmd | Action |
|
|
144
|
+
|-----|--------|
|
|
145
|
+
| `ок` | Следующая фаза |
|
|
146
|
+
| `превью [X]` | Посмотреть документ |
|
|
147
|
+
| `время [N]` | Установить тайминг |
|
|
148
|
+
| `ускорь` | Quick Mode текущей фазы |
|
|
149
|
+
| `wow` | Добавить нестандартный элемент |
|
|
150
|
+
| `углуби [раздел]` | Доисследовать аспект |
|
|
151
|
+
| `выбираю A/B/C/D` | Зафиксировать CJM (Phase 2.5) |
|
|
152
|
+
| `объедини A+D` | Гибрид текущего + Future-Ready |
|
|
153
|
+
|
|
154
|
+
## Critical Rules
|
|
155
|
+
|
|
156
|
+
- Файлы создаются в момент фазы, не в Phase 6
|
|
157
|
+
- ⭐ Phase 2.5 (CJM Prototype) — НИКОГДА НЕ ПРОПУСКАТЬ
|
|
158
|
+
- ⭐ 08_executive_summary.md — ОБЯЗАТЕЛЕН
|
|
159
|
+
- Research в paranoid mode — ноль непроверенных утверждений
|
|
160
|
+
- {CHOSEN_CJM} передаётся в Phase 3-5
|
|
161
|
+
- Если банк: on-premise, ФЗ-152, ЦБ, GigaChat/YandexGPT
|
|
162
|
+
- Если мало времени: Quick Mode
|
|
163
|
+
- Все артефакты в директории `researches/CASE_NAME/`
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Phase 2.5: CJM Prototype ⭐ MANDATORY
|
|
2
|
+
|
|
3
|
+
## Использование
|
|
4
|
+
```
|
|
5
|
+
/cjm-prototype [путь к директории исследования]
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
## Аргумент
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## ⚠️ ЭТА ФАЗА НЕ МОЖЕТ БЫТЬ ПРОПУЩЕНА
|
|
12
|
+
|
|
13
|
+
При нехватке времени — упрощённый прототип (2 варианта, базовый UI), но **не пропуск**.
|
|
14
|
+
|
|
15
|
+
## Действия
|
|
16
|
+
|
|
17
|
+
1. **Загрузи скиллы:**
|
|
18
|
+
- `.claude/skills/reverse-engineering-unicorn/SKILL.md` → модуль M2.5
|
|
19
|
+
- `.claude/skills/frontend-design/SKILL.md` → design quality
|
|
20
|
+
2. **Прочитай Phase 0-2** для контекста
|
|
21
|
+
|
|
22
|
+
3. **Step 1:** Извлечь primary_user, segments, aha_moment, solution_concept из Phase 0-2
|
|
23
|
+
4. **Step 2:** Определить 3 варианта CJM (A/B/C)
|
|
24
|
+
5. **Step 2.5:** VARIANT D — Future-Ready CJM (Trend-Based)
|
|
25
|
+
- Загрузи `.claude/skills/goap-research-ed25519/SKILL.md` для trend research
|
|
26
|
+
- Исследуй 5 категорий трендов (PARANOID mode)
|
|
27
|
+
- Создай Trend Brief
|
|
28
|
+
- Синтезируй Variant D
|
|
29
|
+
6. **Step 3:** Сгенерируй React-прототип (.jsx) с 4 вариантами
|
|
30
|
+
7. **Step 4:** Дождись выбора winning CJM → `{CHOSEN_CJM}`
|
|
31
|
+
|
|
32
|
+
8. **Создай файлы:**
|
|
33
|
+
- `02.5_trend_brief.md`
|
|
34
|
+
- `prototype/cjm-prototype.jsx`
|
|
35
|
+
9. **Покажи Checkpoint 2.5**
|
|
36
|
+
|
|
37
|
+
## Параллелизация (Agent Swarm)
|
|
38
|
+
Запусти 3 агента параллельно:
|
|
39
|
+
- Agent 1: CJM Variant A — один подход к точке входа
|
|
40
|
+
- Agent 2: CJM Variant B + C — альтернативные подходы
|
|
41
|
+
- Agent 3: Trend Research для Variant D (GOAP PARANOID)
|
|
42
|
+
Затем синтезируй в единый прототип с 4 вариантами.
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Phase 0: Product Discovery
|
|
2
|
+
|
|
3
|
+
## Использование
|
|
4
|
+
```
|
|
5
|
+
/discovery [текст кейса или путь к директории исследования]
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
## Аргумент
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## Действия
|
|
12
|
+
|
|
13
|
+
1. **Загрузи скилл:** Прочитай `.claude/skills/reverse-engineering-unicorn/SKILL.md` → используй модули M2-M5
|
|
14
|
+
2. **Определи рабочую директорию** — если аргумент содержит путь к `researches/...`, работай там. Иначе — спроси или создай через `/new-research`.
|
|
15
|
+
|
|
16
|
+
3. **Выполни Product Discovery по шаблону:**
|
|
17
|
+
|
|
18
|
+
### A. Текущий процесс (As-Is One-Liner)
|
|
19
|
+
### B. Пользовательские сегменты (JTBD) — 3+ сегмента
|
|
20
|
+
### C. Voice of Customer
|
|
21
|
+
### D. Aha Moment для AI-решения
|
|
22
|
+
### E. Why AI, Why Now? — 4 фактора
|
|
23
|
+
### F. Конкурентный анализ — 3+ конкурента
|
|
24
|
+
### G. Business Case (предварительный) — ROI, окупаемость
|
|
25
|
+
### H. Adoption Strategy — Pilot → Rollout → Scale
|
|
26
|
+
|
|
27
|
+
4. **Создай файл** `00_product_discovery.md` в рабочей директории
|
|
28
|
+
5. **Покажи Checkpoint 0**
|
|
29
|
+
|
|
30
|
+
## Параллелизация (Agent Swarm)
|
|
31
|
+
Если есть возможность, запусти 2 агента параллельно:
|
|
32
|
+
- Agent 1: JTBD анализ + Voice of Customer + Aha Moment
|
|
33
|
+
- Agent 2: Конкурентный анализ + Business Case + Why AI Why Now
|
|
34
|
+
Затем синтезируй результаты.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Phase 1: Explore — Глубокое понимание кейса
|
|
2
|
+
|
|
3
|
+
## Использование
|
|
4
|
+
```
|
|
5
|
+
/explore-case [путь к директории исследования или текст]
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
## Аргумент
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## Действия
|
|
12
|
+
|
|
13
|
+
1. **Загрузи скилл:** Прочитай `.claude/skills/explore/SKILL.md`
|
|
14
|
+
2. **Прочитай Phase 0** (`00_product_discovery.md`) для контекста
|
|
15
|
+
3. **Сфокусируй задачу:**
|
|
16
|
+
- Декомпозиция проблемы (5 Whys)
|
|
17
|
+
- Анализ данных (доступные, недостающие, качество)
|
|
18
|
+
- Карта ограничений (жёсткие, мягкие, скрытые)
|
|
19
|
+
- Success Criteria (бизнес, пользователи, жюри)
|
|
20
|
+
- Ключевой вопрос кейса
|
|
21
|
+
4. **Создай файл** `01_case_brief.md`
|
|
22
|
+
5. **Покажи Checkpoint 1**
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Harvest — Ритуал извлечения знаний из проекта
|
|
2
|
+
|
|
3
|
+
## Использование
|
|
4
|
+
```
|
|
5
|
+
/harvest [путь к директории исследования или "all"]
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
## Аргумент
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## Суть
|
|
12
|
+
|
|
13
|
+
Систематический процесс извлечения и организации полезных знаний после завершения исследования. Не героическое усилие, а лёгкий процесс после каждого проекта.
|
|
14
|
+
|
|
15
|
+
## Шаг 1 — Ревью с агентом
|
|
16
|
+
|
|
17
|
+
Просмотри указанную директорию исследования и TOOLKIT_HARVEST.md. Найди:
|
|
18
|
+
1. Паттерны, которые можно обобщить
|
|
19
|
+
2. Скиллы/команды/хуки, полезные за пределами этого проекта
|
|
20
|
+
3. Ошибки и workaround-ы, которые стоит запомнить
|
|
21
|
+
4. Удачные формулировки и шаблоны
|
|
22
|
+
5. Инсайты о домене
|
|
23
|
+
|
|
24
|
+
## Шаг 2 — Классификация
|
|
25
|
+
|
|
26
|
+
Каждая находка попадает в одну из корзин:
|
|
27
|
+
|
|
28
|
+
| Категория | Что туда идёт | Пример |
|
|
29
|
+
|-----------|--------------|--------|
|
|
30
|
+
| skills/ | Новые или улучшенные SKILL.md | Лучший подход к CJM |
|
|
31
|
+
| commands/ | Slash-команды для Claude Code | Новая фаза пайплайна |
|
|
32
|
+
| rules/ | Правила и ограничения | "Не используй X потому что Y" |
|
|
33
|
+
| templates/ | Шаблоны документов | Обновлённый шаблон архитектуры |
|
|
34
|
+
| patterns/ | Архитектурные паттерны | Event sourcing для AI pipeline |
|
|
35
|
+
| snippets/ | Готовые куски кода | Универсальный CJM renderer |
|
|
36
|
+
|
|
37
|
+
## Шаг 3 — Деконтекстуализация
|
|
38
|
+
|
|
39
|
+
Перед переносом в тулкит:
|
|
40
|
+
1. **Деконтекстуализировать** — убрать привязки к конкретному проекту
|
|
41
|
+
2. **Документировать** — когда использовать, когда нет, предусловия
|
|
42
|
+
3. **Версионировать** — пометить что изменилось и почему
|
|
43
|
+
|
|
44
|
+
Каждый артефакт должен содержать:
|
|
45
|
+
```markdown
|
|
46
|
+
## Maturity: 🟡 Beta / 🟢 Stable
|
|
47
|
+
## Used in: [список проектов]
|
|
48
|
+
## Last updated: [дата]
|
|
49
|
+
## Changelog:
|
|
50
|
+
- v1: начальная версия из [проект]
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## Шаг 4 — Обновление TOOLKIT_HARVEST.md
|
|
54
|
+
|
|
55
|
+
Обнови корневой `TOOLKIT_HARVEST.md` с новыми находками.
|
|
56
|
+
|
|
57
|
+
## Что НЕ тащить
|
|
58
|
+
|
|
59
|
+
- Код, который работает только в контексте конкретного домена
|
|
60
|
+
- Паттерны, использованные один раз без уверенности в качестве
|
|
61
|
+
- Workaround-ы для конкретных багов библиотек (устаревают)
|
|
62
|
+
|
|
63
|
+
## Параллелизация
|
|
64
|
+
|
|
65
|
+
Если `$ARGUMENTS` = "all", запусти агентов параллельно для каждой директории в `researches/`:
|
|
66
|
+
- Каждый агент ревьюит свою директорию
|
|
67
|
+
- Результаты синтезируются в единый TOOLKIT_HARVEST.md
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# Новое исследование
|
|
2
|
+
|
|
3
|
+
Создать новый изолированный проект исследования для параллельной работы.
|
|
4
|
+
|
|
5
|
+
## Использование
|
|
6
|
+
```
|
|
7
|
+
/new-research [название кейса или тема]
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
## Аргумент
|
|
11
|
+
$ARGUMENTS
|
|
12
|
+
|
|
13
|
+
## Действия
|
|
14
|
+
|
|
15
|
+
1. **Определи идентификатор** — создай slug из названия (snake_case, латиница)
|
|
16
|
+
- Пример: "Автоматизация КЦ для банка" → `bank_kc_automation`
|
|
17
|
+
|
|
18
|
+
2. **Создай директорию** `researches/<slug>/` со структурой:
|
|
19
|
+
```
|
|
20
|
+
researches/<slug>/
|
|
21
|
+
├── prototype/
|
|
22
|
+
├── diagrams/
|
|
23
|
+
└── README.md
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
3. **Создай README.md** с метаданными:
|
|
27
|
+
```markdown
|
|
28
|
+
# Исследование: [Название]
|
|
29
|
+
|
|
30
|
+
**Создано:** [дата]
|
|
31
|
+
**Статус:** 🟡 В работе
|
|
32
|
+
**Домен:** [определить]
|
|
33
|
+
**Тайминг:** [если указан]
|
|
34
|
+
|
|
35
|
+
## Артефакты
|
|
36
|
+
- [ ] Phase 0: Product Discovery
|
|
37
|
+
- [ ] Phase 1: Case Brief
|
|
38
|
+
- [ ] Phase 2: Research Findings
|
|
39
|
+
- [ ] Phase 2.5: CJM Prototype ⭐
|
|
40
|
+
- [ ] Phase 3: Solution Strategy
|
|
41
|
+
- [ ] Phase 4: Architecture
|
|
42
|
+
- [ ] Phase 5: Presentation
|
|
43
|
+
- [ ] Phase 6: Packaging
|
|
44
|
+
|
|
45
|
+
## Описание кейса
|
|
46
|
+
[Текст кейса]
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
4. **Выведи подтверждение:**
|
|
50
|
+
```
|
|
51
|
+
═══════════════════════════════════════════════════════
|
|
52
|
+
✅ Исследование создано: researches/<slug>/
|
|
53
|
+
|
|
54
|
+
Для запуска полного пайплайна:
|
|
55
|
+
/casarium [текст кейса]
|
|
56
|
+
|
|
57
|
+
Для запуска отдельных фаз:
|
|
58
|
+
/discovery, /explore-case, /research, /cjm-prototype,
|
|
59
|
+
/solve, /architecture-phase, /presentation
|
|
60
|
+
|
|
61
|
+
Все артефакты будут сохранены в researches/<slug>/
|
|
62
|
+
═══════════════════════════════════════════════════════
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Параллельные исследования
|
|
66
|
+
|
|
67
|
+
Каждое исследование полностью изолировано в своей директории. Можно запускать несколько `/casarium` для разных кейсов, каждый в своей `researches/<slug>/` папке.
|
|
68
|
+
|
|
69
|
+
Список активных исследований: `ls researches/`
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# Параллельные исследования — запуск нескольких кейсов одновременно
|
|
2
|
+
|
|
3
|
+
## Использование
|
|
4
|
+
```
|
|
5
|
+
/parallel-research кейс1: [описание] | кейс2: [описание] | кейс3: [описание]
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
## Аргумент
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## Действия
|
|
12
|
+
|
|
13
|
+
1. **Распарси аргумент** — раздели по `|` на отдельные кейсы
|
|
14
|
+
2. **Для каждого кейса:**
|
|
15
|
+
- Определи slug (snake_case, латиница)
|
|
16
|
+
- Создай директорию `researches/<slug>/`
|
|
17
|
+
- Инициализируй README.md
|
|
18
|
+
|
|
19
|
+
3. **Запусти Agent Swarm** — для каждого кейса параллельный агент:
|
|
20
|
+
- Каждый агент выполняет Phase 0 (Product Discovery)
|
|
21
|
+
- Агенты работают ИЗОЛИРОВАННО в своих директориях
|
|
22
|
+
- Результаты не пересекаются
|
|
23
|
+
|
|
24
|
+
4. **Синтезируй сводку:**
|
|
25
|
+
```
|
|
26
|
+
═══════════════════════════════════════════════════════
|
|
27
|
+
✅ Параллельные исследования запущены
|
|
28
|
+
|
|
29
|
+
| # | Кейс | Директория | Статус Phase 0 |
|
|
30
|
+
|---|------|-----------|----------------|
|
|
31
|
+
| 1 | [название] | researches/slug1/ | ✅ Complete |
|
|
32
|
+
| 2 | [название] | researches/slug2/ | ✅ Complete |
|
|
33
|
+
| 3 | [название] | researches/slug3/ | ✅ Complete |
|
|
34
|
+
|
|
35
|
+
Для продолжения каждого исследования:
|
|
36
|
+
/casarium researches/slug1/
|
|
37
|
+
/casarium researches/slug2/
|
|
38
|
+
/casarium researches/slug3/
|
|
39
|
+
═══════════════════════════════════════════════════════
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Ограничения
|
|
43
|
+
- Рекомендуется не более 3-4 параллельных исследований
|
|
44
|
+
- Каждый агент работает в своей директории
|
|
45
|
+
- Phase 0 выполняется параллельно, далее — по одному или парами
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Phase 5: Presentation + Executive Summary
|
|
2
|
+
|
|
3
|
+
## Использование
|
|
4
|
+
```
|
|
5
|
+
/presentation [путь к директории исследования]
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
## Аргумент
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## Действия
|
|
12
|
+
|
|
13
|
+
1. **Загрузи скилл:** Прочитай `.claude/skills/presentation-storyteller/SKILL.md`
|
|
14
|
+
2. **Прочитай Phase 0-4** для полного контекста
|
|
15
|
+
|
|
16
|
+
3. **Создай контент презентации (10-12 слайдов):**
|
|
17
|
+
| # | Слайд | Ключевое |
|
|
18
|
+
|---|-------|---------|
|
|
19
|
+
| 1 | Титульный | Название + команда + кейс |
|
|
20
|
+
| 2 | Проблема | SCQA, цена бездействия |
|
|
21
|
+
| 3 | Ключевой вопрос + Ответ | Elevator pitch |
|
|
22
|
+
| 4 | Концепция | High-level, роль AI |
|
|
23
|
+
| 5 | User Flow / To-Be | {CHOSEN_CJM}, скриншоты |
|
|
24
|
+
| 6 | AI под капотом | Модели, RAG/Agent, HITL |
|
|
25
|
+
| 7 | Data Architecture | Источники, качество |
|
|
26
|
+
| 8 | Безопасность | Compliance, риски AI |
|
|
27
|
+
| 9 | Метрики и ROI | As-Is→Target, окупаемость |
|
|
28
|
+
| 10 | Roadmap | PoC→MVP→Scale |
|
|
29
|
+
| 11 | Команда + CTA | Следующие шаги |
|
|
30
|
+
| 12 | Q&A | Заготовленные ответы |
|
|
31
|
+
|
|
32
|
+
4. **Speaker Script** — для каждого слайда: HOOK, CONTENT, BRIDGE, ТОН, КЛЮЧЕВОЕ
|
|
33
|
+
|
|
34
|
+
5. **Q&A Preparation** — 7+ типичных вопросов жюри
|
|
35
|
+
|
|
36
|
+
6. **Executive Summary** — 1 страница для жюри (ОБЯЗАТЕЛЬНО)
|
|
37
|
+
|
|
38
|
+
7. **Создай файлы:**
|
|
39
|
+
- `05_presentation_content.md`
|
|
40
|
+
- `06_speaker_script.md`
|
|
41
|
+
- `07_qa_preparation.md`
|
|
42
|
+
- `08_executive_summary.md`
|
|
43
|
+
8. **Покажи Checkpoint 5**
|
|
44
|
+
|
|
45
|
+
## Параллелизация (Agent Swarm)
|
|
46
|
+
Запусти 3 агента параллельно:
|
|
47
|
+
- Agent 1: Контент презентации (05_presentation_content.md)
|
|
48
|
+
- Agent 2: Speaker Script (06_speaker_script.md)
|
|
49
|
+
- Agent 3: Q&A + Executive Summary (07_qa_preparation.md + 08_executive_summary.md)
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Phase 2: Research — Бенчмарки, аналоги, технологии
|
|
2
|
+
|
|
3
|
+
## Использование
|
|
4
|
+
```
|
|
5
|
+
/research [путь к директории исследования или тема]
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
## Аргумент
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## Действия
|
|
12
|
+
|
|
13
|
+
1. **Загрузи скилл:** Прочитай `.claude/skills/goap-research-ed25519/SKILL.md`
|
|
14
|
+
2. **Прочитай Phase 0-1** для контекста
|
|
15
|
+
3. **Режим: PARANOID** — ноль непроверенных утверждений
|
|
16
|
+
|
|
17
|
+
4. **Исследуй по направлениям:**
|
|
18
|
+
- Аналоги — кто решал похожую задачу
|
|
19
|
+
- Технологии — модели, фреймворки
|
|
20
|
+
- Метрики — результаты у аналогов
|
|
21
|
+
- Регуляторика — требования в домене
|
|
22
|
+
- Anti-patterns — что НЕ работает
|
|
23
|
+
|
|
24
|
+
5. **Создай файл** `02_research_findings.md`
|
|
25
|
+
6. **Покажи Checkpoint 2**
|
|
26
|
+
|
|
27
|
+
## Параллелизация (Agent Swarm)
|
|
28
|
+
Запусти 3 агента параллельно:
|
|
29
|
+
- Agent 1: Аналоги + метрики (benchmark solutions)
|
|
30
|
+
- Agent 2: Технологии + Anti-patterns
|
|
31
|
+
- Agent 3: Регуляторика + market data
|
|
32
|
+
Синтезируй в единый `02_research_findings.md`.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Phase 3: Solve — Стратегия решения
|
|
2
|
+
|
|
3
|
+
## Использование
|
|
4
|
+
```
|
|
5
|
+
/solve [путь к директории исследования]
|
|
6
|
+
```
|
|
7
|
+
|
|
8
|
+
## Аргумент
|
|
9
|
+
$ARGUMENTS
|
|
10
|
+
|
|
11
|
+
## Действия
|
|
12
|
+
|
|
13
|
+
1. **Загрузи скилл:** Прочитай `.claude/skills/problem-solver-enhanced/SKILL.md`
|
|
14
|
+
2. **Прочитай Phase 0-2.5** и `{CHOSEN_CJM}` для контекста
|
|
15
|
+
|
|
16
|
+
3. **Спроектируй решение:**
|
|
17
|
+
- SCQA (для питча)
|
|
18
|
+
- Концепция + Elevator Pitch + Ключевая инновация
|
|
19
|
+
- Process Design: As-Is → To-Be
|
|
20
|
+
- User Flow из {CHOSEN_CJM}
|
|
21
|
+
- AI Pipeline
|
|
22
|
+
- Human-in-the-Loop Design
|
|
23
|
+
- Метрики успеха с baseline
|
|
24
|
+
- Риски и митигация
|
|
25
|
+
- Roadmap: PoC → MVP → Scale
|
|
26
|
+
|
|
27
|
+
4. **Создай файлы:**
|
|
28
|
+
- `03_solution_strategy.md`
|
|
29
|
+
- `diagrams/process-as-is.mermaid`
|
|
30
|
+
- `diagrams/process-to-be.mermaid`
|
|
31
|
+
5. **Покажи Checkpoint 3**
|
|
32
|
+
|
|
33
|
+
## Параллелизация (Agent Swarm)
|
|
34
|
+
Запусти 2 агента параллельно:
|
|
35
|
+
- Agent 1: SCQA + Концепция + Process Design + User Flow + AI Pipeline
|
|
36
|
+
- Agent 2: Mermaid диаграммы (as-is, to-be) + HITL Design + Метрики + Roadmap
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Agent Swarm Rules
|
|
2
|
+
|
|
3
|
+
## When to Use Agents
|
|
4
|
+
- Phase 0: 2 parallel agents (JTBD || Competitors+ROI)
|
|
5
|
+
- Phase 2: 3 parallel agents (Analogues || Technologies || Regulations)
|
|
6
|
+
- Phase 2.5: 3 parallel agents (Variant A || Variant B+C || Trend Research D)
|
|
7
|
+
- Phase 5: 3 parallel agents (Presentation || Speaker Script || Q&A+Executive)
|
|
8
|
+
- /parallel-research: 1 agent per case (up to 4 cases)
|
|
9
|
+
|
|
10
|
+
## Agent Isolation
|
|
11
|
+
- Each agent works in its own research directory
|
|
12
|
+
- Agents do NOT modify files outside their assigned scope
|
|
13
|
+
- After parallel agents complete, the orchestrator SYNTHESIZES results
|
|
14
|
+
|
|
15
|
+
## Agent Naming Convention
|
|
16
|
+
When spawning agents, use descriptive names:
|
|
17
|
+
- "Phase 0 JTBD Analysis"
|
|
18
|
+
- "Phase 2 Technology Research"
|
|
19
|
+
- "Phase 2.5 CJM Variant A"
|
|
20
|
+
- "Phase 5 Speaker Script"
|
|
21
|
+
|
|
22
|
+
## BTO Agent Patterns
|
|
23
|
+
- /bto-test: 3 parallel judge agents (Domain Expert || Critic || Completeness Auditor)
|
|
24
|
+
- /bto-optimize: N parallel variant workers (mutation + evaluation)
|
|
25
|
+
- /bto-optimize Round 1: 5 parallel haiku agents (variant evaluation)
|
|
26
|
+
- /bto-optimize Round 3: 3×3 parallel sonnet agents (Layer 2 full panel)
|
|
27
|
+
|
|
28
|
+
## Cost Optimization
|
|
29
|
+
- Use model="haiku" for simple file operations, formatting, and BTO Layer 0-1 evaluation
|
|
30
|
+
- Use model="sonnet" for research synthesis, analysis, and BTO judge panel (Layer 2)
|
|
31
|
+
- Use default (opus) for complex creative work (CJM design, presentation storytelling, BTO crossover)
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Anti-Pattern Detection Rules
|
|
2
|
+
|
|
3
|
+
## Forbidden Patterns — Flag Immediately
|
|
4
|
+
|
|
5
|
+
| Pattern | Detection Signal | Required Fix |
|
|
6
|
+
|---------|-----------------|--------------|
|
|
7
|
+
| "Just add GPT" | Generic AI without architecture | Specify concrete models + pipeline |
|
|
8
|
+
| Ignoring constraints | No mention of domain limitations | Explicitly address each constraint |
|
|
9
|
+
| Over-engineering | > 10 components in MVP | Simplify to MVP-first approach |
|
|
10
|
+
| No metrics | Solution without KPIs | Add concrete metrics with baselines |
|
|
11
|
+
| Slide reading | Text-heavy presentation | Storytelling + visual anchors |
|
|
12
|
+
| No HITL | AI makes final decisions alone | Define escalation policy |
|
|
13
|
+
| Vague claims | "Improve efficiency" without numbers | Quantify: "Reduce from 4h to 15min" |
|
|
14
|
+
| Skipping CJM | Attempt to skip Phase 2.5 | BLOCK — CJM is MANDATORY |
|
|
15
|
+
| Missing Executive Summary | No 08_executive_summary.md | BLOCK — must be created |
|
|
16
|
+
|
|
17
|
+
## Auto-Detection
|
|
18
|
+
When generating content, self-check against these patterns.
|
|
19
|
+
If detected, flag with ⚠️ and fix before proceeding.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Checkpoint Protocol
|
|
2
|
+
|
|
3
|
+
## After Every Phase
|
|
4
|
+
Display a checkpoint banner and WAIT for user confirmation before proceeding.
|
|
5
|
+
|
|
6
|
+
## Checkpoint Format
|
|
7
|
+
```
|
|
8
|
+
═══════════════════════════════════════════════════════
|
|
9
|
+
⏸️ CHECKPOINT N: [Phase Name] Complete
|
|
10
|
+
[2-3 line summary of what was done]
|
|
11
|
+
Files created: [list] ✅
|
|
12
|
+
• "ок" — next phase
|
|
13
|
+
• "углуби [section]" — elaborate
|
|
14
|
+
• "[specific feedback]" — adjust
|
|
15
|
+
═══════════════════════════════════════════════════════
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Rules
|
|
19
|
+
- NEVER skip checkpoints
|
|
20
|
+
- NEVER auto-advance to the next phase without user confirmation
|
|
21
|
+
- If user says "ок" — proceed to next phase
|
|
22
|
+
- If user gives feedback — adjust current phase, then re-checkpoint
|
|
23
|
+
- Track time spent vs. allocated budget per phase
|