@dzhechkov/harness-cli 0.2.0 → 0.2.1

package/README.md

@@ -1,27 +1,99 @@
 # @dzhechkov/harness-cli
 
-The **`dz`** command-line interface for the DZ cross-platform harness — a thin
-argv shell over [`@dzhechkov/harness-core`](../harness-core).
+The **`dz`** CLI — the main entry point to the DZ Harness Hub. Install AI skills for **Claude Code, Codex, OpenCode, Hermes** from a single command.
 
-## Commands
+## Install
 
+```bash
+npm install -g @dzhechkov/harness-cli
 ```
-dz init   --target <name> [--skills-dir <dir>] [--project <dir>] [--force]
-dz verify [--skills-dir <dir>] [--target <name>]
-dz sync   [--canonical <dir>] [--project <dir>] [--dry-run] [--force]
-dz update   (alias of sync)
-dz doctor [--project <dir>]
+
+## Quick Start
+
+```bash
+# Install a preset (curated skill set) for your platform:
+dz init --target claude-code --preset meta
+
+# That's it — Claude Code will auto-discover the installed skills.
+```
+
+## Presets vs Individual Skills
+
+| Approach | When to use | Example |
+|----------|------------|---------|
+| **Preset** | Want a curated set of skills that work together | `dz init --target claude-code --preset keysarium` |
+| **--select** | Want specific skills by name | `dz init --target claude-code --select explore,feature-adr` |
+| **Standalone npx** | Want a full toolkit with its own CLI | `npx @dzhechkov/keysarium init` |
+
+### Available Presets (7)
+
+| Preset | Skills | Description |
+|--------|--------|-------------|
+| `meta` | 3 | Development process (explore, feature-adr, knowledge-extractor) |
+| `qe-engineer` | 8 | Quality engineering (test-gen, coverage, chaos, defect, ...) |
+| `bto` | 1 | Build-Benchmark-Test-Optimize pipeline |
+| `health` | 8 | Medical AI (diagnostics, drugs, labs, clinical decisions) |
+| `keysarium` | 9 | Full research toolkit (feature-adr, presentation, reverse-eng) |
+| `p-replicator` | 10 | AI product development (/replicate, SPARC PRD, pipeline-forge) |
+| `feature-adr` | 5 | Feature pipeline (feature-adr, explore, frontend-design) |
+
+### Standalone Packages (install via npx, no dz CLI needed)
+
+```bash
+npx @dzhechkov/keysarium init              # full research toolkit
+npx @dzhechkov/p-replicator init           # AI product development
+npx @dzhechkov/health-advisor init         # medical AI (25 skills)
+npx @dzhechkov/skills-bto init             # BTO benchmarking
+npx @dzhechkov/skills-feature-adr init     # 11-step feature pipeline
+npx @dzhechkov/skills-edu-site init        # gamified edu site generator
+npx @dzhechkov/skills-transcript-site init # transcript → interactive site
+npx @dzhechkov/skills-analyst-manual init  # 3-phase analyst composite
+```
+
+**Difference:** `dz init --preset` installs individual skills from `.claude/skills/` source into a target platform tree. Standalone `npx` packages have their own CLI and install a complete toolkit with commands, rules, shards, and agents — a richer but self-contained experience.
+
+## All Commands (11)
+
+```
+dz init      --target <name> [--preset <name>] [--select id,id,...] [--force]
+dz verify    [--skills-dir <dir>] [--target <name>]
+dz sync      [--canonical <dir>] [--project <dir>] [--dry-run] [--force]
+dz update    (alias for sync)
+dz list      [--skills-dir <dir>]
+dz info      --id <skill-id> [--skills-dir <dir>]
+dz migrate   [--project <dir>]
+dz workflow  --task <name> [--dry-run]
+dz doctor    [--project <dir>]
+dz roam      [--apply] [--slug <slug>]
 dz help
 ```
 
-- `--target` — one of `claude-code`, `codex`, `opencode`, `hermes`
-- `init` compiles a skills directory for a target and writes it **additively**
-  (existing files are never overwritten without `--force`)
-- `sync` compares the canonical pack to the legacy `.claude/skills` tree
-- `doctor` reports environment diagnostics
+### Targets (4 platforms)
+
+| Target | Skills directory |
+|--------|-----------------|
+| `claude-code` | `.claude/skills/` |
+| `codex` | `.agents/skills/` |
+| `opencode` | `.opencode/skills/` |
+| `hermes` | `.hermes/skills/` |
+
+### Workflows (Opus 4.8+ dynamic workflows)
+
+```bash
+dz workflow --task coverage-lift     # parallel coverage improvement
+dz workflow --task mutation-kill     # kill surviving mutants
+dz workflow --task canonicalize      # canonicalize new packages
+dz workflow --task security-audit    # adversarial security scan
+```
+
+## How it works
+
+- `dz init` compiles canonical skills from the [agentskills.io](https://agentskills.io) standard into the target platform's layout
+- Writing is **additive** — existing files are never overwritten without `--force`
+- All 4 platform adapters produce **byte-identical** output (ADR-005)
+- `dz doctor` runs 7 health checks (node version, adapters, config, SQLite, skills)
+- `dz migrate` detects legacy keysarium/bto installations and recommends migration path
 
 ## Status
 
-`0.1.0` — alpha, part of the `extended-a-migration` feature (Phase 6).
-`--preset <name>` (Phase 10) selects a named skill set — see
-`@dzhechkov/harness-presets`. The `paperclip` target is planned for a later phase.
+`v0.2.0` — published on npm. Part of [DZ Harness Hub](https://github.com/djd1m/dz-harness-hub).

package/package.json

@@ -1,15 +1,21 @@
 {
   "name": "@dzhechkov/harness-cli",
-  "version": "0.2.0",
-  "description": "The dz CLI - init / sync / verify / doctor for the DZ cross-platform harness.",
+  "version": "0.2.1",
+  "description": "The dz CLI — install AI skills for Claude Code, Codex, OpenCode, Hermes. 11 commands, 7 presets, 4 platform adapters.",
   "type": "module",
   "license": "MIT",
   "author": "dzhechko",
   "keywords": [
     "agent-skills",
+    "agentskills.io",
     "harness",
     "cli",
-    "claude-code"
+    "claude-code",
+    "codex",
+    "opencode",
+    "hermes",
+    "ai-skills",
+    "cross-platform"
   ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",