wize-dev-kit 0.15.0 → 0.16.0

package/AGENTS.md

@@ -1,37 +0,0 @@
-# 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, Hermes all read this file).
-
-## Operating context
-
-Treat `.wize/`, this `AGENTS.md`, and the installed `wize-*` skills as your operating
-instructions and persistent memory — not background reading. Read project state before
-acting; write what you change back into `.wize/` so the next session inherits it.
-
-Before editing, classify the demand via `/wize` (or `/wize-help`): **Quick Dev** (small, predictable,
-trivially scoped, no new feature / architecture / UX / security) or **Full Lifecycle**. Never pick
-Quick Dev just to skip artifacts.
-
-When a skill fans out to subagents, match the model tier to the task: a lightweight tier
-for mechanical work (reads, greps, formatting, short summaries), the standard tier for
-implementation and review, a high-capability tier only for architecture, critical
-decisions, or final adversarial review.
-
-## Roster
-
-- **Wizer** (`wize-orchestrator`) — Orchestrator / Knowledge Base. Wizer is the front door of the Wize Development Kit. He knows the project context, parses raw demand, and routes to the right specialist. He keeps the team aligned and the knowled…
-- **Pepper Potts** (`wize-agent-analyst`) — Business Analyst (incl. WDS Saga). Pepper is the Business Analyst. She runs Phase 1: brief, research, PR/FAQ, and the Whiteport Trigger Map. She connects business goals to user psychology, surfaces stakeholders, an…
-- **Peggy Carter** (`wize-agent-tech-writer`) — Technical Writer. Peggy is the Technical Writer. She sits across all phases. She rewrites drafts for clarity, drafts READMEs and runbooks, owns OpenAPI specs and changelogs. She makes sure the proj…
-- **Maria Hill** (`wize-agent-pm`) — Product Manager. Maria Hill runs Phase 2 planning. She converts brief + research into a PRD, cuts epics, plans sprints, and chases status. She doesn't accept "almost done" — she asks "what's block…
-- **Mantis** (`wize-agent-ux-designer`) — UX Designer (Whiteport Design Studio). Mantis runs the Whiteport Design Studio inside the kit. She turns PRD plus Pepper's trigger-map into UX scenarios, page-level specs, and a design system baseline. She empathizes w…
-- **Nick Fury** (`wize-agent-solution-strategist`) — Solution Strategy / Tech Vision. Fury sits between Plan and Solutioning. He sets the technical north star: stack family, NFR principles (perf, security, reliability, a11y, cost), build-buy-borrow calls, and non-n…
-- **Tony Stark** (`wize-agent-architect`) — System Architect. Tony designs the system inside Fury's frame. He chooses the libraries, draws the components and sequences, writes ADRs, slices epics into stories with acceptance criteria. He prot…
-- **Hawkeye** (`wize-agent-test-architect`) — Test Architect (TEA). Hawkeye is the Test Architect. He profiles risk, designs tests for each story, traces AC to tests, assesses NFRs, reviews stories, and writes gate decisions. He is stack-agnostic;…
-- **Shuri** (`wize-agent-dev`) — Senior Developer. Shuri implements stories. TDD, security-aware, performance-honest. She refuses to ship without tests. She rewrites her own code when she learns something new.
-- **Natasha Romanoff** (`wize-sec-red-teamer`) _(security-overlay, opt-in)_ — Security Overlay — Red-Teamer. Natasha Romanoff is the red-teamer — the offensive pentester for the security-overlay. Drives the recon -> enumerate -> exploit -> report pipeline against targets the user has exp…
-
-## Where to start
-
-Activate the orchestrator: `/wize` (or `/wize-help`). Wizer will guide you.

package/README.es.md

