@dzhechkov/skills-feature-adr 1.0.0

package/README.md

@@ -0,0 +1,195 @@
+# @dzhechkov/skills-feature-adr
+
+**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.
+
+---
+
+## Quick Start
+
+```bash
+# One-command install via npx
+npx @dzhechkov/skills-feature-adr
+
+# Or install globally
+npm install -g @dzhechkov/skills-feature-adr
+skills-feature-adr init
+
+# Install into a project that already has @dzhechkov/keysarium
+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` — 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 |
+| **Examples** | 1 | Sample M-tier feature output |
+| **Command** | 1 | `/feature-adr` — orchestrator command |
+| **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
+
+```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 --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
+
+```bash
+# 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 (7 steps)
+#   L  → full pipeline (9 steps)
+#   XL → full DAG + multi-agent swarm
+```
+
+---
+
+## 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 | 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` |
+
+---
+
+## 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
+├── diagrams/                       ← M+ only
+│   ├── architecture-c4.mermaid
+│   └── sequence-*.mermaid
+└── README.md                       ← Always
+```
+
+---
+
+## 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
+
+```bash
+# 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 (9 steps)
+/bto [skill path]                  # Skill evaluation & optimization
+```
+
+---
+
+## Requirements
+
+- **Claude Code CLI** — installed and configured ([installation guide](https://docs.anthropic.com/en/docs/claude-code))
+- **Node.js >= 16.0.0** — required for the npm install method
+
+---
+
+## License
+
+[MIT](https://opensource.org/licenses/MIT)
+
+---
+
+## Links
+
+- **GitHub:** [https://github.com/dzhechko/product-keysarium-2026](https://github.com/dzhechko/product-keysarium-2026)
+- **Issues:** [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](https://www.npmjs.com/package/@dzhechkov/skills-feature-adr)
+- **Keysarium:** [https://www.npmjs.com/package/@dzhechkov/keysarium](https://www.npmjs.com/package/@dzhechkov/keysarium)
+- **BTO:** [https://www.npmjs.com/package/@dzhechkov/skills-bto](https://www.npmjs.com/package/@dzhechkov/skills-bto)

package/bin/cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+'use strict';
+
+require('../src/cli.js');

package/package.json

@@ -0,0 +1,53 @@
+{
+  "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",
+  "main": "src/cli.js",
+  "bin": {
+    "skills-feature-adr": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/"
+  ],
+  "scripts": {
+    "test": "node bin/cli.js doctor",
+    "prepublishOnly": "node scripts/sync-templates.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "feature-adr",
+    "adr",
+    "architecture-decision-records",
+    "feature-development",
+    "complexity-router",
+    "skills",
+    "skill-pack",
+    "ddd",
+    "quality-engineering"
+  ],
+  "author": "dzhechko",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dzhechko/product-keysarium-2026"
+  },
+  "homepage": "https://github.com/dzhechko/product-keysarium-2026#readme",
+  "bugs": {
+    "url": "https://github.com/dzhechko/product-keysarium-2026/issues"
+  },
+  "peerDependencies": {
+    "@dzhechkov/keysarium-core": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@dzhechkov/keysarium-core": {
+      "optional": true
+    }
+  }
+}

package/src/cli.js

@@ -0,0 +1,151 @@
+'use strict';
+
+const path = require('path');
+const { bold, cyan, dim, green, yellow, red, info, error } = require('./utils');
+
+// ---------------------------------------------------------------------------
+// Banner
+// ---------------------------------------------------------------------------
+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('\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('');
+}
+
+// ---------------------------------------------------------------------------
+// Version
+// ---------------------------------------------------------------------------
+function getVersion() {
+  const pkg = require('../package.json');
+  return pkg.version;
+}
+
+// ---------------------------------------------------------------------------
+// Help
+// ---------------------------------------------------------------------------
+function showHelp() {
+  console.log(bold('Usage:') + ' npx @dzhechkov/skills-feature-adr ' + cyan('<command>') + dim(' [options]'));
+  console.log('');
+  console.log(bold('Commands:'));
+  console.log('  ' + green('init') + '      Install Feature ADR skill pack into current project ' + dim('(default)'));
+  console.log('  ' + green('update') + '    Update Feature ADR skill pack to latest version');
+  console.log('  ' + green('remove') + '    Remove Feature ADR skill pack from project');
+  console.log('  ' + green('list') + '      List installed Feature ADR components');
+  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('');
+  console.log(bold('Examples:'));
+  console.log(dim('  $ ') + 'npx @dzhechkov/skills-feature-adr init');
+  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('');
+}
+
+// ---------------------------------------------------------------------------
+// Parse arguments
+// ---------------------------------------------------------------------------
+function parseArgs(argv) {
+  const args = argv.slice(2);
+
+  const flags = {
+    force: false,
+    dryRun: false,
+    targetDir: process.cwd(),
+  };
+
+  let command = null;
+
+  for (const arg of args) {
+    switch (arg) {
+      case '--force':
+        flags.force = true;
+        break;
+      case '--dry-run':
+        flags.dryRun = true;
+        break;
+      case '--help':
+      case '-h':
+        command = 'help';
+        break;
+      case '--version':
+      case '-v':
+        command = 'version';
+        break;
+      default:
+        if (!arg.startsWith('-') && command === null) {
+          command = arg;
+        }
+        break;
+    }
+  }
+
+  return { command, flags };
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+function main() {
+  const { command, flags } = parseArgs(process.argv);
+
+  // Handle version early (no banner)
+  if (command === 'version') {
+    console.log(getVersion());
+    return;
+  }
+
+  showBanner();
+
+  // Handle help early
+  if (command === 'help') {
+    showHelp();
+    return;
+  }
+
+  // Route to command handlers
+  const resolvedCommand = command || 'init';
+
+  switch (resolvedCommand) {
+    case 'init':
+      require('./commands/init')(flags);
+      break;
+
+    case 'update':
+      require('./commands/update')(flags);
+      break;
+
+    case 'remove':
+      require('./commands/remove')(flags);
+      break;
+
+    case 'list':
+      require('./commands/list')(flags);
+      break;
+
+    case 'doctor':
+      require('./commands/doctor')(flags);
+      break;
+
+    default:
+      error(`Unknown command: "${resolvedCommand}"`);
+      console.log('');
+      showHelp();
+      process.exitCode = 1;
+      break;
+  }
+}
+
+main();