wize-dev-kit 0.14.0 → 0.16.0

package/ARCH.md

@@ -1,8 +1,6 @@
-# Wize Development Kit — Arquitetura
+# Wize Development Kit — Arquitetura Proposta v1
 
-> Estado: **construído e publicado** — snapshot mantido em dia com a v0.10.0.
-> (As Fases 1-7 originais da entrevista deram origem a este documento; ele deixou
-> de ser "proposta/pré-build" a partir da v0.8.0.)
+> Consolidação das Fases 1-7 da entrevista. Pré-build.
 > Referências de inspiração: BMAD Method v6.8.0 + WDS Expansion (Norse).
 > Tema do roster: **Marvel**.
 
@@ -11,7 +9,7 @@
 ## 1. Identidade
 
 - **Nome do pacote npm:** `wize-dev-kit`
-- **CLI:** `wize-dev-kit` (subcomandos: `install`, `update`, `uninstall`, `list`, `sync`, `agent`, `workflow`, `validate`, `doctor`, `document-project`)
+- **CLI:** `wize-dev-kit` (subcomandos: `install`, `update`, `uninstall`, `agent`, `workflow`, `sync`)
 - **Namespace de arquivos/agentes/skills:** `wize-*`
 - **Licença:** MIT — open-source desde o dia 1.
 - **Tema visual do roster:** Marvel.
@@ -21,16 +19,15 @@
 
 ## 2. Modelo de distribuição
 
-**1 pacote, 4 perfis selecionáveis, overlays combináveis.**
+**1 pacote, 3 perfis selecionáveis, overlays combináveis.**
 
 ```
 wize-dev-kit (pacote npm)
 │
 ├── Wize Dev Core      ← base completa (sempre instalada)
 ├── Wize Web Dev       ← overlay opt-in
-├── Wize App Development ← overlay opt-in
-└── Wize Security Overlay ← overlay opt-in (AI Pentester / Natasha Romanoff, red-teamer)
-                     (overlays podem coexistir no mesmo repo)
+└── Wize App Development ← overlay opt-in
+                     (Web + App podem coexistir no mesmo repo)
 ```
 
 - Selecionar perfil no installer aplica Core + overlay correspondente.
@@ -39,7 +36,7 @@ wize-dev-kit (pacote npm)
 
 ---
 
-## 3. Roster final (9 core personas + 1 overlay persona)
+## 3. Roster final (9 personas Marvel)
 
 | Persona | Code | Papel | Fase principal |
 |---|---|---|---|
@@ -52,7 +49,6 @@ wize-dev-kit (pacote npm)
 | Tony Stark | `wize-agent-architect` | System Architect | 3 (Solutioning) |
 | Hawkeye | `wize-agent-test-architect` | Test Architect (TEA) | Gates 2/3/4 |
 | Shuri | `wize-agent-dev` | Senior Developer | 4 (Implementation) |
-| Natasha Romanoff | `wize-sec-red-teamer` | Red-Teamer / AI Pentester (security-overlay, opt-in) | Transversal |
 
 ---
 
@@ -166,12 +162,12 @@ E nos IDE-targets (selecionáveis no install):
 ```
 .claude/skills/wize-*           (Claude Code)
 .cursor/rules/wize-*.mdc        (Cursor)
-.windsurf/rules/wize-*.md       (Windsurf)
-.agents/skills/wize-*           (Codex — .codex/ foi revertido na 0.7.3)
-.continue/prompts/wize-*.prompt (Continue)
-.kimi/skills/wize-*             (Kimi Code)
-.opencode/agents/ + .opencode/commands/  (OpenCode)
-.agent/skills/wize-*            (Antigravity CLI/IDE)
+.windsurf/...                   (Windsurf)
+.codex/...                      (Codex)
+.continue/...                   (Continue)
+.kimi/...                       (Kimi Code)
+.opencode/...                   (OpenCode)
+.antigravity/...                (Antigravity CLI/IDE)
 .wize/agents/                   (fallback genérico)
 ```
 
@@ -200,7 +196,7 @@ wize-dev-kit install
   ├─ Detecta: greenfield vs brownfield
   ├─ Pergunta: perfil(s) — Core / +Web / +App
   ├─ Pergunta: IDE targets — multi-select
-  ├─ Pergunta: idioma (output folder é fixo: .wize/)
+  ├─ Pergunta: idioma e output_folder
   ├─ Cria .wize/ + adapters IDE
   ├─ Se brownfield: oferece `wize-document-project`
   └─ Se ok: dispara onboarding (Wizer → Pepper/Mantis/Tony)
@@ -214,43 +210,7 @@ wize-dev-kit sync     # regera adapters IDE
 
 ---
 
