wize-dev-kit 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -5,6 +5,48 @@ Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.1.3] — 2026-06-01
+
+### Added
+
+- **All 9 IDE adapters now ship real renderers** (previously 8 of them were stub printers). Each adapter writes files at the canonical path each harness expects:
+  - **Claude Code** → `.claude/skills/wize-{code}/SKILL.md`
+  - **Antigravity (Google)** → `.agent/skills/wize-{code}/SKILL.md` (singular `.agent`; `.antigravitycli/` is the CLI's own state and is left untouched)
+  - **OpenAI Codex CLI** → `.agents/skills/wize-{code}/SKILL.md`
+  - **Moonshot Kimi Code** → `.kimi/skills/wize-{code}/SKILL.md`
+  - **Cursor** → `.cursor/rules/wize-{code}.mdc` (with `description`, `globs`, `alwaysApply` frontmatter)
+  - **Windsurf (Codeium)** → `.windsurf/rules/wize-{code}.md`
+  - **Continue.dev** → `.continue/prompts/wize-{code}.prompt` (`invokable: true` → slash command)
+  - **OpenCode (sst/opencode)** → `.opencode/agents/wize-{code}.md` (personas, with `mode: primary` for Wizer and `mode: subagent` for the others) + `.opencode/commands/wize-{code}.md` (workflows/skills as slash commands)
+  - **Generic fallback** → `.wize/agents/wize-{code}.md` + a root `AGENTS.md` baseline (read by Codex, Cursor, Windsurf and Antigravity even without their dedicated adapter)
+- New shared module `tools/installer/render-shared.js` centralizes kit traversal, asset parsing, and the Anthropic-style SKILL.md emitter reused by Claude Code, Antigravity, Codex and Kimi adapters.
+- Adapter test suite expanded from 12 → 25 passing tests, with one sanity test per adapter plus format-specific checks (Cursor frontmatter shape, Continue `invokable: true`, OpenCode primary/subagent mode split, generic AGENTS.md emission).
+
+### Fixed
+
+- Antigravity adapter previously created/touched nothing useful. It now emits skills at the correct location (`.agent/skills/`) and explicitly avoids `.antigravitycli/` (CLI state, owned by the Antigravity CLI itself).
+
+### Notes
+
+- Several harnesses inject custom skills at session startup; you may need to restart the IDE after `wize-dev-kit install` for slash commands to appear.
+
+## [0.1.2] — 2026-05-31
+
+### Added
+
+- **Claude Code adapter is now functional.** `npx wize-dev-kit install` (when `claude-code` is selected as IDE target) generates `.claude/skills/wize-*/SKILL.md` for every agent, workflow and skill in the kit. Each SKILL.md uses the Claude Code skill frontmatter so the slash menu picks up `/wize-orchestrator`, `/wize-product-brief`, `/wize-create-prd`, `/wize-tea-gate`, etc.
+- **`wize-help` reworked as an orchestrator-aware skill.** Moved from `core-skills/` to `orchestrator-skills/`. The skill instructs Wizer to read `.wize/config/project.toml` plus the state of `.wize/planning/`, `.wize/solutioning/`, `.wize/implementation/` and reply with a phase-aware "what to do next" answer. Four modes: default, `next`, `status`, `personas`.
+- **Interactive prompts in the installer.** Profile and IDE-target selection now use arrow-keys + space (checkbox) via the `prompts` dependency. Non-TTY environments fall back to the previous number-based prompt automatically (preserves CI scriptability).
+- Adapter test suite (`test/adapter-claude-code.test.js`) covering: per-agent SKILL.md emission, overlay-gate behavior (core-only vs full), `wize-help` content checks, dry-run safety.
+
+### Changed
+
+- Profile gating now lives inside the Claude Code adapter: overlay workflows (`wize-web-*`, `wize-app-*`) are only emitted when the corresponding overlay is in the selected profiles.
+
+### Dependencies
+
+- Added `prompts@^2.4.2` (1 sub-dependency, ~5 KB). Only used by the interactive installer; not bundled into the kit's runtime artifacts.
+
 ## [0.1.1] — 2026-05-31
 
 ### Changed
@@ -41,6 +83,8 @@ Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Inspired by [BMAD Method v6.8.0](https://github.com/bmad-code-org/BMAD-METHOD).
 - WDS module inspired by [bmad-method-wds-expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion).
 
-[Unreleased]: https://github.com/qwize-br/wize-development-kit/compare/v0.1.1...HEAD
+[Unreleased]: https://github.com/qwize-br/wize-development-kit/compare/v0.1.3...HEAD
+[0.1.3]: https://github.com/qwize-br/wize-development-kit/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/qwize-br/wize-development-kit/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/qwize-br/wize-development-kit/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/qwize-br/wize-development-kit/releases/tag/v0.1.0

package/adapters/antigravity/adapter.yaml

@@ -1,7 +1,7 @@
 code: antigravity
-description: "Antigravity CLI + IDE."
-target_path: ".antigravity/agents/"
-file_pattern: "wize-*.md"
+description: "Google Antigravity skills (.agent/skills, NOT .antigravitycli which is CLI state)."
+target_path: ".agent/skills/"
+file_pattern: "wize-*/SKILL.md"
 file_format: markdown
 hooks:
   pre_render: []

package/adapters/antigravity/render.js

@@ -1,15 +1,16 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// Google Antigravity adapter — emits .agent/skills/wize-{code}/SKILL.md per asset.
+// Note: directory is SINGULAR `.agent`. The `.antigravitycli/` directory is
+// Antigravity's own CLI state and must not be touched. Antigravity also reads
+// the root AGENTS.md.
+
 'use strict';
 
-const fs = require('node:fs');
 const path = require('node:path');
+const { renderAnthropicSkills } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const targetDir = path.join(projectRoot, '.agent', 'skills');
+  return renderAnthropicSkills(kitRoot, targetDir, opts);
 }
 
 module.exports = { render };

package/adapters/claude-code/adapter.yaml

@@ -1,5 +1,5 @@
 code: claude-code
-description: "Native Claude Code skills."
+description: "Native Claude Code skills (Anthropic SKILL.md format)."
 target_path: ".claude/skills/"
 file_pattern: "wize-*/SKILL.md"
 file_format: markdown

package/adapters/claude-code/render.js

@@ -1,15 +1,15 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// Claude Code adapter — emits .claude/skills/wize-{code}/SKILL.md per asset.
+// Skill format is identical to the upstream Anthropic spec, so we delegate
+// to the shared renderer.
+
 'use strict';
 
-const fs = require('node:fs');
 const path = require('node:path');
+const { renderAnthropicSkills } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const targetDir = path.join(projectRoot, '.claude', 'skills');
+  return renderAnthropicSkills(kitRoot, targetDir, opts);
 }
 
 module.exports = { render };

