@dzhechkov/skills-idea2prd 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dzhechko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# @dzhechkov/skills-idea2prd
+
+Idea2PRD Manual — composite skill for [Claude Code](https://claude.com/claude-code) that takes a **problem or an idea** all the way to **Vibe-Coding-ready documentation**, with a user checkpoint between every phase.
+
+## What It Does
+
+Auto-detects the input (problem vs idea) and runs up to two pipelines with **9 checkpoints**:
+
+1. **Analyst pipeline** (only if the input is a *problem*) — `explore` → `goap-research-ed25519` → `problem-solver-enhanced` (all 9 modules), producing a validated Product Idea.
+2. **PRD pipeline** (always) — Requirements → ADR → DDD → C4 → **Pseudocode** → Test Scenarios (Gherkin) → **Completion Checklist**.
+
+Output: a complete doc set ready to hand to a coding agent — PRD, ADRs, DDD model, C4 diagrams, pseudocode, test scenarios, and a CI/CD/deploy completion checklist.
+
+## Why
+
+Going from a raw idea straight to code skips the design that makes the code correct. Idea2PRD front-loads that design as *reviewable artifacts* and forces a human gate at each phase (MANUAL mode), so you catch a wrong assumption at the PRD stage instead of after implementation.
+
+## How to Use
+
+```bash
+npx @dzhechkov/skills-idea2prd init
+```
+
+Then in Claude Code the skill auto-activates on phrases like:
+
+```
+/idea2prd-manual оформи PRD для сервиса подбора подрядчиков
+"сделай PRD пошагово для ..."
+"idea to prd manual: ..."
+```
+
+It will pause at each checkpoint and wait for your confirmation before the next phase.
+
+## Self-Contained Package
+
+Bundles everything needed — no other `@dzhechkov` package required:
+
+| Component | Description |
+|-----------|-------------|
+| `idea2prd-manual` | Orchestrator skill (problem/idea → PRD docs, 9 checkpoints) |
+| `explore` | Task clarification and brief generation *(tracked vendor)* |
+| `goap-research-ed25519` | GOAP research with Ed25519 verification *(tracked vendor)* |
+| `problem-solver-enhanced` | 9-module solver (TRIZ + Game Theory) *(tracked vendor)* |
+| `/idea2prd-manual` | Slash command |
+
+Bundled scripts (local, no network): `c4_generator.py`, `fitness_validator.py`, `pseudocode_generator.py`, `ai_context_builder.py`.
+
+> **Canonicalization (ADR-0001):** `idea2prd-manual` is the canonical artifact of this pack. The `explore`/`goap`/`problem-solver` trio is a **tracked vendored copy** whose canonical home is [`@dzhechkov/skills-analyst-manual`](https://www.npmjs.com/package/@dzhechkov/skills-analyst-manual); see `sources.json`. Re-sync drift with `dz sync-upstream`.
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Install the skill pack into the current project *(default)* |
+| `update` | Update to the latest version |
+| `remove` | Remove the skill pack |
+| `list` | List installed components |
+| `doctor` | Check installation health |
+
+Options: `--force`, `--dry-run`, `--help`, `--version`.
+
+## Also Available Via dz
+
+```bash
+dz init --select idea2prd-manual          # via the unified harness CLI
+dz info idea2prd-manual
+```
+
+## License
+
+MIT

package/bin/cli.js

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@dzhechkov/skills-idea2prd",
+  "version": "0.1.0",
+  "description": "Idea2PRD Manual — composite skill for Claude Code: from problem/idea to Vibe-Coding-ready docs (PRD + ADR + DDD + C4 + Pseudocode + Test Scenarios + Completion) with 9 checkpoints",
+  "main": "src/cli.js",
+  "bin": {
+    "skills-idea2prd": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "sources.json",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "prd",
+    "product-requirements",
+    "idea-to-prd",
+    "ddd",
+    "c4-model",
+    "adr",
+    "pseudocode",
+    "vibe-coding",
+    "checkpoints",
+    "skills",
+    "skill-pack"
+  ],
+  "author": "dzhechko",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/djd1m/dz-harness-hub.git",
+    "directory": "packages/@dzhechkov/skills-idea2prd"
+  },
+  "homepage": "https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/skills-idea2prd#readme",
+  "bugs": {
+    "url": "https://github.com/djd1m/dz-harness-hub/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/sources.json

@@ -0,0 +1,25 @@
+{
+  "_note": "Per ADR-0001: idea2prd-manual is the canonical artifact of THIS pack; the explore/goap/problem-solver trio is a TRACKED vendored copy whose canonical home is @dzhechkov/skills-analyst-manual. Re-sync with `dz sync-upstream`.",
+  "skills": {
+    "idea2prd-manual": {
+      "origin": "dz-original",
+      "canonical_pack": "@dzhechkov/skills-idea2prd",
+      "inspired_by": "Cloud.ru GenAI GTM idea2prd-manual (clean-room canonicalization)"
+    },
+    "explore": {
+      "origin": "vendored",
+      "canonical_pack": "@dzhechkov/skills-analyst-manual",
+      "upstream_path": "templates/.claude/skills/explore"
+    },
+    "goap-research-ed25519": {
+      "origin": "vendored",
+      "canonical_pack": "@dzhechkov/skills-analyst-manual",
+      "upstream_path": "templates/.claude/skills/goap-research-ed25519"
+    },
+    "problem-solver-enhanced": {
+      "origin": "vendored",
+      "canonical_pack": "@dzhechkov/skills-analyst-manual",
+      "upstream_path": "templates/.claude/skills/problem-solver-enhanced"
+    }
+  }
+}

package/src/cli.js

@@ -0,0 +1,108 @@
+'use strict';
+
+const path = require('path');
+const { bold, cyan, dim, green, yellow, red, info, error } = require('./utils');
+
+function showBanner() {
+  console.log('');
+  console.log(cyan('╔══════════════════════════════════════════════════════════╗'));
+  console.log(cyan('║') + bold('   IDEA2PRD MANUAL — Idea → PRD docs with Checkpoints      ') + cyan('║'));
+  console.log(cyan('║') + '   analyst → PRD → DDD → C4 → pseudocode (9 checkpoints)   ' + cyan('║'));
+  console.log(cyan('╚══════════════════════════════════════════════════════════╝'));
+  console.log('');
+}
+
+function getVersion() {
+  const pkg = require('../package.json');
+  return pkg.version;
+}
+
+function showHelp() {
+  console.log(bold('Usage:') + ' npx @dzhechkov/skills-idea2prd ' + cyan('<command>') + dim(' [options]'));
+  console.log('');
+  console.log(bold('Commands:'));
+  console.log('  ' + green('init') + '      Install Idea2PRD Manual skill pack into current project ' + dim('(default)'));
+  console.log('  ' + green('update') + '    Update Idea2PRD Manual skill pack to latest version');
+  console.log('  ' + green('remove') + '    Remove Idea2PRD Manual skill pack from project');
+  console.log('  ' + green('list') + '      List installed Idea2PRD Manual components');
+  console.log('  ' + green('doctor') + '    Check Idea2PRD Manual 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-idea2prd init');
+  console.log(dim('  $ ') + 'npx @dzhechkov/skills-idea2prd init --force');
+  console.log(dim('  $ ') + 'npx @dzhechkov/skills-idea2prd doctor');
+  console.log('');
+  console.log(bold('What gets installed:'));
+  console.log('  Composite skill: idea2prd-manual (orchestrator)');
+  console.log('  Dependent skills: explore, goap-research-ed25519, problem-solver-enhanced');
+  console.log('  Command: /idea2prd-manual');
+  console.log('');
+  console.log(bold('Self-contained:'));
+  console.log('  This package bundles its dependent skills (tracked via sources.json).');
+  console.log('  No need to install @dzhechkov/keysarium or skills-analyst-manual.');
+  console.log('');
+}
+
+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('-')) {
+          error(`Unknown option: ${arg}`);
+          process.exit(1);
+        } else if (command === null) {
+          command = arg;
+        } else {
+          error(`Unexpected argument: ${arg}`);
+          process.exit(1);
+        }
+        break;
+    }
+  }
+
+  return { command, flags };
+}
+
+function main() {
+  const { command, flags } = parseArgs(process.argv);
+
+  if (command === 'version') { console.log(getVersion()); return; }
+
+  showBanner();
+
+  if (command === 'help') { showHelp(); return; }
+
+  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();

package/src/commands/doctor.js

@@ -0,0 +1,340 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, red, yellow, cyan, bold, dim,
+  info, success, warn, error: logError,
+  fileExists, readJSON, readManifest,
+  MANIFEST_FILE, COMPONENTS,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Check definitions
+// ---------------------------------------------------------------------------
+
+function check(name, fn) {
+  try {
+    const result = fn();
+    return {
+      name,
+      passed: result.passed,
+      detail: result.detail || '',
+      fix: result.fix || '',
+    };
+  } catch (err) {
+    return {
+      name,
+      passed: false,
+      detail: `Exception: ${err.message}`,
+      fix: 'Investigate the error above.',
+    };
+  }
+}
+
+function checkFilesExist(manifest, targetDir) {
+  return check('Files exist', () => {
+    const files = manifest.files || [];
+    const missing = [];
+
+    for (const relPath of files) {
+      const absPath = path.join(targetDir, relPath);
+      if (!fileExists(absPath)) {
+        missing.push(relPath);
+      }
+    }
+
+    if (missing.length === 0) {
+      return {
+        passed: true,
+        detail: `All ${files.length} manifest files present`,
+      };
+    }
+
+    return {
+      passed: false,
+      detail: `${missing.length} file(s) missing: ${missing.slice(0, 5).join(', ')}${missing.length > 5 ? '...' : ''}`,
+      fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore missing files.`,
+    };
+  });
+}
+
+function checkSkillAnalyst(targetDir) {
+  return check('Idea2PRD Manual Full skill', () => {
+    const skillDir = path.join(targetDir, '.claude', 'skills', 'idea2prd-manual');
+
+    if (!fileExists(skillDir)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/idea2prd-manual/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore skill.`,
+      };
+    }
+
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/idea2prd-manual/SKILL.md not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore SKILL.md.`,
+      };
+    }
+
+    // Check for references directory
+    const refsDir = path.join(skillDir, 'references');
+    let refCount = 0;
+    if (fileExists(refsDir)) {
+      try {
+        const entries = fs.readdirSync(refsDir);
+        refCount = entries.filter((e) => e.endsWith('.md')).length;
+      } catch {
+        // ignore
+      }
+    }
+
+    return {
+      passed: true,
+      detail: `SKILL.md present, ${refCount} references`,
+    };
+  });
+}
+
+function checkSkillExplore(targetDir) {
+  return check('Explore skill', () => {
+    const skillDir = path.join(targetDir, '.claude', 'skills', 'explore');
+
+    if (!fileExists(skillDir)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/explore/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore skill.`,
+      };
+    }
+
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/explore/SKILL.md not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore SKILL.md.`,
+      };
+    }
+
+    return {
+      passed: true,
+      detail: 'SKILL.md present',
+    };
+  });
+}
+
+function checkSkillGoap(targetDir) {
+  return check('GOAP Research skill', () => {
+    const skillDir = path.join(targetDir, '.claude', 'skills', 'goap-research-ed25519');
+
+    if (!fileExists(skillDir)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/goap-research-ed25519/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore skill.`,
+      };
+    }
+
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/goap-research-ed25519/SKILL.md not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore SKILL.md.`,
+      };
+    }
+
+    return {
+      passed: true,
+      detail: 'SKILL.md present',
+    };
+  });
+}
+
+function checkSkillSolver(targetDir) {
+  return check('Problem Solver Enhanced skill', () => {
+    const skillDir = path.join(targetDir, '.claude', 'skills', 'problem-solver-enhanced');
+
+    if (!fileExists(skillDir)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/problem-solver-enhanced/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore skill.`,
+      };
+    }
+
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/problem-solver-enhanced/SKILL.md not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore SKILL.md.`,
+      };
+    }
+
+    return {
+      passed: true,
+      detail: 'SKILL.md present',
+    };
+  });
+}
+
+function checkCommandPresent(targetDir) {
+  return check('Idea2PRD Manual command', () => {
+    const commandsDir = path.join(targetDir, '.claude', 'commands');
+
+    if (!fileExists(commandsDir)) {
+      return {
+        passed: false,
+        detail: '.claude/commands/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore command.`,
+      };
+    }
+
+    let entries;
+    try {
+      entries = fs.readdirSync(commandsDir);
+    } catch {
+      return {
+        passed: false,
+        detail: 'Cannot read .claude/commands/ directory',
+        fix: 'Check directory permissions.',
+      };
+    }
+
+    const analystCommands = entries.filter(
+      (e) => e.startsWith('idea2prd-manual') && e.endsWith('.md')
+    );
+
+    if (analystCommands.length === 0) {
+      return {
+        passed: false,
+        detail: 'No Idea2PRD Manual command files found (expected idea2prd-manual*.md)',
+        fix: `Run ${cyan('@dzhechkov/skills-idea2prd update')} to restore command.`,
+      };
+    }
+
+    return {
+      passed: true,
+      detail: `${analystCommands.length} command(s): ${analystCommands.join(', ')}`,
+    };
+  });
+}
+
+function checkKeysariumIntegration(targetDir) {
+  return check('Keysarium integration', () => {
+    const keysariumPath = path.join(targetDir, '.keysarium.json');
+
+    if (!fileExists(keysariumPath)) {
+      return {
+        passed: true,
+        detail: 'Not installed (standalone Idea2PRD Manual mode)',
+      };
+    }
+
+    const keysariumManifest = readJSON(keysariumPath);
+    if (!keysariumManifest) {
+      return {
+        passed: true,
+        detail: 'Detected but manifest unreadable',
+      };
+    }
+
+    return {
+      passed: true,
+      detail: `Active (Keysarium v${keysariumManifest.version})`,
+    };
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+async function run(options) {
+  const { targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Check manifest exists ──────────────────────────────────────────
+  if (!fileExists(manifestPath)) {
+    logError('Idea2PRD Manual skill pack is not installed in this directory.');
+    info(`Run ${cyan('@dzhechkov/skills-idea2prd init')} to install.`);
+    process.exit(1);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError(`Failed to read ${MANIFEST_FILE} \u2014 file may be corrupted.`);
+    process.exit(1);
+  }
+
+  console.log('');
+  info(bold(`Running health checks for @dzhechkov/skills-idea2prd v${manifest.version}...`));
+  console.log('');
+
+  // ── b) Run all checks ─────────────────────────────────────────────────
+  const results = [
+    checkFilesExist(manifest, targetDir),
+    checkSkillAnalyst(targetDir),
+    checkSkillExplore(targetDir),
+    checkSkillGoap(targetDir),
+    checkSkillSolver(targetDir),
+    checkCommandPresent(targetDir),
+    checkKeysariumIntegration(targetDir),
+  ];
+
+  // ── c) Display results ────────────────────────────────────────────────
+  let passedCount = 0;
+  const failures = [];
+
+  for (const result of results) {
+    const icon = result.passed ? green('\u2713') : red('\u2717');
+    const statusColor = result.passed ? green : red;
+    const detailStr = result.detail ? dim(` \u2014 ${result.detail}`) : '';
+
+    console.log(`  ${icon} ${statusColor(result.name)}${detailStr}`);
+
+    if (result.passed) {
+      passedCount++;
+    } else {
+      failures.push(result);
+    }
+  }
+
+  // ── d) Summary ────────────────────────────────────────────────────────
+  console.log('');
+  const total = results.length;
+
+  if (passedCount === total) {
+    success(bold(`${passedCount}/${total} checks passed \u2014 Idea2PRD Manual installation is healthy!`));
+    console.log('');
+    process.exit(0);
+  }
+
+  warn(bold(`${passedCount}/${total} checks passed`));
+  console.log('');
+
+  // ── e) Show fix suggestions ───────────────────────────────────────────
+  console.log(bold('Fix suggestions:'));
+  console.log('');
+
+  for (const failure of failures) {
+    console.log(`  ${red('\u2717')} ${bold(failure.name)}`);
+    if (failure.detail) {
+      console.log(`    ${dim(failure.detail)}`);
+    }
+    if (failure.fix) {
+      console.log(`    ${yellow('Fix:')} ${failure.fix}`);
+    }
+    console.log('');
+  }
+
+  process.exit(1);
+}
+
+module.exports = run;
+module.exports.run = run;