-## 8. Document Project Engine
-
-`wize-dev-kit document-project` é a ferramenta de baseline e documentação brownfield do kit.
-
-### Modos
-
-| Modo | O que faz | Nível de scan |
-|---|---|---|
-| `quick` | Gera 6 arquivos de baseline leves (`overview.md`, `architecture-snapshot.md`, `conventions.md`, `dependencies.md`, `risk-spots.md`, `open-questions.md`). | `quick` apenas |
-| `initial_scan` | Classifica o tipo do projeto, gera `index.md` + docs condicionais conforme o tipo. | `quick`, `deep`, `exhaustive` |
-| `full_rescan` | Arquiva o estado anterior e re-executa `initial_scan` do zero. | `quick`, `deep`, `exhaustive` |
-| `deep_dive` | Análise exaustiva de uma pasta, arquivo, feature, api_group ou component_group. | `exhaustive` |
-
-### Arquivo de estado
-
-- `.wize/knowledge/document-project/project-scan-report.json` mantém progresso, passos completados e instruções de resume.
-- Arquivos antigos são arquivados em `.wize/knowledge/document-project/_archive/`.
-- `--resume` continua a partir do `current_step`.
-
-### Index mestre
-
-- `index.md` lista toda a documentação gerada e documentação existente.
-- Docs condicionais que ainda não foram gerados aparecem com `_(To be generated)_`.
-- Re-gerar o index remove os marcadores conforme os arquivos são produzidos.
-
-### Componentes de código
-
-- `tools/installer/commands/document-project.js` — dispatcher CLI e parsing de args.
-- `tools/installer/document-project/modes/{quick,initial-scan,full-rescan,deep-dive}.js` — implementação dos modos.
-- `tools/installer/document-project/classify.js` — classificador de tipo de projeto via CSV.
-- `tools/installer/document-project/batch-scanner.js` — varredura em batches para evitar estouro de contexto.
-- `tools/installer/document-project/render-index.js` — renderizador do `index.md`.
-- `tools/installer/document-project/state.js` — leitura/escrita do `project-scan-report.json`.
-- `src/method-skills/1-analysis/wize-document-project/templates/` — templates markdown/Handlebars para cada doc condicional.
-- `src/method-skills/1-analysis/wize-document-project/documentation-requirements.csv` — regras de tipo de projeto e flags de scan.
-
-## 9. Overlays Web e App
+## 8. Overlays Web e App
 
 ### Wize Web Dev (overlay)
 
@@ -268,16 +228,16 @@ wize-dev-kit sync     # regera adapters IDE
 
 ---
 
-## 10. Agent Builder
+## 9. Agent Builder
 
 - 3 skills meta: `wize-create-agent`, `wize-create-skill`, `wize-create-workflow`.
 - Customização de built-ins via `.wize/custom/{tipo}/{code}/customize.toml` (override sem fork).
-- Validação: checks estruturais (validação de schema via Ajv pendente de orçamento de dependências).
+- Validação obrigatória: schema → lint → dry-run.
 - Auto-sync: regera adapters de todos os IDEs ativos a cada criação/edição.
 
 ---
 
-## 11. Onboarding pós-install (Wizer)
+## 10. Onboarding pós-install (Wizer)
 
 1. Wizer triages: greenfield vs brownfield, perfil, objetivo do projeto.
 2. Se brownfield: oferece rodar `wize-document-project` (Tony + Peggy geram baseline).
@@ -286,7 +246,7 @@ wize-dev-kit sync     # regera adapters IDE
 
 ---
 