package/adapters/codex/adapter.yaml

@@ -1,7 +1,7 @@
 code: codex
-description: "OpenAI Codex CLI agents."
-target_path: ".codex/"
-file_pattern: "wize-*.md"
+description: "OpenAI Codex CLI agent skills (.agents/skills/, Anthropic-compatible)."
+target_path: ".agents/skills/"
+file_pattern: "wize-*/SKILL.md"
 file_format: markdown
 hooks:
   pre_render: []

package/adapters/codex/render.js

@@ -1,15 +1,14 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// OpenAI Codex CLI adapter — emits .agents/skills/wize-{code}/SKILL.md per asset.
+// Codex shares the Anthropic SKILL.md format and also reads the root AGENTS.md.
+
 'use strict';
 
-const fs = require('node:fs');
 const path = require('node:path');
+const { renderAnthropicSkills } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const targetDir = path.join(projectRoot, '.agents', 'skills');
+  return renderAnthropicSkills(kitRoot, targetDir, opts);
 }
 
 module.exports = { render };

package/adapters/continue/adapter.yaml

@@ -1,8 +1,8 @@
 code: continue
-description: "Continue agent slot."
-target_path: ".continue/agents/"
-file_pattern: "wize-*.md"
-file_format: markdown
+description: "Continue.dev slash commands (.continue/prompts/, .prompt files)."
+target_path: ".continue/prompts/"
+file_pattern: "wize-*.prompt"
+file_format: prompt
 hooks:
   pre_render: []
   post_render: []

package/adapters/continue/render.js

@@ -1,15 +1,43 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// Continue.dev adapter — emits .continue/prompts/wize-{code}.prompt per asset.
+// Prompt files are markdown with YAML frontmatter: name, description, invokable.
+// `invokable: true` registers the prompt as a slash command.
+// Reference: https://docs.continue.dev/customize/deep-dives/prompts
+
 'use strict';
 
 const fs = require('node:fs');
 const path = require('node:path');
+const { collectAssets, escapeYamlDouble, clipOneLine, ensureDir } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const targetDir = path.join(projectRoot, '.continue', 'prompts');
+  const assets = collectAssets(kitRoot, opts);
+  const written = [];
+  if (!opts.dryRun) ensureDir(targetDir);
+
+  for (const a of assets) {
+    const desc = clipOneLine(a.description, 180);
+    const content = [
+      '---',
+      `name: ${a.code}`,
+      `description: "${escapeYamlDouble(desc)}"`,
+      `invokable: true`,
+      '---',
+      '',
+      a.kind === 'agent' ? `# ${a.name} — ${a.title}` : `# ${a.name}`,
+      '',
+      a.body.trim(),
+      ''
+    ].join('\n');
+
+    if (opts.dryRun) {
+      written.push(`[dry-run] ${a.code}.prompt`);
+    } else {
+      fs.writeFileSync(path.join(targetDir, `${a.code}.prompt`), content, 'utf-8');
+      written.push(`${a.code}.prompt`);
+    }
+  }
+  return { written, skipped: [] };
 }
 
 module.exports = { render };

package/adapters/cursor/adapter.yaml

@@ -1,8 +1,8 @@
 code: cursor
-description: "Cursor MDC rules."
+description: "Cursor rules (.cursor/rules/, .mdc format)."
 target_path: ".cursor/rules/"
 file_pattern: "wize-*.mdc"
-file_format: markdown
+file_format: mdc
 hooks:
   pre_render: []
   post_render: []

package/adapters/cursor/render.js

@@ -1,15 +1,49 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// Cursor adapter — emits .cursor/rules/wize-{code}.mdc per asset.
+// Cursor rule frontmatter keys: description (required), globs (comma list),
+// alwaysApply (boolean). Mode is inferred from combinations.
+// Reference: https://cursor.com/docs/context/rules
+
 'use strict';
 
 const fs = require('node:fs');
 const path = require('node:path');