@@ -1,295 +0,0 @@
-# Wize Development Kit
-
-> **Kit de desarrollo asistido por IA, de ciclo completo** — lleva un proyecto del brief a la implementación testeada mediante 10 agentes especializados, con un Test Architect, un estudio de UX Whiteport y un Pentester de IA integrados. Funciona dentro de tu IDE con IA.
-
-[![npm version](https://img.shields.io/npm/v/wize-dev-kit?color=blue)](https://www.npmjs.com/package/wize-dev-kit)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Status](https://img.shields.io/badge/status-beta-green)](#estado)
-[![Repo](https://img.shields.io/badge/repo-qwize--br%2Fwize--development--kit-181717?logo=github)](https://github.com/qwize-br/wize-development-kit)
-
-**🌐 Idiomas:** [English](README.md) · [Português (pt-BR)](README.pt-BR.md) · **Español**
-
----
-
-## Resumen rápido
-
-```bash
-npx wize-dev-kit install
-```
-
-Elige tus perfiles y tu IDE; luego, en tu IDE con IA, di *"Activa a Wizer y dale el briefing del proyecto."* Wizer te guía por el agente adecuado en cada fase — brief, PRD, UX, arquitectura, código testeado — y (opcionalmente) ejecuta un pentest de IA sobre tu aplicación.
-
----
-
-## Qué es
-
-Wize Development Kit (WDK) es un **stack de agentes de IA** instalable que funciona dentro de tu IDE con IA (Claude Code, Cursor, Windsurf, Codex y otros) y escribe artefactos estructurados en una carpeta oculta `.wize/` de tu repositorio. Lleva un proyecto de **brief → PRD → estrategia de UX → arquitectura → implementación testeada**, y también puede **hacer pentest de la app en ejecución y planificar el sprint de remediación**.
-
-Es **file-first y zero-runtime**: los agentes son skills en Markdown que tu IDE lee; el tooling es Node puro (una única dependencia npm — `prompts`, usada solo por el instalador; nada se añade a tu proyecto). Nada está simulado — cada paso lee el artefacto anterior y escribe uno real.
-
-### Perfiles (combinables en monorepos)
-
-| Perfil | Qué añade |
-|---|---|
-| **Wize Dev Core** | Ciclo completo (análisis → plan → solución → implementación) + Test Architect + UX Whiteport + Agent Builder. Siempre instalado. |
-| **Wize Web Dev** *(overlay)* | Scaffolds web, SEO, analytics, playbook WCAG para Mantis, Playwright/Vitest para Hawkeye. |
-| **Wize App Development** *(overlay)* | Scaffolds móviles, ficha de tienda, directrices de plataforma (HIG / Material 3), Detox/Maestro para Hawkeye. |
-| **Wize Security** *(overlay)* | **Pentester de IA.** Pipeline de pentest file-first (recon → enumerate → SAST → DAST → report) conducido por **Natasha Romanoff**, la persona `red-teamer`, con gate de alcance, clasificación OWASP/CVSS e informe ejecutivo. |
-
----
-
-## Instalación
-
-En cualquier repositorio, nuevo o existente (greenfield o brownfield):
-
-```bash
-npx wize-dev-kit install
-```
-
-O directamente desde GitHub (sin necesidad de npm):
-
-```bash
-npx github:qwize-br/wize-development-kit install
-```
-
-El instalador pregunta:
-
-1. **Nombre del proyecto** — escrito en `.wize/config/project.toml`.
-2. **Perfil(es)** — Core / +Web / +App / +Security (selección múltiple).
-3. **IDE(s) objetivo** — Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, OpenCode, Antigravity o fallback genérico (selección múltiple).
-4. **Idiomas** — comunicación + salida de documentos.
-5. **Tu nombre** — cómo deben dirigirse a ti los agentes (guardado en `user.toml`).
-6. **Brownfield** — ofrece ejecutar `wize-document-project` para crear la baseline del código existente.
-
-Tras instalar, abre tu IDE y di:
-
-> "Activa a Wizer y dale el briefing del proyecto."
-
----
-
-## Harnesses soportados
-
-Los 10 IDEs objetivo se renderizan desde la misma fuente; el formato y la mecánica varían por harness. **OpenCode** recibe la integración más profunda — la separación persona/workflow del kit se mapea sobre las primitivas propias de OpenCode (`mode: primary|subagent`, `agent:`, `subtask:`) en lugar de aplanarse en un único tipo de archivo.
-
-| Harness | Salida | Destacado |
-|---|---|---|
-| **OpenCode** 🆕 | `.opencode/agents/` + `.opencode/commands/` | `mode: primary\|subagent` nativo; los comandos se vinculan automáticamente a su persona propietaria (`agent:`); los workers de fan-out corren aislados (`subtask: true`). [Docs →](docs/harnesses/opencode.md) |
-| **Claude Code** | `.claude/skills/*/SKILL.md` | Formato Skill de Anthropic; fan-out ad-hoc vía Task/Agent tool (`wize-code-review`). [Docs →](docs/harnesses/claude-code.md) |
-| **Codex** | `.agents/skills/*/SKILL.md` | Mismo formato Skill + `AGENTS.md` en la raíz. [Docs →](docs/harnesses/codex.md) |
-| **Kimi Code** | `.kimi/skills/*/SKILL.md` | Mismo formato Skill; autodetecta árboles de skills de Claude/Codex. [Docs →](docs/harnesses/kimi-code.md) |
-| **Hermes Agent** 🆕 | `.hermes/skills/*/SKILL.md` | Mismo formato Skill, project-local; trust gate (`hermes skills trust`); las skills del proyecto sobreescriben las de perfil. [Docs →](docs/harnesses/hermes.md) |
-| **Antigravity** | `.agent/skills/*/SKILL.md` | Mismo formato Skill + `AGENTS.md` en la raíz. [Docs →](docs/harnesses/antigravity.md) |
-| **Cursor** | `.cursor/rules/*.mdc` | Reglas on-demand (`alwaysApply: false`), emparejadas por descripción. [Docs →](docs/harnesses/cursor.md) |
-| **Windsurf** | `.windsurf/rules/*.md` | Markdown plano; el modo de activación se define dentro del IDE. [Docs →](docs/harnesses/windsurf.md) |
-| **Continue.dev** | `.continue/prompts/*.prompt` | Slash commands con `invokable: true`. [Docs →](docs/harnesses/continue.md) |
-| **Fallback genérico** | `.wize/agents/*.md` + `AGENTS.md` en la raíz | Para cualquier IDE sin adapter dedicado. [Docs →](docs/harnesses/generic.md) |
-
----
-
-## El elenco
-
-| # | Persona | Código | Rol |
-|---|---|---|---|
-| 1 | **Wizer** | `wize-orchestrator` | Orquestador, base de conocimiento, briefing, enrutamiento |
-| 2 | **Pepper Potts** | `wize-agent-analyst` | Analista de Negocio + WDS Saga (brief de producto, trigger map) |
-| 3 | **Peggy Carter** | `wize-agent-tech-writer` | Redactora Técnica (transversal) |
-| 4 | **Maria Hill** | `wize-agent-pm` | Product Manager (PRD, epics, sprints) |
-| 5 | **Mantis** | `wize-agent-ux-designer` | UX Designer + WDS Freya (escenarios, diseño, design system) |
-| 6 | **Nick Fury** | `wize-agent-solution-strategist` | Estrategia de Solución, visión técnica, principios de NFR |
-| 7 | **Tony Stark** | `wize-agent-architect` | Arquitecto de Sistemas (arquitectura, ADRs, epics, stories) |
-| 8 | **Hawkeye** | `wize-agent-test-architect` | Test Architect — 6 gates (risk, design, trace, nfr, review, gate) |
-| 9 | **Shuri** | `wize-agent-dev` | Desarrolladora Senior (TDD, código, refactor) |
-| 10 | **Natasha Romanoff** | `wize-sec-red-teamer` (overlay de seguridad) | Red-Teamer / Pentester de IA — recon, SAST/DAST, pruebas ofensivas con alcance, informe |
-
-Consulta [`ROSTER.md`](ROSTER.md) para personas, estilos y equivalencias con BMAD.
-
----
-
-## Recorrido — un proyecto completo, de principio a fin
-
-Cada paso es un slash command en tu IDE; cada persona lee el artefacto anterior antes de escribir el suyo.
-
-```
-1.  /wize-orchestrator          Wizer saluda, lee config, detecta el estado y enruta.
-
-2.  /wize-grill                  Cualquier persona te entrevista hasta un entendimiento
-                                compartido antes de redactar — una pregunta a la vez,
-                                cada una con respuesta recomendada (ofrecida, nunca
-                                impuesta).
-    /wize-product-brief         Pepper convierte la demanda bruta en brief.md.
-    /wize-trigger-map           Pepper mapea psicología del usuario → metas de negocio (WDS).
-    /wize-research              Pepper sintetiza evidencia externa (opcional).
-
-3.  /wize-create-prd            Maria Hill escribe prd.md (metas, alcance, ACs).
-    /wize-validate-prd          Maria Hill (+ Mantis/Fury) aprueba.
-
-4.  /wize-ux-scenarios          Mantis conduce el diálogo WDS de 8 preguntas.
-    /wize-ux-design             Mantis escribe specs de pantalla (un .md por pantalla).
-
-5.  /wize-tech-vision           Fury elige la familia de stack + innegociables.
-    /wize-nfr-principles        Fury escribe el presupuesto de NFR (perf, seg, a11y…).
-
-6.  /wize-create-architecture   Tony escribe architecture.md + ADRs (8 pasos).
-    /wize-design-system         Mantis escribe design-system/ (tokens + componentes).
-    /wize-create-epics-and-stories
-                                Tony divide epics → stories (cada una con ACs).
-
-7.  /wize-sprint-planning       Maria Hill abre el sprint desde los epics/stories.
-    /wize-tea-risk              Hawkeye construye el perfil global de riesgo.
-    /wize-tea-design            Hawkeye escribe el test design de la próxima story.
-    /wize-create-story          Tony escribe la siguiente story con los campos de
-                                contrato: fuentes de verdad, restricciones,
-                                validación, done-means.
-    /wize-dev-story             Shuri implementa (TDD, IDs de AC en los commits) con
-                                loop auto-verificable y guarda de 3 ciclos.
-    /wize-tea-trace             Hawkeye mapea cada AC → tests.
-    /wize-tea-review            Hawkeye ejecuta la revisión de la story.
-    /wize-tea-gate              Hawkeye emite PASS / CONCERNS / FAIL / WAIVED.
-
-8.  /wize-sprint-status         Maria Hill mantiene el snapshot diario actualizado.
-    /wize-retrospective         Wizer facilita la retro al final de cada sprint.
-
-Transversales:
-    /wize-help                  Wizer te enruta: `next` (única acción siguiente),
-                                `status` (snapshot del proyecto), `mission` (un
-                                contrato de misión lleno para la persona ejecutora).
-    /wize-check                 Checklist de avance de la demanda en vuelo: hecho
-                                (con evidencia), en curso, lo que falta — luego
-                                retoma el trabajo interrumpido.
-    /wize-grill                 Entrevista-hasta-entendimiento antes de cualquier
-                                paso de autoría.
-    /wize-quick-dev             Shuri toma un arreglo pequeño sin el ciclo completo.
-    /wize-pre-pr-check          Corre lint/format/build/tests unitarios localmente
-                                antes de abrir un PR — falla rápido, cero costo de runner.
-    /wize-correct-course        Re-planifica cuando un gate falla o el loop se
-                                estanca (auto-disparado por la guarda de max-cycles;
-                                también manual).
-    /wize-code-review           Revisión adversarial antes del gate TEA de Hawkeye.
-    /wize-party-mode            Wizer reúne multi-persona para decisiones difíciles.
-```
-
-> Usa `/wize-help next` cuando tengas dudas — inspecciona `.wize/` y te dice la única acción siguiente.
-
----
-
-## 🛡️ Overlay de seguridad — Pentester de IA
-
-Con el perfil **Wize Security** instalado, **Natasha Romanoff** (`wize-sec-red-teamer`, la persona red-teamer) ejecuta un pentest file-first de tu proyecto y produce un informe listo para stakeholders.
-
-### Cómo funciona
-
-1. **Autoriza el objetivo.** Declaras hosts/URLs permitidos en un `.wize/security/scope.md` firmado (integridad por SHA-256). Cualquier cosa fuera de la allowlist es **rechazada y auditada** — la herramienta nunca toca un objetivo que no autorizaste.
-2. **Ejecuta el pipeline.**
-   ```
-   /wize-sec-pentest                 # pasivo por defecto (chequeos read-only)
-   /wize-sec-pentest --active        # habilita tooling ofensivo (sqlmap, ffuf)
-   ```
-   Encadena: **recon** (nmap) → **enumerate** (superficie HTTP) → **SAST** (secrets con gitleaks + deps con osv-scanner/grype) → **DAST** (nuclei, nikto, sqlmap, ffuf) → **report**.
-3. **Lee el informe.** `report.md` + un `report.html` self-contained (offline, WCAG 2.2 AA) con:
-   - **Puntuación de riesgo 0–100** + **briefing** ejecutivo (qué significa el riesgo para el negocio),
-   - hallazgos clasificados por **CVSS v3.1** y **OWASP Top 10**, con secrets redactados,
-   - **cobertura honesta** ("audit confidence" — qué se probó y qué no),
-   - un **plan de acción priorizado** (P0/P1/P2).
-4. **Planifica la corrección.** El scan genera `security-backlog.md` (epics de remediación agrupados por tema, trazables a los hallazgos) e imprime el comando exacto para convertirlo en un sprint:
-   ```
-   /wize-create-epics-and-stories --from .wize/security/security-backlog.md
-   ```
-
-### Garantías de diseño
-
-- **Cero runtime propio** — solo built-ins de Node; ninguna dependencia npm nueva; el overlay nunca invoca una skill (imprime el comando para que tú/el agente lo ejecuten).
-- **Los datos quedan locales** — informes y hallazgos se escriben en `.wize/security/`, nunca se suben a ningún lado.
-- **Las herramientas se detectan, nunca se auto-instalan** — un preflight comprueba tu toolchain y genera un `install-pentest-tools.sh` consciente del SO (apt para nmap/nikto/sqlmap; releases de GitHub para gitleaks/nuclei/ffuf/osv-scanner; script oficial para grype). Una herramienta ausente degrada solo ese chequeo — el pipeline continúa.
-- **Pasivo por defecto** — el tooling ofensivo (sqlmap/ffuf) solo corre con `--active`; flags peligrosas (`--dump`, `--os-shell`) son vetadas por una allowlist independiente del input.
-
-> ⚠️ **Herramienta de doble uso.** Prueba solo sistemas que poseas o estés explícitamente autorizado a probar.
-
----
-
-## Estructura de salida (en el repositorio objetivo)
-
-```
-.wize/
-├── config/             # project.toml, user.toml, tea.toml
-├── planning/           # brief, research, ux/, prd, tech-vision, nfr-principles
-├── solutioning/        # architecture, adrs, epics, stories
-├── implementation/     # sprint-status, retrospective, tea/{gates}
-├── knowledge/          # docs y referencias de larga duración
-├── security/           # scope.md, report.{md,html}, security-backlog.md (overlay de seguridad)
-└── custom/             # agents/skills/workflows creados por Agent Builder
-```
-
----
-
-## Comandos de la CLI
-
-```bash
-npx wize-dev-kit install         # setup interactivo
-npx wize-dev-kit update          # actualiza un kit instalado a la versión actual
-npx wize-dev-kit sync            # re-renderiza los adapters de IDE tras editar la config
-npx wize-dev-kit list            # lista agentes, skills y workflows instalados
-npx wize-dev-kit agent list      # lista agentes nativos + personalizados
-npx wize-dev-kit agent create    # crea un nuevo agente personalizado (validado + dry-run)
-npx wize-dev-kit agent edit <code>  # sobrescribe un agente nativo
-npx wize-dev-kit workflow list   # lista workflows nativos + personalizados
-npx wize-dev-kit workflow create # crea un nuevo workflow personalizado
-npx wize-dev-kit doctor          # diagnostica kit / proyecto / adapters / gates
-npx wize-dev-kit validate        # chequeos estructurales en los assets del kit
-npx wize-dev-kit document-project [quick|initial_scan|full_rescan|deep_dive] [--resume] [--target <path>]
-npx wize-dev-kit uninstall       # elimina .wize/ (tu código queda intacto)
-npx wize-dev-kit help            # referencia de comandos
-npx wize-dev-kit version         # imprime la versión instalada del kit
-```
-
----
-
-## Documentación
-
-- [`ARCH.md`](ARCH.md) — arquitectura completa: distribución, flujos, layout, instalador.
-- [`ROSTER.md`](ROSTER.md) — personas con estilo, rol, equivalencias BMAD.
-- [`AGENTS.md`](AGENTS.md) — el roster generado + el contexto operativo que las IDEs leen en la raíz del repo.
-- [`DECISIONS.md`](DECISIONS.md) — registro de decisiones.
-- [`CHANGELOG.md`](CHANGELOG.md) — historial de releases.
-- [`docs/harnesses/`](docs/harnesses/) — un doc por [harness soportado](#harnesses-soportados), en inglés + [pt-BR](README.pt-BR.md#harnesses-suportadas).
-
----
-
-## Estado
-
-**v0.12.1 — beta.** El método nunca produce estimaciones de desarrollo — ni horas, ni puntos, ni tallas de camiseta; una story se dimensiona solo por si cabe en un único PR. El ciclo completo (análisis → plan → solución → implementación) está montado con 10 agentes y una biblioteca estructurada de skills. Los releases recientes suman **contratos de misión** (`/wize-help mission`), **`wize-grill`** (entrevista-hasta-entendimiento antes de cualquier paso de autoría), **`wize-pre-pr-check`** (gate local de lint/format/build/tests unitarios antes de abrir un PR — cero costo de runner de CI) y **loop verification** en `wize-dev-story` (un loop de implementación auto-verificable con guarda de max-cycles que escala a `wize-correct-course`). El `security-overlay` (Pentester de IA) entrega un pipeline de pentest completo, un informe ejecutivo (puntuación de riesgo + briefing + plan de acción por IA) y planificación de remediación post-scan — validado de principio a fin contra una aplicación Laravel/PHP real. Los adapters de IDE para Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, Hermes, OpenCode y Antigravity se regeneran automáticamente — [OpenCode](docs/harnesses/opencode.md) recibe wiring nativo de `mode`/`agent`/`subtask`, la integración más profunda de las 10.
-
----
-
-## Inspiración y créditos
-
-- [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) por Brian (BMad) Madison — ciclo ágil de IA, personas de agentes, patrón de instalador, sistema de módulos.
-- [Whiteport Design Studio expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion) — metodología UX-first, panteón nórdico (Saga, Freya), estructura de fases.
-
-Wize Development Kit es una **adaptación independiente** — no afiliada ni respaldada por los autores de BMAD o WDS. Los nombres de personas Marvel se usan como referencias creativas bajo uso nominativo justo.
-
----
-
-## Licencia
-
-MIT — consulta [`LICENSE`](LICENSE).
-
----
-
-## 🤖 Prerrequisito para colaborar con agentes de IA
-
-Antes de abrir este repo en cualquier agente (Claude Code, Cursor, Codex, Antigravity, OpenCode, Kimi, Qwen, …), instala el Wize Dev Kit:
-
-```bash
-npx wize-dev-kit@latest install
-```
-
-Por qué:
-
-- Inyecta las skills `/wize-*` (analista, PM, arquitecto, dev, TEA, orquestador) que le dan estructura al ciclo de vida del proyecto.
-- Crea/actualiza una baseline brownfield en `.wize/knowledge/document-project/` — la fuente canónica a consultar antes de decidir cambios.
-- Habilita el seguimiento de actividad en `.wize/implementation/` — cada story, plan y gate queda auditable.
-- Estandariza idiomas y quality gates entre agentes vía `.wize/config/`.
-
-Sin el kit, el agente trabaja sin contexto histórico, sin gates y sin trazabilidad. Esto vale para cualquier agente de IA usado en el proyecto.
-
-Para Claude Code: empieza con `/wize-help` para un diagnóstico y el siguiente paso recomendado.

package/README.pt-BR.md

@@ -1,293 +0,0 @@
-# Wize Development Kit
-
-> **Kit de desenvolvimento assistido por IA, de ciclo completo** — leva um projeto do brief à implementação testada por meio de 10 agentes especializados, com um Test Architect, um estúdio de UX Whiteport e um Pentester de IA embarcados. Roda dentro da sua IDE com IA.
-
-[![npm version](https://img.shields.io/npm/v/wize-dev-kit?color=blue)](https://www.npmjs.com/package/wize-dev-kit)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Status](https://img.shields.io/badge/status-beta-green)](#status)
-[![Repo](https://img.shields.io/badge/repo-qwize--br%2Fwize--development--kit-181717?logo=github)](https://github.com/qwize-br/wize-development-kit)
-
-**🌐 Idiomas:** [English](README.md) · **Português (pt-BR)** · [Español](README.es.md)
-
----
-
-## Resumo rápido
-
-```bash
-npx wize-dev-kit install
-```
-
-Escolha os perfis e a IDE; depois, na sua IDE com IA, diga *"Ative o Wizer e dê o briefing do projeto a ele."* O Wizer te conduz pelo agente certo em cada fase — brief, PRD, UX, arquitetura, código testado — e (opcionalmente) roda um pentest de IA na sua aplicação.
-
----
-
-## O que é
-
-O Wize Development Kit (WDK) é uma **stack de agentes de IA** instalável que roda dentro da sua IDE com IA (Claude Code, Cursor, Windsurf, Codex e outras) e grava artefatos estruturados em uma pasta oculta `.wize/` no seu repositório. Leva um projeto de **brief → PRD → estratégia de UX → arquitetura → implementação testada** e também pode **fazer pentest da aplicação rodando e planejar a sprint de correção**.
-
-É **file-first e zero-runtime**: os agentes são skills em Markdown que sua IDE lê; o tooling é Node puro (uma única dependência de runtime, `prompts`, usada pelo instalador interativo — nada é adicionado ao seu projeto). Nada é simulado — cada passo lê o artefato anterior e grava um real.
-
-### Perfis (combináveis em monorepos)
-
-| Perfil | O que adiciona |
-|---|---|
-| **Wize Dev Core** | Ciclo completo (análise → plano → solução → implementação) + Test Architect + UX Whiteport + Agent Builder. Sempre instalado. |
-| **Wize Web Dev** *(overlay)* | Scaffolds web, SEO, analytics, playbook WCAG para o Mantis, Playwright/Vitest para o Hawkeye. |
-| **Wize App Development** *(overlay)* | Scaffolds mobile, listagem em loja, diretrizes de plataforma (HIG / Material 3), Detox/Maestro para o Hawkeye. |
-| **Wize Security** *(overlay)* | **Pentester de IA.** Pipeline de pentest file-first (recon → enumerate → SAST → DAST → report) conduzido por **Natasha Romanoff**, a persona `red-teamer`, com gate de escopo, classificação OWASP/CVSS e relatório executivo. |
-
----
-
-## Instalação
-
-Em qualquer repositório, novo ou existente (greenfield ou brownfield):
-
-```bash
-npx wize-dev-kit install
-```
-
-Ou direto do GitHub (sem precisar de npm):
-
-```bash
-npx github:qwize-br/wize-development-kit install
-```
-
-O instalador pergunta:
-
-1. **Nome do projeto** — gravado em `.wize/config/project.toml`.
-2. **Perfil(is)** — Core / +Web / +App / +Security (múltipla escolha).
-3. **IDE(s) alvo** — Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, OpenCode, Antigravity ou fallback genérico (múltipla escolha).
-4. **Idiomas** — comunicação + saída de documentos.
-5. **Seu nome** — como os agentes devem te chamar (salvo em `user.toml`).
-6. **Brownfield** — oferece rodar `wize-document-project` para criar a baseline do código existente.
-
-Após instalar, abra sua IDE e diga:
-
-> "Ative o Wizer e dê o briefing do projeto a ele."
-
----
-
-## Harnesses suportadas
-
-Os 10 alvos de IDE são gerados a partir da mesma fonte; formato e mecânica mudam por harness. O **OpenCode** tem a integração mais profunda — a divisão persona/workflow do kit mapeia pras primitivas nativas do próprio OpenCode (`mode: primary|subagent`, `agent:`, `subtask:`) em vez de ser achatada num único tipo de arquivo.
-
-| Harness | Saída | Destaque |
-|---|---|---|
-| **OpenCode** 🆕 | `.opencode/agents/` + `.opencode/commands/` | `mode: primary\|subagent` nativo; commands se ligam à persona dona (`agent:`); workers de fan-out rodam isolados (`subtask: true`). [Docs →](docs/harnesses/opencode.pt-BR.md) |
-| **Claude Code** | `.claude/skills/*/SKILL.md` | Formato Skill da Anthropic; fan-out ad hoc via Task/Agent tool (`wize-code-review`). [Docs →](docs/harnesses/claude-code.pt-BR.md) |
-| **Codex** | `.agents/skills/*/SKILL.md` | Mesmo formato Skill + `AGENTS.md` na raiz. [Docs →](docs/harnesses/codex.pt-BR.md) |
-| **Kimi Code** | `.kimi/skills/*/SKILL.md` | Mesmo formato Skill; autodetecta as árvores do Claude/Codex. [Docs →](docs/harnesses/kimi-code.pt-BR.md) |
-| **Hermes Agent** 🆕 | `.hermes/skills/*/SKILL.md` | Mesmo formato Skill, project-local; trust gate (`hermes skills trust`); skills do projeto sobrescrevem as de perfil. [Docs →](docs/harnesses/hermes.pt-BR.md) |
-| **Antigravity** | `.agent/skills/*/SKILL.md` | Mesmo formato Skill + `AGENTS.md` na raiz. [Docs →](docs/harnesses/antigravity.pt-BR.md) |
-| **Cursor** | `.cursor/rules/*.mdc` | Rules sob demanda (`alwaysApply: false`), casadas por descrição. [Docs →](docs/harnesses/cursor.pt-BR.md) |
-| **Windsurf** | `.windsurf/rules/*.md` | Markdown puro; modo de ativação definido dentro da IDE. [Docs →](docs/harnesses/windsurf.pt-BR.md) |
-| **Continue.dev** | `.continue/prompts/*.prompt` | Slash commands via `invokable: true`. [Docs →](docs/harnesses/continue.pt-BR.md) |
-| **Fallback genérico** | `.wize/agents/*.md` + `AGENTS.md` na raiz | Para qualquer IDE sem adapter dedicado. [Docs →](docs/harnesses/generic.pt-BR.md) |
-
----
-
-## O elenco
-
-| # | Persona | Código | Papel |
-|---|---|---|---|
-| 1 | **Wizer** | `wize-orchestrator` | Orquestrador, base de conhecimento, briefing, roteamento |
-| 2 | **Pepper Potts** | `wize-agent-analyst` | Analista de Negócio + WDS Saga (brief de produto, trigger map) |
-| 3 | **Peggy Carter** | `wize-agent-tech-writer` | Redatora Técnica (transversal) |
-| 4 | **Maria Hill** | `wize-agent-pm` | Product Manager (PRD, epics, sprints) |
-| 5 | **Mantis** | `wize-agent-ux-designer` | UX Designer + WDS Freya (cenários, design, design system) |
-| 6 | **Nick Fury** | `wize-agent-solution-strategist` | Estratégia de Solução, visão técnica, princípios de NFR |
-| 7 | **Tony Stark** | `wize-agent-architect` | Arquiteto de Sistemas (arquitetura, ADRs, epics, stories) |
-| 8 | **Hawkeye** | `wize-agent-test-architect` | Test Architect — 6 gates (risk, design, trace, nfr, review, gate) |
-| 9 | **Shuri** | `wize-agent-dev` | Desenvolvedora Sênior (TDD, código, refactor) |
-| 10 | **Natasha Romanoff** | `wize-sec-red-teamer` (overlay de segurança) | Red-Teamer / Pentester de IA — recon, SAST/DAST, testes ofensivos com escopo, relatório |
-
-Veja [`ROSTER.md`](ROSTER.md) para personas, estilos e equivalências com o BMAD.
-
----
-
-## Passo a passo — um projeto completo, de ponta a ponta
-
-Cada passo é um slash command na sua IDE; cada persona lê o artefato anterior antes de escrever o seu.
-
-```
-1.  /wize-orchestrator          Wizer cumprimenta, lê config, detecta estado e roteia.
-
-2.  /wize-grill                  Qualquer persona te entrevista até entendimento
-                                compartilhado antes de redigir — uma pergunta por
-                                vez, cada uma com resposta recomendada (oferecida,
-                                nunca imposta).
-    /wize-product-brief         Pepper transforma a demanda bruta em brief.md.
-    /wize-trigger-map           Pepper mapeia psicologia do usuário → metas de negócio (WDS).
-    /wize-research              Pepper sintetiza evidências externas (opcional).
-
-3.  /wize-create-prd            Maria Hill escreve prd.md (metas, escopo, ACs).
-    /wize-validate-prd          Maria Hill (+ Mantis/Fury) aprova.
-
-4.  /wize-ux-scenarios          Mantis conduz o diálogo WDS de 8 perguntas.
-    /wize-ux-design             Mantis escreve specs de tela (um .md por tela).
-
-5.  /wize-tech-vision           Fury escolhe a família de stack + não-negociáveis.
-    /wize-nfr-principles        Fury escreve o orçamento de NFR (perf, seg, a11y…).
-
-6.  /wize-create-architecture   Tony escreve architecture.md + ADRs (8 passos).
-    /wize-design-system         Mantis escreve design-system/ (tokens + componentes).
-    /wize-create-epics-and-stories
-                                Tony fatia epics → stories (cada uma com ACs).
-
-7.  /wize-sprint-planning       Maria Hill abre a sprint a partir dos epics/stories.
-    /wize-tea-risk              Hawkeye monta o perfil global de risco.
-    /wize-tea-design            Hawkeye escreve o test design da próxima story.
-    /wize-create-story          Tony escreve a próxima story (campos de contrato:
-                                fontes de verdade, restrições, validação, done-means).
-    /wize-dev-story             Shuri implementa (TDD, IDs de AC nos commits) com
-                                loop auto-verificável e guarda de 3 ciclos.
-    /wize-tea-trace             Hawkeye mapeia cada AC → testes.
-    /wize-tea-review            Hawkeye faz a revisão da story.
-    /wize-tea-gate              Hawkeye emite PASS / CONCERNS / FAIL / WAIVED.
-
-8.  /wize-sprint-status         Maria Hill mantém o snapshot diário atualizado.
-    /wize-retrospective         Wizer facilita a retro no fim de cada sprint.
-
-Transversais:
-    /wize-help                  Wizer te direciona: `next` (próxima ação única),
-                                `status` (snapshot do projeto), `mission` (contrato
-                                de missão preenchido para a persona executora).
-    /wize-check                 Checklist de acompanhamento da demanda em voo:
-                                feito (com evidência), em andamento, o que falta —
-                                depois retoma o trabalho interrompido.
-    /wize-grill                 Entrevista-até-entendimento antes de qualquer passo
-                                de autoria.
-    /wize-quick-dev             Shuri pega uma correção pequena sem o ciclo completo.
-    /wize-pre-pr-check          Roda lint/format/build/testes unitários localmente
-                                antes de abrir um PR — falha cedo, zero custo de runner.
-    /wize-correct-course        Re-planeja quando um gate falha ou o loop trava
-                                (auto-disparado pela guarda de max-cycles; também
-                                manual).
-    /wize-code-review           Revisão adversarial antes do gate TEA do Hawkeye.
-    /wize-party-mode            Wizer reúne multi-persona para decisões difíceis.
-```
-
-> Use `/wize-help next` sempre que estiver em dúvida — ele inspeciona `.wize/` e diz a única próxima ação.
-
----
-
-## 🛡️ Overlay de segurança — Pentester de IA
-
-Com o perfil **Wize Security** instalado, **Natasha Romanoff** (`wize-sec-red-teamer`, a persona red-teamer) roda um pentest file-first do seu projeto e produz um relatório pronto para stakeholders.
-
-### Como funciona
-
-1. **Autorize o alvo.** Você declara hosts/URLs permitidos em um `.wize/security/scope.md` assinado (integridade por SHA-256). Qualquer coisa fora da allowlist é **recusada e auditada** — a ferramenta nunca toca em um alvo que você não autorizou.
-2. **Rode o pipeline.**
-   ```
-   /wize-sec-pentest                 # passivo por padrão (checagens read-only)
-   /wize-sec-pentest --active        # habilita tooling ofensivo (sqlmap, ffuf)
-   ```
-   Encadeia: **recon** (nmap) → **enumerate** (superfície HTTP) → **SAST** (secrets via gitleaks + deps via osv-scanner/grype) → **DAST** (nuclei, nikto, sqlmap, ffuf) → **report**.
-3. **Leia o relatório.** `report.md` + um `report.html` self-contained (offline, WCAG 2.2 AA) com:
-   - **Score de risco 0–100** + **briefing** executivo (o que o risco significa para o negócio),
-   - findings classificados por **CVSS v3.1** e **OWASP Top 10**, com secrets redatados,
-   - **cobertura honesta** ("audit confidence" — o que foi e o que não foi testado),
-   - um **plano de ação priorizado** (P0/P1/P2).
-4. **Planeje a correção.** O scan gera `security-backlog.md` (epics de remediação agrupados por tema, rastreáveis aos findings) e imprime o comando exato para virar uma sprint:
-   ```
-   /wize-create-epics-and-stories --from .wize/security/security-backlog.md
-   ```
-
-### Garantias de design
-
-- **Zero runtime próprio** — só built-ins do Node; nenhuma dependência npm nova; o overlay nunca invoca uma skill (ele imprime o comando para você/o agente rodar).
-- **Os dados ficam locais** — relatórios e findings são gravados em `.wize/security/`, nunca enviados a lugar nenhum.
-- **Ferramentas são detectadas, nunca auto-instaladas** — um preflight checa seu toolchain e gera um `install-pentest-tools.sh` ciente do SO (apt para nmap/nikto/sqlmap; releases do GitHub para gitleaks/nuclei/ffuf/osv-scanner; script oficial para grype). Ferramenta ausente degrada só aquela checagem — o pipeline continua.
-- **Passivo por padrão** — tooling ofensivo (sqlmap/ffuf) só roda com `--active`; flags perigosas (`--dump`, `--os-shell`) são vetadas por uma allowlist independente do input.
-
-> ⚠️ **Ferramenta dual-use.** Só teste sistemas que você possui ou está explicitamente autorizado a testar.
-
----
-
-## Layout de saída (no repositório alvo)
-
-```
-.wize/
-├── config/             # project.toml, user.toml, tea.toml
-├── planning/           # brief, research, ux/, prd, tech-vision, nfr-principles
-├── solutioning/        # architecture, adrs, epics, stories
-├── implementation/     # sprint-status, retrospective, tea/{gates}
-├── knowledge/          # docs e referências de longa duração
-├── security/           # scope.md, report.{md,html}, security-backlog.md (overlay de segurança)
-└── custom/             # agents/skills/workflows criados pelo Agent Builder
-```
-
----
-
-## Comandos da CLI
-
-```bash
-npx wize-dev-kit install         # setup interativo
-npx wize-dev-kit update          # atualiza um kit instalado para a versão atual
-npx wize-dev-kit sync            # re-renderiza os adapters de IDE após editar a config
-npx wize-dev-kit list            # lista agentes, skills e workflows instalados
-npx wize-dev-kit agent list      # lista agentes nativos + customizados
-npx wize-dev-kit agent create    # cria um novo agente customizado (validado + dry-run)
-npx wize-dev-kit agent edit <code>  # sobrescreve um agente nativo
-npx wize-dev-kit workflow <create|list>  # cria ou lista workflows customizados
-npx wize-dev-kit doctor          # diagnostica kit / projeto / adapters / gates
-npx wize-dev-kit validate        # checagens estruturais nos assets do kit
-npx wize-dev-kit document-project [quick|initial_scan|full_rescan|deep_dive] [--resume] [--target <path>]
-npx wize-dev-kit uninstall       # remove .wize/ (seu código permanece intacto)
-npx wize-dev-kit help            # referência de comandos
-npx wize-dev-kit version         # imprime a versão instalada do kit
-```
-
----
-
-## Documentação
-
-- [`ARCH.md`](ARCH.md) — arquitetura completa: distribuição, fluxos, layout, instalador.
-- [`ROSTER.md`](ROSTER.md) — personas com estilo, papel, equivalências BMAD.
-- [`AGENTS.md`](AGENTS.md) — o roster gerado + contexto operacional que as IDEs leem na raiz do repo.
-- [`DECISIONS.md`](DECISIONS.md) — log de decisões.
-- [`CHANGELOG.md`](CHANGELOG.md) — histórico de releases.
-- [`docs/harnesses/`](docs/harnesses/) — um doc por [harness suportada](#harnesses-suportadas), em português + [English](README.md#supported-harnesses).
-
----
-
-## Status
-
-**v0.12.1 — beta.** O método nunca produz estimativas de desenvolvimento — nada de horas, pontos ou tamanhos de camiseta; uma story é dimensionada apenas por caber (ou não) em um único PR. O ciclo completo (análise → plano → solução → implementação) está montado com 10 agentes e uma biblioteca estruturada de skills. Releases recentes adicionam **contratos de missão** (`/wize-help mission`), **`wize-grill`** (entrevista-até-entendimento antes de qualquer passo de autoria), **`wize-pre-pr-check`** (gate local de lint/format/build/testes unitários antes de abrir um PR — zero custo de runner de CI) e **loop verification** no `wize-dev-story` (loop de implementação auto-verificável com guarda de max-cycles que escala para `wize-correct-course`). O `security-overlay` (Pentester de IA) entrega um pipeline de pentest completo, um relatório executivo (score de risco + briefing + plano de ação por IA) e planejamento de correção pós-scan — validado de ponta a ponta contra uma aplicação Laravel/PHP real. Os adapters de IDE para Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, Hermes, OpenCode e Antigravity são regenerados automaticamente — o [OpenCode](docs/harnesses/opencode.pt-BR.md) tem a integração mais profunda das 10, com `mode`/`agent`/`subtask` nativos.
-
----
-
-## Inspiração & créditos
-
-- [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) por Brian (BMad) Madison — ciclo ágil de IA, personas de agentes, padrão de instalador, sistema de módulos.
-- [Whiteport Design Studio expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion) — metodologia UX-first, panteão nórdico (Saga, Freya), estrutura de fases.
-
-O Wize Development Kit é uma **adaptação independente** — não afiliada nem endossada pelos autores do BMAD ou do WDS. Os nomes de personas Marvel são referências criativas sob uso nominativo justo.
-
----
-
-## Licença
-
-MIT — veja [`LICENSE`](LICENSE).
-
----
-
-## 🤖 Pré-requisito para colaboração com Agentes de IA
-
-Antes de abrir o repositório em qualquer agente (Claude Code, Cursor, Codex, Antigravity, OpenCode, Kimi, Qwen, …), instale o Wize Dev Kit:
-
-```bash
-npx wize-dev-kit@latest install
-```
-
-Por quê:
-
-- Injeta as skills `/wize-*` (analista, PM, arquiteto, dev, TEA, orquestrador) que dão estrutura ao ciclo de vida do projeto.
-- Cria/atualiza a baseline brownfield em `.wize/knowledge/document-project/` — a fonte canônica a consultar antes de decidir mudanças.
-- Habilita trackeamento de atividade em `.wize/implementation/` — cada story, plano e gate fica auditável.
-- Padroniza idiomas e gates de qualidade entre agentes via `.wize/config/`.
-
-Sem o kit, o agente trabalha sem contexto histórico, sem gates e sem rastreabilidade. Isso vale para qualquer agente de IA usado no projeto.
-
-Para Claude Code: comece com `/wize-help` para diagnóstico e recomendação do próximo passo.

package/adapters/hermes/README.md

@@ -1,23 +0,0 @@
-# Hermes Agent — Wize Dev Kit Adapter
-
-Emits the kit's agents/skills/workflows as Hermes project-local skills under
-`.hermes/skills/wize-{code}/SKILL.md`, using the Anthropic `SKILL.md` format
-that Hermes consumes verbatim (same as Claude Code / Codex / Kimi Code).
-
-## How Hermes picks these up
-
-- Hermes discovers project-local skills at `<git-root>/.hermes/skills/`
-  (Hermes-native) and `<git-root>/.agents/skills/` (cross-tool convention).
-- **Trust gate:** skills are only loaded when the repo root is trusted. Run
-  `hermes skills trust` (or add the repo to `skills.trusted_project_dirs` in
-  `~/.hermes/config.yaml`) once per checkout.
-- Trusted project skills **override** same-named profile/bundled skills —
-  vendored repo skills win inside their repo.
-- Hermes also reads root-level `AGENTS.md` (and `CLAUDE.md`, `.cursorrules`)
-  as project context, so installing the generic target alongside is a bonus,
-  not a requirement.
-
-## Files
-
-- `render.js` — renders via the shared `renderAnthropicSkills` emitter.
-- `adapter.yaml` — descriptor (target path, file pattern).