wize-dev-kit 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -5,6 +5,26 @@ Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.1.1] — 2026-05-31
+
+### Changed
+
+- `README.md`: `Install` section now appears right after the badges (was buried in the middle).
+- `ROSTER.md`: rewritten entirely in English; Wizer's motto no longer references a personal name — now reads "I know the qwize methodology, I know the project — I activate the right agent."
+- Installer: now asks **two** language questions separately (BMAD parity):
+  - **Communication language** — how agents talk to you in chat.
+  - **Document output language** — language used in generated files (`brief.md`, `prd.md`, `architecture.md`, gates, etc.).
+  - Both stored under `[language]` in `.wize/config/project.toml`.
+  - Includes a curated catalog of common BCP-47 codes (en, pt-BR, pt-PT, es, fr, de, it, zh-CN, ja, vi) with free-text fallback for any other locale.
+- `package.json`: corrected `repository`, `homepage`, `bugs` to point at `qwize-br/wize-development-kit` (was `qwize/wize-dev-kit`).
+- `package.json`: added `prepublishOnly` running tests + structural validators.
+
+### Added
+
+- `.github/workflows/publish.yml`: GitHub Actions workflow that publishes to npm on tag push (`v*`) using **Trusted Publishing** (OIDC). No long-lived `NPM_TOKEN` secret. Emits `--provenance` attestation.
+
+## [0.1.0] — 2026-05-31
+
 ### Added
 
 - Initial skeleton (v0.1.0 scaffold).