+const { collectAssets, escapeYamlDouble, clipOneLine, ensureDir } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const targetDir = path.join(projectRoot, '.cursor', 'rules');
+  const assets = collectAssets(kitRoot, opts);
+  const written = [];
+  if (!opts.dryRun) ensureDir(targetDir);
+
+  for (const a of assets) {
+    const desc = clipOneLine(
+      a.kind === 'agent'
+        ? `${a.name} (${a.title}) — ${a.description}`
+        : a.description
+    );
+    // Agents become alwaysApply=false rules attached on demand;
+    // workflows/skills are Agent-attachable via description.
+    const content = [
+      '---',
+      `description: "${escapeYamlDouble(desc)}"`,
+      `globs:`,
+      `alwaysApply: false`,
+      '---',
+      '',
+      a.kind === 'agent' ? `# ${a.name} — ${a.title}` : `# ${a.name}`,
+      '',
+      a.body.trim(),
+      ''
+    ].join('\n');
+
+    if (opts.dryRun) {
+      written.push(`[dry-run] ${a.code}.mdc`);
+    } else {
+      fs.writeFileSync(path.join(targetDir, `${a.code}.mdc`), content, 'utf-8');
+      written.push(`${a.code}.mdc`);
+    }
+  }
+  return { written, skipped: [] };
 }
 
 module.exports = { render };

package/adapters/generic/adapter.yaml

@@ -1,7 +1,7 @@
 code: generic
-description: "Generic markdown fallback for any AI agent runtime that can read a folder of markdown."
+description: "Generic markdown fallback (.wize/agents/) + AGENTS.md baseline."
 target_path: ".wize/agents/"
-file_pattern: "wize-*.md"
+file_pattern: "wize-*.md + AGENTS.md"
 file_format: markdown
 hooks:
   pre_render: []

package/adapters/generic/render.js

@@ -1,15 +1,35 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// Generic fallback adapter — emits plain markdown under .wize/agents/ and
+// writes a root AGENTS.md as a baseline pointer (read by Codex, Cursor,
+// Windsurf and Antigravity even without their dedicated adapter installed).
+
 'use strict';
 
 const fs = require('node:fs');
 const path = require('node:path');
+const { collectAssets, renderAgentsMd, clipOneLine, ensureDir } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const targetDir = path.join(projectRoot, '.wize', 'agents');
+  const assets = collectAssets(kitRoot, opts);
+  const written = [];
+  if (!opts.dryRun) ensureDir(targetDir);
+
+  for (const a of assets) {
+    const summary = clipOneLine(a.description, 180);
+    const header = a.kind === 'agent' ? `# ${a.name} — ${a.title}` : `# ${a.name}`;
+    const content = [header, '', `> ${summary}`, '', a.body.trim(), ''].join('\n');
+    if (opts.dryRun) {
+      written.push(`[dry-run] ${a.code}.md`);
+    } else {
+      fs.writeFileSync(path.join(targetDir, `${a.code}.md`), content, 'utf-8');
+      written.push(`${a.code}.md`);
+    }
+  }
+
+  // Baseline AGENTS.md (not overwritten if user already has one).
+  const agentsMd = renderAgentsMd(kitRoot, projectRoot, opts);
+  written.push(...agentsMd.written);
+  return { written, skipped: agentsMd.skipped };
 }
 
 module.exports = { render };

package/adapters/kimi-code/adapter.yaml

@@ -1,7 +1,7 @@
 code: kimi-code
-description: "Moonshot Kimi Code agents."
-target_path: ".kimi/agents/"
-file_pattern: "wize-*.md"
+description: "Moonshot Kimi Code skills (.kimi/skills/, Anthropic-compatible)."
+target_path: ".kimi/skills/"
+file_pattern: "wize-*/SKILL.md"
 file_format: markdown
 hooks:
   pre_render: []

package/adapters/kimi-code/render.js

@@ -1,15 +1,16 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// Moonshot Kimi Code adapter — emits .kimi/skills/wize-{code}/SKILL.md per asset.
+// Kimi Code consumes the Anthropic SKILL.md format verbatim and additionally
+// auto-detects .claude/skills/ and .codex/skills/, so installing alongside
+// those adapters is harmless.
+
 'use strict';
 
-const fs = require('node:fs');
 const path = require('node:path');
+const { renderAnthropicSkills } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const targetDir = path.join(projectRoot, '.kimi', 'skills');
+  return renderAnthropicSkills(kitRoot, targetDir, opts);
 }
 
 module.exports = { render };

package/adapters/opencode/adapter.yaml

@@ -1,7 +1,7 @@
 code: opencode
-description: "OpenCode CLI agents."
-target_path: ".opencode/agents/"
-file_pattern: "wize-*.md"
+description: "OpenCode agents + commands (.opencode/agents/ and .opencode/commands/)."
+target_path: ".opencode/"
+file_pattern: "agents/wize-*.md, commands/wize-*.md"
 file_format: markdown
 hooks:
   pre_render: []

package/adapters/opencode/render.js

@@ -1,15 +1,70 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// OpenCode (sst/opencode) adapter — emits two trees:
+//   - .opencode/agents/wize-{code}.md     (personas → system prompts)
+//   - .opencode/commands/wize-{code}.md   (workflows/skills → slash commands)
+// Frontmatter (agents): description, mode (primary|subagent|all)
+// Frontmatter (commands): description, template (the prompt body)
+// Reference: https://opencode.ai/docs/agents/ + /docs/commands/
+
 'use strict';
 
 const fs = require('node:fs');
 const path = require('node:path');
