wize-dev-kit 0.7.3 → 0.8.1

package/adapters/windsurf/README.md

@@ -1,9 +1,9 @@
 # Adapter — windsurf
 
-Windsurf Cascade-friendly markdown agents.
+Windsurf Cascade-friendly markdown rules.
 
-- **Target path:** `.windsurf/agents/`
+- **Target path:** `.windsurf/rules/`
 - **File pattern:** `wize-*.md`
 - **Format:** markdown
 
-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.
+Renders each Wize agent/skill/workflow as a rules file that Windsurf Cascade loads.

package/docs/harnesses/antigravity.md

@@ -0,0 +1,20 @@
+# Google Antigravity — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](antigravity.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+Antigravity uses the same public Anthropic Skill format as Claude Code and Codex.
+
+## Output
+
+- `.agent/skills/wize-{code}/SKILL.md` — note the **singular** `.agent`, not `.agents` (that's Codex's directory).
+- A root `AGENTS.md` (shared with Codex, Cursor, and Windsurf).
+
+## Notable
+
+- `.antigravitycli/` is Antigravity's own CLI state directory and is never touched by the kit — only `.agent/skills/` and `AGENTS.md` are written.
+
+## Setup
+
+Pick **Antigravity** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Antigravity, then run `/wize-orchestrator` or ask it to read `AGENTS.md`.

package/docs/harnesses/antigravity.pt-BR.md

