@dzhechkov/skills-feature-adr

Adaptive Feature Development skill pack for Claude Code

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 for comprehensive quality engineering. Part of the Keysarium ecosystem.

Quick Start

# 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 --with-learning --knowledge-extractor

# Already have @dzhechkov/keysarium? Just install core (learning & harvest included)
npx @dzhechkov/skills-feature-adr init

After installation, open Claude Code in your project directory and use /feature-adr.

What You Get

| Component | Count | Description | |-----------|-------|-------------| | 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 (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 |

Everything is installed into your project's .claude/ directory and works natively with Claude Code.

Commands

npx @dzhechkov/skills-feature-adr                    # Full install (same as init)
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
npx @dzhechkov/skills-feature-adr remove             # Clean uninstall
npx @dzhechkov/skills-feature-adr list               # Show installed components
npx @dzhechkov/skills-feature-adr doctor             # Health check

Feature ADR Pipeline

Step 0        Step 1          Step 2       Step 3     Step 4
COMPLEXITY → REQUIREMENTS → RESEARCH  →   ADR    →   DDD
  ROUTER                   (L/XL only)  (M+ only)  (L/XL only)

Step 5         Step 6            Step 7     Step 8
ARCHITECTURE → IMPLEMENTATION →  CODE   →   QE
(M+ only)       PLAN

Usage in Claude Code

# Start the full adaptive pipeline
/feature-adr Add user authentication with OAuth2 and JWT

# The Complexity Router classifies your feature automatically:
#   S  → fast track (5 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

Complexity Tiers

| Tier | Scope | Active Steps | Time Budget | |------|-------|-------------|-------------| | S | 1-3 files, 1 domain | 0→1→6→7→8 | ~15 min | | M | 4-10 files, 1-2 domains | 0→1→3→5→6→7→8 | ~45 min | | L | 11-30 files, 2-4 domains | Full pipeline with parallelism | ~2 hours | | XL | 30+ files, cross-cutting | Full DAG + multi-agent swarm | ~4+ hours |

Complexity Dimensions (scored 1-4 each)

| Dimension | 1 (Low) | 4 (High) | |-----------|---------|----------| | Files affected | 1-3 | 30+ | | Domain breadth | Single module | Cross-cutting concerns | | Integration points | 0-1 external | 4+ external systems | | Risk / reversibility | Easily reverted | Data migration required | | Novelty | Well-known pattern | No prior art in codebase | | Stakeholder count | Solo developer | 4+ teams affected |

Pipeline Steps

| 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

Output Structure

features/<feature-slug>/
├── 00_complexity_assessment.md     ← Always
├── 01_requirements.md              ← Always
├── 02_research.md                  ← L/XL only
├── 03_adr/
│   └── 001-<decision-slug>.md      ← M+ only
├── 04_domain_model.md              ← L/XL only
├── 05_architecture.md              ← M+ only
├── 06_implementation_plan.md       ← Always
├── 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
└── README.md                       ← Always

Agentic QE Integration

Feature ADR integrates 15 skills from 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 installed | | Direct Extended | --full-qe-extended | 15 (9 core + 6 extended) | agentic-qe installed |

Installing agentic-qe (required for --full-qe and --full-qe-extended)

# 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

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

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:

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

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):

| Skill | Used In | Purpose | |-------|---------|---------| | explore | Step 1 | Requirements clarification | | problem-solver-enhanced | Step 3 | Trade-off analysis for ADR | | frontend-design | Step 7 | UI implementation (if applicable) |

These are optional — Feature ADR works standalone but benefits from the full toolkit.

Integration with Keysarium Ecosystem

# Install the full ecosystem
npx @dzhechkov/keysarium init              # Research pipeline
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 (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

Requirements

• Claude Code CLI — installed and configured (installation guide)
• Node.js >= 16.0.0 — required for the npm install method

License

MIT

Links

• GitHub: https://github.com/dzhechko/product-keysarium-2026
• Issues: https://github.com/dzhechko/product-keysarium-2026/issues
• npm: https://www.npmjs.com/package/@dzhechkov/skills-feature-adr
• Keysarium: https://www.npmjs.com/package/@dzhechkov/keysarium
• BTO: https://www.npmjs.com/package/@dzhechkov/skills-bto