+const { collectAssets, escapeYamlDouble, clipOneLine, ensureDir } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const agentsDir = path.join(projectRoot, '.opencode', 'agents');
+  const commandsDir = path.join(projectRoot, '.opencode', 'commands');
+  const assets = collectAssets(kitRoot, opts);
+  const written = [];
+
+  if (!opts.dryRun) {
+    ensureDir(agentsDir);
+    ensureDir(commandsDir);
+  }
+
+  for (const a of assets) {
+    if (a.kind === 'agent') {
+      const desc = clipOneLine(`${a.name} (${a.title}) — ${a.description}`);
+      const mode = a.code === 'wize-orchestrator' ? 'primary' : 'subagent';
+      const content = [
+        '---',
+        `description: "${escapeYamlDouble(desc)}"`,
+        `mode: ${mode}`,
+        '---',
+        '',
+        `# ${a.name} — ${a.title}`,
+        '',
+        a.body.trim(),
+        ''
+      ].join('\n');
+      if (opts.dryRun) {
+        written.push(`[dry-run] agents/${a.code}.md`);
+      } else {
+        fs.writeFileSync(path.join(agentsDir, `${a.code}.md`), content, 'utf-8');
+        written.push(`agents/${a.code}.md`);
+      }
+    } else {
+      // workflow or skill → command
+      const desc = clipOneLine(a.description, 180);
+      const content = [
+        '---',
+        `description: "${escapeYamlDouble(desc)}"`,
+        '---',
+        '',
+        `# ${a.name}`,
+        '',
+        a.body.trim(),
+        ''
+      ].join('\n');
+      if (opts.dryRun) {
+        written.push(`[dry-run] commands/${a.code}.md`);
+      } else {
+        fs.writeFileSync(path.join(commandsDir, `${a.code}.md`), content, 'utf-8');
+        written.push(`commands/${a.code}.md`);
+      }
+    }
+  }
+  return { written, skipped: [] };
 }
 
 module.exports = { render };

package/adapters/windsurf/adapter.yaml

@@ -1,6 +1,6 @@
 code: windsurf
-description: "Windsurf Cascade-friendly markdown agents."
-target_path: ".windsurf/agents/"
+description: "Windsurf Cascade rules (.windsurf/rules/, plain markdown)."
+target_path: ".windsurf/rules/"
 file_pattern: "wize-*.md"
 file_format: markdown
 hooks:

package/adapters/windsurf/render.js

@@ -1,15 +1,40 @@
-/* Stub renderer for this adapter — emits a console preview of what would be written. */
+// Windsurf (Codeium) adapter — emits .windsurf/rules/wize-{code}.md per asset.
+// Windsurf rules are plain markdown; activation mode is configured inside the
+// IDE Rules panel, not in frontmatter. Cascade picks them up on session start.
+// Reference: https://docs.windsurf.com/windsurf/cascade/memories#rules
+
 'use strict';
 
 const fs = require('node:fs');
 const path = require('node:path');
+const { collectAssets, clipOneLine, ensureDir } = require('../../tools/installer/render-shared.js');
 
 function render(kitRoot, projectRoot, opts = {}) {
-  const adapterDir = __dirname;
-  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
-  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
-  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
-  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+  const targetDir = path.join(projectRoot, '.windsurf', 'rules');
+  const assets = collectAssets(kitRoot, opts);
+  const written = [];
+  if (!opts.dryRun) ensureDir(targetDir);
+
+  for (const a of assets) {
+    const summary = clipOneLine(a.description, 180);
+    const header = a.kind === 'agent' ? `# ${a.name} — ${a.title}` : `# ${a.name}`;
+    const content = [
+      header,
+      '',
+      `> ${summary}`,
+      '',
+      a.body.trim(),
+      ''
+    ].join('\n');
+
+    if (opts.dryRun) {
+      written.push(`[dry-run] ${a.code}.md`);
+    } else {
+      fs.writeFileSync(path.join(targetDir, `${a.code}.md`), content, 'utf-8');
+      written.push(`${a.code}.md`);
+    }
+  }
+  return { written, skipped: [] };
 }
 
 module.exports = { render };

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wize-dev-kit",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Full-lifecycle AI-assisted development kit with Test Architect and Whiteport Design Studio embedded. Inspired by BMAD Method and WDS.",
   "keywords": [
     "ai",
@@ -48,5 +48,8 @@
     "ARCH.md",
     "ROSTER.md",
     "DECISIONS.md"
-  ]
+  ],
+  "dependencies": {
+    "prompts": "^2.4.2"
+  }
 }

package/src/core-skills/module.yaml

@@ -16,9 +16,6 @@ skills:
   - code: wize-brainstorming
     name: "Brainstorming"
     description: "Divergent-then-convergent ideation; produces idea-pool.md."
-  - code: wize-help
-    name: "Help"
-    description: "Routes user to the right agent/workflow based on intent."
   - code: wize-shard-doc
     name: "Shard Doc"
     description: "Splits large markdown docs (PRD, architecture) into addressable shards."

package/src/orchestrator-skills/module.yaml