-## 12. Estrutura do repo `wize-dev-kit/` (source code do kit)
+## 11. Estrutura do repo `wize-dev-kit/` (source code do kit)
 
 ```
 wize-dev-kit/
@@ -299,7 +259,7 @@ wize-dev-kit/
 ├── ROSTER.md                   # ← quadro Marvel
 │
 ├── src/
-│   ├── core-skills/            # Core (advanced-elicitation, brainstorming, spec, etc)
+│   ├── core-skills/            # Core (advanced-elicitation, brainstorming, party-mode, etc)
 │   │   └── wize-*/
 │   ├── method-skills/          # AI Agile dev: 1-analysis, 2-plan, 3-solutioning, 4-implementation
 │   │   ├── 1-analysis/
@@ -351,19 +311,12 @@ wize-dev-kit/
 │   │   └── wize-create-workflow/
 │   ├── web-overlay/            # Wize Web Dev overlay
 │   │   ├── wize-web-scaffold/
-│   │   ├── wize-web-deploy/
 │   │   ├── wize-web-seo-audit/
 │   │   └── module.yaml
-│   ├── app-overlay/            # Wize App Development overlay
-│   │   ├── wize-app-scaffold/
-│   │   ├── wize-app-release-channels/
-│   │   ├── wize-app-store-listing/
-│   │   └── module.yaml
-│   └── security-overlay/       # Wize Security Overlay (AI Pentester, opt-in)
-│       ├── agents/red-teamer/  # Natasha Romanoff (wize-sec-red-teamer)
-│       ├── skills/
-│       ├── data/
-│       └── _shared/
+│   └── app-overlay/            # Wize App Development overlay
+│       ├── wize-app-scaffold/
+│       ├── wize-app-release-channels/
+│       └── module.yaml
 │
 ├── adapters/                   # IDE adapters
 │   ├── claude-code/
@@ -382,12 +335,6 @@ wize-dev-kit/
 │       ├── detect.js           # greenfield/brownfield detector
 │       ├── onboarding.js
 │       ├── sync.js
-│       ├── render-shared.js
-│       ├── baseline.js
-│       ├── version-check.js
-│       ├── setup-helpers.js
-│       ├── commands/
-│       ├── document-project/
 │       └── validators/         # schema, lint, dry-run
 │
 └── test/                       # specs validating skills + workflows

package/CHANGELOG.md

@@ -9,6 +9,30 @@ Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.16.0] — 2026-09-02
+
+**`/wize-eli5` — explain anything to anyone.** New core skill that detects the audience (age, grade level, job role, relationship) and calibrates vocabulary, analogies, tone, depth and framing to the listener — a concept, code, error, or decision explained for a 5-year-old, a manager, an engineer, or a client. Inspired by [ELI5](https://github.com/dreambigou/eli5) by Andrew Ou (credited in all 3 READMEs). Registered in the core module catalog; rendered by all 10 harness adapters (Claude Code, Antigravity, Codex, Kimi Code, Hermes, Cursor, Windsurf, Continue, OpenCode, Generic).
+
+### Added
+
+- **`wize-eli5` core skill** (`src/core-skills/wize-eli5/skill.md`) — audience detection → five-axis calibration (vocabulary, analogies, tone, depth, framing) → explanation → comprehension check; role-specific framing (manager, designer, engineer, client, child) and anti-patterns.
+- **READMEs (en/pt-BR/es)** — `/wize-eli5` listed in the cross-cutting commands walkthrough; ELI5 credited in the Inspiration & credits section.
+
+## [0.15.0] — 2026-09-02
+
+**Hermes Agent is now the 10th supported harness.** New `hermes` IDE target renders the kit's agents/skills/workflows as project-local skills at `.hermes/skills/wize-{code}/SKILL.md` (Anthropic-compatible format, same as Claude Code/Codex/Kimi Code). Hermes discovers project skills at the git root, loads them only when the repo is trusted (`hermes skills trust`), and lets trusted project skills override same-named profile skills — vendored repo skills win inside their repo. Hermes also reads root `AGENTS.md` as project context, and its CLI (`hermes -z "<prompt>"`) is registered in the installer's brownfield baseline for headless runs. Highlighted in all 3 READMEs + `docs/harnesses/hermes.md` (+pt-BR); registered in the installer targets, `doctor`, `.gitignore` block, and 4 test suites.
+
+### Added
+
+- **`hermes` IDE target** (`adapters/hermes/`) — renders via the shared Anthropic emitter to `.hermes/skills/`; companion files (`steps/`, `templates/`, `data/`) copied alongside `SKILL.md`. Selectable in `npx wize-dev-kit install` / `sync`; `install --yes` now enables 10 harnesses.
+- **`docs/harnesses/hermes.md` + `hermes.pt-BR.md`** — output layout, trust-gate setup (`hermes skills trust` / `skills.trusted_project_dirs`), precedence rules, and headless usage.
+
+### Changed
+
+- **Installer** — `TARGETS` gains `hermes`; `adapterTargetPath()` maps it to `.hermes/skills` (also covers `uninstall`); `.gitignore` block ignores `.hermes/skills/wize-*`; brownfield `baseline.js` detects the `hermes` CLI and runs `hermes -z` headlessly.
+- **Docs** — README (en/pt-BR/es) harness tables and summaries now list **10** IDE targets, with Hermes highlighted as new; `AGENTS.md` (repo + generated template) lists Hermes among the harnesses that read it.
+- **Tests** — adapter emit/companion coverage, structure, `install --yes` full-defaults, and `doctor` path mapping all now include `hermes`.
+
 ## [0.14.0] — 2026-08-31
 
 **`wize-check` — progress checklist with evidence.** A read-only orchestrator skill (owner: Wizer) that answers "where are we, what's done, what's left" mid-session without advancing or re-planning the work. The **evidence rule** is the core: an item only reaches *Done* with a commit, `file:line`, a passed command, a recorded gate, or a merged PR — intent and plans are never evidence. Done condition comes first: if it is not explicit, the skill states the assumed criterion and asks for confirmation instead of inventing a destination. After reporting, it resumes the interrupted work. Modes: default, `now`, `save` (`.wize/implementation/checks/`), `{topic}`. Registered in the orchestrator catalog, the intent routing table (Meta), all 9 harness adapters, READMEs (3 languages) and CHANGELOG. Suite green (539 tests, validate 80 files).

package/DECISIONS.md

@@ -6,7 +6,7 @@
 
 ## Estado
 
-- **Fase atual:** Construído e publicado — manutenção contínua (v0.10.0).
+- **Fase atual:** Entrevista — Discovery
 - **Pasta destino:** `wize-dev-kit/`
 - **Repositório de inspiração:** BMAD Method (raiz deste repo)
 
@@ -136,32 +136,6 @@
 - **D7.5 — Localização das custom:** `.wize/custom/agents/{code}/`, `.wize/custom/skills/{code}/`, `.wize/custom/workflows/{code}/`. Estrutura espelha a do kit core.
 - **D7.6 — Ponto de entrada:** `wize-dev-kit agent create` no CLI + skill nativo `wize-create-agent` chamável pelo Wizer dentro do IDE.
 
-### Fase 8 — Importação de fluxos Steps do BMAD
-
-- **D8.1 — Seleção:** dos fluxos de Steps do BMAD ainda não importados, selecionamos quatro para adaptação imediata:
-  - `bmad-spec` → `wize-spec` (core skill).
-  - `bmad-create-architecture` → `wize-create-architecture` reescrito em 8 steps (micro-file architecture).
-  - `bmad-code-review` → `wize-code-review` reescrito em 4 steps com triagem adversarial.
-  - Research do BMAD (`bmad-market-research`, `bmad-domain-research`, `bmad-technical-research`) → três skills verticais Wize em `src/method-skills/1-analysis/`.
-- **D8.2 — Micro-file architecture:** workflows substituídos por step files auto-contidos em `steps/` ou `{vertical}-steps/`. Cada step controla frontmatter `stepsCompleted` e só avança com confirmação do usuário.
-- **D8.3 — Manter dispatcher genérico:** `wize-research` continua existindo como skill genérico, mas as três vertentes oferecem passos estruturados e templates próprios.
-- **D8.4 — Versionamento dos workflows antigos:** cópias dos `workflow.md` monolíticos de `wize-create-architecture` e `wize-code-review` são arquivadas em `.wize/knowledge/decisions/` para referência, não mantidas em produção.
-- **D8.5 — Registro em catálogos:** skills adicionados a `src/core-skills/module.yaml` e `src/method-skills/module.yaml`; fluxos refletidos no `README.md`.
-
-### Fase 9 — Security Overlay + OpenCode nativo (2026-07-11)
-
-- **D9.1 — Security Overlay neste kit:** o perfil `security-overlay` (AI Pentester) passa a ser distribuído **dentro do `wize-dev-kit`** como 4º perfil opt-in do installer, com a persona **red-teamer** (`wize-sec-red-teamer`) em `src/security-overlay/`. _Supersede parcialmente D1.1 (3 perfis → 4 perfis), D3.2 (9 papéis → 9 core + 1 overlay) e D3.5 (security deixava de ser reservado para kit futuro)._ As entradas históricas permanecem inalteradas como registro.
-- **D9.2 — OpenCode com wiring nativo (0.8.0):** o adapter OpenCode passa a gerar **agents e commands nativos** (`.opencode/agents/` + `.opencode/commands/`), com commands vinculados à persona dona e workers de fan-out isolados — em vez do fallback genérico.
-
-### Fase 10 — Mission contracts, grill, loop e polish (2026-08)
-
-- **D10.1 — Mission contracts (0.9.0):** cada etapa da cadeia passa a operar por um contrato explícito (objetivo, fontes de verdade, escopo & limites, ACs, contratos de execução/validação, persistência em `.wize/`). `/wize-help mission` emite o contrato preenchido a partir do estado do projeto; templates de story ganham campos de contrato (sources of truth, restrictions, validation, done-means). Motivo: modelos de longo horizonte executam melhor com o alvo declarado.
-- **D10.2 — `wize-grill` (0.10.0):** nova skill core de entrevista-até-entendimento antes de qualquer passo de autoria (brief, PRD, epics, stories, planos). Sempre sugestiva, nunca imposta; sem artefato próprio (decisões caem nos campos do artefato alvo). Adaptado do princípio grill-me.
-- **D10.3 — Loop verification + max-cycles guard (0.10.0):** `wize-dev-story` ganha auto-check antes de declarar o loop concluído (evidência de iteração, mapa AC→teste completo, testes verdes) e guarda de ciclo (mesmo AC falhando 3+ vezes → escala para `wize-correct-course`, agora também auto-disparado).
-- **D10.4 — Persona do overlay ganha nome Marvel:** o `red-teamer` passa a ter o nome de exibição **Natasha Romanoff** (espionagem/operação ofensiva sob mandato — casa com o scope-gate do overlay). Mudança **apenas de nome de exibição**: o `code` permanece `wize-sec-red-teamer` (identificador de invocação e diretório dos 9 adapters, estável). "Red-Teamer" fica no `title`. _Deadpool foi avaliado e rejeitado: o nome entra no corpo do SKILL.md como instrução e o personagem é o que mais ignora autorização — conflita com o design de consentimento do overlay._ Remove Black Widow do pool de personas reservadas no `ROSTER.md`.
-- **D10.5 — Correções de tooling/qualidade:** (a) `readYamlField` passa a ler **block scalars** (`description: |`) — antes toda descrição renderizada terminava em `— |` nos 9 adapters; (b) `npm test` deixa de usar glob não-recursivo e passa a rodar também `test/security-overlay/**` (evita 8 testes stale passarem despercebidos); (c) adicionado workflow de **CI** (`ci.yml`) em push/PR (Node 20+24), já que só existia `publish.yml` por tag; (d) roster do `AGENTS.md` gerado passa a ser ordenado deterministicamente e marca a persona opt-in do overlay.
-
 ## Perguntas em aberto
 
 _(serão preenchidas conforme a entrevista avança)_
-

package/README.md

@@ -69,7 +69,7 @@ After install, open your IDE and say:
 
 ## Supported harnesses
 
-All 9 IDE targets render from the same source; format and mechanics differ per harness. **OpenCode** gets the deepest integration — the kit's persona/workflow split maps onto OpenCode's own primitives (`mode: primary|subagent`, `agent:`, `subtask:`) instead of being flattened into one file type.
+All 10 IDE targets render from the same source; format and mechanics differ per harness. **OpenCode** gets the deepest integration — the kit's persona/workflow split maps onto OpenCode's own primitives (`mode: primary|subagent`, `agent:`, `subtask:`) instead of being flattened into one file type.
 
 | Harness | Output | Notable |
 |---|---|---|
@@ -77,6 +77,7 @@ All 9 IDE targets render from the same source; format and mechanics differ per h
 | **Claude Code** | `.claude/skills/*/SKILL.md` | Anthropic Skill format; ad-hoc Task/Agent-tool fan-out (`wize-code-review`). [Docs →](docs/harnesses/claude-code.md) |
 | **Codex** | `.agents/skills/*/SKILL.md` | Same Skill format + root `AGENTS.md`. [Docs →](docs/harnesses/codex.md) |
 | **Kimi Code** | `.kimi/skills/*/SKILL.md` | Same Skill format; auto-detects Claude/Codex skill trees. [Docs →](docs/harnesses/kimi-code.md) |
+| **Hermes Agent** 🆕 | `.hermes/skills/*/SKILL.md` | Same Skill format, project-local; trust gate (`hermes skills trust`); project skills override profile ones. [Docs →](docs/harnesses/hermes.md) |
 | **Antigravity** | `.agent/skills/*/SKILL.md` | Same Skill format + root `AGENTS.md`. [Docs →](docs/harnesses/antigravity.md) |
 | **Cursor** | `.cursor/rules/*.mdc` | On-demand rules (`alwaysApply: false`), matched by description. [Docs →](docs/harnesses/cursor.md) |
 | **Windsurf** | `.windsurf/rules/*.md` | Plain markdown; activation mode set inside the IDE. [Docs →](docs/harnesses/windsurf.md) |
@@ -154,6 +155,9 @@ Cross-cutting:
                                 done (with evidence), in progress, what's left —
                                 then resumes the interrupted work.
     /wize-grill                 Interview-to-understanding before any authoring step.
+    /wize-eli5                  Explain anything to anyone — vocabulary, analogies,
+                                tone, depth and framing calibrated to the audience
+                                (age, role, relationship).
     /wize-quick-dev             Shuri takes a small fix without the full ride.
     /wize-pre-pr-check          Run lint/format/build/unit tests locally before
                                 opening a PR — fail fast, zero CI runner cost.
@@ -250,7 +254,7 @@ npx wize-dev-kit version         # print the installed kit version
 
 ## Status
 
-**v0.12.1 — beta.** The method never produces development estimates — no hours, points, or t-shirt sizes; a story is sized only by whether it fits a single PR. The full lifecycle (analysis → plan → solution → implementation) is wired with 10 agents and a structured skill library. Recent releases add **mission contracts** (`/wize-help mission`), **`wize-grill`** (interview-to-shared-understanding before any authoring step), **`wize-pre-pr-check`** (local lint/format/build/unit-test gate before opening a PR — zero CI runner cost), and **loop verification** in `wize-dev-story` (a self-checking implementation loop with a max-cycles guard that escalates to `wize-correct-course`). The `security-overlay` (AI Pentester) ships a complete pentest pipeline, a stakeholder report (risk score + briefing + AI action plan), and post-scan remediation planning — validated end-to-end against a real Laravel/PHP app. IDE adapters for Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, OpenCode, and Antigravity are regenerated automatically — [OpenCode](docs/harnesses/opencode.md) gets native `mode`/`agent`/`subtask` wiring, the deepest integration of the 9.
+**v0.12.1 — beta.** The method never produces development estimates — no hours, points, or t-shirt sizes; a story is sized only by whether it fits a single PR. The full lifecycle (analysis → plan → solution → implementation) is wired with 10 agents and a structured skill library. Recent releases add **mission contracts** (`/wize-help mission`), **`wize-grill`** (interview-to-shared-understanding before any authoring step), **`wize-pre-pr-check`** (local lint/format/build/unit-test gate before opening a PR — zero CI runner cost), and **loop verification** in `wize-dev-story` (a self-checking implementation loop with a max-cycles guard that escalates to `wize-correct-course`). The `security-overlay` (AI Pentester) ships a complete pentest pipeline, a stakeholder report (risk score + briefing + AI action plan), and post-scan remediation planning — validated end-to-end against a real Laravel/PHP app. IDE adapters for Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, Hermes, OpenCode, and Antigravity are regenerated automatically — [OpenCode](docs/harnesses/opencode.md) gets native `mode`/`agent`/`subtask` wiring, the deepest integration of the 10.
 
 ---
 
@@ -258,6 +262,7 @@ npx wize-dev-kit version         # print the installed kit version
 
 - [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) by Brian (BMad) Madison — agile AI lifecycle, agent personas, installer pattern, module system.
 - [Whiteport Design Studio expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion) — UX-first methodology, Norse pantheon (Saga, Freya), phase structure.
+- [ELI5](https://github.com/dreambigou/eli5) by Andrew Ou — audience-calibrated explanations; the inspiration for `/wize-eli5`.
 
 Wize Development Kit is an **independent adaptation** — not affiliated with or endorsed by BMAD or WDS authors. Marvel persona names are used as creative references under nominative fair use.
 

package/ROSTER.md

@@ -10,24 +10,16 @@
 | 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, validation, sprint planning, sprint status, correct-course, deadline enforcement (epics/stories are Tony's). Style: military discipline, no excuses, outcome-focused. | John (`bmad-agent-pm`) |
+| 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`) |
 
-## Security overlay (opt-in)
-
-Installs only with the `security-overlay` profile.
-
-| # | Persona | Code | Role | Phase | Motto / Style | BMAD equiv. |
-|---|---|---|---|---|---|---|
-| 10 | **Natasha Romanoff** | `wize-sec-red-teamer` | Red-Teamer / AI Pentester | Overlay | "Only what you're authorized to touch." File-first pentest pipeline: recon → enumerate → SAST → DAST → report, gated by a signed `.wize/security/scope.md`. Default passive; exploits opt-in via `--active`; every refusal audited. Hawkeye/TEA validates the overlay's implementation stories. | (new — no BMAD core equivalent) |
-
 ## Notes
 
 - **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.
-- **Overlays add skills, not persona variants.** Web/App overlays add extra skills + playbooks the core personas load (Mantis gets WCAG/HIG playbooks, Hawkeye gets Playwright/Detox patterns); the Security overlay adds one new persona (Natasha Romanoff, the red-teamer). There are no per-profile "variants" of Tony or Shuri in code.
-- **Future Marvel personas (out of dev-kit scope):** Pepper is already Analyst here, Fury is already Strategist, Natasha is the red-teamer. Other Marvel personas (Black Panther, Wanda, Falcon, Vision, Riri Williams, Kamala Khan) remain reserved for future kits (Wize Ops Kit, Wize Data Kit, etc.). The Security overlay's red-teamer already lives in this kit.
+- **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/adapters/README.md

@@ -8,12 +8,12 @@ Each adapter renders the kit's agents/skills/workflows into the file layout that
 |---|---|---|---|
 | `claude-code` | `.claude/skills/wize-*/` | `SKILL.md` per agent/workflow | Default. Uses Claude Code skill folder pattern. |
 | `cursor` | `.cursor/rules/wize-*.mdc` | MDC | Each agent/skill becomes a rule file. |
-| `windsurf` | `.windsurf/rules/wize-*.md` | Markdown | Cascade-friendly. |
-| `codex` | `.agents/skills/wize-*/` | `SKILL.md` per agent/workflow | OpenAI Codex. |
-| `continue` | `.continue/prompts/wize-*.prompt` | `.prompt` | Continue prompt slot. |
-| `kimi-code` | `.kimi/skills/wize-*/` | `SKILL.md` per agent/workflow | Moonshot Kimi Code. |
-| `opencode` | `.opencode/agents/wize-*.md` + `.opencode/commands/wize-*.md` | Markdown | OpenCode CLI. Native agents + commands. |
-| `antigravity` | `.agent/skills/wize-*/` | `SKILL.md` per agent/workflow | Antigravity CLI + IDE. |
+| `windsurf` | `.windsurf/agents/wize-*.md` | Markdown | Cascade-friendly. |
+| `codex` | `.codex/wize-*.md` | Markdown | OpenAI Codex CLI. |
+| `continue` | `.continue/agents/wize-*.md` | Markdown | Continue agent slot. |
+| `kimi-code` | `.kimi/agents/wize-*.md` | Markdown | Moonshot Kimi Code. |
+| `opencode` | `.opencode/agents/wize-*.md` | Markdown | OpenCode CLI. |
+| `antigravity` | `.antigravity/agents/wize-*.md` | Markdown | Antigravity CLI + IDE. |
 | `generic` | `.wize/agents/wize-*.md` | Markdown | Fallback for any agent that can read a folder of markdown. |
 
 ## Adapter shape
@@ -23,4 +23,4 @@ Every adapter is a folder under `adapters/{code}/` with:
 - `render.js` — function `(kitRoot, projectRoot, opts) => void` that emits files.
 - `README.md` — adapter-specific notes.
 
-The shipped adapters emit real files through `render.js`.
+In v0.1 only the descriptors and READMEs are present; `render.js` is a stub printing what it would emit. Wiring is on the v0.2 roadmap.

package/adapters/antigravity/README.md

@@ -1,9 +1,9 @@
 # Adapter — antigravity
 
-Antigravity CLI + IDE skills.
+Antigravity CLI + IDE.
 
-- **Target path:** `.agent/skills/`
-- **File pattern:** `wize-*/SKILL.md`
-- **Format:** Anthropic-compatible `SKILL.md`
+- **Target path:** `.antigravity/agents/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
 
