@ner076/prd-toolkit 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bagas (ner076)
+
+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,164 @@
+# @ner076/prd-toolkit
+
+**AI-powered PRD toolkit** — guided discovery + auto-dev ready PRD generation for [Claude Code](https://claude.ai/code) and [Opencode](https://opencode.ai).
+
+Turn a fuzzy product idea into a PRD that AI coding agents can implement without going off-rails.
+
+---
+
+## What you get
+
+Two skills, one install:
+
+- **`prd-discovery`** — guided 8-phase discovery session (Express / Guided / Deep modes) that captures features, sub-features, dependencies, data model, business rules, and granular design tokens. Outputs a structured `discovery-output.md`.
+- **`prd-generator`** — transforms the discovery output into a 16-section PRD with API contracts, data schemas, screen specs, state machines, test scenarios, and a full traceability matrix.
+
+---
+
+## Install
+
+One command, auto-detects your environment:
+
+```bash
+npx @ner076/prd-toolkit install
+```
+
+Or be explicit:
+
+```bash
+# Both targets, user-wide
+npx @ner076/prd-toolkit install --target=all --scope=user
+
+# Only Opencode, non-interactive
+npx @ner076/prd-toolkit install --target=opencode -y
+
+# Preview without writing
+npx @ner076/prd-toolkit install --dryRun
+```
+
+### Install locations
+
+| Target | Scope | Location |
+|--------|-------|----------|
+| Claude Code | user | `~/.claude/skills/<name>/SKILL.md` |
+| Claude Code | project | `./.claude/skills/<name>/SKILL.md` |
+| Opencode | user | `~/.config/opencode/command/<name>.md` |
+| Opencode | project | `./.opencode/command/<name>.md` |
+
+Default scope is `project` so you don't pollute global config.
+
+---
+
+## Usage
+
+### In Claude Code
+
+```
+$ cd my-product
+$ claude
+> jalankan prd-discovery, gua mau bikin aplikasi X
+```
+
+Claude Code will auto-load the `prd-discovery` skill and start the guided session.
+
+### In Opencode
+
+```
+$ opencode
+> /prd-discovery
+```
+
+The command runs the same discovery workflow as a subtask.
+
+### Chained workflow
+
+```
+1. /prd-discovery       → produces discovery-output.md
+2. /prd-generator       → produces PRD-<slug>.md
+3. Feed PRD to your AI coding agent for auto-implementation
+```
+
+---
+
+## Command reference
+
+```
+npx @ner076/prd-toolkit <command> [flags]
+
+Commands:
+  install       Install skills to target environment(s)
+  uninstall     Remove installed skills (tracked via manifest)
+  update        Re-install to pick up latest version
+  list          Show installed skills across all targets
+  doctor        Diagnose environment & install health
+  help          Show help
+
+Flags:
+  --target=<t>  claude-code | opencode | all | auto (default: auto)
+  --scope=<s>   user | project (default: project)
+  -y, --yes     Skip confirmation prompts
+  -f, --force   Overwrite existing files
+  --dryRun      Preview without writing
+  -v, --version Print version
+```
+
+---
+
+## Design
+
+### Why a toolkit, not just skill files?
+
+- **One-command install** works across environments
+- **Format transformation** — source of truth is one `SKILL.md`, adapters handle target-specific formatting
+- **Manifest-based uninstall** — clean removal without touching unrelated files
+- **Environment detection** — no manual "where do I put this?" hunt
+
+### Architecture
+
+```
+prd-toolkit/
+├── bin/prd-toolkit.js        # CLI entry
+├── src/
+│   ├── install.js            # orchestrator
+│   ├── uninstall.js
+│   ├── list.js
+│   ├── doctor.js
+│   ├── detect.js             # env detection
+│   ├── help.js
+│   ├── version.js
+│   └── adapters/
+│       ├── claude-code.js    # copies SKILL.md verbatim
+│       └── opencode.js       # transforms frontmatter for command format
+└── skills/
+    ├── prd-discovery/SKILL.md
+    └── prd-generator/SKILL.md
+```
+
+Source `SKILL.md` files use Claude Code frontmatter (`name`, `description`). The Opencode adapter transforms this into command-style frontmatter (`description`, `agent`, `subtask`) while preserving the body verbatim.
+
+### Requirements
+
+- Node.js 18+ (uses native `parseArgs`)
+- At least one of: Claude Code CLI, Opencode CLI
+
+---
+
+## Publishing (maintainer notes)
+
+This package publishes to [npm](https://www.npmjs.com/) under `@ner076`. To release:
+
+```bash
+# Bump version
+npm version patch|minor|major
+
+# Push tag — CI publishes automatically
+git push --follow-tags
+```
+
+CI runs on Node 18/20/22 across Ubuntu, macOS, and Windows. Publish requires an npm access token stored as `NPM_TOKEN` in GitHub Actions secrets.
+
+---
+
+## License
+
+MIT © Bagas

package/bin/prd-toolkit.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+/**
+ * @ner076/prd-toolkit — CLI entrypoint
+ *
+ * Usage:
+ *   npx @ner076/prd-toolkit <command> [flags]
+ *
+ * Commands:
+ *   install     Install skills to target environment
+ *   uninstall   Remove installed skills
+ *   update      Re-install to pick up latest version
+ *   list        Show installed skills across targets
+ *   doctor      Diagnose install health
+ *   help        Show help
+ */
+
+import { parseArgs } from 'node:util';
+import { install } from '../src/install.js';
+import { uninstall } from '../src/uninstall.js';
+import { list } from '../src/list.js';
+import { doctor } from '../src/doctor.js';
+import { printHelp, printVersion } from '../src/help.js';
+
+const { values, positionals } = parseArgs({
+  allowPositionals: true,
+  options: {
+    target: { type: 'string' },        // claude-code | opencode | all
+    scope:  { type: 'string' },        // user | project
+    yes:    { type: 'boolean', short: 'y' },
+    force:  { type: 'boolean', short: 'f' },
+    dryRun: { type: 'boolean' },
+    help:   { type: 'boolean', short: 'h' },
+    version:{ type: 'boolean', short: 'v' }
+  }
+});
+
+const command = positionals[0];
+
+if (values.version) {
+  await printVersion();
+  process.exit(0);
+}
+
+if (values.help || !command || command === 'help') {
+  printHelp();
+  process.exit(0);
+}
+
+const opts = {
+  target: values.target ?? 'auto',
+  scope: values.scope ?? 'project',
+  yes: values.yes ?? false,
+  force: values.force ?? false,
+  dryRun: values.dryRun ?? false
+};
+
+try {
+  switch (command) {
+    case 'install':   await install(opts); break;
+    case 'uninstall': await uninstall(opts); break;
+    case 'update':    await install({ ...opts, force: true }); break;
+    case 'list':      await list(opts); break;
+    case 'doctor':    await doctor(opts); break;
+    default:
+      console.error(`Unknown command: ${command}\n`);
+      printHelp();
+      process.exit(1);
+  }
+} catch (err) {
+  console.error(`\n✖ ${err.message}`);
+  if (process.env.DEBUG) console.error(err.stack);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@ner076/prd-toolkit",
+  "version": "0.1.4",
+  "description": "AI-powered PRD toolkit: guided discovery + auto-dev ready PRD generation for Claude Code and Opencode",
+  "keywords": [
+    "prd",
+    "claude-code",
+    "opencode",
+    "skill",
+    "product-management",
+    "ai-agent",
+    "requirements",
+    "auto-dev"
+  ],
+  "homepage": "https://github.com/ner076/prd-toolkit#readme",
+  "bugs": {
+    "url": "https://github.com/ner076/prd-toolkit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ner076/prd-toolkit.git"
+  },
+  "license": "MIT",
+  "author": "Bagas <ner076>",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "prd-toolkit": "bin/prd-toolkit.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "skills/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "node --test tests/version.test.js tests/detect.test.js tests/frontmatter.test.js",
+    "lint": "node scripts/lint.cjs",
+    "smoke": "node bin/prd-toolkit.js --version && node bin/prd-toolkit.js doctor"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}