@dzhechkov/keysarium 1.4.0 → 1.5.0

package/templates/.claude/skills/analyst-manual-full/SKILL.md

@@ -0,0 +1,286 @@
+---
+name: analyst-manual-full
+description: >
+  Композитный скилл-оркестратор для продакт-менеджера с контрольными точками.
+  Объединяет explore, goap-research-ed25519 и problem-solver-enhanced в единый
+  manual pipeline. Запрашивает подтверждение между фазами. Используй для:
+  стратегических продуктовых задач, ценообразования, позиционирования,
+  конкурентного анализа, GTM-стратегии.
+  Режим MANUAL — подтверждение между каждой фазой.
+trust_tier: 1
+trust_tier_label: "Structured"
+trust_tier_note: "Composite skill — depends on explore, goap-research-ed25519, problem-solver-enhanced"
+---
+
+# Analyst Manual Full: Strategic Analysis with Checkpoints
+
+Композитный скилл-оркестратор для решения комплексных продуктовых задач. Запрашивает подтверждение после каждой фазы.
+
+## Dependent Skills
+
+Этот скилл оркестрирует три атомарных скилла. Перед каждой фазой загружай соответствующий SKILL.md:
+
+| Phase | Skill | Path |
+|-------|-------|------|
+| Phase 1: Explore | explore | `.claude/skills/explore/SKILL.md` |
+| Phase 2: Research | goap-research-ed25519 | `.claude/skills/goap-research-ed25519/SKILL.md` |
+| Phase 3: Solve | problem-solver-enhanced | `.claude/skills/problem-solver-enhanced/SKILL.md` |
+
+Scripts и references для Phase 2 находятся в:
+- `.claude/skills/goap-research-ed25519/scripts/goap_planner.py`
+- `.claude/skills/goap-research-ed25519/scripts/ed25519_verifier.py`
+- `.claude/skills/goap-research-ed25519/references/`
+
+## Core Philosophy
+
+**Контрольные точки:** После каждой фазы скилл останавливается для подтверждения. Пользователь может скорректировать направление или продолжить.
+
+**Cryptographic Verification:** Ed25519 подписи для верификации источников (через goap-research-ed25519).
+
+## Workflow Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  INPUT: Задача пользователя                                     │
+│                         ↓                                       │
+│  GATE: Оценка ясности задачи                                    │
+│  → Ясна? → Пропустить Explore                                   │
+│  → Не ясна? → Phase 1: Explore                                  │
+│                         ↓                                       │
+│  Phase 1: EXPLORE (если нужен)                                  │
+│  → Загрузи: .claude/skills/explore/SKILL.md                     │
+│  → Output: Task Brief                                           │
+│  → ⏸️ CHECKPOINT 1: "Подтвердите Task Brief"                    │
+│                         ↓                                       │
+│  Phase 2: RESEARCH (Ed25519 Verified)                           │
+│  → Загрузи: .claude/skills/goap-research-ed25519/SKILL.md       │
+│  → Output: Verified Research Findings                           │
+│  → ⏸️ CHECKPOINT 2: "Подтвердите findings"                      │
+│                         ↓                                       │
+│  Phase 3: SOLVE                                                 │
+│  → Загрузи: .claude/skills/problem-solver-enhanced/SKILL.md     │
+│  → Output: Solution & Action Plan                               │
+│  → ⏸️ CHECKPOINT 3: "Подтвердите решение"                       │
+│                         ↓                                       │
+│  SYNTHESIS: Final Summary + All Artifacts                       │
+│                         ↓                                       │
+│  OUTPUT: 4 документа × 2 формата (md + docx)                   │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Phase Execution Protocol
+
+### Gate: Task Clarity Assessment
+
+**При пропуске Explore уведоми:**
+```
+⚡ Фаза Explore пропущена — задача достаточно ясна.
+Сформирован Task Brief на основе вашего запроса.
+[показать Task Brief]
+
+⏸️ CHECKPOINT 1: Подтвердите Task Brief или внесите коррективы.
+```
+
+### Phase 1: Explore
+
+**Загрузи:** Прочитай `.claude/skills/explore/SKILL.md` и выполни по его инструкциям.
+
+**Output — Task Brief:**
+```markdown
+## Task Brief
+
+**Objective:** [Чёткая формулировка цели]
+**Context:** [Релевантный контекст]
+**Success Criteria:** [Измеримые критерии]
+**Constraints:** [Жёсткие ограничения]
+**Timeline:** [Дедлайн]
+**Out of Scope:** [Что исключено]
+```
+
+**⏸️ CHECKPOINT 1:**
+```
+═══════════════════════════════════════════════════════════════
+⏸️ CHECKPOINT 1: Task Brief Complete
+
+[показать Task Brief]
+
+Варианты действий:
+• "ок" — перейти к Verified Research (moderate mode)
+• "режим strict" — research с порогом 0.95
+• "режим paranoid" — research с порогом 0.99
+• "скорректируй X" — внести изменения
+
+Что выберете?
+═══════════════════════════════════════════════════════════════
+```
+
+### Phase 2: Research (goap-research-ed25519)
+
+**Загрузи:** Прочитай `.claude/skills/goap-research-ed25519/SKILL.md` и выполни по его инструкциям.
+
+**Verification Modes (выбор на CHECKPOINT 1):**
+
+| Mode | Threshold | Команда на checkpoint |
+|------|-----------|----------------------|
+| `moderate` | 0.85 | "ок" или "продолжай" |
+| `strict` | 0.95 | "режим strict" |
+| `paranoid` | 0.99 | "режим paranoid" |
+
+**Output — Verified Research Findings:**
+```markdown
+## Verified Research Findings
+
+### Verification Status
+- **Mode:** [selected_mode] ([threshold] threshold)
+- **Chain Integrity:** ✅ VERIFIED (ed25519)
+- **Unsigned Claims:** 0
+- **Total Citations:** [число]
+
+### Verified Findings
+[Findings с signed citations]
+
+### Confidence Assessment
+- **Cryptographically Verified (≥0.95):** [список]
+- **Cross-Reference Verified (0.85-0.95):** [список]
+
+### Citation Chain
+[Ed25519 verified chain — см. Appendix]
+```
+
+**⏸️ CHECKPOINT 2:**
+```
+═══════════════════════════════════════════════════════════════
+⏸️ CHECKPOINT 2: Verified Research Complete
+
+**Verification Status:**
+- Mode: [strict/moderate/paranoid]
+- Unsigned Claims: 0 ✅
+- Citation Chain: VERIFIED (Ed25519) ✅
+
+**Ключевые находки:**
+[краткое summary]
+
+**Области с confidence < 0.95:**
+[список, если есть]
+
+Варианты действий:
+• "ок" — перейти к Solution
+• "исследуй глубже X" — дополнительный verified research
+• "повысь confidence для Y" — найти больше источников
+
+Что выберете?
+═══════════════════════════════════════════════════════════════
+```
+
+### Phase 3: Solve (problem-solver-enhanced)
+
+**Загрузи:** Прочитай `.claude/skills/problem-solver-enhanced/SKILL.md` и выполни по его инструкциям.
+
+**9-Module Framework:**
+1. First Principles Breakdown
+2. Root Cause Analysis (5 Whys)
+3. SCQA Framework
+4. Game Theory Analysis
+5. Second-Order Thinking
+6. Contradiction Analysis (TRIZ)
+7. Design Thinking
+8. OODA Loop
+9. Solution Synthesis
+
+**Output — Solution:**
+```markdown
+## Solution & Action Plan
+
+### Problem Statement (SCQA)
+### Root Cause Analysis
+### Strategic Analysis
+### Contradictions Resolved (TRIZ)
+### Recommended Solution
+### Action Plan
+### Risk Mitigation
+### Success Metrics
+```
+
+**⏸️ CHECKPOINT 3:**
+```
+═══════════════════════════════════════════════════════════════
+⏸️ CHECKPOINT 3: Solution Complete
+
+**Ключевые рекомендации:**
+[краткое summary]
+
+**Data Quality:**
+- Все рекомендации основаны на verified research ✅
+- Citation chain integrity: VERIFIED (Ed25519) ✅
+
+Варианты действий:
+• "ок" — создать все документы
+• "альтернатива для X" — другой подход
+• "детализируй Y" — углубить аспект
+
+Что выберете?
+═══════════════════════════════════════════════════════════════
+```
+
+### Synthesis: Final Summary
+
+```markdown
+## Strategic Analysis: [Название задачи]
+
+### Executive Summary
+### Verification Status (Ed25519)
+- Research Mode: [mode]
+- All Claims Verified: ✅
+- Citation Chain: CRYPTOGRAPHICALLY VERIFIED ✅
+
+### Key Research Insights
+### Recommended Strategy
+### Immediate Next Steps
+```
+
+## Checkpoint Interaction Rules
+
+**Команды на checkpoint:**
+
+| Команда | Действие |
+|---------|----------|
+| `ок`, `продолжай` | Следующая фаза |
+| `режим strict` | Изменить verification mode (CHECKPOINT 1) |
+| `режим paranoid` | Изменить verification mode (CHECKPOINT 1) |
+| `скорректируй X` | Изменить артефакт |
+| `исследуй глубже X` | Доп. research (CHECKPOINT 2) |
+| `повысь confidence для X` | Больше источников (CHECKPOINT 2) |
+| `альтернатива для X` | Другое решение (CHECKPOINT 3) |
+| `стоп` | Пауза с сохранением |
+
+## Output Generation
+
+| Документ | Файлы |
+|----------|-------|
+| Task Brief | `01_task_brief.md`, `01_task_brief.docx` |
+| Verified Research | `02_research_findings.md`, `02_research_findings.docx` |
+| Solution | `03_solution.md`, `03_solution.docx` |
+| Final Summary | `04_final_summary.md`, `04_final_summary.docx` |
+
+## Quality Standards
+
+**Anti-Hallucination Checks:**
+- [ ] 100% claims имеют citations
+- [ ] Citation chain cryptographically verified (Ed25519)
+- [ ] Нет утверждений без DOI/URL
+- [ ] Confidence levels для всех findings
+
+**Completeness:**
+- [ ] Все 9 модулей problem-solver пройдены
+- [ ] Подтверждение на каждом checkpoint получено
+
+## Dependencies
+
+**Required skills** (must be installed in `.claude/skills/`):
+- `explore` — task clarification and brief generation
+- `goap-research-ed25519` — verified research with Ed25519 (includes scripts/ and references/)
+- `problem-solver-enhanced` — 9-module problem solving with TRIZ
+
+**Runtime:**
+- Python 3.9+ (for Ed25519 scripts in goap-research-ed25519)
+- `cryptography` package for Ed25519