-Renders the Wize skills directly into the folder Antigravity loads at startup.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/claude-code/README.md

@@ -6,4 +6,4 @@ Native Claude Code skills.
 - **File pattern:** `wize-*/SKILL.md`
 - **Format:** markdown
 
-Renders the Wize skills directly into the folder Claude Code loads at startup.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/codex/README.md

@@ -1,9 +1,9 @@
 # Adapter — codex
 
-OpenAI Codex skills.
+OpenAI Codex CLI agents.
 
-- **Target path:** `.agents/skills/`
-- **File pattern:** `wize-*/SKILL.md`
-- **Format:** Anthropic-compatible `SKILL.md`
+- **Target path:** `.codex/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
 
-Renders the Wize skills directly into the folder Codex loads at startup.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/codex/adapter.yaml

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

package/adapters/codex/render.js

@@ -1,4 +1,4 @@
-// OpenAI Codex adapter — emits .agents/skills/wize-{code}/SKILL.md per asset.
+// 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';

package/adapters/continue/README.md

@@ -1,9 +1,9 @@
 # Adapter — continue
 
-Continue prompt files.
+Continue agent slot.
 
-- **Target path:** `.continue/prompts/`
-- **File pattern:** `wize-*.prompt`
-- **Format:** Continue `.prompt` (markdown with frontmatter)
+- **Target path:** `.continue/agents/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
 