@@ -21,4 +41,6 @@ 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/wize-dev-kit/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/qwize-br/wize-development-kit/compare/v0.1.1...HEAD
+[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/README.md

@@ -10,6 +10,36 @@
 
 ---
 
+## Install
+
+In any greenfield or brownfield repo:
+
+```bash
+npx wize-dev-kit install
+```
+
+Or straight from GitHub (no npm required):
+
+```bash
+npx github:qwize-br/wize-development-kit install
+```
+
+The installer asks:
+
+1. Profile(s) to enable (Core / +Web / +App — multi-select).
+2. IDE target(s) (Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, OpenCode, Antigravity, or generic fallback — multi-select).
+3. Language preferences (communication + document output).
+4. Output folder (default `.wize/`).
+5. For brownfield repos: offers to run `wize-document-project` to baseline the existing codebase.
+
+After install, open your IDE and start with:
+
+> "Activate Wizer and brief him on the project."
+
+Wizer will route you to the right persona (Pepper for brief, Mantis for UX baseline, Tony for architecture preferences, etc.).
+
+---
+
 ## What it is
 
 Wize Development Kit (WDK) is an installable AI agent stack that takes a project from **brief → PRD → UX strategy → architecture → tested implementation** through 9 specialized agents (Marvel-themed) and a structured workflow library. It runs inside your AI IDE (Claude Code, Cursor, Windsurf, and others) and writes structured artifacts to a hidden `.wize/` folder in the target repo.
@@ -42,35 +72,6 @@ See [`ROSTER.md`](ROSTER.md) for personas, styles and BMAD equivalences.
 
 ---
 
-## Quick start
-
-```bash
-# In any greenfield or brownfield repo
-npx wize-dev-kit install
-```
-
-Or, before this is published in your environment, install straight from GitHub:
-
-```bash
-npx github:qwize-br/wize-development-kit install
-```
-
-The installer asks:
-
-1. Profile(s) to enable (Core / +Web / +App — multi-select).
-2. IDE target(s) (Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, OpenCode, Antigravity, or generic fallback — multi-select).
-3. Language preferences (communication + document output).
-4. Output folder (default `.wize/`).
-5. For brownfield repos: offers to run `wize-document-project` to baseline the existing codebase.
-
-After install, open your IDE and start with:
-
-> "Activate Wizer and brief him on the project."
-
-Wizer will route you to the right persona (Pepper for brief, Mantis for UX baseline, Tony for architecture preferences, etc.).
-
----
-
 ## Output layout (in the target repo)
 
 ```

package/ROSTER.md

@@ -1,25 +1,25 @@
-# Wize Dev Kit — Roster de Agentes (proposta v1)
+# Wize Dev Kit — Agent Roster (v1)
 
-> Tema: **Marvel**. Cada persona representa um papel específico no método.
-> Equivalências BMAD listadas para referência cruzada com o repositório-pai.
+> Theme: **Marvel**. Each persona represents a specific role in the qwize methodology.
+> BMAD equivalences listed for cross-reference with the inspiration repo.
 
-## Quadro
+## Roster table
 
-| # | Persona | Code | Papel | Fase | Lema / Estilo | Equiv. BMAD |
+| # | Persona | Code | Role | Phase | Motto / Style | BMAD equiv. |
 |---|---|---|---|---|---|---|
-| 1 | **Wizer** | `wize-orchestrator` | Orchestrator / Knowledge Base / Briefing | Todas | "Conheço o time, conheço o André, ative o agente certo." Estilo: anfitrião, escolhe, distribui. Tools: globais. | (não existe — papel de orchestrator surge no `party-mode` do BMAD) |
-| 2 | **Pepper Potts** | `wize-agent-analyst` | Business Analyst | 1 — Analysis | "Eficiência implacável." Brainstorming, market research, product-brief, PRFAQ, ROI, stakeholder map. Estilo: pragmática, antecipa, conecta business → tech. | Mary (`bmad-agent-analyst`) |
-| 3 | **Peggy Carter** | `wize-agent-tech-writer` | Technical Writer | Transversal (1–4) | "Estrutura, audiência, clareza." DITA, CommonMark, OpenAPI, READMEs, runbooks. Estilo: organizada, didática, técnica-mas-acessível. | Paige (`bmad-agent-tech-writer`) |
-| 4 | **Maria Hill** | `wize-agent-pm` | Product Manager | 2 — Planning | "Mission first." PRD, epics, sprint planning, cobrança de prazos. Estilo: militar, disciplinado, sem desculpas. | John (`bmad-agent-pm`) |
-| 5 | **Mantis** | `wize-agent-ux-designer` | UX Designer (Whiteport Strategic UX v0.4.3) | 2–3 | "Sinto o usuário antes de desenhar." Jobs-to-be-done, jornadas, empathy mapping, design tokens, IA, design system. Estilo: research-heavy, qualitative, narrativa empática. | Sally (`bmad-agent-ux-designer`) — substituída + metodologia Whiteport |
-| 6 | **Nick Fury** | `wize-agent-solution-strategist` | Solution Strategy / Tech Vision | 2 → 3 (boundary) | "Pessoas > Objetivo." Big-picture, NFRs, escolha de stack, princípios, trade-offs estratégicos. Estilo: autoritário, direto, poucas palavras. | (parcial de) Winston — vertente estratégica |
-| 7 | **Tony Stark** | `wize-agent-architect` | System Architect | 3 — Solutioning | "Eu construo as coisas." System design, componentes, ADRs, prototipagem, escolha de patterns. Estilo: confiante, irreverente, mostra com código. | Winston (`bmad-agent-architect`) — vertente sistêmica |
-| 8 | **Hawkeye** | `wize-agent-test-architect` | Test Architect (TEA) | Transversal (gates em 2, 3, 4) | "Sempre acerto onde dói." Risk profile, test design, traceability, NFR assessment, review, gate decision. Estilo: pragmático, edge-case hunter, foca no que importa. | (novo — não existe no BMAD, inspirado no TEA do BMAD-Method v5) |
-| 9 | **Shuri** | `wize-agent-dev` | Senior Developer | 4 — Implementation | "Wakanda forever — agora compila." TDD red-green-refactor, segurança, performance. Estilo: gênio inovador, rápida, protetora do ecossistema, código limpo. | Amelia (`bmad-agent-dev`) |
+| 1 | **Wizer** | `wize-orchestrator` | Orchestrator / Knowledge Base / Briefing | All | "I know the qwize methodology, I know the project — I activate the right agent." Style: host, picks, routes. Tools: global. | (none — orchestrator role surfaces only in BMAD's `party-mode`) |
+| 2 | **Pepper Potts** | `wize-agent-analyst` | Business Analyst | 1 — Analysis | "Relentless efficiency." Brainstorming, market research, product brief, PR/FAQ, ROI, stakeholder map. Style: pragmatic, anticipates, connects business → tech. | Mary (`bmad-agent-analyst`) |
+| 3 | **Peggy Carter** | `wize-agent-tech-writer` | Technical Writer | Transversal (1–4) | "Structure, audience, clarity." DITA, CommonMark, OpenAPI, READMEs, runbooks. Style: organized, didactic, technical but accessible. | Paige (`bmad-agent-tech-writer`) |
+| 4 | **Maria Hill** | `wize-agent-pm` | Product Manager | 2 — Planning | "Mission first." PRD, epics, sprint planning, deadline enforcement. Style: military discipline, no excuses, outcome-focused. | John (`bmad-agent-pm`) |
+| 5 | **Mantis** | `wize-agent-ux-designer` | UX Designer (Whiteport Strategic UX v0.4.3) | 2–3 | "I feel the user before I sketch." Jobs-to-be-done, journeys, empathy mapping, design tokens, IA, design system. Style: research-heavy, qualitative, empathic narrative. | Sally (`bmad-agent-ux-designer`) — replaced with Whiteport methodology |
+| 6 | **Nick Fury** | `wize-agent-solution-strategist` | Solution Strategy / Tech Vision | 2 → 3 (boundary) | "People > Objective." Big-picture, NFRs, stack family, principles, strategic trade-offs. Style: authoritative, direct, few words. | (partial) Winston — strategic side |
+| 7 | **Tony Stark** | `wize-agent-architect` | System Architect | 3 — Solutioning | "I build the thing." System design, components, ADRs, prototyping, pattern selection. Style: confident, irreverent, shows with code. | Winston (`bmad-agent-architect`) — systemic side |
+| 8 | **Hawkeye** | `wize-agent-test-architect` | Test Architect (TEA) | Transversal (gates in 2, 3, 4) | "I always hit where it hurts." Risk profile, test design, traceability, NFR assessment, review, gate decision. Style: pragmatic, edge-case hunter, focused on what matters. | (new — does not exist in BMAD core; inspired by BMAD-Method v5 TEA) |
+| 9 | **Shuri** | `wize-agent-dev` | Senior Developer | 4 — Implementation | "Wakanda forever — now it compiles." TDD red-green-refactor, security, performance. Style: genius innovator, fast, clean code, protective of the ecosystem. | Amelia (`bmad-agent-dev`) |
 
-## Notas
+## Notes
 
-- **Tema visual:** ícones podem usar emojis (📊 🛡️ 🦾 etc.) mas a identidade visual fica para a Fase 8 de consolidação.
-- **Agent Builder:** decidido na Fase 3 como **skill**, não agente (`wize-create-agent`). Wizer chama essa skill quando precisa registrar um novo persona/módulo custom.
-- **Times:** todos no time default `software-development`. Times opcionais (`web-dev`, `app-dev`) ativam variantes de Tony e Shuri por perfil (decisão pendente para Fase 4).
-- **Adições futuras (fora do kit dev):** Pepper já está usada como Analyst; Fury já como Strategist. Outras personas do ecossistema Marvel (Black Panther, Wanda, Falcon, Vision, Riri Williams) ficam livres para kits futuros (Wize Ops Kit, Wize Data Kit, Wize Security Kit, etc.).
+- **Visual theme:** emoji icons (📊 🛡️ 🦾 etc.) are placeholders; a full visual identity will be consolidated in a later phase.
+- **Agent Builder:** decided as a **skill** (`wize-create-agent`), not an agent. Wizer invokes the skill when a new persona or custom module needs to be registered.
+- **Teams:** default team is `software-development`. Optional teams (`web-dev`, `app-dev`) activate variants of Tony and Shuri per profile.
+- **Future Marvel personas (out of dev-kit scope):** Pepper is already Analyst here, Fury is already Strategist. Other Marvel personas (Black Panther, Wanda, Falcon, Vision, Riri Williams, Kamala Khan) remain reserved for future kits (Wize Ops Kit, Wize Data Kit, Wize Security Kit, etc.).

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wize-dev-kit",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Full-lifecycle AI-assisted development kit with Test Architect and Whiteport Design Studio embedded. Inspired by BMAD Method and WDS.",
   "keywords": [
     "ai",

package/tools/installer/wize-cli.js

@@ -34,6 +34,20 @@ const PROFILES = [
   { code: 'app-overlay', label: 'Wize App Development (overlay)', required: false }
 ];
 
+// Common BCP-47 short codes. Users can type any other value freely.
+const LANGUAGES = [
+  { code: 'en',    label: 'English' },
+  { code: 'pt-BR', label: 'Português (Brasil)' },
+  { code: 'pt-PT', label: 'Português (Portugal)' },
+  { code: 'es',    label: 'Español' },
+  { code: 'fr',    label: 'Français' },
+  { code: 'de',    label: 'Deutsch' },
+  { code: 'it',    label: 'Italiano' },
+  { code: 'zh-CN', label: '中文 (简体)' },
+  { code: 'ja',    label: '日本語' },
+  { code: 'vi',    label: 'Tiếng Việt' }
+];
+
 const HELP = `wize-dev-kit v${KIT_VERSION}
 
 Usage:
@@ -79,6 +93,19 @@ async function confirm(question, defaultYes = true) {
   return ans.startsWith('y');
 }
 
+async function selectLanguage(label, defaultCode = 'en') {
+  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();
+  if (!ans) return defaultCode;
+  const asNum = parseInt(ans, 10);
+  if (!isNaN(asNum) && asNum >= 1 && asNum <= LANGUAGES.length) return LANGUAGES[asNum - 1].code;
+  return ans;
+}
+
 async function multiSelect(label, items, isSelected = i => i.default) {
   console.log(`\n${label}:`);
   items.forEach((it, i) => {
@@ -147,7 +174,7 @@ const WIZE_DIRS = [
   '.wize/custom/workflows'
 ];
 
-function projectToml({ profiles, targets, language, project_name }) {
+function projectToml({ profiles, targets, communication_language, document_output_language, project_name }) {
   const profileLine = profiles.map(p => `"${p.code}"`).join(', ');
   const targetLine = targets.map(t => `"${t.code}"`).join(', ');
   return `# Wize Development Kit — project config
@@ -162,8 +189,11 @@ profiles = [${profileLine}]
 ide_targets = [${targetLine}]
 
 [language]
-communication = "${language}"
-document_output = "${language}"
+# Language used when agents talk to you in the IDE chat.
+communication = "${communication_language}"
+# Language used when agents write artifacts to disk
+# (brief.md, prd.md, architecture.md, gate.md, etc.).
+document_output = "${document_output_language}"
 
 [paths]
 output_root    = ".wize"
@@ -217,12 +247,22 @@ async function cmdInstall(args) {
   const project_name = (await prompt(`Project name [${path.basename(cwd)}]: `)) || path.basename(cwd);
   const profiles = await multiSelect('Select profile(s) to install', PROFILES);
   const targets = await multiSelect('Select IDE target(s)', TARGETS);
-  const language = (await prompt('Communication language [en]: ')) || 'en';
+
+  const communication_language = await selectLanguage(
+    'Communication language (how agents will talk to you in chat)',
+    'en'
+  );
+  const document_output_language = await selectLanguage(
+    `Document output language (language used in generated files; ENTER for "${communication_language}")`,
+    communication_language
+  );
 
   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, language, project_name }));
+  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/tea.toml'), teaToml());