@dzhechkov/keysarium 1.5.31 → 1.5.33

package/src/commands/doctor.js

@@ -5,7 +5,7 @@ const path = require('path');
 const {
   green, red, yellow, cyan, bold, dim,
   info, success, warn, error: logError,
-  fileExists, readJSON, readManifest,
+  fileExists, readJSON, readManifest, getTemplateFileNames,
   MANIFEST_FILE,
 } = require('../utils');
 
@@ -60,7 +60,7 @@ function checkFilesExist(manifest, targetDir) {
     return {
       passed: false,
       detail: `${missing.length} file(s) missing: ${missing.slice(0, 5).join(', ')}${missing.length > 5 ? '...' : ''}`,
-      fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore missing files.`,
+      fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore missing files.`,
     };
   });
 }
@@ -76,7 +76,7 @@ function checkClaudeMd(targetDir) {
       return {
         passed: false,
         detail: 'CLAUDE.md not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} or ${cyan('@dzhechkov/keysarium init --force')} to restore.`,
+        fix: `Run ${cyan('npx @dzhechkov/keysarium update')} or ${cyan('npx @dzhechkov/keysarium init --force')} to restore.`,
       };
     }
 
@@ -117,7 +117,7 @@ function checkSkillsComplete(targetDir) {
       return {
         passed: false,
         detail: '.claude/skills/ directory not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore skills.`,
+        fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore skills.`,
       };
     }
 
@@ -165,141 +165,100 @@ function checkSkillsComplete(targetDir) {
 }
 
 /**
- * Check 4: All 11 command .md files are present.
+ * Shared body for the "every shipped <thing>.md is installed" checks.
+ *
+ * The expected list is DERIVED from the package's own templates/ tree, never hardcoded —
+ * a command or rule added to templates/ is named-checked on the next run with no edit here.
+ * (Regression this guards: the lists used to be frozen at a legacy 11-command / 7-rule
+ * subset, so `doctor` reported "All 11 command files present" on a 19-command install and
+ * newer files like feature-adr.md / dream.md / reward-learning.md were never named.)
  */
-function checkCommandsPresent(targetDir) {
-  return check('Commands present', () => {
-    const commandsDir = path.join(targetDir, '.claude', 'commands');
-    const expectedCommands = [
-      'casarium.md',
-      'new-research.md',
-      'parallel-research.md',
-      'discovery.md',
-      'explore-case.md',
-      'research.md',
-      'cjm-prototype.md',
-      'solve.md',
-      'architecture-phase.md',
-      'presentation.md',
-      'harvest.md',
-    ];
-
-    if (!fileExists(commandsDir)) {
-      return {
-        passed: false,
-        detail: '.claude/commands/ directory not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore commands.`,
-      };
-    }
+function checkComponentFilesPresent(targetDir, opts) {
+  const { checkName, componentKey, dirParts, noun } = opts;
 
-    const missing = [];
-    for (const cmd of expectedCommands) {
-      if (!fileExists(path.join(commandsDir, cmd))) {
-        missing.push(cmd);
-      }
-    }
+  return check(checkName, () => {
+    const dir = path.join(targetDir, ...dirParts);
+    const relDir = dirParts.join('/') + '/';
+    const expected = getTemplateFileNames(componentKey);
 
-    if (missing.length === 0) {
+    if (expected.length === 0) {
       return {
-        passed: true,
-        detail: `All ${expectedCommands.length} command files present`,
+        passed: false,
+        detail: `Cannot read the shipped ${noun} list from the package templates/ tree`,
+        fix: 'Reinstall the package: the templates/ directory is missing or unreadable.',
       };
     }
 
-    return {
-      passed: false,
-      detail: `Missing ${missing.length} command(s): ${missing.join(', ')}`,
-      fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore missing commands.`,
-    };
-  });
-}
-
-/**
- * Check 5: All 7 rule .md files are present.
- */
-function checkRulesPresent(targetDir) {
-  return check('Rules present', () => {
-    const rulesDir = path.join(targetDir, '.claude', 'rules');
-    const expectedRules = [
-      'agent-swarm.md',
-      'anti-patterns.md',
-      'checkpoint-protocol.md',
-      'domain-specific.md',
-      'file-conventions.md',
-      'modular-reuse.md',
-      'research-quality.md',
-    ];
-
-    if (!fileExists(rulesDir)) {
+    if (!fileExists(dir)) {
       return {
         passed: false,
-        detail: '.claude/rules/ directory not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore rules.`,
+        detail: `${relDir} directory not found`,
+        fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore ${noun}s.`,
       };
     }
 
-    const missing = [];
-    for (const rule of expectedRules) {
-      if (!fileExists(path.join(rulesDir, rule))) {
-        missing.push(rule);
-      }
-    }
+    const missing = expected.filter((name) => !fileExists(path.join(dir, name)));
 
     if (missing.length === 0) {
       return {
         passed: true,
-        detail: `All ${expectedRules.length} rule files present`,
+        detail: `All ${expected.length} ${noun} files present`,
       };
     }
 
     return {
       passed: false,
-      detail: `Missing ${missing.length} rule(s): ${missing.join(', ')}`,
-      fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore missing rules.`,
+      detail: `Missing ${missing.length}/${expected.length} ${noun}(s): ${missing.slice(0, 5).join(', ')}${missing.length > 5 ? '...' : ''}`,
+      fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore missing ${noun}s.`,
     };
   });
 }
 
 /**
- * Check 6: All 5 agent .md files are present.
+ * Check 4: every shipped command .md file is present.
  */
-function checkAgentsPresent(targetDir) {
-  return check('Agents present', () => {
-    const agentsDir = path.join(targetDir, '.claude', 'agents');
-
-    if (!fileExists(agentsDir)) {
-      return {
-        passed: false,
-        detail: '.claude/agents/ directory not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore agents.`,
-      };
-    }
-
-    let entries;
-    try {
-      entries = fs.readdirSync(agentsDir);
-    } catch {
-      return {
-        passed: false,
-        detail: 'Cannot read .claude/agents/ directory',
-        fix: 'Check directory permissions.',
-      };
-    }
+function checkCommandsPresent(targetDir) {
+  return checkComponentFilesPresent(targetDir, {
+    checkName: 'Commands present',
+    componentKey: 'commands',
+    dirParts: ['.claude', 'commands'],
+    noun: 'command',
+  });
+}
 
-    const mdFiles = entries.filter((e) => e.endsWith('.md'));
+/**
+ * Check 5: every shipped rule .md file is present.
+ */
+function checkRulesPresent(targetDir) {
+  return checkComponentFilesPresent(targetDir, {
+    checkName: 'Rules present',
+    componentKey: 'rules',
+    dirParts: ['.claude', 'rules'],
+    noun: 'rule',
+  });
+}
 
-    if (mdFiles.length >= 5) {
-      return {
-        passed: true,
-        detail: `${mdFiles.length} agent file(s) present`,
-      };
-    }
+/**
+ * Check 5b: every shipped governance shard is present.
+ */
+function checkShardsPresent(targetDir) {
+  return checkComponentFilesPresent(targetDir, {
+    checkName: 'Shards present',
+    componentKey: 'shards',
+    dirParts: ['.claude', 'shards'],
+    noun: 'shard',
+  });
+}
 
-    return {
-      passed: false,
-      detail: `Only ${mdFiles.length}/5 agent files found`,
-      fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore missing agent templates.`,
-    };
+/**
+ * Check 6: every shipped agent template .md file is present.
+ */
+function checkAgentsPresent(targetDir) {
+  return checkComponentFilesPresent(targetDir, {
+    checkName: 'Agents present',
+    componentKey: 'agents',
+    dirParts: ['.claude', 'agents'],
+    noun: 'agent',
   });
 }
 
@@ -314,7 +273,7 @@ function checkSettingsValid(targetDir) {
       return {
         passed: false,
         detail: '.claude/settings.json not found',
-        fix: `Run ${cyan('@dzhechkov/keysarium update')} to restore settings.`,
+        fix: `Run ${cyan('npx @dzhechkov/keysarium update')} to restore settings.`,
       };
     }
 
@@ -390,7 +349,7 @@ async function run(options) {
   // ── a) Check manifest exists ───────────────────────────────────────────
   if (!fileExists(manifestPath)) {
     logError('Keysarium is not installed in this directory.');
-    info(`Run ${cyan('@dzhechkov/keysarium init')} to install.`);
+    info(`Run ${cyan('npx @dzhechkov/keysarium init')} to install.`);
     process.exit(1);
   }
 
@@ -411,6 +370,7 @@ async function run(options) {
     checkSkillsComplete(targetDir),
     checkCommandsPresent(targetDir),
     checkRulesPresent(targetDir),
+    checkShardsPresent(targetDir),
     checkAgentsPresent(targetDir),
     checkSettingsValid(targetDir),
     checkResearchDir(targetDir),

package/src/commands/init.js

@@ -90,7 +90,7 @@ async function run(options) {
   if (fileExists(manifestPath)) {
     if (!force) {
       warn('Keysarium is already installed in this directory.');
-      info(`Run ${cyan('@dzhechkov/keysarium update')} to update, or use ${yellow('--force')} to overwrite.`);
+      info(`Run ${cyan('npx @dzhechkov/keysarium update')} to update, or use ${yellow('--force')} to overwrite.`);
       process.exit(1);
     }
     warn('Existing installation found — overwriting (--force).');

package/src/commands/list.js

@@ -65,7 +65,7 @@ async function run(options) {
   // ── a) Read manifest ───────────────────────────────────────────────────
   if (!fileExists(manifestPath)) {
     warn('Keysarium is not installed in this directory.');
-    info(`Run ${cyan('@dzhechkov/keysarium init')} to install.`);
+    info(`Run ${cyan('npx @dzhechkov/keysarium init')} to install.`);
     process.exit(1);
   }
 

package/src/commands/remove.js

@@ -187,7 +187,7 @@ async function run(options) {
     console.log(`  ${dim('-')} ${skippedCount} file(s) already missing (skipped)`);
   }
   console.log('');
-  info(`To reinstall, run: ${cyan('@dzhechkov/keysarium init')}`);
+  info(`To reinstall, run: ${cyan('npx @dzhechkov/keysarium init')}`);
   console.log('');
 
   process.exit(0);

package/src/commands/update.js

@@ -30,7 +30,7 @@ async function run(options) {
   // ── a) Read existing manifest ───────────────────────────────────────────
   if (!fileExists(manifestPath)) {
     logError('Keysarium is not installed in this directory.');
-    info(`Run ${cyan('@dzhechkov/keysarium init')} to install.`);
+    info(`Run ${cyan('npx @dzhechkov/keysarium init')} to install.`);
     process.exit(1);
   }
 

package/src/utils.js

@@ -250,19 +250,105 @@ function getTemplatesDir() {
 // Component definitions
 // ===========================================================================
 
-const COMPONENTS = {
-  skills:    { src: '.claude/skills',         label: 'Skills (8 skill packs)',            group: 'core' },
-  commands:  { src: '.claude/commands',        label: 'Commands (13 slash commands)',      group: 'core' },
-  rules:     { src: '.claude/rules',           label: 'Rules (10 auto-loaded rules)',     group: 'core' },
-  shards:    { src: '.claude/shards',          label: 'Shards (7 context shards)',        group: 'core' },
-  agents:    { src: '.claude/agents',          label: 'Agent templates (5 swarm configs)', group: 'core' },
-  hooks:     { src: '.claude/settings.json',   label: 'Hooks configuration',              group: 'core', isFile: true },
-  lib:       { src: 'lib',                     label: 'Library modules (4 modules)',       group: 'extended' },
-  docs:      { src: 'docs',                    label: 'Documentation (12 guides)',         group: 'docs' },
-  claude_md: { src: 'CLAUDE.md',               label: 'Master instructions',              group: 'core', isFile: true },
-  harvest:   { src: 'TOOLKIT_HARVEST.md',      label: 'Knowledge harvest tracker',        group: 'core', isFile: true },
+/**
+ * Count the units a component contributes, by inspecting the real templates/ tree.
+ *
+ * `countMode` decides what a "unit" is:
+ *   'dirs'  — immediate subdirectories (one skill pack = one directory)
+ *   'files' — every file, recursively (lib/, docs/ ship nested files)
+ *   'md'    — immediate *.md files (one command / rule / shard / agent = one file)
+ *
+ * Returns null when the count cannot be determined (missing dir, unreadable),
+ * so callers can degrade to a bare label instead of printing a wrong number.
+ */
+function countTemplateUnits(comp) {
+  if (comp.isFile) return null;
+
+  const srcPath = path.join(getTemplatesDir(), comp.src);
+
+  try {
+    if (!fs.statSync(srcPath).isDirectory()) return null;
+  } catch {
+    return null;
+  }
+
+  try {
+    if (comp.countMode === 'files') {
+      return getRelativePaths(srcPath).length;
+    }
+
+    const entries = fs.readdirSync(srcPath, { withFileTypes: true });
+
+    if (comp.countMode === 'dirs') {
+      return entries.filter((e) => e.isDirectory()).length;
+    }
+
+    // default: 'md'
+    return entries.filter((e) => e.isFile() && e.name.endsWith('.md')).length;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Component definitions.
+ *
+ * IMPORTANT: `label` is a COMPUTED getter — the parenthetical count is read from the
+ * shipped templates/ tree at access time, never hardcoded. Adding a command / rule /
+ * skill to templates/ changes what `init`, `init --dry-run` and `list` print, with no
+ * source edit. (Regression this guards: the labels used to be frozen strings reading
+ * "8 skill packs / 13 slash commands / 10 rules / 7 shards / 4 modules" long after the
+ * tree had grown past all five numbers.)
+ */
+const COMPONENT_SPECS = {
+  skills:    { src: '.claude/skills',        name: 'Skills',           unit: 'skill packs',    countMode: 'dirs',  group: 'core' },
+  commands:  { src: '.claude/commands',      name: 'Commands',         unit: 'slash commands', countMode: 'md',    group: 'core' },
+  rules:     { src: '.claude/rules',         name: 'Rules',            unit: 'auto-loaded rules', countMode: 'md', group: 'core' },
+  shards:    { src: '.claude/shards',        name: 'Shards',           unit: 'context shards', countMode: 'md',    group: 'core' },
+  agents:    { src: '.claude/agents',        name: 'Agent templates',  unit: 'swarm configs',  countMode: 'md',    group: 'core' },
+  hooks:     { src: '.claude/settings.json', name: 'Hooks configuration', group: 'core', isFile: true },
+  lib:       { src: 'lib',                   name: 'Library modules',  unit: 'modules',        countMode: 'files', group: 'extended' },
+  docs:      { src: 'docs',                  name: 'Documentation',    unit: 'guides',         countMode: 'files', group: 'docs' },
+  claude_md: { src: 'CLAUDE.md',             name: 'Master instructions', group: 'core', isFile: true },
+  harvest:   { src: 'TOOLKIT_HARVEST.md',    name: 'Knowledge harvest tracker', group: 'core', isFile: true },
 };
 
+/**
+ * The shipped `*.md` filenames for a directory component, read from templates/.
+ *
+ * This is the single source of truth for "what SHOULD be installed" — `doctor` derives its
+ * named checks from it, so a new command/rule/shard is named-checked the moment it lands in
+ * templates/, with no second list to keep in sync. Returns [] when templates/ is unreadable.
+ */
+function getTemplateFileNames(componentKey) {
+  const comp = COMPONENT_SPECS[componentKey];
+  if (!comp || comp.isFile) return [];
+
+  try {
+    return fs
+      .readdirSync(path.join(getTemplatesDir(), comp.src), { withFileTypes: true })
+      .filter((e) => e.isFile() && e.name.endsWith('.md'))
+      .map((e) => e.name)
+      .sort();
+  } catch {
+    return [];
+  }
+}
+
+const COMPONENTS = {};
+for (const [key, spec] of Object.entries(COMPONENT_SPECS)) {
+  const comp = Object.assign({}, spec);
+  Object.defineProperty(comp, 'label', {
+    enumerable: true,
+    get() {
+      const n = countTemplateUnits(this);
+      if (n === null || !this.unit) return this.name;
+      return `${this.name} (${n} ${this.unit})`;
+    },
+  });
+  COMPONENTS[key] = comp;
+}
+
 // ===========================================================================
 // Exports
 // ===========================================================================
@@ -306,4 +392,6 @@ module.exports = {
 
   // Components
   COMPONENTS,
+  countTemplateUnits,
+  getTemplateFileNames,
 };

package/templates/.claude/rules/agent-swarm.md

@@ -20,10 +20,8 @@ When spawning agents, use descriptive names:
 - "Phase 5 Speaker Script"
 
 ## BTO Agent Patterns
-- /bto-test: 3 parallel judge agents (Domain Expert || Critic || Completeness Auditor)
-- /bto-optimize: N parallel variant workers (mutation + evaluation)
-- /bto-optimize Round 1: 5 parallel haiku agents (variant evaluation)
-- /bto-optimize Round 3: 3×3 parallel sonnet agents (Layer 2 full panel)
+(Skill-evaluation swarms — BTO test/optimize — live in the separate `@dzhechkov/skills-bto`
+package and are not available in a Keysarium-only install.)
 
 ## Cost Optimization
 - Use model="haiku" for simple file operations, formatting, and BTO Layer 0-1 evaluation

package/templates/.claude/rules/background-workers.md

@@ -5,7 +5,7 @@
 | Trigger | Worker Type | Condition |
 |---------|------------|-----------|
 | Case completion | `consolidate` | After 3rd completed `/casarium` case in project |
-| Post-BTO test | `health-check` | After any `/bto-test` run (advisory, not enforced) |
+| Post-BTO test | `health-check` | After a BTO evaluation run, if `@dzhechkov/skills-bto` is installed (advisory, not enforced) |
 | Manual | Any | User runs `/workers start <type>` |
 
 Auto-launch triggers are ADVISORY. The system may suggest launching a worker but

package/templates/.claude/rules/dream-cycles.md

@@ -6,6 +6,7 @@ When starting a new pipeline run (`/casarium` or `/feature-adr`), the orchestrat
 
 1. Read `.keysarium/insights/trigger-state.json`
 2. Evaluate triggers using the protocol in `lib/dream-engine.md`
+   (under `init --minimal`, `lib/` is NOT installed — dream cycles are non-blocking, so skip)
 3. If any trigger is met, suggest to the user:
    ```
    Dream cycle trigger met ({reason}). Consider running /dream run for fresh insights.

package/templates/.claude/rules/feature-adr-conventions.md

@@ -8,7 +8,7 @@
 | Researching an AI case for hackathon | `/casarium` |
 | Solving a complex problem (no code) | `/solve` |
 | Designing architecture only (no code) | `/architecture-phase` |
-| Building a new skill/command | `/bto-build` |
+| Building a new skill/command | BTO build — separate package: `npx @dzhechkov/skills-bto init` |
 
 ## Output Directory
 

package/templates/.claude/rules/modular-reuse.md

@@ -24,7 +24,11 @@ They can be composed for different workflows.
 Shared logic lives in lib/ directory:
 - lib/phase-utils.md: Common phase utilities
 - lib/agent-patterns.md: Agent spawning patterns
-- lib/checkpoint-template.md: Checkpoint formatting
+- lib/skill-loader.md: Skill loading conventions
+- lib/domain-templates.md: Domain-specific templates
+
+Under `init --minimal`, `lib/` is NOT installed; treat these modules as absent and skip the
+optional behaviour they describe rather than failing.
 
 ## Extending the System
 To add a new phase:

package/templates/.claude/rules/reward-learning.md

@@ -9,6 +9,9 @@ Govern how the Keysarium pipeline integrates with the Reward-Calibrated Learning
 Read `lib/memory-protocol.md` for the full protocol specification.
 Read `lib/reward-tracker.md` for analytics and pattern detection.
 
+Under `init --minimal`, `lib/` is NOT installed; memory operations are non-blocking, so skip them
+silently when these files are absent.
+
 ## When to Call memory_query()
 
 **Trigger:** At the START of every pipeline phase (Phase 0 through Phase 5).

package/templates/.claude/rules/trust-tiers.md

@@ -1,12 +1,17 @@
 # Trust Tier System
 
+> **BTO evaluation is a SEPARATE package.** Keysarium installs no `/bto*` slash commands — the
+> BTO evaluator ships as `@dzhechkov/skills-bto` (`npx @dzhechkov/skills-bto init`). Where this
+> file refers to a "BTO evaluation", it means running that package. Tier promotion is therefore
+> optional: without it, skills stay at the tier their structure earns (Tier 0/1).
+
 ## Tier Definitions
 
 | Tier | Label | Requirements | Promotion Path |
 |------|-------|-------------|----------------|
 | Tier 3 | Verified | Eval test suites with deterministic validation | — (highest) |
-| Tier 2 | Validated | Passed /bto-test with Layer 2 score ≥ 7.0 | Run /bto-test, score ≥ 8.5 on Layer 2 |
-| Tier 1 | Structured | SKILL.md + references/ or modules/ | Run /bto-test, score ≥ 7.0 on Layer 2 |
+| Tier 2 | Validated | Passed a BTO evaluation with Layer 2 score ≥ 7.0 | Run a BTO evaluation, score ≥ 8.5 on Layer 2 |
+| Tier 1 | Structured | SKILL.md + references/ or modules/ | Run a BTO evaluation, score ≥ 7.0 on Layer 2 |
 | Tier 0 | Advisory | Basic SKILL.md only | Add references/, examples/, structured output |
 
 ## Current Skill Tiers
@@ -19,24 +24,23 @@
 | problem-solver-enhanced | 1 | Structured | Comprehensive SKILL.md with TRIZ framework |
 | presentation-storyteller | 1 | Structured | SKILL.md + references/ |
 | reverse-engineering-unicorn | 1 | Structured | SKILL.md + modules/ + references/ + examples/ |
-| bto | 1 | Structured | SKILL.md + modules/ + references/ + examples/ |
-| knowledge-extractor | 2 | Validated | /bto-test Layer 2 score 7.5, optimized 2026-03-03 |
+| knowledge-extractor | 2 | Validated | BTO evaluation Layer 2 score 7.5, optimized 2026-03-03 |
 | analyst-manual-full | 0 | Advisory | SKILL.md only (composite orchestrator, depends on explore + goap-research + problem-solver) |
 | feature-adr | 1 | Structured | SKILL.md + modules/ + references/ + examples/ |
 | edu-site-generator | 1 | Structured | SKILL.md + modules/ + references/ + examples/ |
-| transcript-site-generator | 2 | Validated | /bto-test Layer 2 score 7.82 |
+| transcript-site-generator | 2 | Validated | BTO evaluation Layer 2 score 7.82 |
 | ai-factory-mapper | 1 | Structured | SKILL.md + references/ + assets/ + scripts/ (v1.0, апрель 2026) |
 
 ## Tier Enforcement
 
 - Tier 0 skills: Flag with warning when loaded in production pipeline
-- Tier 1 skills: Standard usage, recommend /bto-test for promotion
+- Tier 1 skills: Standard usage, recommend a BTO evaluation for promotion
 - Tier 2 skills: Full confidence, include BTO score in metadata
 - Tier 3 skills: Highest confidence, deterministic validation available
 
 ## Promotion Protocol
 
-1. Run `/bto-test .claude/skills/<name>/`
+1. Install the evaluator (`npx @dzhechkov/skills-bto init`), then run its BTO test on `.claude/skills/<name>/`
 2. If Layer 2 score ≥ 7.0 → promote to Tier 2, record score in SKILL.md
 3. If Layer 2 score ≥ 8.5 + deterministic eval tests exist → promote to Tier 3
 4. Record promotion date and score in SKILL.md frontmatter

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

@@ -10,7 +10,7 @@ trust_tier: 1
 
 # edu-site-generator — Gamified Educational Site Generator
 
-<!-- Trust Tier: 1 — Structured | Path to Tier 2: Run /bto-test for self-evaluation -->
+<!-- Trust Tier: 1 — Structured | Path to Tier 2: run a BTO evaluation (separate package: npx @dzhechkov/skills-bto) -->
 
 > Generate a complete gamified educational SPA from documentation/content, optimized for GitHub Pages deployment.
 

package/templates/.claude/skills/explore/SKILL.md

@@ -10,7 +10,7 @@ description: >
   provide solutions until task is fully explored.
 trust_tier: 1
 trust_tier_label: "Structured"
-trust_tier_path: "Run /bto-test to promote to Tier 2"
+trust_tier_path: "Run a BTO evaluation from the separate package @dzhechkov/skills-bto to promote to Tier 2"
 ---
 
 # Explore: Adaptive Task Clarification

package/templates/.claude/skills/feature-adr/SKILL.md

@@ -11,7 +11,7 @@ description: >
   "implement feature", "/feature-adr".
 trust_tier: 0
 trust_tier_label: "Advisory"
-trust_tier_path: "Run /bto-test to promote to Tier 1"
+trust_tier_path: "Run a BTO evaluation from the separate package @dzhechkov/skills-bto to promote to Tier 1"
 agentic_qe_version: "7.5.1"
 agentic_qe_source: "https://github.com/proffesor-for-testing/agentic-qe"
 agentic_qe_skills_core: 9

package/templates/.claude/skills/frontend-design/SKILL.md

@@ -4,7 +4,7 @@ description: Create distinctive, production-grade frontend interfaces with high
 license: Complete terms in LICENSE.txt
 trust_tier: 0
 trust_tier_label: "Advisory"
-trust_tier_path: "Add references/ directory and run /bto-test to promote to Tier 1"
+trust_tier_path: "Add references/ directory and run a BTO evaluation from the separate package @dzhechkov/skills-bto to promote to Tier 1"
 ---
 
 This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.

package/templates/.claude/skills/goap-research-ed25519/SKILL.md

@@ -3,7 +3,7 @@ name: goap-research-ed25519
 description: GOAP research system with Ed25519 provenance and tamper-evidence under pinned trusted-issuer keys. Use for high-stakes research that needs cited sources, explicit confidence, signed audit trails, or cryptographic proof of who signed a fact. Ed25519 does not prove truthfulness or prevent hallucination.
 trust_tier: 1
 trust_tier_label: "Structured"
-trust_tier_path: "Run /bto-test to promote to Tier 2"
+trust_tier_path: "Run a BTO evaluation from the separate package @dzhechkov/skills-bto to promote to Tier 2"
 ---
 
 # GOAP Research with Ed25519 Provenance

package/templates/.claude/skills/knowledge-extractor/SKILL.md

@@ -9,7 +9,7 @@ trust_tier: 2
 trust_tier_label: "Validated"
 bto_score: 7.5
 bto_date: "2026-03-03"
-trust_tier_path: "Run /bto-test, score >= 8.5 + eval tests for Tier 3"
+trust_tier_path: "Run a BTO evaluation from the separate package @dzhechkov/skills-bto, score >= 8.5 + eval tests for Tier 3"
 ---
 
 # Knowledge Extractor
@@ -227,7 +227,7 @@ Category-to-agent mapping (see `references/artifact-categories.md`):
 | memory_query() | Pipeline start | Load historical harvest patterns |
 | memory_store() | After user checkpoint | Store harvest reward data |
 | brain-export | N/A (passive) | Findings JSON is brain-compatible schema |
-| BTO | Post-harvest | Placed skills can be evaluated via `/bto-test` |
+| BTO | Post-harvest | Placed skills can be evaluated with the separate package `npx @dzhechkov/skills-bto` |
 | dream cycles | Pipeline end | Update trigger-state.json |
 | /harvest command | Entry point | Thin wrapper loads this skill |
 

package/templates/.claude/skills/knowledge-extractor/modules/04-integrate.md

@@ -144,7 +144,7 @@ Placed artifacts:
 Gate pass rate: {rate}%
 Memory reward stored: {score} ({label})
 
-Run /bto-test on placed skills for promotion to Tier 2.
+Run a BTO evaluation (separate package: `npx @dzhechkov/skills-bto`) on placed skills for promotion to Tier 2.
 ═══════════════════════════════════════════════════════
 ```