package/templates/.claude/skills/edu-site-generator/SKILL.md

@@ -0,0 +1,254 @@
+# edu-site-generator — Gamified Educational Site Generator
+
+<!-- Trust Tier: 1 — Structured | Path to Tier 2: Run /bto-test for self-evaluation -->
+
+> Generate a complete gamified educational SPA from documentation/content, optimized for GitHub Pages deployment.
+
+## When To Activate
+
+Trigger on:
+- "generate edu site from [docs]"
+- "create learning site [topic]"
+- "build educational app [topic]"
+- "gamified site from documentation"
+- `/edu-site [topic or docs path]`
+
+## Overview
+
+This skill takes documentation, guides, or structured content and produces a fully functional interactive educational single-page application with:
+
+- **6 exercise types:** Quiz, Flashcards (toggle flip), Matching, Drag-to-Order, Command Builder, Scenario Game
+- **Gamification:** Points, achievements, progress tracking, toast notifications
+- **Final assessment:** Comprehensive test with per-section results
+- **Dark mode** + responsive design + **swipe gesture navigation** on mobile
+- **SEO optimized:** meta tags, Open Graph, Twitter Cards, JSON-LD, **sitemap.xml**, **robots.txt**
+- **GitHub Pages** auto-deployment via GitHub Actions
+- **localStorage** persistence for progress
+
+## Architecture
+
+```
+.claude/skills/edu-site-generator/
+├── SKILL.md                           <- This file (orchestrator)
+├── modules/
+│   ├── 00-content-analysis.md         <- Step 0: Analyze source docs
+│   ├── 01-course-structure.md         <- Step 1: Split into sections + pick exercise types
+│   ├── 02-data-generation.md          <- Step 2: Generate all data files
+│   ├── 03-scaffold.md                 <- Step 3: Project scaffold + config
+│   ├── 04-components.md               <- Step 4: Generate components
+│   ├── 05-gamification.md             <- Step 5: Achievements + progress
+│   ├── 06-deploy.md                   <- Step 6: GitHub Pages deployment
+│   └── 07-verification.md            <- Step 7: Build + verify
+├── references/
+│   ├── tech-stack.md                  <- Stack versions and config
+│   ├── data-schemas.md                <- All data structure schemas
+│   ├── exercise-catalog.md            <- Exercise type descriptions + when to use
+│   └── component-templates.md         <- Code templates for all components
+└── examples/
+    └── sample-course-structure.md     <- Example output for a 5-section course
+```
+
+## Pipeline
+
+```
+Step 0          Step 1            Step 2          Step 3
+ANALYZE    ->  STRUCTURE    ->  DATA GEN    ->  SCAFFOLD
+(read docs)   (sections +      (sections.js    (vite + tailwind
+               exercise types)  exercises.js    + packages)
+                                quizzes.js
+                                achievements.js)
+     |
+     v
+Step 4          Step 5           Step 6          Step 7
+COMPONENTS  ->  GAMIFICATION ->  DEPLOY    ->   VERIFY
+(layout +       (achievements   (GH Actions     (npm run build
+ sections +      + progress      workflow +       + check)
+ interactive)    + store)        index.html)
+```
+
+## Input Requirements
+
+The skill accepts one of:
+1. **Documentation URL(s)** — fetched and parsed
+2. **Local file path(s)** — read directly
+3. **Pasted text** — used as-is
+4. **Topic description** — generates content from knowledge
+
+Minimum: enough content for 3 sections. Maximum recommended: 20 sections.
+
+## Output
+
+A complete, deployable SPA in the current repository:
+
+```
+<project-root>/
+├── .github/workflows/deploy.yml
+├── index.html                    (SEO meta, OG tags, JSON-LD)
+├── vite.config.js
+├── package.json
+├── eslint.config.js
+├── src/
+│   ├── main.jsx
+│   ├── App.jsx
+│   ├── index.css                 (TailwindCSS v4 + theme tokens)
+│   ├── data/
+│   │   ├── sections.js
+│   │   ├── exercises.js
+│   │   ├── quizQuestions.js
+│   │   └── achievements.js
+│   ├── store/
+│   │   └── useAppStore.js
+│   ├── hooks/
+│   │   ├── useProgress.js
+│   │   └── useAchievements.js
+│   ├── components/
+│   │   ├── layout/
+│   │   │   ├── Header.jsx
+│   │   │   ├── Footer.jsx
+│   │   │   ├── Navigation.jsx
+│   │   │   ├── ProgressBar.jsx
+│   │   │   └── SectionLayout.jsx
+│   │   ├── interactive/
+│   │   │   ├── Quiz.jsx
+│   │   │   ├── Flashcard.jsx
+│   │   │   ├── MatchingExercise.jsx
+│   │   │   ├── DragOrder.jsx
+│   │   │   ├── CommandBuilder.jsx
+│   │   │   └── ScenarioGame.jsx
+│   │   ├── common/
+│   │   │   ├── Accordion.jsx
+│   │   │   ├── AchievementsPanel.jsx
+│   │   │   └── Toast.jsx
+│   │   ├── final-test/
+│   │   │   ├── FinalTest.jsx
+│   │   │   └── TestResults.jsx
+│   │   └── sections/
+│   │       └── Section1..N.jsx
+│   └── pages/
+│       ├── HomePage.jsx
+│       └── FinalTestPage.jsx
+└── public/
+```
+
+## Execution Protocol
+
+### Step 0: Content Analysis
+```
+Read: modules/00-content-analysis.md
+```
+- Read/fetch source documentation
+- Identify distinct topics/concepts
+- Estimate section count
+- Determine language (Russian/English)
+- **Output:** Topic list with descriptions
+
+### Step 1: Course Structure
+```
+Read: modules/01-course-structure.md
+Read: references/exercise-catalog.md
+```
+- Split content into 3-20 sections
+- Assign exercise type per section based on content nature
+- Define section order (simple -> complex)
+- Write theory text per section
+- **Output:** Section definitions + exercise assignments
+
+### Step 2: Data Generation
+```
+Read: modules/02-data-generation.md
+Read: references/data-schemas.md
+```
+- Generate `sections.js` with all section metadata
+- Generate `exercises.js` with exercise data per type
+- Generate `quizQuestions.js` with per-section quizzes + final test
+- Generate `achievements.js` with course-specific achievements
+- **Output:** All 4 data files
+
+### Step 3: Project Scaffold
+```
+Read: modules/03-scaffold.md
+Read: references/tech-stack.md
+```
+- Initialize package.json with dependencies
+- Create vite.config.js with correct `base` path
+- Create index.html with SEO meta
+- Create index.css with TailwindCSS v4 theme
+- Create eslint.config.js
+- Run `npm install`
+- **Output:** Buildable project skeleton
+
+### Step 4: Components
+```
+Read: modules/04-components.md
+Read: references/component-templates.md
+```
+- Generate layout components (Header, Footer, Navigation, etc.)
+- Generate interactive components (all 6 types)
+- Generate section components (one per section)
+- Generate page components (Home, FinalTest)
+- Generate common components (Accordion, Toast, AchievementsPanel)
+- **Output:** All JSX components
+
+### Step 5: Gamification
+```
+Read: modules/05-gamification.md
+```
+- Generate Zustand store with persist middleware
+- Generate useProgress hook
+- Generate useAchievements hook
+- Wire up Toast notifications
+- **Output:** State management + gamification logic
+
+### Step 6: Deployment
+```
+Read: modules/06-deploy.md
+```
+- Create `.github/workflows/deploy.yml`
+- Configure GitHub Pages in workflow
+- Set correct `base` in vite.config.js
+- **Output:** CI/CD pipeline
+
+### Step 7: Verification
+```
+Read: modules/07-verification.md
+```
+- Run `npm run build`
+- Verify no build errors
+- Check all imports resolve
+- Verify section count matches data
+- **Output:** Build success confirmation
+
+## Customization Points
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| Language | auto-detect | UI language (ru/en) |
+| Repo name | from git remote | For `base` path in vite |
+| Theme colors | Blue primary | Primary color palette |
+| Exercise types | auto-assigned | Override per section |
+| Achievement count | ~8-12 | Based on section count |
+| Final test | yes | Include final assessment |
+| FAQ section | yes | Include FAQ at bottom |
+| Footer link | none | Optional social/channel link |
+
+## Anti-Patterns
+
+| Anti-Pattern | Detection | Fix |
+|-------------|-----------|-----|
+| Too few sections (<3) | Not enough content for gamification | Combine with more docs or split deeper |
+| All same exercise type | Monotonous UX | Vary types based on content nature |
+| Theory too long | >500 words per section | Split into subsections or use accordion |
+| Quiz questions too easy | All obvious answers | Include plausible distractors |
+| No wrong-answer feedback | Just "wrong" message | Add explanations to quiz answers |
+| Hardcoded content | Content in JSX instead of data/ | All content must live in data/ files |
+| Missing dark mode | No .dark CSS vars | Always include dark theme tokens |
+| Wrong base path | 404 on GitHub Pages | Derive from repo name |
+
+## Checkpoint Protocol
+
+After each step, output:
+```
+Step N/7: [Name] Complete
+Artifacts: [list]
+"ok" to continue | "[feedback]" to adjust
+```