@@ -0,0 +1,20 @@
+# Google Antigravity — Wize Development Kit
+
+🌐 **Idiomas:** [English](antigravity.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+O Antigravity usa o mesmo formato público de Skill da Anthropic que o Claude Code e o Codex.
+
+## Saída
+
+- `.agent/skills/wize-{code}/SKILL.md` — repare no **singular** `.agent`, não `.agents` (esse é o diretório do Codex).
+- Um `AGENTS.md` na raiz (compartilhado com Codex, Cursor e Windsurf).
+
+## Destaques
+
+- `.antigravitycli/` é o diretório de estado do próprio CLI do Antigravity e nunca é tocado pelo kit — só `.agent/skills/` e `AGENTS.md` são gravados.
+
+## Como ativar
+
+Escolha **Antigravity** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Antigravity e rode `/wize-orchestrator` ou peça pra ele ler o `AGENTS.md`.

package/docs/harnesses/claude-code.md

@@ -0,0 +1,23 @@
+# Claude Code — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](claude-code.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+Claude Code was the kit's first target and uses the public Anthropic Skill format verbatim.
+
+## Output
+
+`.claude/skills/wize-{code}/SKILL.md` — one directory per asset (persona, workflow, or skill). YAML frontmatter (`name`, `description`) plus the Markdown body. Companion files a workflow references by relative path (`steps/`, `templates/`, `data/`, `customize.toml`, ...) are copied alongside the `SKILL.md` so those paths resolve.
+
+There is no separate "agent" file shape here — personas (Wizer, Shuri, Hawkeye...) and workflows/skills all render to the same `SKILL.md` structure.
+
+## Notable
+
+- **Discovery is description-based.** Claude Code surfaces installed skills by matching the task at hand against each `description`; you can also invoke one directly by name (`/wize-dev-story`) or ask to "activate Wizer."
+- **Subagent fan-out is ad hoc, not persona-bound.** `wize-code-review` uses Claude Code's own Task/Agent tool to spin up isolated, parallel workers (Blind Hunter, Edge Case Hunter, Acceptance Auditor) for a single review pass. Any skill can do this — it isn't wired to a specific `.claude/agents/*.md` subagent definition, since the kit doesn't emit one.
+- Claude Code does **not** read the root `AGENTS.md` the installer generates (that file is for Codex, Cursor, Windsurf, and Antigravity).
+
+## Setup
+
+Pick **Claude Code** as an IDE target during `npx wize-dev-kit install` (default). Restart Claude Code, then say *"Activate Wizer and brief him on the project"* or run `/wize-orchestrator`.

package/docs/harnesses/claude-code.pt-BR.md

@@ -0,0 +1,23 @@
+# Claude Code — Wize Development Kit
+
+🌐 **Idiomas:** [English](claude-code.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+Claude Code foi o primeiro alvo do kit e usa o formato público de Skill da Anthropic ao pé da letra.
+
+## Saída
+
+`.claude/skills/wize-{code}/SKILL.md` — um diretório por asset (persona, workflow ou skill). Frontmatter YAML (`name`, `description`) mais o corpo em Markdown. Arquivos complementares que um workflow referencia por caminho relativo (`steps/`, `templates/`, `data/`, `customize.toml`, ...) são copiados junto do `SKILL.md` para que esses caminhos resolvam.
+
+Não existe um formato separado de "agente" aqui — personas (Wizer, Shuri, Hawkeye...) e workflows/skills viram todos a mesma estrutura de `SKILL.md`.
+
+## Destaques
+
+- **Descoberta por descrição.** O Claude Code encontra as skills instaladas casando a tarefa em mãos contra cada `description`; também dá pra invocar direto pelo nome (`/wize-dev-story`) ou pedir pra "ativar o Wizer".
+- **Fan-out de subagentes é ad hoc, não amarrado a persona.** O `wize-code-review` usa a própria ferramenta Task/Agent do Claude Code pra levantar workers isolados e paralelos (Blind Hunter, Edge Case Hunter, Acceptance Auditor) numa única passada de review. Qualquer skill pode fazer isso — não está amarrado a uma definição de subagente `.claude/agents/*.md`, já que o kit não gera nenhuma.
+- O Claude Code **não** lê o `AGENTS.md` na raiz que o instalador gera (esse arquivo é pro Codex, Cursor, Windsurf e Antigravity).
+
+## Como ativar
+
+Escolha **Claude Code** como alvo de IDE em `npx wize-dev-kit install` (padrão). Reinicie o Claude Code e diga *"Ative o Wizer e dê o briefing do projeto a ele"* ou rode `/wize-orchestrator`.

package/docs/harnesses/codex.md

@@ -0,0 +1,21 @@
+# OpenAI Codex — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](codex.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+Codex shares the same Anthropic Skill format as Claude Code and Kimi Code.
+
+## Output
+
+- `.agents/skills/wize-{code}/SKILL.md` — one directory per persona, workflow, or skill.
+- A root `AGENTS.md` (shared with Cursor, Windsurf, and Antigravity) listing the roster and pointing at `wize-orchestrator` as the entry point.
+
+## Notable
+
+- `.agents/skills/` is Codex's documented path for repository-local skills — the kit writes there directly, not to a Codex-specific directory.
+- **History:** 0.7.2 briefly moved this output to `.codex/skills/`, which broke skill loading in real Codex sessions; 0.7.3 reverted it to `.agents/skills/`. If you're on an older install, run `npx wize-dev-kit update` to fix the path.
+
+## Setup
+
+Pick **Codex** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Codex, then run `/wize-orchestrator` or ask it to read `AGENTS.md`.

package/docs/harnesses/codex.pt-BR.md

@@ -0,0 +1,21 @@
+# OpenAI Codex — Wize Development Kit
+
+🌐 **Idiomas:** [English](codex.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+O Codex usa o mesmo formato de Skill da Anthropic que o Claude Code e o Kimi Code.
+
+## Saída
+
+- `.agents/skills/wize-{code}/SKILL.md` — um diretório por persona, workflow ou skill.
+- Um `AGENTS.md` na raiz (compartilhado com Cursor, Windsurf e Antigravity) listando o elenco e apontando pro `wize-orchestrator` como ponto de entrada.
+
+## Destaques
+
+- `.agents/skills/` é o caminho documentado do Codex pra skills locais do repositório — o kit grava lá diretamente, não num diretório específico do Codex.
+- **Histórico:** a 0.7.2 moveu essa saída, por um breve período, para `.codex/skills/`, o que quebrou o carregamento das skills em sessões reais do Codex; a 0.7.3 reverteu para `.agents/skills/`. Se sua instalação é antiga, rode `npx wize-dev-kit update` pra corrigir o caminho.
+
+## Como ativar
+
+Escolha **Codex** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Codex e rode `/wize-orchestrator` ou peça pra ele ler o `AGENTS.md`.

package/docs/harnesses/continue.md

@@ -0,0 +1,21 @@
+# Continue.dev — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](continue.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+## Output
+
+`.continue/prompts/wize-{code}.prompt` — one file per persona, workflow, or skill.
+
+## Notable
+
+- Frontmatter: `name`, `description`, `invokable: true`. The `invokable` flag is what registers the file as a slash command in Continue's palette instead of a passive context document.
+
+## Setup
+
+Pick **Continue** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Reload the Continue extension, then run `/wize-orchestrator` from the prompt palette.
+
+## Reference
+
+- [docs.continue.dev — Prompts](https://docs.continue.dev/customize/deep-dives/prompts)

package/docs/harnesses/continue.pt-BR.md

@@ -0,0 +1,21 @@
+# Continue.dev — Wize Development Kit
+
+🌐 **Idiomas:** [English](continue.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+## Saída
+
+`.continue/prompts/wize-{code}.prompt` — um arquivo por persona, workflow ou skill.
+
+## Destaques
+
+- Frontmatter: `name`, `description`, `invokable: true`. É a flag `invokable` que registra o arquivo como slash command na paleta do Continue, em vez de um documento de contexto passivo.
+
+## Como ativar
+
+Escolha **Continue** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Recarregue a extensão do Continue e rode `/wize-orchestrator` na paleta de prompts.
+
+## Referência
+
+- [docs.continue.dev — Prompts](https://docs.continue.dev/customize/deep-dives/prompts)

package/docs/harnesses/cursor.md

@@ -0,0 +1,22 @@
+# Cursor — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](cursor.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+## Output
+
+`.cursor/rules/wize-{code}.mdc` — one rule per persona, workflow, or skill.
+
+## Notable
+
+- Frontmatter: `description`, `globs` (empty — not file-pattern-triggered), `alwaysApply: false`. Every wize-dev-kit rule attaches **on demand**, matched by Cursor against its `description`, rather than being injected into every prompt.
+- No native agent/subagent split in this format — personas and workflows/skills share the same `.mdc` shape (unlike [OpenCode](opencode.md)).
+
+## Setup
+
+Pick **Cursor** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Cursor, then reference `@wize-orchestrator` or ask it to activate Wizer.
+
+## Reference
+
+- [cursor.com/docs/context/rules](https://cursor.com/docs/context/rules)

package/docs/harnesses/cursor.pt-BR.md

@@ -0,0 +1,22 @@
+# Cursor — Wize Development Kit
+
+🌐 **Idiomas:** [English](cursor.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+## Saída
+
+`.cursor/rules/wize-{code}.mdc` — uma rule por persona, workflow ou skill.
+
+## Destaques
+
+- Frontmatter: `description`, `globs` (vazio — não é disparado por padrão de arquivo), `alwaysApply: false`. Toda rule do wize-dev-kit se anexa **sob demanda**, casada pelo Cursor contra sua `description`, em vez de ser injetada em todo prompt.
+- Sem divisão nativa agente/subagente nesse formato — personas e workflows/skills compartilham o mesmo formato `.mdc` (diferente do [OpenCode](opencode.pt-BR.md)).
+
+## Como ativar
+
+Escolha **Cursor** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Cursor e referencie `@wize-orchestrator` ou peça pra ativar o Wizer.
+
+## Referência
+
+- [cursor.com/docs/context/rules](https://cursor.com/docs/context/rules)

package/docs/harnesses/generic.md

@@ -0,0 +1,20 @@
+# Generic fallback — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](generic.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+For any AI IDE that isn't one of the [dedicated targets](../../README.md#supported-harnesses).
+
+## Output
+
+- `.wize/agents/wize-{code}.md` — plain Markdown per persona, workflow, or skill: a heading, a one-line summary blockquote, and the body. No frontmatter, no slash-command wiring.
+- A root `AGENTS.md` — the same baseline pointer file also read natively by Codex, Cursor, Windsurf, and Antigravity. It is never overwritten if one already exists in the repo.
+
+## Notable
+
+- This target has no activation mechanism of its own — you point your assistant at `.wize/agents/wize-orchestrator.md` (or `AGENTS.md`) and ask it to read and follow it.
+
+## Setup
+
+Pick **Generic fallback** as an IDE target during `npx wize-dev-kit install` — it's on by default alongside your primary target, precisely so an unsupported second tool in the same repo still has something to read.

package/docs/harnesses/generic.pt-BR.md

@@ -0,0 +1,20 @@
+# Fallback genérico — Wize Development Kit
+
+🌐 **Idiomas:** [English](generic.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+Para qualquer IDE com IA que não esteja entre os [alvos dedicados](../../README.pt-BR.md#harnesses-suportadas).
+
+## Saída
+
+- `.wize/agents/wize-{code}.md` — Markdown puro por persona, workflow ou skill: um título, um resumo de uma linha em bloco de citação, e o corpo. Sem frontmatter, sem integração de slash command.
+- Um `AGENTS.md` na raiz — o mesmo arquivo-ponteiro de baseline lido nativamente por Codex, Cursor, Windsurf e Antigravity. Nunca é sobrescrito se já existir um no repositório.
+
+## Destaques
+
+- Esse alvo não tem mecanismo de ativação próprio — você aponta seu assistente pra `.wize/agents/wize-orchestrator.md` (ou `AGENTS.md`) e pede pra ele ler e seguir.
+
+## Como ativar
+
+Escolha **Fallback genérico** como alvo de IDE em `npx wize-dev-kit install` — ele já vem ligado por padrão junto do seu alvo principal, justamente pra que uma segunda ferramenta sem suporte dedicado no mesmo repositório ainda tenha algo pra ler.

package/docs/harnesses/kimi-code.md

@@ -0,0 +1,19 @@
+# Kimi Code — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](kimi-code.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+Moonshot's Kimi Code consumes the same public Anthropic Skill format as Claude Code and Codex.
+
+## Output
+
+`.kimi/skills/wize-{code}/SKILL.md` — one directory per persona, workflow, or skill, with companion files (`steps/`, `templates/`, `data/`) copied alongside.
+
+## Notable
+
+- Kimi Code also auto-detects `.claude/skills/` and `.agents/skills/` (Codex) if present in the repo, so installing the **Kimi Code** target alongside **Claude Code** and/or **Codex** is harmless — Kimi just has more places to find the same skills.
+
+## Setup
+
+Pick **Kimi Code** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Kimi Code, then run `/wize-orchestrator`.

package/docs/harnesses/kimi-code.pt-BR.md

@@ -0,0 +1,19 @@
+# Kimi Code — Wize Development Kit
+
+🌐 **Idiomas:** [English](kimi-code.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+O Kimi Code, da Moonshot, consome o mesmo formato público de Skill da Anthropic usado pelo Claude Code e pelo Codex.
+
+## Saída
+
+`.kimi/skills/wize-{code}/SKILL.md` — um diretório por persona, workflow ou skill, com arquivos complementares (`steps/`, `templates/`, `data/`) copiados junto.
+
+## Destaques
+
+- O Kimi Code também autodetecta `.claude/skills/` e `.agents/skills/` (Codex) se existirem no repositório, então instalar o alvo **Kimi Code** junto com **Claude Code** e/ou **Codex** é inofensivo — o Kimi só passa a ter mais lugares onde achar as mesmas skills.
+
+## Como ativar
+
+Escolha **Kimi Code** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Kimi Code e rode `/wize-orchestrator`.

package/docs/harnesses/opencode.md

@@ -0,0 +1,31 @@
+# OpenCode — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](opencode.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+OpenCode is the harness where the kit's persona/workflow split maps onto a **native** primitive instead of being flattened to one file type. Everywhere else, "agent" and "workflow" both become the same kind of file; on OpenCode they become two different things OpenCode itself understands.
+
+## Output
+
+`npx wize-dev-kit sync` (or `install`) writes two trees:
+
+- `.opencode/agents/wize-{code}.md` — the 10 personas (Wizer, Pepper, Shuri, Hawkeye...).
+- `.opencode/commands/wize-{code}.md` — the workflows and skills (`/wize-dev-story`, `/wize-code-review`, ...).
+
+## Notable
+
+- **`mode: primary | subagent`.** Only `wize-orchestrator` (Wizer) is `primary`. Every other persona is `subagent` — addressable directly with `@wize-agent-dev`, or delegated to automatically based on its `description`.
+- **`agent:` on commands.** Each workflow/skill's `owner:` frontmatter (e.g. `owner: wize-agent-dev # Shuri`) is resolved against the installed personas, so `/wize-dev-story` runs under Shuri's system prompt instead of whatever agent happened to be active. Commands with no clear owner (the Agent Builder skills) are left unbound.
+- **`subtask: true` on fan-out workers.** `wize-review-adversarial` and `wize-review-edge-case-hunter` — the two named subagent workers `wize-code-review` dispatches in parallel — are marked `subtask: true`, so OpenCode isolates them from the caller's context regardless of who invokes them.
+
+This is also the harness the kit's own subagent fan-out pattern (documented in Wizer's persona) is written against: name each worker, scope its context, dispatch on `mode: subagent` / `subtask: true`, tolerate partial failure.
+
+## Setup
+
+Pick **OpenCode** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart OpenCode, then say *"Activate Wizer and brief him on the project"* or run `/wize-orchestrator`.
+
+## Reference
+
+- [opencode.ai/docs/agents](https://opencode.ai/docs/agents/)
+- [opencode.ai/docs/commands](https://opencode.ai/docs/commands/)

package/docs/harnesses/opencode.pt-BR.md

@@ -0,0 +1,31 @@
+# OpenCode — Wize Development Kit
+
+🌐 **Idiomas:** [English](opencode.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+OpenCode é a harness onde a divisão persona/workflow do kit mapeia para uma primitiva **nativa**, em vez de ser achatada num único tipo de arquivo. Em todo o resto, "agente" e "workflow" viram o mesmo tipo de arquivo; no OpenCode eles viram duas coisas diferentes que o próprio OpenCode entende.
+
+## Saída
+
+`npx wize-dev-kit sync` (ou `install`) grava duas árvores:
+
+- `.opencode/agents/wize-{code}.md` — as 10 personas (Wizer, Pepper, Shuri, Hawkeye...).
+- `.opencode/commands/wize-{code}.md` — os workflows e skills (`/wize-dev-story`, `/wize-code-review`, ...).
+
+## Destaques
+
+- **`mode: primary | subagent`.** Só o `wize-orchestrator` (Wizer) é `primary`. Toda outra persona é `subagent` — endereçável direto com `@wize-agent-dev`, ou delegada automaticamente com base na `description`.
+- **`agent:` nos commands.** O campo `owner:` de cada workflow/skill (ex.: `owner: wize-agent-dev # Shuri`) é resolvido contra as personas instaladas, então `/wize-dev-story` roda sob o system prompt da Shuri em vez do agente que estava ativo. Commands sem um dono claro (as skills do Agent Builder) ficam sem vínculo.
+- **`subtask: true` nos workers de fan-out.** `wize-review-adversarial` e `wize-review-edge-case-hunter` — os dois workers nomeados que o `wize-code-review` dispara em paralelo — vêm marcados como `subtask: true`, então o OpenCode os isola do contexto de quem invocou, não importa quem seja.
+
+Esta também é a harness contra a qual o padrão de fan-out de subagentes do kit (documentado na persona da Wizer) foi escrito: nomear cada worker, escopar seu contexto, despachar via `mode: subagent` / `subtask: true`, tolerar falha parcial.
+
+## Como ativar
+
+Escolha **OpenCode** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o OpenCode e diga *"Ative o Wizer e dê o briefing do projeto a ele"* ou rode `/wize-orchestrator`.
+
+## Referência
+
+- [opencode.ai/docs/agents](https://opencode.ai/docs/agents/)
+- [opencode.ai/docs/commands](https://opencode.ai/docs/commands/)

package/docs/harnesses/windsurf.md

@@ -0,0 +1,22 @@
+# Windsurf (Codeium) — Wize Development Kit
+
+🌐 **Languages:** **English** · [Português (pt-BR)](windsurf.pt-BR.md)
+
+← [Back to README](../../README.md)
+
+## Output
+
+`.windsurf/rules/wize-{code}.md` — plain Markdown, no frontmatter: a heading, a one-line summary blockquote, and the full body.
+
+## Notable
+
+- Windsurf's Cascade reads everything under `.windsurf/rules/` at session start. Activation mode (always-on, manual, model-decided, glob) is configured **inside the IDE's Rules panel** per file — the kit doesn't encode it, since Windsurf's rule format has no frontmatter for it.
+- Same flattening as Cursor: no agent/workflow distinction in the file format.
+
+## Setup
+
+Pick **Windsurf** as an IDE target during `npx wize-dev-kit install` (or add it and re-run `npx wize-dev-kit sync`). Restart Windsurf, review the new rules under **Cascade → Rules**, then ask it to activate Wizer.
+
+## Reference
+
+- [docs.windsurf.com — Cascade rules](https://docs.windsurf.com/windsurf/cascade/memories#rules)

package/docs/harnesses/windsurf.pt-BR.md

@@ -0,0 +1,22 @@
+# Windsurf (Codeium) — Wize Development Kit
+
+🌐 **Idiomas:** [English](windsurf.md) · **Português (pt-BR)**
+
+← [Voltar ao README](../../README.pt-BR.md)
+
+## Saída
+
+`.windsurf/rules/wize-{code}.md` — Markdown puro, sem frontmatter: um título, um resumo de uma linha em bloco de citação, e o corpo completo.
+
+## Destaques
+
+- O Cascade do Windsurf lê tudo dentro de `.windsurf/rules/` no início da sessão. O modo de ativação (sempre ativo, manual, decidido pelo modelo, por glob) é configurado **dentro do painel de Rules da IDE**, por arquivo — o kit não codifica isso, já que o formato de rule do Windsurf não tem frontmatter pra isso.
+- Mesmo achatamento do Cursor: sem distinção agente/workflow no formato do arquivo.
+
+## Como ativar
+
+Escolha **Windsurf** como alvo de IDE em `npx wize-dev-kit install` (ou adicione depois e rode `npx wize-dev-kit sync`). Reinicie o Windsurf, confira as novas rules em **Cascade → Rules**, e peça pra ativar o Wizer.
+
+## Referência
+
+- [docs.windsurf.com — Cascade rules](https://docs.windsurf.com/windsurf/cascade/memories#rules)

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wize-dev-kit",
-  "version": "0.7.3",
+  "version": "0.8.1",
   "description": "Full-lifecycle AI-assisted development kit with Test Architect and Whiteport Design Studio embedded. Inspired by BMAD Method and WDS.",
   "keywords": [
     "ai",
@@ -42,6 +42,7 @@
     "adapters/",
     "tools/",
     "schemas/",
+    "docs/",
     "README.md",
     "README.pt-BR.md",
     "README.es.md",

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)-[a-z0-9-]+$|^wize-orchestrator$" },
+    "code": { "type": "string", "pattern": "^wize-(agent|orchestrator|sec)-[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", "custom"] },
+    "module": { "enum": ["orchestrator", "method", "tea", "builder", "core", "web-overlay", "app-overlay", "security-overlay", "custom"] },
     "phase": { "type": "string" },
     "description": { "type": "string", "minLength": 10 },
     "style": {

package/schemas/workflow.schema.json

@@ -11,7 +11,7 @@
     "phase": { "type": "string" },
     "owner": { "type": "string" },
     "absorbs": { "type": "string" },
-    "overlay": { "enum": ["web", "app"] },
+    "overlay": { "enum": ["web", "app", "security"] },
     "status": { "enum": ["stub", "draft", "ready", "stable"] },
     "gate": { "enum": ["risk", "design", "trace", "nfr", "review", "gate"] },
     "when": { "type": "string" }

package/src/core-skills/wize-review-adversarial/skill.md

@@ -3,6 +3,7 @@ code: wize-review-adversarial
 name: Adversarial Review
 module: core
 status: stub
+subtask: true
 ---
 
 # Adversarial Review

package/src/core-skills/wize-review-edge-case-hunter/skill.md

@@ -3,6 +3,7 @@ code: wize-review-edge-case-hunter
 name: Edge Case Hunter
 module: core
 status: ready
+subtask: true
 ---
 
 # Edge Case Hunter

package/src/method-skills/4-implementation/wize-agent-dev/persona.md

@@ -12,6 +12,18 @@ I am **Shuri**. Wakandan technologist. I implement the story Tony wrote, against
 4. **Security & perf.** I think about both at write-time, not at review-time.
 5. **Commit with AC IDs.** Every commit cites the story acceptance criteria it advances.
 
+## Before I write new code (the reuse ladder)
+
+At the "green" step, before typing a new function, I walk this ladder in order and stop at the first "yes":
+
+1. **Does this need to exist?** → no: skip it (YAGNI).
+2. **Already in this codebase?** → reuse it, don't rewrite it.
+3. **Does the stdlib do it?** → use the stdlib.
+4. **Native platform/framework feature?** → use that.
+5. **An installed dependency does it?** → use the dependency.
+6. **Is it one line?** → write the one line.
+7. **Only then** do I write the minimum new code that makes the test pass.
+
 ## Style
 
 - File paths, AC IDs, commit-message brevity.

package/src/method-skills/4-implementation/wize-code-review/steps/step-02-review.md

@@ -14,6 +14,8 @@ failed_layers: ''
 
 ## Instructions
 
+This step is an instance of Wizer's subagent fan-out pattern (see `wize-orchestrator` persona): name, scope, dispatch on whatever the current harness natively supports, tolerate partial failure.
+
 1. If `{review_mode}` = `"no-spec"`, note: "Acceptance Auditor skipped — no spec file provided."
 
 2. Launch parallel subagents without conversation context:

package/src/method-skills/4-implementation/wize-dev-story/workflow.md

@@ -48,7 +48,7 @@ test('valid email returns ok', () => {
 
 ### 4. Green
 
-Write the **minimum** code that turns the test green. No anticipated branches; no "just-in-case" handling.
+Before writing anything new, run Shuri's reuse ladder (see `wize-agent-dev` persona): does this need to exist → already in the codebase → stdlib → native/framework feature → installed dependency → one-liner → only then new code. Write the **minimum** code that turns the test green. No anticipated branches; no "just-in-case" handling.
 
 ```ts
 // green — minimum to pass

package/src/method-skills/4-implementation/wize-quick-dev/workflow.md

@@ -61,7 +61,7 @@ What changes, why, and what could break. If the paragraph is hard to write, you'
 ### 2. Implement
 
 - TDD when reasonable; smoke-test-and-fix when the cost of TDD is greater than the value.
-- Reuse existing components. Don't introduce new abstractions.
+- Run Shuri's reuse ladder (see `wize-agent-dev` persona) before writing anything new: does this need to exist → already in the codebase → stdlib → native/framework feature → installed dependency → one-liner → only then new code. Don't introduce new abstractions.
 
 ### 3. Hawkeye lite