-Renders each Wize agent/skill/workflow as a prompt file that Continue loads.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/cursor/README.md

@@ -4,6 +4,6 @@ Cursor MDC rules.
 
 - **Target path:** `.cursor/rules/`
 - **File pattern:** `wize-*.mdc`
-- **Format:** MDC (markdown with frontmatter)
+- **Format:** markdown
 
-Renders each Wize agent/skill/workflow as an MDC rule file that Cursor picks up automatically.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/generic/README.md

@@ -6,4 +6,4 @@ Generic markdown fallback for any AI agent runtime that can read a folder of mar
 - **File pattern:** `wize-*.md`
 - **Format:** markdown
 
-Renders each Wize agent/skill/workflow as a plain markdown file that any runtime can read.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/kimi-code/README.md

@@ -1,9 +1,9 @@
 # Adapter — kimi-code
 
-Moonshot Kimi Code skills.
+Moonshot Kimi Code agents.
 
-- **Target path:** `.kimi/skills/`
-- **File pattern:** `wize-*/SKILL.md`
-- **Format:** Anthropic-compatible `SKILL.md`
+- **Target path:** `.kimi/agents/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
 
-Renders the Wize skills directly into the folder Kimi Code loads at startup.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/kimi-code/render.js

@@ -1,7 +1,7 @@
 // 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 .agents/skills/ (Codex), so installing
-// alongside those adapters is harmless.
+// auto-detects .claude/skills/ and .codex/skills/, so installing alongside
+// those adapters is harmless.
 
 'use strict';
 

package/adapters/opencode/README.md

@@ -1,9 +1,9 @@
 # Adapter — opencode
 
-OpenCode CLI native agents and commands.
+OpenCode CLI agents.
 
-- **Target paths:** `.opencode/agents/` and `.opencode/commands/`
+- **Target path:** `.opencode/agents/`
 - **File pattern:** `wize-*.md`
 - **Format:** markdown
 
-Renders each Wize agent as a native OpenCode agent in `.opencode/agents/` and each skill/workflow as a command in `.opencode/commands/`, bound to its owning persona.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/opencode/render.js

@@ -2,10 +2,7 @@
 //   - .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, agent (derived from the source's
-//   `owner:` field, when it resolves to a known persona), subtask (from the
-//   source's `subtask: true`, for skills meant to run isolated regardless of
-//   which agent invokes them — e.g. the wize-code-review fan-out workers)
+// Frontmatter (commands): description, template (the prompt body)
 // Reference: https://opencode.ai/docs/agents/ + /docs/commands/
 
 'use strict';
@@ -14,30 +11,10 @@ const fs = require('node:fs');
 const path = require('node:path');
 const { collectAssets, escapeYamlDouble, clipOneLine, ensureDir } = require('../../tools/installer/render-shared.js');
 
-// `owner:` in workflow/skill frontmatter is written for humans (agent code,
-// display name, "X + Y" pairings, trailing "# comment"). Resolve it to a
-// single known agent code, or null if it doesn't clearly name one (e.g.
-// builder-skills' `owner: builder`, which isn't a persona).
-function resolveOwnerAgentCode(ownerRaw, agents) {
-  if (!ownerRaw) return null;
-  const withoutComment = ownerRaw.split('#')[0].trim();
-  const primary = withoutComment.split(/\s*\+\s*|,/)[0].trim();
-  if (!primary) return null;
-  const byCode = agents.find(a => a.code === primary);
-  if (byCode) return byCode.code;
-  const lower = primary.toLowerCase();
-  const byName = agents.find(a => {
-    const name = a.name.toLowerCase();
-    return name === lower || name.includes(lower) || lower.includes(name.split(' ')[0]);
-  });
-  return byName ? byName.code : null;
-}
-
 function render(kitRoot, projectRoot, opts = {}) {
   const agentsDir = path.join(projectRoot, '.opencode', 'agents');
   const commandsDir = path.join(projectRoot, '.opencode', 'commands');
   const assets = collectAssets(kitRoot, opts);
-  const agents = assets.filter(a => a.kind === 'agent');
   const written = [];
 
   if (!opts.dryRun) {
@@ -69,12 +46,9 @@ function render(kitRoot, projectRoot, opts = {}) {
     } else {
       // workflow or skill → command
       const desc = clipOneLine(a.description, 180);
-      const agentCode = resolveOwnerAgentCode(a.owner, agents);
       const content = [
         '---',
         `description: "${escapeYamlDouble(desc)}"`,
-        ...(agentCode ? [`agent: ${agentCode}`] : []),
-        ...(a.subtask ? ['subtask: true'] : []),
         '---',
         '',
         `# ${a.name}`,

