wize-dev-kit 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -5,6 +5,50 @@ Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.1.4] — 2026-06-01
+
+### Added
+
+- **`user_name` prompt at install time.** The installer asks "How should the agents call you?" (default = `$USER`), and persists the answer to `.wize/config/user.toml` under `[user] name`. Wizer and `wize-help` read this file and greet the user by name (e.g., *"Welcome back, [USER_NAME]. {project} — {profiles}. Next: …"*).
+- **Opt-in suggested `.gitignore` block.** The installer asks whether to apply the suggested entries. When accepted, an idempotent block is injected between `# >>> wize-dev-kit (managed) >>>` and `# <<< wize-dev-kit (managed) <<<` markers covering: per-developer files (`user.toml`, `scratch/`, `.local/`, `quick-dev-log.md`) and the generated IDE adapter outputs (`.claude/skills/wize-*`, `.agent/skills/wize-*`, `.cursor/rules/wize-*.mdc`, etc.). Re-running install only updates lines between the markers; everything outside is untouched. Declining keeps `.gitignore` exactly as it was.
+- `tools/installer/setup-helpers.js`: pure-ish helpers for `applyGitignore()` (create / append / replace / unchanged) and `generateUserToml()`.
+- 8 new unit tests covering gitignore idempotency (create, append, idempotent re-run, stale-block replace, dry-run) and user.toml generation (name, escaping, optional role). Total: 33 passing.
+
+### Changed
+
+- Wizer (orchestrator) persona and `wize-help` skill now instruct the agent to read `.wize/config/user.toml` and use `[user] name` when greeting.
+- `project.toml` template comment clarifies "personal preferences live in user.toml".
+
+### Recommended layout (for a team repo)
+
+Commit: `.wize/config/project.toml`, `.wize/config/tea.toml`, `.wize/planning/`, `.wize/solutioning/`, `.wize/implementation/tea/`, `.wize/implementation/retrospective/`, `.wize/knowledge/`, `.wize/custom/`, `AGENTS.md`.
+Ignore (handled by the suggested block): `.wize/config/user.toml`, `.wize/scratch/`, `.wize/.local/`, `.wize/implementation/quick-dev-log.md`, and all generated adapter outputs (each developer runs `npx wize-dev-kit install` for their own IDE target).
+
+## [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
@@ -58,7 +102,9 @@ 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.2...HEAD
+[Unreleased]: https://github.com/qwize-br/wize-development-kit/compare/v0.1.4...HEAD
+[0.1.4]: https://github.com/qwize-br/wize-development-kit/compare/v0.1.3...v0.1.4
+[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,186 +1,15 @@
-//
-// Claude Code adapter — renders kit assets into .claude/skills/wize-{code}/SKILL.md.
-//
-// Strategy:
-//   - For each agent (agent.yaml + persona.md), emit a SKILL.md that pairs the
-//     agent identity with its responsibilities, so Claude Code can activate
-//     the persona via slash command.
-//   - For each workflow/skill file, emit a SKILL.md that wraps the workflow
-//     content with an activation frontmatter Claude Code understands.
-//
-// Each SKILL.md uses the Claude Code skill format:
-//     ---
-//     name: <code>
-//     description: <one-liner shown in the slash menu>
-//     ---
-//     <body>
-//
+// 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 { walkAgents, walkWorkflows, walkSkills } = require('../../tools/installer/validators/walk.js');
-
-function readYamlField(content, field) {
-  // Minimal scalar/quoted-string extractor for top-level YAML scalars.
-  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) {
-  // Returns an object of top-level key:value pairs from a leading
-  // ---\n...\n--- block. Simple scalars only.
-  if (!content.startsWith('---')) return {};
-  const end = content.indexOf('\n---', 3);
-  if (end === -1) return {};
-  const fm = content.slice(3, end).split('\n');
-  const out = {};
-  for (const line of fm) {
-    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 escapeForYamlDouble(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 renderAgentSkill({ code, name, title, description, body }) {
-  const desc = clipOneLine(`${name} (${title}) — ${description}`);
-  return `---
-name: ${code}
-description: "${escapeForYamlDouble(desc)}"
----
-
-# ${name} — ${title}
-
-${body.trim()}
-`;
-}
-
-function renderWorkflowSkill({ code, name, description, body }) {
-  const desc = clipOneLine(description || `Workflow ${code}`);
-  return `---
-name: ${code}
-description: "${escapeForYamlDouble(desc)}"
----
-
-# ${name}
+const { renderAnthropicSkills } = require('../../tools/installer/render-shared.js');
 
-${body.trim()}
-`;
-}
-
-function ensureDir(dir) {
-  fs.mkdirSync(dir, { recursive: true });
-}
-
-function writeSkill(skillsDir, code, content) {
-  const dir = path.join(skillsDir, code);
-  ensureDir(dir);
-  fs.writeFileSync(path.join(dir, 'SKILL.md'), content, 'utf-8');
-}
-
-/**
- * Render the full kit into `.claude/skills/` at the project root.
- *
- * @param {string} kitRoot - absolute path to the installed wize-dev-kit package
- * @param {string} projectRoot - absolute path to the target repo (cwd of install)
- * @param {object} opts
- * @param {string[]} [opts.profiles] - selected profile codes (e.g., ['core', 'web-overlay'])
- * @param {boolean} [opts.dryRun] - when true, return the list without writing
- * @returns {{ written: string[], skipped: string[] }}
- */
 function render(kitRoot, projectRoot, opts = {}) {
-  const skillsDir = path.join(projectRoot, '.claude', 'skills');
-  const written = [];
-  const skipped = [];
-  const profiles = new Set(opts.profiles || ['core']);
-  const dryRun = !!opts.dryRun;
-
-  if (!dryRun) ensureDir(skillsDir);
-
-  // 1. Agents
-  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) { skipped.push(yamlPath); continue; }
-
-    const personaPath = path.join(dir, 'persona.md');
-    const persona = fs.existsSync(personaPath) ? fs.readFileSync(personaPath, 'utf-8') : '';
-    const body = persona || description;
-
-    const content = renderAgentSkill({ code, name, title, description, body });
-    if (dryRun) {
-      written.push(`[dry-run] ${code}/SKILL.md`);
-    } else {
-      writeSkill(skillsDir, code, content);
-      written.push(`${code}/SKILL.md`);
-    }
-  }
-
-  // 2. Workflows — gate by overlay selection
-  for (const wfPath of walkWorkflows(kitRoot)) {
-    const content = fs.readFileSync(wfPath, 'utf-8');
-    const fm = readFrontmatter(content);
-    const code = fm.code;
-    const name = fm.name || code;
-    if (!code) { skipped.push(wfPath); continue; }
-
-    if (fm.overlay === 'web' && !profiles.has('web-overlay')) { skipped.push(wfPath); continue; }
-    if (fm.overlay === 'app' && !profiles.has('app-overlay')) { skipped.push(wfPath); continue; }
-
-    const description = `${fm.phase || fm.gate || 'workflow'}: ${name}`;
-    const body = bodyAfterFrontmatter(content);
-    const skillContent = renderWorkflowSkill({ code, name, description, body });
-    if (dryRun) {
-      written.push(`[dry-run] ${code}/SKILL.md`);
-    } else {
-      writeSkill(skillsDir, code, skillContent);
-      written.push(`${code}/SKILL.md`);
-    }
-  }
-
-  // 3. Standalone skills
-  for (const skPath of walkSkills(kitRoot)) {
-    const content = fs.readFileSync(skPath, 'utf-8');
-    const fm = readFrontmatter(content);
-    const code = fm.code;
-    const name = fm.name || code;
-    if (!code) { skipped.push(skPath); continue; }
-
-    const description = fm.module ? `${fm.module} skill: ${name}` : name;
-    const body = bodyAfterFrontmatter(content);
-    const skillContent = renderWorkflowSkill({ code, name, description, body });
-    if (dryRun) {
-      written.push(`[dry-run] ${code}/SKILL.md`);
-    } else {
-      writeSkill(skillsDir, code, skillContent);
-      written.push(`${code}/SKILL.md`);
-    }
-  }
-
-  return { written, skipped };
+  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.2",
+  "version": "0.1.4",
   "description": "Full-lifecycle AI-assisted development kit with Test Architect and Whiteport Design Studio embedded. Inspired by BMAD Method and WDS.",
   "keywords": [
     "ai",

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

@@ -26,6 +26,7 @@ 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/user.toml` | Per-developer preferences. Use `[user] name` to greet the user by name. Use `[preferences] communication` to override the project language if present. |
 | `.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. |
@@ -63,14 +64,20 @@ For brownfield repos where `.wize/knowledge/document-project/` is missing, prepe
 
 ## Step 3 — respond
 
-Default response shape (3 lines):
+Default response shape (3 lines). When `user.toml` provides a `[user] name`, include it in the greeting:
 
 ```
-Welcome back. {project name} — {profiles, e.g., "Core + Web"}.
+Welcome back{{, <user.name> when present}}. {project name} — {profiles, e.g., "Core + Web"}.
 You're at: {phase + last completed artifact}.
 Next: /{next workflow} ({persona}).
 ```
 
+Concrete example with personalization filled in:
+
+> Welcome back, [USER_NAME]. wize-development-kit — Core + Web.
+> You're at: Phase 3 closeout — architecture signed, no risk profile yet.
+> Next: `/wize-tea-risk` (Hawkeye).
+
 For `status`, return a markdown table:
 
 ```

package/src/orchestrator-skills/wize-orchestrator/persona.md

@@ -17,6 +17,14 @@ I am **Wizer**. I am the host of this development kit. I know who you are, what
 - I speak the user's language (configurable in `.wize/config/project.toml`).
 - I never narrate my reasoning aloud — I just route.
 
+## Personalization
+
+Before greeting, read `.wize/config/user.toml` if it exists. If it has `[user] name = "…"`, call the user by that name. If it also has `role = "…"`, factor that into how technical/strategic you frame follow-ups (a PM gets framing, a developer gets file paths).
+
+If `user.toml` is missing or has no `name`, fall back to a neutral greeting.
+
 ## Greet
 
-> "Welcome back. What are we working on?"
+> "Welcome back{{`, ` + user.name when present, else ''}}. What are we working on?"
+
+Example with personalization filled in: *"Welcome back, [USER_NAME]. What are we working on?"*

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/setup-helpers.js

@@ -0,0 +1,105 @@
+// Setup helpers used by `wize-dev-kit install`:
+//   - generateUserToml({ name, role }) → .wize/config/user.toml template
+//   - applyGitignore(projectRoot) → idempotent gitignore block injection
+//
+// Both are pure functions where possible; only applyGitignore writes to disk.
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const GITIGNORE_BEGIN = '# >>> wize-dev-kit (managed) >>>';
+const GITIGNORE_END = '# <<< wize-dev-kit (managed) <<<';
+
+const GITIGNORE_BODY = [
+  '# Personal / per-developer (do NOT commit)',
+  '.wize/config/user.toml',
+  '.wize/scratch/',
+  '.wize/.local/',
+  '.wize/implementation/quick-dev-log.md',
+  '',
+  '# Generated IDE adapter outputs (regenerate with `npx wize-dev-kit install`)',
+  '.claude/skills/wize-*',
+  '.agent/skills/wize-*',
+  '.agents/skills/wize-*',
+  '.kimi/skills/wize-*',
+  '.cursor/rules/wize-*.mdc',
+  '.windsurf/rules/wize-*.md',
+  '.continue/prompts/wize-*.prompt',
+  '.opencode/agents/wize-*.md',
+  '.opencode/commands/wize-*.md',
+  '.wize/agents/wize-*.md'
+].join('\n');
+
+function buildGitignoreBlock() {
+  return [
+    GITIGNORE_BEGIN,
+    '# Managed by `npx wize-dev-kit install`. Re-running install will update',
+    '# the lines between the markers below; lines outside are untouched.',
+    '',
+    GITIGNORE_BODY,
+    GITIGNORE_END
+  ].join('\n');
+}
+
+// Idempotent: if the block exists, replace it; otherwise append.
+// Returns { changed: boolean, mode: 'created'|'replaced'|'appended'|'unchanged' }.
+function applyGitignore(projectRoot, { dryRun = false } = {}) {
+  const file = path.join(projectRoot, '.gitignore');
+  const block = buildGitignoreBlock();
+  let current = '';
+  let exists = fs.existsSync(file);
+  if (exists) current = fs.readFileSync(file, 'utf-8');
+
+  const startIdx = current.indexOf(GITIGNORE_BEGIN);
+  const endIdx = current.indexOf(GITIGNORE_END);
+  let next;
+  let mode;
+
+  if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+    const before = current.slice(0, startIdx).replace(/\n+$/, '');
+    const after = current.slice(endIdx + GITIGNORE_END.length).replace(/^\n+/, '');
+    next = [before, block, after].filter(Boolean).join('\n\n');
+    if (!next.endsWith('\n')) next += '\n';
+    mode = current.includes(block) ? 'unchanged' : 'replaced';
+  } else if (exists) {
+    next = current.replace(/\n+$/, '') + '\n\n' + block + '\n';
+    mode = 'appended';
+  } else {
+    next = block + '\n';
+    mode = 'created';
+  }
+
+  const changed = next !== current;
+  if (changed && !dryRun) fs.writeFileSync(file, next, 'utf-8');
+  return { changed, mode };
+}
+
+function generateUserToml({ name = '', role = '' } = {}) {
+  const escapedName = String(name).replace(/"/g, '\\"');
+  const roleLine = role
+    ? `role = "${String(role).replace(/"/g, '\\"')}"`
+    : `# role = "developer"          # optional — "developer", "PM", "designer", etc.`;
+  return `# Wize Development Kit — user-level customizations.
+# This file is per-developer; the kit places it in .gitignore so each member
+# of the team gets their own copy. Do NOT commit.
+
+[user]
+name = "${escapedName}"
+${roleLine}
+
+[preferences]
+# Override project-level language if you prefer another locally:
+# communication   = "pt-BR"
+# document_output = "en"
+`;
+}
+
+module.exports = {
+  GITIGNORE_BEGIN,
+  GITIGNORE_END,
+  buildGitignoreBlock,
+  applyGitignore,
+  generateUserToml
+};

package/tools/installer/wize-cli.js

@@ -10,9 +10,11 @@
 'use strict';
 
 const fs = require('node:fs');
+const os = require('node:os');
 const path = require('node:path');
 const readline = require('node:readline');
 const prompts = require('prompts');
+const { applyGitignore, generateUserToml } = require('./setup-helpers.js');
 
 const INTERACTIVE = process.stdout.isTTY && process.stdin.isTTY;
 
@@ -228,7 +230,7 @@ function projectToml({ profiles, targets, communication_language, document_outpu
   const profileLine = profiles.map(p => `"${p.code}"`).join(', ');
   const targetLine = targets.map(t => `"${t.code}"`).join(', ');
   return `# Wize Development Kit — project config
-# Generated at install. Edit user-level customizations in user.toml.
+# Generated at install. Commit this file. Personal preferences live in user.toml.
 
 [project]
 name = "${project_name}"
@@ -239,7 +241,7 @@ profiles = [${profileLine}]
 ide_targets = [${targetLine}]
 
 [language]
-# Language used when agents talk to you in the IDE chat.
+# Language used when agents talk to the team in chat.
 communication = "${communication_language}"
 # Language used when agents write artifacts to disk
 # (brief.md, prd.md, architecture.md, gate.md, etc.).
@@ -271,12 +273,6 @@ gate    = { granularity = "per-story" }
 `;
 }
 
-function userToml() {
-  return `# Wize Development Kit — user-level customizations
-# This file is preserved on update; project.toml may be rewritten.
-`;
-}
-
 function renderAdapters({ kitRoot, projectRoot, targets, profiles }) {
   const results = [];
   const profileCodes = profiles.map(p => p.code);
@@ -336,18 +332,39 @@ async function cmdInstall(args) {
     communication_language
   );
 
+  // Personal touch — the user_name lands in .wize/config/user.toml (per-developer).
+  const defaultName = (os.userInfo().username || '').trim();
+  const user_name = (await prompt(
+    `How should the agents call you? [${defaultName || 'leave blank'}]: `
+  )).trim() || defaultName;
+
+  // Gitignore — opt-in, idempotent.
+  const wantsGitignore = await confirm(
+    'Add the suggested entries to .gitignore (user.toml + scratch + generated adapter outputs)?',
+    true
+  );
+
   console.log('\nCreating .wize/ skeleton...');
   for (const dir of WIZE_DIRS) mkdirp(path.join(cwd, dir));
 
   writeIfMissing(path.join(cwd, '.wize/config/project.toml'), projectToml({
     profiles, targets, communication_language, document_output_language, project_name
   }));
-  writeIfMissing(path.join(cwd, '.wize/config/user.toml'), userToml());
+  writeIfMissing(path.join(cwd, '.wize/config/user.toml'), generateUserToml({ name: user_name }));
   writeIfMissing(path.join(cwd, '.wize/config/tea.toml'), teaToml());
 
   console.log('✓ .wize/ created');
   console.log(`✓ profiles: ${profiles.map(p => p.code).join(', ')}`);
   console.log(`✓ ide targets: ${targets.map(t => t.code).join(', ')}`);
+  if (user_name) console.log(`✓ user.toml: agents will call you "${user_name}"`);
+
+  if (wantsGitignore) {
+    const r = applyGitignore(cwd);
+    if (r.changed) console.log(`✓ .gitignore ${r.mode} with the wize-dev-kit block`);
+    else           console.log(`= .gitignore already up to date`);
+  } else {
+    console.log('= .gitignore untouched (you opted out of suggested entries)');
+  }
 
   console.log('\nGenerating IDE adapters...');
   const renderResults = renderAdapters({