npm - @zrg-sh/studio - Versions diffs - 0.1.0 - Mend

@zrg-sh/studio 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (95) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+Copyright (c) 2026 matthew. All rights reserved.
+This software and its source code are proprietary and confidential. Access
+is granted only to npm accounts explicitly added to the @zrg-sh:buyers team.
+You may NOT:
+  - Redistribute, sublicense, publish, or resell this package or its contents.
+  - Share installed files with anyone outside your own organization.
+  - Reverse-engineer the package to extract content for circumvention of access controls.
+You MAY:
+  - Use the installed agents, prompts, and hooks in your own projects.
+  - Modify your local copy of the files for your own use.
+  - Make as many local copies as needed within your team's projects, provided
+    everyone using them holds their own valid team membership.
+This license terminates automatically if you violate the above terms or if
+your team membership is revoked. Upon termination you must delete all
+installed copies.
+No warranty. The software is provided "AS IS".

package/ONBOARDING.html ADDED Viewed

@@ -0,0 +1,270 @@
+<!doctype html>
+<html lang="ru">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>zrg-studio — установка для продактов</title>
+<style>
+  :root {
+    --bg: #0b0d10;
+    --card: #14181d;
+    --text: #e8eef5;
+    --muted: #97a3b3;
+    --accent: #ffb547;
+    --accent-2: #4ea0ff;
+    --ok: #5ddc97;
+    --warn: #ff6b6b;
+    --border: #1f262e;
+    --code-bg: #0f1318;
+  }
+  * { box-sizing: border-box; }
+  html, body { margin: 0; padding: 0; background: var(--bg); color: var(--text); font: 16px/1.65 -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; }
+  .wrap { max-width: 780px; margin: 0 auto; padding: 48px 24px 96px; }
+  h1 { font-size: 38px; line-height: 1.15; margin: 0 0 8px; letter-spacing: -0.02em; }
+  h2 { font-size: 24px; margin: 56px 0 16px; letter-spacing: -0.01em; }
+  h3 { font-size: 18px; margin: 32px 0 8px; }
+  p { color: var(--text); }
+  .sub { color: var(--muted); font-size: 18px; margin: 0 0 32px; }
+  .step { background: var(--card); border: 1px solid var(--border); border-radius: 12px; padding: 24px; margin: 16px 0; position: relative; }
+  .step::before { content: counter(step); counter-increment: step; position: absolute; top: -14px; left: 20px; background: var(--accent); color: #0b0d10; font-weight: 700; width: 28px; height: 28px; border-radius: 50%; display: grid; place-items: center; font-size: 14px; }
+  body { counter-reset: step; }
+  .step h3 { margin-top: 0; }
+  code, pre { font-family: ui-monospace, "SF Mono", Menlo, monospace; }
+  code { background: var(--code-bg); padding: 2px 6px; border-radius: 4px; font-size: 14px; color: var(--accent); }
+  pre { background: var(--code-bg); padding: 16px 18px; border-radius: 8px; overflow-x: auto; border: 1px solid var(--border); font-size: 14px; line-height: 1.55; }
+  pre code { background: transparent; padding: 0; color: var(--text); }
+  .copy { position: relative; }
+  .copy-btn { position: absolute; top: 8px; right: 8px; background: var(--border); color: var(--muted); border: 0; padding: 4px 10px; font-size: 12px; border-radius: 4px; cursor: pointer; font-family: inherit; }
+  .copy-btn:hover { background: var(--accent-2); color: #fff; }
+  .copy-btn.done { background: var(--ok); color: #0b0d10; }
+  .note { border-left: 3px solid var(--accent-2); padding: 12px 16px; background: rgba(78,160,255,0.08); margin: 16px 0; border-radius: 4px; }
+  .warn { border-left: 3px solid var(--warn); padding: 12px 16px; background: rgba(255,107,107,0.08); margin: 16px 0; border-radius: 4px; }
+  .ok { border-left: 3px solid var(--ok); padding: 12px 16px; background: rgba(93,220,151,0.08); margin: 16px 0; border-radius: 4px; }
+  a { color: var(--accent-2); }
+  ul, ol { padding-left: 22px; }
+  li { margin: 6px 0; }
+  .kbd { background: #222; border: 1px solid #333; border-bottom-width: 2px; padding: 1px 7px; border-radius: 4px; font-family: ui-monospace, monospace; font-size: 13px; }
+  .hr { height: 1px; background: var(--border); margin: 48px 0; border: 0; }
+  .small { color: var(--muted); font-size: 14px; }
+  .platforms { display: flex; gap: 8px; margin: 12px 0 20px; }
+  .platforms button { flex: 1; background: var(--card); border: 1px solid var(--border); color: var(--muted); padding: 10px 14px; border-radius: 8px; cursor: pointer; font: inherit; font-size: 14px; }
+  .platforms button.active { background: var(--accent); color: #0b0d10; border-color: var(--accent); font-weight: 600; }
+  .platform-block { display: none; }
+  .platform-block.active { display: block; }
+  .toc { background: var(--card); border: 1px solid var(--border); border-radius: 8px; padding: 16px 24px; margin: 24px 0 40px; }
+  .toc ol { margin: 0; }
+  .toc a { color: var(--text); text-decoration: none; }
+  .toc a:hover { color: var(--accent); }
+  .emoji { font-size: 1.4em; vertical-align: -0.15em; margin-right: 4px; }
+  .footer { text-align: center; color: var(--muted); margin-top: 80px; font-size: 13px; }
+</style>
+</head>
+<body>
+<div class="wrap">
+<h1>Установка zrg-studio</h1>
+<p class="sub">Гайд для не-разработчиков. Всё делается один раз, дальше работает само.</p>
+<div class="note">
+  <strong>Что вы получите в итоге:</strong> в любой папке проекта одной командой будут разворачиваться AI-агенты для написания продуктовых спек по DDD-методологии. Сами агенты работают внутри Claude Code.
+</div>
+<div class="toc">
+  <strong>Что предстоит сделать:</strong>
+  <ol>
+    <li><a href="#step1">Установить Node.js</a> (5 минут)</li>
+    <li><a href="#step2">Установить Claude Code</a> (3 минуты)</li>
+    <li><a href="#step3">Создать аккаунт на npm</a> (2 минуты)</li>
+    <li><a href="#step4">Войти в npm в терминале</a> (1 минута)</li>
+    <li><a href="#step5">Сообщить ваш ник продавцу</a> (1 минута + ожидание)</li>
+    <li><a href="#step6">Установить zrg-studio в проект</a> (30 секунд)</li>
+    <li><a href="#step7">Запустить первого агента</a></li>
+  </ol>
+</div>
+<h2 id="step1">Шаг 1. Установить Node.js</h2>
+<p>Node.js — это программа, которая умеет запускать пакеты вроде нашего. Без неё ничего не заработает.</p>
+<div class="step">
+  <h3>Что делать</h3>
+  <ol>
+    <li>Откройте сайт <a href="https://nodejs.org/" target="_blank">nodejs.org</a></li>
+    <li>На главной странице нажмите большую кнопку <strong>"LTS"</strong> (это «стабильная версия»). Она сама определит вашу операционную систему.</li>
+    <li>Откройте скачанный файл и пройдите установку, нажимая «Далее» / «Continue» на каждом шаге. Соглашайтесь со всем по умолчанию.</li>
+  </ol>
+  <h3 style="margin-top:24px">Как проверить что работает</h3>
+  <p>Откройте терминал:</p>
+  <ul>
+    <li><strong>Mac:</strong> нажмите <span class="kbd">⌘</span> + <span class="kbd">пробел</span>, наберите <em>Terminal</em>, <span class="kbd">Enter</span>.</li>
+    <li><strong>Windows:</strong> нажмите <span class="kbd">Win</span>, наберите <em>PowerShell</em>, <span class="kbd">Enter</span>.</li>
+  </ul>
+  <p>В открывшемся чёрном окне вставьте и нажмите <span class="kbd">Enter</span>:</p>
+  <div class="copy"><pre><code>node --version</code></pre><button class="copy-btn" data-copy="node --version">Копировать</button></div>
+  <p>Должно вывести что-то типа <code>v20.11.0</code>. Если так — Node стоит. Если ошибка «команда не найдена» — перезапустите терминал.</p>
+</div>
+<h2 id="step2">Шаг 2. Установить Claude Code</h2>
+<p>Claude Code — это приложение от Anthropic, в котором будут жить наши агенты.</p>
+<div class="step">
+  <h3>Что делать</h3>
+  <ol>
+    <li>Откройте <a href="https://claude.com/claude-code" target="_blank">claude.com/claude-code</a></li>
+    <li>Скачайте установщик для вашей системы (Mac / Windows).</li>
+    <li>Установите. При первом запуске войдите своим аккаунтом Claude / Anthropic. Если аккаунта нет — заведите там же, бесплатно.</li>
+  </ol>
+  <div class="note">
+    Платная подписка на Claude нужна только если хотите много гонять агентов. Для теста хватит free-tier.
+  </div>
+</div>
+<h2 id="step3">Шаг 3. Создать аккаунт на npm</h2>
+<p>npm — это «магазин пакетов» для Node. Через него вы получите наш продукт.</p>
+<div class="step">
+  <h3>Что делать</h3>
+  <ol>
+    <li>Откройте <a href="https://www.npmjs.com/signup" target="_blank">npmjs.com/signup</a></li>
+    <li>Заполните: <strong>username</strong> (короткий ник латиницей, например <code>anna-product</code>), email, пароль.</li>
+    <li>Подтвердите email через письмо, которое npm пришлёт.</li>
+  </ol>
+  <div class="warn">
+    <strong>Запомните или запишите ваш username</strong> — именно его вы сообщите продавцу. И email + пароль для следующего шага.
+  </div>
+</div>
+<h2 id="step4">Шаг 4. Войти в npm в терминале</h2>
+<p>Один раз — чтобы потом установка работала автоматически.</p>
+<div class="step">
+  <h3>Что делать</h3>
+  <p>В терминале выполните:</p>
+  <div class="copy"><pre><code>npm login</code></pre><button class="copy-btn" data-copy="npm login">Копировать</button></div>
+  <p>Откроется браузер, попросит подтвердить вход. Нажмите кнопку <strong>"Login"</strong> на странице, потом можно браузер закрыть.</p>
+  <p>В терминале появится строчка <code>Logged in as &lt;ваш-ник&gt; on https://registry.npmjs.org/</code> — значит готово.</p>
+  <h3 style="margin-top:24px">Проверка</h3>
+  <div class="copy"><pre><code>npm whoami</code></pre><button class="copy-btn" data-copy="npm whoami">Копировать</button></div>
+  <p>Должно вывести ваш ник.</p>
+</div>
+<h2 id="step5">Шаг 5. Сообщить ник продавцу</h2>
+<div class="step">
+  <h3>Что делать</h3>
+  <ol>
+    <li>Напишите продавцу: <strong>«Мой npm username: <em>ваш-ник</em>. Пожалуйста, добавьте меня в команду.»</strong></li>
+    <li>После того как добавят — придёт письмо на ваш email от npm: <em>«You've been added to the team @zrg-sh:buyers»</em>.</li>
+  </ol>
+  <div class="ok">
+    Только после этого следующий шаг сработает. До этого момента будет ошибка <code>403 Forbidden</code> — это нормально, просто ещё не дали доступ.
+  </div>
+</div>
+<h2 id="step6">Шаг 6. Установить zrg-studio в проект</h2>
+<div class="step">
+  <h3>Что делать</h3>
+  <ol>
+    <li>Создайте или откройте папку, где будет жить ваш проект продуктовой спеки. Например <code>~/Documents/my-product</code>.</li>
+    <li>В терминале перейдите в эту папку. Простой способ:
+      <ul>
+        <li><strong>Mac:</strong> наберите <code>cd </code> (с пробелом!), затем перетащите папку из Finder в окно терминала — путь подставится сам. Нажмите <span class="kbd">Enter</span>.</li>
+        <li><strong>Windows:</strong> в проводнике откройте папку, щёлкните по адресной строке, наберите <code>powershell</code> и <span class="kbd">Enter</span> — терминал откроется прямо в этой папке.</li>
+      </ul>
+    </li>
+    <li>Выполните <strong>одну команду</strong>:
+      <div class="copy"><pre><code>npx @zrg-sh/studio init</code></pre><button class="copy-btn" data-copy="npx @zrg-sh/studio init">Копировать</button></div>
+      Первый раз npm может спросить разрешение скачать пакет — отвечайте <code>y</code> и <span class="kbd">Enter</span>.
+    </li>
+  </ol>
+  <div class="ok">
+    Если в конце вывело <strong>"Done. Next steps:"</strong> — всё установилось. В папке появилось две вещи: <code>product-specs/</code> и <code>.claude/</code>.
+  </div>
+  <div class="warn">
+    Если ошибка <code>403 Forbidden</code> — продавец ещё не добавил вас в команду, см. Шаг 5.<br>
+    Если ошибка <code>npm: command not found</code> — Node не установился, см. Шаг 1.
+  </div>
+</div>
+<h2 id="step7">Шаг 7. Запустить первого агента</h2>
+<div class="step">
+  <h3>Что делать</h3>
+  <ol>
+    <li>Откройте Claude Code.</li>
+    <li>В нём откройте ту же папку, где запускали установку (File → Open Folder → выберите свою папку проекта).</li>
+    <li>
+      В окне чата с Клодом напишите команду и нажмите <span class="kbd">Enter</span>.
+      <ul>
+        <li>Если это <strong>новый проект</strong> (или вы хотите описать существующий, чтобы агент его понял) — начните с <code>/studio-onboard</code>. Это «знакомство»: агент задаст вопросы про продукт, пользователей и домены, и сам заполнит базу. Идёт в несколько подходов, можно выйти и продолжить позже.</li>
+        <li>Если база уже заполнена и вы хотите <strong>добавить новую фичу</strong> — пишите <code>/studio-pm</code>.</li>
+      </ul>
+    </li>
+    <li>Агент задаст вам вопросы. Отвечайте словами на русском, как живому коллеге. Если устали — просто закройте Claude Code, в следующий раз продолжит с того же места.</li>
+  </ol>
+  <div class="note">
+    <strong>Команды, которые можно запускать в Claude Code:</strong><br>
+    <code>/studio-onboard</code> — <em>cold start</em>: заполнить видение продукта, карту возможностей и домены с нуля (или по существующему коду). Многоитерационный диалог.<br>
+    <code>/studio-pm</code> — начать новую фичу (когда основа уже есть)<br>
+    <code>/studio-analyst</code> — анализ рисков<br>
+    <code>/studio-scenario-writer</code> — пользовательские сценарии<br>
+    <code>/studio-domain-framer</code> — детальная модель одного домена<br>
+    <code>/studio-designer</code> — UX-наброски
+  </div>
+  <div class="ok">
+    <strong>С чего начать в первый раз:</strong> запустите <code>/studio-onboard</code>. Это самый длинный, но самый важный шаг — он расскажет агенту про ваш продукт. После этого все остальные команды будут понимать контекст.
+  </div>
+</div>
+<hr class="hr">
+<h2>Частые проблемы</h2>
+<h3>«npm: command not found»</h3>
+<p>Node.js не установлен или терминал не был перезапущен после установки. Закройте все окна терминала, откройте заново и проверьте <code>node --version</code>.</p>
+<h3>«403 Forbidden» или «E403» при <code>npx</code></h3>
+<p>Вас ещё не добавили в команду на npm. Напишите продавцу и подождите письмо от npm.</p>
+<h3>«EACCES» / «permission denied»</h3>
+<p>На Mac: попробуйте префикс <code>sudo</code>, например <code>sudo npx @zrg-sh/studio init</code>. Введите пароль от компьютера. На Windows такого обычно нет.</p>
+<h3>«ENOENT» при init</h3>
+<p>Вы запустили команду не из той папки. Проверьте куда вы перешли командой <code>pwd</code> (на Mac) или <code>cd</code> (на Windows без аргументов).</p>
+<h3>Сломалось всё — как откатить?</h3>
+<p>Просто удалите папку <code>product-specs/</code> и <code>.claude/</code> в проекте. Никаких системных файлов мы не трогаем.</p>
+<h3>Обновить до новой версии?</h3>
+<p>Запустите в той же папке:</p>
+<div class="copy"><pre><code>npx @zrg-sh/studio@latest init --force</code></pre><button class="copy-btn" data-copy="npx @zrg-sh/studio@latest init --force">Копировать</button></div>
+<p><strong>Внимание:</strong> <code>--force</code> перезапишет файлы. Если вы что-то правили в <code>product-specs/</code> руками — сохраните их в другую папку перед обновлением.</p>
+<p class="footer">© zrg-studio. Closed source, by invitation.</p>
+</div>
+<script>
+  // One-click copy for code blocks.
+  document.querySelectorAll('.copy-btn').forEach((btn) => {
+    btn.addEventListener('click', async () => {
+      const text = btn.getAttribute('data-copy');
+      try {
+        await navigator.clipboard.writeText(text);
+        const orig = btn.textContent;
+        btn.textContent = 'Скопировано';
+        btn.classList.add('done');
+        setTimeout(() => {
+          btn.textContent = orig;
+          btn.classList.remove('done');
+        }, 1500);
+      } catch {
+        btn.textContent = 'Ошибка';
+      }
+    });
+  });
+</script>
+</body>
+</html>

package/README.md ADDED Viewed

@@ -0,0 +1,82 @@
+# @zrg-sh/studio
+DDD product-spec pipeline agents for Claude Code. Drop-in `studio-*` agents, slash commands, and hooks for going from raw idea → structured change → reviewed spec.
+> **Closed source.** Access by invitation only. If you do not have a team membership, you cannot install this package.
+>
+> **Non-technical users:** open **[ONBOARDING.html](./ONBOARDING.html)** — pictures and click-by-click steps.
+## Quick install (developers)
+```bash
+npm login                       # one-time, use your npm account
+npx @zrg-sh/studio init         # in any project root
+```
+That's it. The CLI:
+1. Copies `product-specs/` into your current folder (skeleton + agent prompts + hooks).
+2. Copies 7 `studio-*` agents into `.claude/agents/`.
+3. Copies 5 `/studio-*` slash commands into `.claude/commands/`.
+4. Merges studio hooks into `.claude/settings.json` (idempotent).
+Then open the folder in Claude Code and type `/studio-pm` to start.
+## Commands
+```text
+npx @zrg-sh/studio init              # install into current dir
+npx @zrg-sh/studio init --force      # overwrite existing files
+npx @zrg-sh/studio init --no-hooks   # don't touch .claude/settings.json
+npx @zrg-sh/studio doctor            # verify install
+npx @zrg-sh/studio --version
+```
+## What you get
+| Path | What |
+|------|------|
+| `product-specs/CLAUDE.md` | Pipeline overview |
+| `product-specs/agents/studio-*.md` | 14 agent prompts (PM, analyst, scenario-writer, domain-framer, designer, reviewer, merger, …) |
+| `product-specs/hooks/` | 6 hooks (stage-gate, conflict-detect, prompt-guard, …) |
+| `product-specs/workflows/` | 7 workflows (pipeline-full, pipeline-resume, …) |
+| `product-specs/rules/` | DDD + change management conventions |
+| `product-specs/references/` | Model profiles, stage pipeline, gates |
+| `product-specs/templates/` | Change/domain/meta scaffolds |
+| `product-specs/docs/_meta/*.example.md` | Reference fillings from the original project — replace with your own |
+| `.claude/agents/studio-*.md` | Claude Code agent definitions |
+| `.claude/commands/studio-*.md` | `/studio-*` interactive slash commands |
+## Pipeline at a glance
+```text
+/studio-onboard          →  Journey: заполнить _meta/ + domains/ с нуля (greenfield или brownfield)
+/studio-pm               →  PRDCT draft (intent + readiness)
+/studio-analyst          →  Risk + scope analysis
+/studio-scenario-writer  →  User scenarios
+/studio-domain-framer    →  Domain model (aggregates, VOs, events)
+/studio-designer         →  UX surfaces + HTML mockups
+studio-reviewer          →  Cross-doc consistency
+studio-merger            →  Merge into canon
+```
+**Cold start (новый проект):** запусти `/studio-onboard` — многоитерационный диалог, который заполнит базовое видение продукта, capability map, карту доменов и скелеты доменной документации. Можно прерывать в любой момент и возобновлять.
+See `product-specs/references/stage-pipeline.md` for the full version.
+## Access
+This is a private scoped package. To request access, contact the maintainer with your npm username.
+After you've been added to the `@zrg-sh:buyers` team:
+```bash
+npm login                       # use your npm account
+npx @zrg-sh/studio init
+```
+If `npm install` returns `403 Forbidden`, your account is not in the team yet.
+## License
+Proprietary. UNLICENSED. Do not redistribute.

package/bin/zrg-studio.mjs ADDED Viewed

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+// Entry point for the @zrg-sh/studio CLI.
+// Routes to subcommand handlers under src/commands/.
+import { runInit } from '../src/commands/init.mjs';
+import { runDoctor } from '../src/commands/doctor.mjs';
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgPath = join(__dirname, '..', 'package.json');
+const args = process.argv.slice(2);
+const cmd = args[0];
+function printHelp() {
+  console.log(`@zrg-sh/studio — DDD product-spec pipeline for Claude Code
+Usage:
+  npx @zrg-sh/studio <command> [options]
+Commands:
+  init           Copy product-specs/ and .claude/{agents,commands}/studio-* into current dir
+  doctor         Verify installed files are intact
+  --version, -v  Print version
+  --help, -h     Show this help
+Init options:
+  --force        Overwrite existing files
+  --no-hooks     Skip merging studio hooks into .claude/settings.json
+`);
+}
+async function printVersion() {
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+  console.log(pkg.version);
+}
+try {
+  switch (cmd) {
+    case undefined:
+    case '--help':
+    case '-h':
+    case 'help':
+      printHelp();
+      break;
+    case '--version':
+    case '-v':
+      await printVersion();
+      break;
+    case 'init':
+      await runInit(args.slice(1));
+      break;
+    case 'doctor':
+      await runDoctor();
+      break;
+    default:
+      console.error(`Unknown command: ${cmd}\n`);
+      printHelp();
+      process.exit(1);
+  }
+} catch (err) {
+  console.error(`\nError: ${err.message}`);
+  if (process.env.DEBUG) console.error(err.stack);
+  process.exit(1);
+}

package/package.json ADDED Viewed

@@ -0,0 +1,29 @@
+{
+  "name": "@zrg-sh/studio",
+  "version": "0.1.0",
+  "description": "DDD product-spec pipeline agents and commands for Claude Code (studio-pm, studio-analyst, studio-domain-framer, etc.)",
+  "type": "module",
+  "bin": {
+    "zrg-studio": "bin/zrg-studio.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "template",
+    "README.md",
+    "ONBOARDING.html",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test test/"
+  },
+  "license": "UNLICENSED",
+  "author": "matthew",
+  "keywords": ["claude-code", "ddd", "product-spec", "agents"]
+}

package/src/commands/doctor.mjs ADDED Viewed

@@ -0,0 +1,60 @@
+// `doctor` command: sanity-checks an installed zrg-studio layout in cwd.
+import { existsSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+const REQUIRED_PATHS = [
+  'product-specs/CLAUDE.md',
+  'product-specs/agents',
+  'product-specs/hooks',
+  'product-specs/workflows',
+  'product-specs/rules',
+  'product-specs/references',
+  'product-specs/templates',
+  'product-specs/docs/_meta/doc-schema.md',
+  '.claude/agents',
+  '.claude/commands',
+];
+const EXPECTED_STUDIO_AGENTS = 7;
+const EXPECTED_STUDIO_COMMANDS = 6;
+export async function runDoctor() {
+  const cwd = process.cwd();
+  const problems = [];
+  for (const rel of REQUIRED_PATHS) {
+    if (!existsSync(join(cwd, rel))) problems.push(`missing: ${rel}`);
+  }
+  // Count studio-* in .claude/{agents,commands}
+  try {
+    const agents = (await readdir(join(cwd, '.claude', 'agents')))
+      .filter((f) => f.startsWith('studio-') && f.endsWith('.md'));
+    if (agents.length < EXPECTED_STUDIO_AGENTS) {
+      problems.push(`expected >= ${EXPECTED_STUDIO_AGENTS} studio agents in .claude/agents, found ${agents.length}`);
+    }
+  } catch {
+    problems.push('.claude/agents not readable');
+  }
+  try {
+    const commands = (await readdir(join(cwd, '.claude', 'commands')))
+      .filter((f) => f.startsWith('studio-') && f.endsWith('.md'));
+    if (commands.length < EXPECTED_STUDIO_COMMANDS) {
+      problems.push(`expected >= ${EXPECTED_STUDIO_COMMANDS} studio commands in .claude/commands, found ${commands.length}`);
+    }
+  } catch {
+    problems.push('.claude/commands not readable');
+  }
+  if (problems.length === 0) {
+    console.log('OK — zrg-studio install looks healthy.');
+  } else {
+    console.log('Problems found:');
+    for (const p of problems) console.log(`  - ${p}`);
+    console.log('\nRun `npx @zrg-sh/studio init --force` to repair.');
+    process.exit(1);
+  }
+}

package/src/commands/init.mjs ADDED Viewed

@@ -0,0 +1,44 @@
+// `init` command: copies template/ into the user's current working directory
+// and (unless --no-hooks) merges studio hooks into .claude/settings.json.
+import { copyTree, TEMPLATE_ROOT } from '../lib/copy-template.mjs';
+import { mergeClaudeSettings } from '../lib/merge-claude-settings.mjs';
+export async function runInit(argv) {
+  const force = argv.includes('--force');
+  const noHooks = argv.includes('--no-hooks');
+  const cwd = process.cwd();
+  console.log(`\nInstalling @zrg-sh/studio into ${cwd}\n`);
+  const { copied, skipped } = await copyTree(TEMPLATE_ROOT, cwd, { force });
+  console.log(`  Copied:  ${copied.length} files`);
+  if (skipped.length > 0) {
+    console.log(`  Skipped: ${skipped.length} (already exist; use --force to overwrite)`);
+    if (process.env.DEBUG) {
+      for (const p of skipped) console.log(`    - ${p}`);
+    }
+  }
+  if (!noHooks) {
+    const { added, path } = await mergeClaudeSettings(cwd);
+    if (added > 0) {
+      console.log(`  Hooks:   added ${added} entries to ${path}`);
+    } else {
+      console.log(`  Hooks:   already configured in ${path}`);
+    }
+  } else {
+    console.log(`  Hooks:   skipped (--no-hooks)`);
+  }
+  console.log(`
+Done. Next steps:
+  1. Open this folder in Claude Code.
+  2. First time? Run /studio-onboard — multi-turn journey that fills
+     product vision, capability map, and domains. Resumes if interrupted.
+  3. Otherwise run /studio-pm to start a new feature.
+  4. See product-specs/CLAUDE.md for the full pipeline overview.
+`);
+}

package/src/lib/copy-template.mjs ADDED Viewed

@@ -0,0 +1,42 @@
+// Idempotent recursive copy from package's template/ into the user's cwd.
+// Honors --force; otherwise skips files that already exist and reports them.
+import { cp, mkdir, stat, readdir, copyFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, relative, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export const TEMPLATE_ROOT = join(__dirname, '..', '..', 'template');
+/**
+ * Recursively copies `src` to `dst`.
+ * Returns { copied: string[], skipped: string[] } (paths relative to dst root).
+ */
+export async function copyTree(src, dst, { force = false, dstRoot = dst } = {}) {
+  const result = { copied: [], skipped: [] };
+  const entries = await readdir(src, { withFileTypes: true });
+  await mkdir(dst, { recursive: true });
+  for (const entry of entries) {
+    const s = join(src, entry.name);
+    const d = join(dst, entry.name);
+    if (entry.isDirectory()) {
+      const sub = await copyTree(s, d, { force, dstRoot });
+      result.copied.push(...sub.copied);
+      result.skipped.push(...sub.skipped);
+    } else if (entry.isFile()) {
+      const rel = relative(dstRoot, d);
+      if (existsSync(d) && !force) {
+        result.skipped.push(rel);
+      } else {
+        await copyFile(s, d);
+        result.copied.push(rel);
+      }
+    }
+  }
+  return result;
+}