package/adapters/windsurf/README.md

@@ -1,9 +1,9 @@
 # Adapter — windsurf
 
-Windsurf Cascade-friendly markdown rules.
+Windsurf Cascade-friendly markdown agents.
 
-- **Target path:** `.windsurf/rules/`
+- **Target path:** `.windsurf/agents/`
 - **File pattern:** `wize-*.md`
 - **Format:** markdown
 
-Renders each Wize agent/skill/workflow as a rules file that Windsurf Cascade loads.
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/package.json

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

package/schemas/agent.schema.json

@@ -6,12 +6,12 @@
   "required": ["code", "name", "title", "module", "description"],
   "additionalProperties": true,
   "properties": {
-    "code": { "type": "string", "pattern": "^wize-(agent|orchestrator|sec)-[a-z0-9-]+$|^wize-orchestrator$" },
+    "code": { "type": "string", "pattern": "^wize-(agent|orchestrator)-[a-z0-9-]+$|^wize-orchestrator$" },
     "name": { "type": "string", "minLength": 1 },
     "title": { "type": "string", "minLength": 1 },
     "icon": { "type": "string" },
     "team": { "type": "string" },
-    "module": { "enum": ["orchestrator", "method", "tea", "builder", "core", "web-overlay", "app-overlay", "security-overlay", "custom"] },
+    "module": { "enum": ["orchestrator", "method", "tea", "builder", "core", "web-overlay", "app-overlay", "custom"] },
     "phase": { "type": "string" },
     "description": { "type": "string", "minLength": 10 },
     "style": {