@@ -13,6 +13,9 @@ agents:
     description: "Knows the user deeply, parses raw demand, routes to the right specialist. Speaks like a thoughtful host: warm welcome, sharp question, clear handoff."
 
 skills:
+  - code: wize-help
+    name: "Help (Wizer)"
+    description: "Project-state-aware help. Reads .wize/ and tells the user what to do next. Modes: default, next, status, personas."
   - code: wize-onboarding
     name: "Onboarding"
     description: "Post-install triage: greenfield vs brownfield, profile, objective. Delegates to specialists."

package/src/orchestrator-skills/wize-help/skill.md

@@ -0,0 +1,102 @@
+---
+code: wize-help
+name: Help (Wizer)
+module: orchestrator
+owner: wize-orchestrator
+status: ready
+---
+
+# Wizer · `/wize-help`
+
+You are **Wizer**, the orchestrator. The user invoked `/wize-help`. Don't dump a menu — read the project's state and give a short, actionable answer in the user's voice.
+
+## Modes
+
+| Invocation | What to do |
+|---|---|
+| `/wize-help` or `/wize` (no argument) | Greeting + project snapshot + the **single best next step**. |
+| `/wize-help next` | Just the next step. Skip the snapshot. |
+| `/wize-help status` | Snapshot only — phase, last TEA gate, in-flight stories. |
+| `/wize-help personas` | List only the personas relevant to the active profiles. |
+
+## Step 1 — read project state
+
+Read these files if they exist (they may not — that's information too):
+
+| Path | Tells you |
+|---|---|
+| `.wize/config/project.toml` | Active profiles, IDE targets, communication & document languages, project name. |
+| `.wize/config/tea.toml` | TEA gate policy (advisory vs enforcing). |
+| `.wize/planning/brief.md` | Whether Phase 1 (Pepper) started. |
+| `.wize/planning/research.md` | Whether research was done. |
+| `.wize/planning/ux/trigger-map.md` | Whether WDS trigger map exists. |
+| `.wize/planning/prd.md` | Whether Phase 2 (Maria Hill) PRD exists. |
+| `.wize/planning/ux/ux-scenarios.md`, `.wize/planning/ux/ux-design/**` | Whether Mantis ran UX. |
+| `.wize/planning/tech-vision.md`, `nfr-principles.md` | Whether Fury set tech strategy. |
+| `.wize/solutioning/architecture.md` | Whether Tony's architecture exists. |
+| `.wize/solutioning/stories/**/*.md` | Whether stories are sliced. |
+| `.wize/implementation/tea/risk-profile.md` | Whether Hawkeye's risk profile is in place. |
+| `.wize/implementation/tea/**/gate.md` | Last gate decisions per story. |
+| `.wize/implementation/sprint-status.md` | Active sprint state. |
+
+## Step 2 — determine current phase
+
+Apply this heuristic, top-down. Stop at the first match.
+
+1. **No `.wize/` folder.** → Tell the user the kit isn't installed; suggest `npx wize-dev-kit install`.
+2. **No `brief.md`.** → Phase 1. Next: **Pepper / `wize-product-brief`**.
+3. **`brief.md` exists, no `trigger-map.md`.** → Still Phase 1. Next: **Pepper / `wize-trigger-map`**.
+4. **No `prd.md`.** → Phase 2. Next: **Maria Hill / `wize-create-prd`**.
+5. **`prd.md` exists, no `ux-scenarios.md`.** → Phase 2 UX. Next: **Mantis / `wize-ux-scenarios`**.
+6. **`ux-design/` empty.** → Phase 2 UX continues. Next: **Mantis / `wize-ux-design`**.
+7. **No `tech-vision.md` or `nfr-principles.md`.** → Phase 2→3 boundary. Next: **Fury / `wize-tech-vision`** then `wize-nfr-principles`.
+8. **No `architecture.md`.** → Phase 3. Next: **Tony / `wize-create-architecture`**.
+9. **No `stories/**/*.md`.** → Phase 3 still. Next: **Tony / `wize-create-epics-and-stories`**.
+10. **No `tea/risk-profile.md`.** → Phase 3 closeout. Next: **Hawkeye / `wize-tea-risk`**.
+11. **Has stories but `sprint-status.md` shows no active sprint.** → Phase 4 start. Next: **Maria Hill / `wize-sprint-planning`**.
+12. **Has active sprint, oldest in-flight story has no `tea/.../design.md`.** → Next: **Hawkeye / `wize-tea-design`** for that story.
+13. **In-flight story exists, no implementation commits.** → Next: **Shuri / `wize-dev-story`** on that story.
+14. **In-flight story exists with code, no `gate.md`.** → Next: **Hawkeye / `wize-tea-trace` → `wize-tea-review` → `wize-tea-gate`** for that story.
+15. **All stories gated.** → Next: **Wizer / `wize-retrospective`** + plan next epic.
+
+For brownfield repos where `.wize/knowledge/document-project/` is missing, prepend: "Run `wize-document-project` first to baseline the codebase."
+
+## Step 3 — respond
+
+Default response shape (3 lines):
+
+```
+Welcome back. {project name} — {profiles, e.g., "Core + Web"}.
+You're at: {phase + last completed artifact}.
+Next: /{next workflow} ({persona}).
+```
+
+For `status`, return a markdown table:
+
+```
+| Item | State |
+|---|---|
+| Phase | … |
+| Profiles | … |
+| Last TEA gate | … (PASS/CONCERNS/FAIL/WAIVED) |
+| In-flight stories | … |
+| Active sprint | … |
+| TEA policy | advisory / enforcing |
+```
+
+For `personas`, list only personas whose role applies to active profiles. Always include Wizer, Pepper, Peggy, Maria Hill, Mantis, Fury, Tony, Hawkeye, Shuri (all are profile-independent core roles). If `web-overlay` active, note that **Mantis** has the WCAG/responsive playbook loaded and **Hawkeye** has Playwright/Vitest patterns. If `app-overlay` active, note HIG/Material 3 for Mantis and Detox/Maestro for Hawkeye.
+
+## Step 4 — offer to act
+
+End every response with one of:
+
+- "Want me to call {persona}?" — if the next step is clear.
+- "Want me to baseline the repo first?" — if brownfield + no document-project.
+- "Want me to call a party-mode with {persona1} + {persona2}?" — if the next step has a cross-cutting decision.
+
+## Style
+
+- Speak in the user's `communication` language (from `.wize/config/project.toml`).
+- One sharp question is better than three sentences of advice.
+- If the user invoked `/wize-help next`, give them just the next step in one line and stop.
+- If user invoked `/wize-help status`, give the table and stop. Don't suggest actions.

package/tools/installer/render-shared.js

@@ -0,0 +1,187 @@
+// Shared helpers used by all IDE adapters: kit traversal, asset parsing,
+// and renderers for the Anthropic-style "SKILL.md" format (Claude Code,
+// Antigravity, OpenAI Codex, Kimi Code all use it verbatim).
+//
+// Adapters that need a different format (Cursor .mdc, Windsurf, Continue,
+// OpenCode) consume the parsed assets via collectAssets() and then render
+// per their own conventions.
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { walkAgents, walkWorkflows, walkSkills } = require('./validators/walk.js');
+
+function readYamlField(content, field) {
+  const re = new RegExp('^' + field + ':\\s*(?:"([^"]*)"|\'([^\']*)\'|(.*?))\\s*$', 'm');
+  const m = content.match(re);
+  if (!m) return null;
+  return (m[1] || m[2] || m[3] || '').trim();
+}
+
+function readFrontmatter(content) {
+  if (!content.startsWith('---')) return {};
+  const end = content.indexOf('\n---', 3);
+  if (end === -1) return {};
+  const lines = content.slice(3, end).split('\n');
+  const out = {};
+  for (const line of lines) {
+    const m = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*?)\s*$/);
+    if (m) out[m[1]] = m[2].replace(/^"|"$/g, '').replace(/^'|'$/g, '');
+  }
+  return out;
+}
+
+function bodyAfterFrontmatter(content) {
+  if (!content.startsWith('---')) return content;
+  const end = content.indexOf('\n---', 3);
+  if (end === -1) return content;
+  return content.slice(end + 4).replace(/^\s+/, '');
+}
+
+function escapeYamlDouble(str) {
+  return String(str).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+
+function clipOneLine(str, max = 240) {
+  const flat = String(str).replace(/\s+/g, ' ').trim();
+  if (flat.length <= max) return flat;
+  return flat.slice(0, max - 1).trimEnd() + '…';
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+// Walks the kit and returns a flat array of "assets" the adapters can render.
+// Each asset has: { kind: 'agent'|'workflow'|'skill', code, name, title, description, body, overlay }
+function collectAssets(kitRoot, { profiles = ['core'] } = {}) {
+  const out = [];
+  const profSet = new Set(profiles);
+
+  for (const yamlPath of walkAgents(kitRoot)) {
+    const dir = path.dirname(yamlPath);
+    const yaml = fs.readFileSync(yamlPath, 'utf-8');
+    const code = readYamlField(yaml, 'code');
+    const name = readYamlField(yaml, 'name');
+    const title = readYamlField(yaml, 'title') || '';
+    const description = readYamlField(yaml, 'description') || '';
+    if (!code || !name) continue;
+    const personaPath = path.join(dir, 'persona.md');
+    const persona = fs.existsSync(personaPath) ? fs.readFileSync(personaPath, 'utf-8') : '';
+    out.push({ kind: 'agent', code, name, title, description, body: persona || description, overlay: null });
+  }
+
+  for (const wfPath of walkWorkflows(kitRoot)) {
+    const content = fs.readFileSync(wfPath, 'utf-8');
+    const fm = readFrontmatter(content);
+    if (!fm.code) continue;
+    if (fm.overlay === 'web' && !profSet.has('web-overlay')) continue;
+    if (fm.overlay === 'app' && !profSet.has('app-overlay')) continue;
+    out.push({
+      kind: 'workflow',
+      code: fm.code,
+      name: fm.name || fm.code,
+      title: fm.phase || fm.gate || '',
+      description: `${fm.phase || fm.gate || 'workflow'}: ${fm.name || fm.code}`,
+      body: bodyAfterFrontmatter(content),
+      overlay: fm.overlay || null
+    });
+  }
+
+  for (const skPath of walkSkills(kitRoot)) {
+    const content = fs.readFileSync(skPath, 'utf-8');
+    const fm = readFrontmatter(content);
+    if (!fm.code) continue;
+    out.push({
+      kind: 'skill',
+      code: fm.code,
+      name: fm.name || fm.code,
+      title: fm.module || '',
+      description: fm.module ? `${fm.module} skill: ${fm.name || fm.code}` : (fm.name || fm.code),
+      body: bodyAfterFrontmatter(content),
+      overlay: null
+    });
+  }
+
+  return out;
+}
+
+// Anthropic-style SKILL.md renderer used by Claude Code, Antigravity, Codex, Kimi.
+// Each asset becomes <targetDir>/<code>/SKILL.md with YAML frontmatter (name, description).
+function renderAnthropicSkills(kitRoot, targetDir, opts = {}) {
+  const assets = collectAssets(kitRoot, opts);
+  const written = [];
+  if (!opts.dryRun) ensureDir(targetDir);
+
+  for (const a of assets) {
+    const desc = clipOneLine(
+      a.kind === 'agent'
+        ? `${a.name} (${a.title}) — ${a.description}`
+        : a.description
+    );
+    const heading = a.kind === 'agent' ? `# ${a.name} — ${a.title}` : `# ${a.name}`;
+    const content = [
+      '---',
+      `name: ${a.code}`,
+      `description: "${escapeYamlDouble(desc)}"`,
+      '---',
+      '',
+      heading,
+      '',
+      a.body.trim(),
+      ''
+    ].join('\n');
+
+    if (opts.dryRun) {
+      written.push(`[dry-run] ${a.code}/SKILL.md`);
+    } else {
+      const skillDir = path.join(targetDir, a.code);
+      ensureDir(skillDir);
+      fs.writeFileSync(path.join(skillDir, 'SKILL.md'), content, 'utf-8');
+      written.push(`${a.code}/SKILL.md`);
+    }
+  }
+  return { written, skipped: [] };
+}
+
+// Convenience emitter for a root-level AGENTS.md — read by Codex, Cursor,
+// Windsurf and Antigravity as a baseline pointer to the kit's deeper docs.
+function renderAgentsMd(kitRoot, projectRoot, opts = {}) {
+  const assets = collectAssets(kitRoot, opts);
+  const agents = assets.filter(a => a.kind === 'agent');
+  const file = path.join(projectRoot, 'AGENTS.md');
+  if (fs.existsSync(file) && !opts.overwrite) {
+    return { written: [], skipped: ['AGENTS.md (already present; not overwritten)'] };
+  }
+  const lines = [
+    '# Agents — Wize Development Kit',
+    '',
+    'This repo is wired with the [`wize-dev-kit`](https://www.npmjs.com/package/wize-dev-kit).',
+    'Detailed artifacts live under `.wize/`. The agents below are activated through your AI IDE',
+    'using slash commands (Claude Code, Codex, Cursor, Windsurf, Antigravity all read this file).',
+    '',
+    '## Roster',
+    ''
+  ];
+  for (const a of agents) {
+    lines.push(`- **${a.name}** (\`${a.code}\`) — ${a.title}. ${clipOneLine(a.description, 180)}`);
+  }
+  lines.push('', '## Where to start', '', 'Activate the orchestrator: `wize-orchestrator` (Wizer). Then ask `/wize-help`.', '');
+
+  if (opts.dryRun) return { written: ['[dry-run] AGENTS.md'], skipped: [] };
+  fs.writeFileSync(file, lines.join('\n'), 'utf-8');
+  return { written: ['AGENTS.md'], skipped: [] };
+}
+
+module.exports = {
+  collectAssets,
+  renderAnthropicSkills,
+  renderAgentsMd,
+  // Re-exports for adapter authors who need to roll their own format:
+  readFrontmatter,
+  bodyAfterFrontmatter,
+  escapeYamlDouble,
+  clipOneLine,
+  ensureDir
+};

package/tools/installer/wize-cli.js

@@ -12,6 +12,9 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const readline = require('node:readline');
+const prompts = require('prompts');
+
+const INTERACTIVE = process.stdout.isTTY && process.stdin.isTTY;
 
 const KIT_ROOT = path.resolve(__dirname, '..', '..');
 const KIT_VERSION = require(path.join(KIT_ROOT, 'package.json')).version;
@@ -94,12 +97,41 @@ async function confirm(question, defaultYes = true) {
 }
 
 async function selectLanguage(label, defaultCode = 'en') {
+  if (INTERACTIVE) {
+    const choices = LANGUAGES.map(l => ({
+      title: `${l.code.padEnd(6)} — ${l.label}`,
+      value: l.code,
+      description: l.code === defaultCode ? 'default' : undefined
+    }));
+    choices.push({ title: 'Other (type a custom BCP-47 code)…', value: '__custom' });
+    const initial = LANGUAGES.findIndex(l => l.code === defaultCode);
+    const { picked } = await prompts({
+      type: 'select',
+      name: 'picked',
+      message: label,
+      choices,
+      initial: initial === -1 ? 0 : initial
+    });
+    if (picked === undefined) process.exit(130);
+    if (picked === '__custom') {
+      const { custom } = await prompts({
+        type: 'text',
+        name: 'custom',
+        message: 'Type a BCP-47 language code (e.g. ko, ar, nl, ru)',
+        initial: defaultCode,
+        validate: v => /^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$/.test(v) || 'use a valid code like "en" or "pt-BR"'
+      });
+      return custom || defaultCode;
+    }
+    return picked;
+  }
+  // Non-TTY fallback: number-driven.
   console.log(`\n${label}:`);
   LANGUAGES.forEach((l, i) => {
     const def = l.code === defaultCode ? '(default)' : '';
     console.log(`  ${String(i + 1).padStart(2)}. ${l.code.padEnd(6)} — ${l.label} ${def}`);
   });
-  const ans = (await prompt(`Pick a number, type a code (e.g. "en", "pt-BR", "ko"), or ENTER for ${defaultCode}: `)).trim();
+  const ans = (await prompt(`Pick a number, type a code, or ENTER for ${defaultCode}: `)).trim();
   if (!ans) return defaultCode;
   const asNum = parseInt(ans, 10);
   if (!isNaN(asNum) && asNum >= 1 && asNum <= LANGUAGES.length) return LANGUAGES[asNum - 1].code;
@@ -107,6 +139,26 @@ async function selectLanguage(label, defaultCode = 'en') {
 }
 
 async function multiSelect(label, items, isSelected = i => i.default) {
+  if (INTERACTIVE) {
+    const { picked } = await prompts({
+      type: 'multiselect',
+      name: 'picked',
+      message: label,
+      hint: '↑/↓ navigate · space toggle · enter confirm',
+      instructions: false,
+      choices: items.map(it => ({
+        title: it.label + (it.required ? ' (required)' : ''),
+        value: it.code,
+        selected: it.required || isSelected(it),
+        disabled: it.required
+      }))
+    });
+    if (picked === undefined) process.exit(130);
+    const codes = new Set(picked);
+    for (const req of items.filter(i => i.required)) codes.add(req.code);
+    return items.filter(it => codes.has(it.code));
+  }
+  // Non-TTY fallback.
   console.log(`\n${label}:`);
   items.forEach((it, i) => {
     const star = it.required ? '★ ' : '  ';
@@ -114,9 +166,7 @@ async function multiSelect(label, items, isSelected = i => i.default) {
     console.log(`  ${i + 1}. ${star}${it.label} ${def}`);
   });
   const ans = await prompt('Pick numbers (comma-separated) or ENTER for defaults: ');
-  if (!ans) {
-    return items.filter(it => it.required || isSelected(it));
-  }
+  if (!ans) return items.filter(it => it.required || isSelected(it));
   const indices = ans.split(',').map(s => parseInt(s.trim(), 10) - 1).filter(i => !isNaN(i));
   const picked = indices.map(i => items[i]).filter(Boolean);
   for (const req of items.filter(i => i.required)) {
@@ -227,6 +277,35 @@ function userToml() {
 `;
 }
 
+function renderAdapters({ kitRoot, projectRoot, targets, profiles }) {
+  const results = [];
+  const profileCodes = profiles.map(p => p.code);
+  for (const target of targets) {
+    const adapterDir = path.join(kitRoot, 'adapters', target.code);
+    const renderPath = path.join(adapterDir, 'render.js');
+    if (!fs.existsSync(renderPath)) {
+      results.push({ code: target.code, skipped: true, reason: 'adapter missing' });
+      continue;
+    }
+    try {
+      const mod = require(renderPath);
+      if (typeof mod.render !== 'function') {
+        results.push({ code: target.code, skipped: true, reason: 'no render() export' });
+        continue;
+      }
+      const out = mod.render(kitRoot, projectRoot, { profiles: profileCodes });
+      if (out && typeof out === 'object' && Array.isArray(out.written)) {
+        results.push({ code: target.code, written: out.written.length });
+      } else {
+        results.push({ code: target.code, skipped: true, reason: 'stub (no skills emitted)' });
+      }
+    } catch (err) {
+      results.push({ code: target.code, error: err.message });
+    }
+  }
+  return results;
+}
+
 async function cmdInstall(args) {
   const cwd = process.cwd();
   console.log(logo());
@@ -270,8 +349,18 @@ async function cmdInstall(args) {
   console.log(`✓ profiles: ${profiles.map(p => p.code).join(', ')}`);
   console.log(`✓ ide targets: ${targets.map(t => t.code).join(', ')}`);
 
-  console.log('\n(stub) IDE adapter generation would run now for each target.');
-  console.log('(stub) onboarding handoff to Wizer would start here.');
+  console.log('\nGenerating IDE adapters...');
+  const renderResults = renderAdapters({
+    kitRoot: KIT_ROOT,
+    projectRoot: cwd,
+    targets,
+    profiles
+  });
+  for (const r of renderResults) {
+    if (r.skipped) console.log(`  - ${r.code}: skipped (${r.reason})`);
+    else if (r.written) console.log(`  ✓ ${r.code}: ${r.written} skill(s) emitted`);
+    else if (r.error) console.log(`  ✖ ${r.code}: ${r.error}`);
+  }
 
   if (detection.brownfield) {
     const baseline = await confirm('\nRun `wize-document-project` to baseline the existing repo now?', true);

package/src/core-skills/wize-help/skill.md

@@ -1,18 +0,0 @@
----
-code: wize-help
-name: Help
-module: core
-status: stub
----
-
-# Help
-
-Routes user intent to the right agent or workflow.
-
-## Examples
-- "I need to start a new project." → Wizer onboarding.
-- "I have a brief; what's next?" → Maria Hill / `wize-create-prd`.
-- "Design system?" → Mantis / `wize-design-system`.
-- "Architecture?" → Tony / `wize-create-architecture`.
-- "Test plan for this story?" → Hawkeye / `wize-tea-design`.
-- "Add a custom agent." → Builder / `wize-create-agent`.