package/templates/.claude/skills/edu-site-generator/examples/sample-course-structure.md

@@ -0,0 +1,116 @@
+# Example: 5-Section Course on "Git Best Practices"
+
+## Step 0 Output: Content Analysis
+
+```
+Language: en
+Course Title: Git Best Practices
+Course Description: 5 essential Git practices for productive collaboration
+
+Topics:
+1. Commit Messages — writing clear, meaningful commits
+2. Branching Strategy — when to branch and naming conventions
+3. Code Review — effective PR review workflow
+4. Merge vs Rebase — choosing the right integration strategy
+5. Git Hooks — automating quality checks
+```
+
+## Step 1 Output: Course Structure
+
+| # | Icon | Title | Short Title | Exercise Type |
+|---|------|-------|-------------|---------------|
+| 1 | "message icon" | 1. Writing Good Commit Messages | Commit Messages | quiz |
+| 2 | "branch icon" | 2. Branching Strategy | Branching | flashcards |
+| 3 | "review icon" | 3. Effective Code Review | Code Review | matching |
+| 4 | "merge icon" | 4. Merge vs Rebase | Merge/Rebase | scenario |
+| 5 | "hook icon" | 5. Git Hooks for Quality | Git Hooks | drag-and-drop |
+
+## Step 2 Output: Data Files
+
+### sections.js (excerpt)
+```javascript
+export const SECTIONS = [
+  {
+    id: 'commit-messages',
+    order: 1,
+    title: '1. Writing Good Commit Messages',
+    shortTitle: 'Commit Messages',
+    description: 'Learn to write clear, meaningful commit messages',
+    icon: 'icon',
+    interactiveType: 'quiz',
+    theory: `A good commit message explains WHY a change was made...`
+  },
+  // ... 4 more sections
+]
+export const TOTAL_SECTIONS = 5
+```
+
+### quizQuestions.js (excerpt)
+```javascript
+export const quizQuestions = {
+  'commit-messages': [
+    {
+      id: 'cm-q1',
+      question: 'What should the first line of a commit message contain?',
+      options: [
+        'The full diff of changes',
+        'A concise summary of the change (50 chars or less)',
+        'The ticket number only',
+        'The author name and date'
+      ],
+      correctAnswer: 1,
+      explanation: 'The first line should be a brief summary...'
+    },
+    // ... more questions
+  ]
+}
+
+export const finalTestQuestions = [
+  {
+    id: 'final-commit-messages',
+    sectionId: 'commit-messages',
+    question: 'Which commit message follows best practices?',
+    options: ['fix', 'Fix login redirect for OAuth users', 'fixed stuff', 'WIP'],
+    correctAnswer: 1
+  },
+  // ... one per section
+]
+```
+
+### achievements.js (excerpt)
+```javascript
+export const ACHIEVEMENTS = [
+  {
+    id: 'first-step',
+    title: 'First Commit',
+    description: 'Complete your first section',
+    icon: 'icon',
+    condition: (s) => Object.keys(s.completedSections).length >= 1
+  },
+  {
+    id: 'halfway',
+    title: 'Branch Out',
+    description: 'Complete 3 of 5 sections',
+    icon: 'icon',
+    condition: (s) => Object.keys(s.completedSections).length >= 3
+  },
+  {
+    id: 'merge-master',
+    title: 'Merge Master',
+    description: 'Complete the Merge/Rebase section',
+    icon: 'icon',
+    condition: (s) => s.completedSections['merge-rebase']
+  },
+  // ... more achievements
+]
+```
+
+## Final Output
+
+- 5 sections with varied exercise types
+- 10+ quiz questions across quiz sections
+- 5 final test questions
+- 8 achievements
+- Full SPA with Header, Navigation, Progress, Dark Mode
+- GitHub Pages deployment via Actions
+- localStorage progress persistence