@dzhechkov/skills-feature-adr 1.0.0 → 1.2.0

package/README.md

@@ -2,21 +2,24 @@
 
 **Adaptive Feature Development skill pack for Claude Code**
 
-9-step pipeline with Complexity Router (S/M/L/XL) for developing features of any scale — from a 3-file config change to a cross-cutting 30+ file refactoring. Part of the [Keysarium](https://www.npmjs.com/package/@dzhechkov/keysarium) ecosystem.
+11-step pipeline with Complexity Router (S/M/L/XL) for developing features of any scale — from a 3-file config change to a cross-cutting 30+ file refactoring. Integrates 15 skills from [agentic-qe](https://github.com/proffesor-for-testing/agentic-qe) for comprehensive quality engineering. Part of the [Keysarium](https://www.npmjs.com/package/@dzhechkov/keysarium) ecosystem.
 
 ---
 
 ## Quick Start
 
 ```bash
-# One-command install via npx
-npx @dzhechkov/skills-feature-adr
+# Core install (feature-adr pipeline only)
+npx @dzhechkov/skills-feature-adr init
+
+# Full install with learning + knowledge extraction
+npx @dzhechkov/skills-feature-adr init --with-learning --knowledge-extractor
 
 # Or install globally
 npm install -g @dzhechkov/skills-feature-adr
-skills-feature-adr init
+skills-feature-adr init --with-learning --knowledge-extractor
 
-# Install into a project that already has @dzhechkov/keysarium
+# Already have @dzhechkov/keysarium? Just install core (learning & harvest included)
 npx @dzhechkov/skills-feature-adr init
 ```
 
@@ -28,11 +31,11 @@ After installation, open Claude Code in your project directory and use `/feature
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| **Skill** | 1 | `feature-adr` — 9-step pipeline with complexity routing |
-| **Modules** | 9 | Steps 00-08: Complexity Router → Requirements → Research → ADR → DDD → Architecture → Plan → Code → QE |
-| **References** | 4 | Complexity matrix, ADR template, C4 template, QE checklist |
+| **Skill** | 1 | `feature-adr` — 11-step pipeline with complexity routing |
+| **Modules** | 11 | Steps 00-09 + 03.5: Router → Requirements → Research → ADR → QCSD → DDD → Architecture → Plan → Code → QE → Fleet QE |
+| **References** | 4+15 | Complexity matrix, ADR/C4/QE templates + 15 agentic-qe skill protocols |
 | **Examples** | 1 | Sample M-tier feature output |
-| **Command** | 1 | `/feature-adr` — orchestrator command |
+| **Command** | 1 | `/feature-adr` — orchestrator (supports `--full-qe` and `--full-qe-extended`) |
 | **Rules** | 1 | `feature-adr-conventions` — directory structure and naming |
 | **Shards** | 1 | `feature-adr` — governance shard with quality gates |
 
@@ -44,7 +47,10 @@ Everything is installed into your project's `.claude/` directory and works nativ
 
 ```bash
 npx @dzhechkov/skills-feature-adr                    # Full install (same as init)
-npx @dzhechkov/skills-feature-adr init               # Install all components
+npx @dzhechkov/skills-feature-adr init               # Install core components
+npx @dzhechkov/skills-feature-adr init --with-learning                  # + reward learning
+npx @dzhechkov/skills-feature-adr init --knowledge-extractor            # + knowledge extractor
+npx @dzhechkov/skills-feature-adr init --with-learning --knowledge-extractor  # + both
 npx @dzhechkov/skills-feature-adr init --force       # Overwrite existing files
 npx @dzhechkov/skills-feature-adr init --dry-run     # Preview without making changes
 npx @dzhechkov/skills-feature-adr update             # Update to latest version
@@ -75,9 +81,17 @@ ARCHITECTURE → IMPLEMENTATION →  CODE   →   QE
 
 # The Complexity Router classifies your feature automatically:
 #   S  → fast track (5 steps)
-#   M  → standard (7 steps)
-#   L  → full pipeline (9 steps)
+#   M  → standard (8 steps)
+#   L  → full pipeline (11 steps)
 #   XL → full DAG + multi-agent swarm
+
+# With full agentic-qe integration (requires: npm install -g agentic-qe)
+/feature-adr --full-qe Add payment processing module
+# Full protocols for 9 core skills, same agents, deeper methodology
+
+# With extended agentic-qe (chaos, security, performance, mutation, TDD)
+/feature-adr --full-qe-extended Migrate authentication to zero-trust architecture
+# Full protocols + 6 extra skills, up to 7 fleet QE agents
 ```
 
 ---
@@ -106,17 +120,21 @@ ARCHITECTURE → IMPLEMENTATION →  CODE   →   QE
 
 ## Pipeline Steps
 
-| Step | Name | Tiers | Model | Output |
-|------|------|-------|-------|--------|
-| 0 | Complexity Router | All | haiku | `00_complexity_assessment.md` |
-| 1 | Requirements | All | sonnet | `01_requirements.md` |
-| 2 | Research | L/XL | sonnet | `02_research.md` |
-| 3 | ADR | M+ | opus | `03_adr/001-*.md` |
-| 4 | DDD | L/XL | opus | `04_domain_model.md` |
-| 5 | Architecture | M+ | opus | `05_architecture.md` + diagrams |
-| 6 | Implementation Plan | All | sonnet | `06_implementation_plan.md` |
-| 7 | Code | All | opus | `07_code_changes/` |
-| 8 | QE | All | sonnet | `08_qe_report.md` |
+| Step | Name | Tiers | Model | Agentic QE Skill | Output |
+|------|------|-------|-------|------------------|--------|
+| 0 | Complexity Router | All | haiku | — | `00_complexity_assessment.md` |
+| 1 | Requirements | All | sonnet | — | `01_requirements.md` |
+| 2 | Research | L/XL | sonnet | — | `02_research.md` |
+| 3 | ADR + Shift-Left | M+ | opus | shift-left-testing | `03_adr/001-*.md` |
+| 3.5 | QCSD Ideation Swarm | M+ | sonnet | qcsd-ideation-swarm | `03.5_ideation_report.md` |
+| 4 | DDD | L/XL | opus | — | `04_domain_model.md` |
+| 5 | Architecture | M+ | opus | — | `05_architecture.md` + diagrams |
+| 6 | SPARC-GOAP Plan | All | sonnet | code-goal-planner | `06_implementation_plan.md` |
+| 7 | Code | All | opus | tdd-london-chicago* | `07_code_changes/` |
+| 8 | QE + Brutal Honesty | All | sonnet | brutal-honesty-review | `08_qe_report.md` |
+| 9 | Fleet QE | L/XL | sonnet | 5 skills (4 agents) | `09_fleet_qe_assessment.md` |
+
+*\* Extended skills (marked with \*) are only available with `--full-qe-extended`*
 
 ---
 
@@ -135,6 +153,7 @@ features/<feature-slug>/
 ├── 07_code_changes/
 │   └── change_manifest.md          ← Always
 ├── 08_qe_report.md                 ← Always
+├── 09_fleet_qe_assessment.md       ← L/XL only
 ├── diagrams/                       ← M+ only
 │   ├── architecture-c4.mermaid
 │   └── sequence-*.mermaid
@@ -143,6 +162,103 @@ features/<feature-slug>/
 
 ---
 
+## Agentic QE Integration
+
+Feature ADR integrates 15 skills from [agentic-qe](https://github.com/proffesor-for-testing/agentic-qe) for quality engineering at every step.
+
+### Three Modes
+
+| Mode | Flag | Skills | Requires |
+|------|------|--------|----------|
+| **Reference** | (none) | 9 core (condensed copies) | Nothing — works out of the box |
+| **Direct** | `--full-qe` | 9 core (full protocols) | [agentic-qe](https://github.com/proffesor-for-testing/agentic-qe) installed |
+| **Direct Extended** | `--full-qe-extended` | 15 (9 core + 6 extended) | [agentic-qe](https://github.com/proffesor-for-testing/agentic-qe) installed |
+
+### Installing agentic-qe (required for `--full-qe` and `--full-qe-extended`)
+
+```bash
+# 1. Install agentic-qe globally
+npm install -g agentic-qe
+
+# 2. Initialize in your project (auto-detects tech stack, configures MCP)
+cd your-project && aqe init --auto
+```
+
+Source: [github.com/proffesor-for-testing/agentic-qe](https://github.com/proffesor-for-testing/agentic-qe)
+
+After installation, feature-adr auto-detects agentic-qe when you use the `--full-qe` or `--full-qe-extended` flags. If agentic-qe is not found, the pipeline falls back to Reference Mode with a warning.
+
+### Core Skills (9, all modes)
+
+| Skill | Step | Purpose |
+|-------|------|---------|
+| shift-left-testing | 3 | ADR testability validation |
+| qcsd-ideation-swarm | 3.5 | HTSM + SFDIPOT quality swarm |
+| code-goal-planner | 6 | SPARC-GOAP milestone planning |
+| brutal-honesty-review | 8 | Linus/Ramsay/Bach code review |
+| qe-requirements-validation | 9 | Traceability matrix + SMART |
+| risk-based-testing | 9 | Probability×Impact 5×5 scoring |
+| enterprise-integration-testing | 9 | Contract testing + E2E flows |
+| regression-testing | 9 | Change-based test selection |
+| qe-coverage-analysis | 9 | Risk-weighted coverage |
+
+### Extended Skills (6, `--full-qe-extended` only)
+
+| Skill | Step | Condition |
+|-------|------|-----------|
+| tdd-london-chicago | 7 | Always |
+| mutation-testing | 8 | If test suite exists |
+| security-testing | 8, 9 | `HAS_AUTH` / `HAS_EXTERNAL_API` |
+| performance-testing | 8, 9 | `HAS_PERFORMANCE_SLA` |
+| chaos-engineering-resilience | 9 | `HAS_INFRASTRUCTURE_CHANGE` |
+| qcsd-production-swarm | Post-9 | Advisory feedback loops |
+
+---
+
+## Optional Features: Learning & Knowledge Extraction
+
+Feature ADR can be extended with reward learning and knowledge extraction — no additional packages required.
+
+### `--with-learning` — Reward Learning
+
+Adds the Memory Protocol and Reward Tracker. The pipeline **learns from your feedback** at every checkpoint:
+- Stores reward scores based on your responses (immediate approval = 1.0, minor adjustments = 0.7, rework = 0.3)
+- Loads historical patterns at the start of each step
+- Detects domain-specific bottlenecks and skill effectiveness trends
+
+```bash
+npx @dzhechkov/skills-feature-adr init --with-learning
+```
+
+**Installs:** `lib/memory-protocol.md`, `lib/reward-tracker.md`, `.claude/rules/reward-learning.md`
+
+### `--knowledge-extractor` — Knowledge Harvesting
+
+Adds the Knowledge Extractor skill with the `/harvest` command. After completing a feature, extract reusable patterns:
+
+```bash
+npx @dzhechkov/skills-feature-adr init --knowledge-extractor
+
+# After completing a feature:
+/harvest features/<feature-slug>/
+```
+
+**Installs:** `.claude/skills/knowledge-extractor/` (5 agents, 7 categories, 8 quality gates), `.claude/commands/harvest.md`
+
+### Both at once
+
+```bash
+npx @dzhechkov/skills-feature-adr init --with-learning --knowledge-extractor
+```
+
+### Already using `@dzhechkov/keysarium`?
+
+> **If you have `@dzhechkov/keysarium` installed, these flags are not needed.**
+> Keysarium already includes reward learning, knowledge extraction, and more.
+> The installer auto-detects keysarium and skips optional components to avoid duplication.
+
+---
+
 ## Shared Skills
 
 Feature ADR uses these skills from `@dzhechkov/keysarium` (if installed):
@@ -166,9 +282,11 @@ npx @dzhechkov/skills-bto init             # Build-Test-Optimize
 npx @dzhechkov/skills-feature-adr init     # Feature development
 
 # Use the right tool for the job:
-/casarium [case description]       # AI case research (7 phases)
-/feature-adr [feature description] # Feature development (9 steps)
-/bto [skill path]                  # Skill evaluation & optimization
+/casarium [case description]                        # AI case research (7 phases)
+/feature-adr [feature description]                  # Feature development (11 steps)
+/feature-adr --full-qe [feature description]        # + full agentic-qe protocols
+/feature-adr --full-qe-extended [feature desc]      # + extended QE skills
+/bto [skill path]                                   # Skill evaluation & optimization
 ```
 
 ---

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dzhechkov/skills-feature-adr",
-  "version": "1.0.0",
-  "description": "Adaptive Feature Development skill pack for Claude Code — 9-step pipeline with Complexity Router (S/M/L/XL), ADR-driven architecture, and multi-agent QE",
+  "version": "1.2.0",
+  "description": "Adaptive Feature Development skill pack for Claude Code — 11-step pipeline with Complexity Router (S/M/L/XL), ADR-driven architecture, 15 agentic-qe skills, multi-agent fleet QE. Supports --full-qe, --full-qe-extended, --with-learning, and --knowledge-extractor modes.",
   "main": "src/cli.js",
   "bin": {
     "skills-feature-adr": "./bin/cli.js"
@@ -27,7 +27,13 @@
     "skills",
     "skill-pack",
     "ddd",
-    "quality-engineering"
+    "quality-engineering",
+    "agentic-qe",
+    "shift-left",
+    "fleet-qe",
+    "reward-learning",
+    "knowledge-extractor",
+    "harvest"
   ],
   "author": "dzhechko",
   "license": "MIT",

package/src/cli.js

@@ -10,7 +10,7 @@ function showBanner() {
   console.log('');
   console.log(cyan('\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557'));
   console.log(cyan('\u2551') + bold('   FEATURE-ADR \u2014 Adaptive Feature Development          ') + cyan('\u2551'));
-  console.log(cyan('\u2551') + '   9-step pipeline with Complexity Router (S/M/L/XL)   ' + cyan('\u2551'));
+  console.log(cyan('\u2551') + '   11-step pipeline with Complexity Router (S/M/L/XL)  ' + cyan('\u2551'));
   console.log(cyan('\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D'));
   console.log('');
 }
@@ -37,20 +37,24 @@ function showHelp() {
   console.log('  ' + green('doctor') + '    Check Feature ADR installation health');
   console.log('');
   console.log(bold('Options:'));
-  console.log('  ' + yellow('--force') + '      Overwrite existing files without prompting');
-  console.log('  ' + yellow('--dry-run') + '    Show what would be done without making changes');
-  console.log('  ' + yellow('--help, -h') + '   Show this help message');
-  console.log('  ' + yellow('--version, -v') + ' Show version number');
+  console.log('  ' + yellow('--force') + '                Overwrite existing files without prompting');
+  console.log('  ' + yellow('--dry-run') + '              Show what would be done without making changes');
+  console.log('  ' + yellow('--with-learning') + '        Add reward learning (memory protocol + reward tracker)');
+  console.log('  ' + yellow('--knowledge-extractor') + '  Add knowledge extractor skill (/harvest)');
+  console.log('  ' + yellow('--help, -h') + '             Show this help message');
+  console.log('  ' + yellow('--version, -v') + '          Show version number');
   console.log('');
   console.log(bold('Examples:'));
   console.log(dim('  $ ') + 'npx @dzhechkov/skills-feature-adr init');
+  console.log(dim('  $ ') + 'npx @dzhechkov/skills-feature-adr init --with-learning');
+  console.log(dim('  $ ') + 'npx @dzhechkov/skills-feature-adr init --with-learning --knowledge-extractor');
   console.log(dim('  $ ') + 'npx @dzhechkov/skills-feature-adr init --force');
-  console.log(dim('  $ ') + 'npx @dzhechkov/skills-feature-adr update --dry-run');
   console.log(dim('  $ ') + 'npx @dzhechkov/skills-feature-adr doctor');
   console.log('');
   console.log(bold('Integration:'));
   console.log('  Works alongside @dzhechkov/keysarium and @dzhechkov/skills-bto.');
-  console.log('  Install all three for the full toolkit.');
+  console.log('  If @dzhechkov/keysarium is already installed, --with-learning and');
+  console.log('  --knowledge-extractor are not needed (already included in keysarium).');
   console.log('');
 }
 
@@ -63,6 +67,8 @@ function parseArgs(argv) {
   const flags = {
     force: false,
     dryRun: false,
+    withLearning: false,
+    knowledgeExtractor: false,
     targetDir: process.cwd(),
   };
 
@@ -76,6 +82,12 @@ function parseArgs(argv) {
       case '--dry-run':
         flags.dryRun = true;
         break;
+      case '--with-learning':
+        flags.withLearning = true;
+        break;
+      case '--knowledge-extractor':
+        flags.knowledgeExtractor = true;
+        break;
       case '--help':
       case '-h':
         command = 'help';

package/src/commands/init.js

@@ -8,7 +8,7 @@ const {
   copyDirRecursive, copyDirFiltered, fileExists, readJSON,
   ensureDir, getRelativePaths, getRelativePathsFiltered,
   createManifest, writeManifest, getTemplatesDir,
-  COMPONENTS, MANIFEST_FILE, getComponentFilter,
+  COMPONENTS, OPTIONAL_COMPONENTS, MANIFEST_FILE, getComponentFilter,
 } = require('../utils');
 
 // ---------------------------------------------------------------------------
@@ -47,6 +47,13 @@ function installComponent(key, comp, templatesDir, targetDir) {
     return [];
   }
 
+  // Single file copy (for isFile components)
+  if (comp.isFile) {
+    ensureDir(path.dirname(dest));
+    fs.copyFileSync(src, dest);
+    return [comp.src];
+  }
+
   const filterFn = getComponentFilter(comp);
 
   if (filterFn) {
@@ -58,12 +65,33 @@ function installComponent(key, comp, templatesDir, targetDir) {
   return getRelativePaths(dest).map((rel) => path.join(comp.src, rel));
 }
 
+// Resolve which optional component keys to install based on flags
+function getOptionalKeys(flags, keysariumDetected) {
+  if (keysariumDetected) return []; // keysarium already provides these
+
+  const keys = [];
+
+  if (flags.withLearning) {
+    for (const [key, comp] of Object.entries(OPTIONAL_COMPONENTS)) {
+      if (comp.group === 'learning') keys.push(key);
+    }
+  }
+
+  if (flags.knowledgeExtractor) {
+    for (const [key, comp] of Object.entries(OPTIONAL_COMPONENTS)) {
+      if (comp.group === 'knowledge-extractor') keys.push(key);
+    }
+  }
+
+  return keys;
+}
+
 // ---------------------------------------------------------------------------
 // Main command
 // ---------------------------------------------------------------------------
 
 async function run(options) {
-  const { force, dryRun, targetDir } = options;
+  const { force, dryRun, targetDir, withLearning, knowledgeExtractor } = options;
   const manifestPath = path.join(targetDir, MANIFEST_FILE);
 
   // ── a) Check for existing installation ─────────────────────────────────
@@ -78,12 +106,23 @@ async function run(options) {
 
   // ── b) Detect keysarium integration ────────────────────────────────────
   const keysariumManifest = detectKeysarium(targetDir);
+  const keysariumDetected = !!keysariumManifest;
+
   if (keysariumManifest) {
     showKeysariumIntegration(keysariumManifest);
   }
 
+  // Warn if flags used but keysarium already provides these
+  if (keysariumDetected && (withLearning || knowledgeExtractor)) {
+    console.log('');
+    warn('Keysarium is already installed \u2014 it includes learning and knowledge extraction.');
+    info('Flags --with-learning and --knowledge-extractor are not needed. Skipping optional components.');
+    console.log('');
+  }
+
   // ── c) Determine components ────────────────────────────────────────────
   const componentKeys = Object.keys(COMPONENTS);
+  const optionalKeys = getOptionalKeys(options, keysariumDetected);
   const templatesDir = getTemplatesDir();
 
   // ── d) Show plan ───────────────────────────────────────────────────────
@@ -97,6 +136,16 @@ async function run(options) {
     console.log(`  ${green('+')} ${comp.label}${filterNote}`);
   }
 
+  if (optionalKeys.length > 0) {
+    console.log('');
+    info(bold('Optional components:'));
+    console.log('');
+    for (const key of optionalKeys) {
+      const comp = OPTIONAL_COMPONENTS[key];
+      console.log(`  ${yellow('+')} ${comp.label}`);
+    }
+  }
+
   console.log('');
 
   if (dryRun) {
@@ -104,14 +153,25 @@ async function run(options) {
     process.exit(0);
   }
 
-  // ── e) Install components ──────────────────────────────────────────────
-  const totalComponents = componentKeys.length;
+  // ── e) Install core components ─────────────────────────────────────────
+  const totalComponents = componentKeys.length + optionalKeys.length;
   const installedFiles = [];
+  let stepNum = 0;
 
-  for (let i = 0; i < totalComponents; i++) {
-    const key = componentKeys[i];
+  for (const key of componentKeys) {
+    stepNum++;
     const comp = COMPONENTS[key];
-    step(i + 1, totalComponents, `Installing ${comp.label}...`);
+    step(stepNum, totalComponents, `Installing ${comp.label}...`);
+
+    const files = installComponent(key, comp, templatesDir, targetDir);
+    installedFiles.push(...files);
+  }
+
+  // ── e2) Install optional components ────────────────────────────────────
+  for (const key of optionalKeys) {
+    stepNum++;
+    const comp = OPTIONAL_COMPONENTS[key];
+    step(stepNum, totalComponents, `Installing ${comp.label}...`);
 
     const files = installComponent(key, comp, templatesDir, targetDir);
     installedFiles.push(...files);
@@ -122,7 +182,15 @@ async function run(options) {
   const pkg = readJSON(pkgPath);
   const version = pkg ? pkg.version : '0.0.0';
 
-  const manifest = createManifest(version, componentKeys, installedFiles.sort());
+  const allKeys = [...componentKeys, ...optionalKeys];
+  const manifest = createManifest(version, allKeys, installedFiles.sort());
+
+  // Track optional features in manifest
+  manifest.optional = {
+    withLearning: optionalKeys.some((k) => OPTIONAL_COMPONENTS[k]?.group === 'learning'),
+    knowledgeExtractor: optionalKeys.some((k) => OPTIONAL_COMPONENTS[k]?.group === 'knowledge-extractor'),
+  };
+
   writeManifest(targetDir, manifest);
   info(`Created ${MANIFEST_FILE} manifest`);
 
@@ -136,6 +204,10 @@ async function run(options) {
     const comp = COMPONENTS[key];
     console.log(`  ${green('\u2713')} ${comp.label}`);
   }
+  for (const key of optionalKeys) {
+    const comp = OPTIONAL_COMPONENTS[key];
+    console.log(`  ${green('\u2713')} ${comp.label} ${yellow('[optional]')}`);
+  }
 
   console.log('');
   console.log(bold('Next steps:'));
@@ -143,6 +215,14 @@ async function run(options) {
   console.log(`  2. Run ${cyan('/feature-adr [description]')} to start the pipeline`);
   console.log(`  3. The Complexity Router will classify your feature as S/M/L/XL`);
   console.log(`  4. Then the pipeline adapts: fewer steps for S, full DAG for XL`);
+
+  if (manifest.optional.withLearning) {
+    console.log(`  5. Reward learning is active \u2014 pipeline improves from your feedback`);
+  }
+  if (manifest.optional.knowledgeExtractor) {
+    console.log(`  ${manifest.optional.withLearning ? '6' : '5'}. Run ${cyan('/harvest features/<slug>/')} after completing a feature to extract knowledge`);
+  }
+
   console.log('');
 
   console.log(bold('Complexity Tiers:'));
@@ -152,10 +232,19 @@ async function run(options) {
   console.log(`  ${bold('XL')} ${dim('\u2014 30+ files, ~4h+     (Full DAG + multi-agent swarm)')}`);
   console.log('');
 
+  if (!withLearning && !knowledgeExtractor && !keysariumDetected) {
+    console.log(bold('Optional features:'));
+    console.log(`  ${dim('Add reward learning:')}     npx @dzhechkov/skills-feature-adr init --with-learning --force`);
+    console.log(`  ${dim('Add knowledge extractor:')} npx @dzhechkov/skills-feature-adr init --knowledge-extractor --force`);
+    console.log(`  ${dim('Add both:')}                npx @dzhechkov/skills-feature-adr init --with-learning --knowledge-extractor --force`);
+    console.log('');
+  }
+
   if (keysariumManifest) {
     console.log(bold('Integration:'));
     console.log(`  Feature ADR is available alongside your Keysarium pipeline.`);
     console.log(`  Use ${cyan('/casarium')} for research, ${cyan('/feature-adr')} for feature development.`);
+    console.log(`  Learning and knowledge extraction are provided by Keysarium.`);
     console.log('');
   }
 

package/src/utils.js

@@ -270,6 +270,41 @@ const COMPONENTS = {
   },
 };
 
+// Optional components — installed only with explicit flags
+const OPTIONAL_COMPONENTS = {
+  // --with-learning
+  learning_lib_memory: {
+    src: 'lib/memory-protocol.md',
+    label: 'Memory Protocol (reward-calibrated learning)',
+    group: 'learning',
+    isFile: true,
+  },
+  learning_lib_reward: {
+    src: 'lib/reward-tracker.md',
+    label: 'Reward Tracker (analytics & pattern detection)',
+    group: 'learning',
+    isFile: true,
+  },
+  learning_rule: {
+    src: '.claude/rules/reward-learning.md',
+    label: 'Reward Learning Rules',
+    group: 'learning',
+    isFile: true,
+  },
+  // --knowledge-extractor
+  knowledge_extractor_skill: {
+    src: '.claude/skills/knowledge-extractor',
+    label: 'Knowledge Extractor Skill (5 agents, 7 categories, 8 gates)',
+    group: 'knowledge-extractor',
+  },
+  knowledge_extractor_command: {
+    src: '.claude/commands',
+    label: 'Harvest Command (/harvest)',
+    group: 'knowledge-extractor',
+    filter: 'harvest',
+  },
+};
+
 // ===========================================================================
 // Filter helpers
 // ===========================================================================
@@ -328,6 +363,7 @@ module.exports = {
 
   // Components
   COMPONENTS,
+  OPTIONAL_COMPONENTS,
 
   // Filters
   getComponentFilter,

package/templates/.claude/commands/feature-adr.md

@@ -3,6 +3,8 @@
 ## Использование
 ```
 /feature-adr [описание фичи или путь к issue]
+/feature-adr --full-qe [описание фичи]            # Direct Mode: полные протоколы agentic-qe
+/feature-adr --full-qe-extended [описание фичи]    # Direct Extended: полные протоколы + доп. скиллы
 ```
 
 ## Аргумент
@@ -16,6 +18,12 @@ $ARGUMENTS
 3. **Step 0 — Complexity Router:**
    - Прочитай `modules/00-complexity-router.md` и `references/complexity-matrix.md`
    - Классифицируй фичу в S/M/L/XL
+   - **Проверь agentic-qe флаги:**
+     - `--full-qe` → проверь `which aqe` или `node_modules/agentic-qe/`.
+       Если найден → `{AGENTIC_QE_MODE}=direct`. Если нет → WARN, fallback to reference.
+     - `--full-qe-extended` → то же + `{AGENTIC_QE_MODE}=direct-extended`.
+       Активирует доп. скиллы (chaos, security, performance, mutation, TDD, production-swarm).
+     - Без флагов → `{AGENTIC_QE_MODE}=reference` (condensed копии, без установки).
    - Определи `{ACTIVE_STEPS}` и `{TIME_BUDGET}`
    - Покажи Checkpoint 0 и **жди подтверждения tier**