wize-dev-kit 0.11.0 → 0.12.1

package/AGENTS.md

@@ -10,8 +10,8 @@ Treat `.wize/`, this `AGENTS.md`, and the installed `wize-*` skills as your oper
 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-help`: **Quick Dev** (small, predictable,
-~≤1h, no new feature / architecture / UX / security) or **Full Lifecycle**. Never pick
+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
@@ -34,4 +34,4 @@ decisions, or final adversarial review.
 
 ## Where to start
 
-Activate the orchestrator: `wize-orchestrator` (Wizer). Then ask `/wize-help`.
+Activate the orchestrator: `/wize` (or `/wize-help`). Wizer will guide you.

package/CHANGELOG.md

@@ -9,6 +9,43 @@ Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.12.1] — 2026-08-08
+
+**Pre-PR Check — gate local antes de abrir PR.** Nova skill core para rodar lint, format, build e testes unitários localmente antes de submeter código, evitando ciclagem cara de CI no Actions. Agnóstica de tecnologia (detecta stack via `package.json`, `composer.json`, `Cargo.toml`, etc.). Registrada em todos os 9 harness adapters.
+
+### Added
+
+- **`wize-pre-pr-check`** (core skill) — gate local que detecta a stack do projeto e roda checks rápidos (lint, format, type-check, build, unit tests) antes de `git push` ou abertura de PR. Pare no primeiro erro. Complementa o CI; não substitui testes de integração/E2E. Description: *"Quando for abrir um Pull Request ou PR leia."*
+
+## [0.12.0] — 2026-08-08
+
+**Intent-first UX overhaul (Epic 09).** The kit now routes by user intent, not just by lifecycle phase. 10 stories across 3 sprints: block-scalar parser fix, intent descriptions on all 68 skills, 56-entry intent routing table, `/wize` primary alias, onboarding one-liner, research dispatcher, `--sign-scope`, non-interactive install + honest uninstall, release/changelog skills, CI on push/PR. Suite green (532 tests, validate 78 files).
+
+### Added
+
+- **`/wize` alias** — primary entry point; `/wize-help` remains canonical. Onboarding reduced to `→ /wize`.
+- **Intent routing table** — 56 intent phrases mapped to skills in `wize-help` (e.g., "concorrência" → `wize-market-research`). Falls back to phase heuristic only when ambiguous.
+- **Intent descriptions** — all 68 skills/workflows carry a one-sentence `description:` telling the harness WHEN to invoke them. Block-scalar parser (`|`, `>`) now supported.
+- **`wize-sec-scope`** — guided scope creation for the security overlay (4 questions → `scope.md` + signed hash).
+- **`--sign-scope`** flag on `wize-sec-pentest` — recomputes SHA-256 without manual editing.
+- **Non-interactive install** — `install --profiles core,security --targets claude-code --yes` for CI/scripted installs. `--dry-run` supported.
+- **Honest uninstall** — removes rendered adapter directories (`.claude/skills/`, `.cursor/rules/`, etc.) in addition to `.wize/`. `--dry-run` supported.
+- **`wize-release`** skill — version bump + changelog + git tag from gated stories.
+- **`wize-changelog`** skill — Keep a Changelog format generated from done stories.
+- **CI workflow** — `.github/workflows/ci.yml` runs `npm test` + `npm run validate` on push/PR against Node 20.x and 22.x.
+- **Tool contract tests** — smoke tests for nmap, gitleaks, osv-scanner, grype, nuclei, nikto, sqlmap, ffuf (skip if absent, catch CLI drift).
+
+### Changed
+
+- **`wize-research`** — now a dispatcher that classifies intent and delegates to `wize-market-research`, `wize-domain-research`, or `wize-technical-research`.
+- **Phase labels** — normalized across all workflows (`2-plan-workflows` → `2-plan`, `2-to-3-boundary` → `3-solutioning`).
+- **Onboarding** — contextual one-liner (`→ /wize`) instead of multi-line menu. Detects brownfield/security-overlay.
+- **AGENTS.md template** — references `/wize` as primary, `/wize-help` as canonical.
+
+### Fixed
+
+- **Block scalar parser** — `readFrontmatter` now handles `|`, `>`, `|-`, `|+`, `|2` and chomp indicators. Fixes the `— |` bug that corrupted all 10 persona descriptions.
+
 ## [0.11.0] — 2026-08-06
 
 **No-estimates policy.** The method now refuses to produce development estimates at any step — no hours, days, story points, or S/M/L/XL t-shirt sizes. Following the BMAD stance already stated in the architecture skill ("AI development speed has fundamentally changed"), estimates are treated as noise that only burns time and tokens. The only sizing signal that remains is binary: **does a story fit one PR? If not, slice it.** Suite green (417 tests, validate 74 files).

package/README.es.md

@@ -155,6 +155,8 @@ Transversales:
     /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).
@@ -250,7 +252,7 @@ npx wize-dev-kit version         # imprime la versión instalada del kit
 
 ## Estado
 
-**v0.11.0 — 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` emite un contrato lleno de objetivo / fuentes de verdad / alcance / ACs / contrato de validación para la persona ejecutora), **`wize-grill`** (una pasada de entrevista hasta entendimiento compartido antes de cualquier paso de autoría) 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, 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 9.
+**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, 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 9.
 
 ---
 

package/README.md

@@ -152,6 +152,8 @@ Cross-cutting:
                                 mission contract for the executing persona).
     /wize-grill                 Interview-to-understanding before any authoring step.
     /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.
     /wize-correct-course        Re-plan when a gate fails or a loop stalls (auto-
                                 triggered by the max-cycles guard; also manual).
     /wize-code-review           Adversarial peer review before Hawkeye's TEA gate.
@@ -245,7 +247,7 @@ npx wize-dev-kit version         # print the installed kit version
 
 ## Status
 
-**v0.11.0 — 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` emits a filled objective / sources-of-truth / scope / ACs / validation contract for the executing persona), **`wize-grill`** (an interview-to-shared-understanding pass before any authoring step), 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, OpenCode, and Antigravity are regenerated automatically — [OpenCode](docs/harnesses/opencode.md) gets native `mode`/`agent`/`subtask` wiring, the deepest integration of the 9.
 
 ---
 

package/README.pt-BR.md

@@ -154,6 +154,8 @@ Transversais:
     /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).
@@ -248,7 +250,7 @@ npx wize-dev-kit version         # imprime a versão instalada do kit
 
 ## Status
 
-**v0.11.0 — 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` emite um contrato preenchido de objetivo / fontes de verdade / escopo / ACs / validação para a persona executora), **`wize-grill`** (uma passagem de entrevista até entendimento compartilhado antes de qualquer passo de autoria) 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, OpenCode e Antigravity são regenerados automaticamente — o [OpenCode](docs/harnesses/opencode.pt-BR.md) tem a integração mais profunda das 9, com `mode`/`agent`/`subtask` nativos.
+**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, OpenCode e Antigravity são regenerados automaticamente — o [OpenCode](docs/harnesses/opencode.pt-BR.md) tem a integração mais profunda das 9, com `mode`/`agent`/`subtask` nativos.
 
 ---
 

package/package.json

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

package/src/app-overlay/wize-app-release-channels/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-app-release-channels
+description: "Use quando o app estiver pronto para distribuição e precisar configurar canais de release (beta, produção)."
 name: App Release Channels
 overlay: app
 owner: wize-agent-pm   # Maria Hill

package/src/app-overlay/wize-app-scaffold/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-app-scaffold
+description: "Use quando precisar criar o scaffold inicial de um projeto mobile com a stack aprovada pelo Fury."
 name: App Scaffold
 overlay: app
 owner: wize-agent-architect   # Tony

package/src/app-overlay/wize-app-store-listing/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-app-store-listing
+description: "Use quando o app estiver próximo do lançamento e precisar preparar a listagem na loja (copy, assets, metadados)."
 name: App Store Listing
 overlay: app
 owner: wize-agent-analyst   # Pepper (copy) + Mantis (visual brief)

package/src/builder-skills/wize-create-agent/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-create-agent
+description: "Use quando precisar criar um novo agente customizado sob .wize/custom/agents/."
 name: Create Agent
 owner: builder
 status: stub

package/src/builder-skills/wize-create-skill/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-create-skill
+description: "Use quando precisar criar uma nova skill single-step sob .wize/custom/skills/."
 name: Create Skill
 owner: builder
 status: stub

package/src/builder-skills/wize-create-workflow/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-create-workflow
+description: "Use quando precisar criar um novo workflow multi-step sob .wize/custom/workflows/."
 name: Create Workflow
 owner: builder
 status: stub

package/src/core-skills/module.yaml

@@ -28,4 +28,7 @@ skills:
   - code: wize-spec
     name: "Spec"
     description: "Distills any intent input into a canonical five-field spec kernel + companions."
+  - code: wize-pre-pr-check
+    name: "Pre-PR Check"
+    description: "Quando for abrir um Pull Request ou PR leia — gate local para lint, format, build e testes rápidos antes de submeter código."
 

package/src/core-skills/wize-advanced-elicitation/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-advanced-elicitation
+description: "Use quando uma resposta do usuário parecer subespecificada e precisar de técnicas de elicitação (5 Whys, laddering, premortem) para aprofundar o entendimento."
 name: Advanced Elicitation
 module: core
 status: stub

package/src/core-skills/wize-brainstorming/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-brainstorming
+description: "Use quando precisar gerar ideias divergentes e convergir para as melhores opções em qualquer fase de decisão."
 name: Brainstorming
 module: core
 status: stub

package/src/core-skills/wize-customize/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-customize
+description: "Use quando precisar personalizar um agente, skill ou workflow built-in sem alterar os arquivos originais do kit."
 name: Customize
 module: core
 status: ready

package/src/core-skills/wize-editorial-review-prose/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-editorial-review-prose
+description: "Use quando um artefato Wize (brief, PRD, ADR, gate) precisar de revisão de prosa — clareza, tom, jargão e precisão."
 name: Editorial Review — Prose
 module: core
 status: ready

package/src/core-skills/wize-editorial-review-structure/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-editorial-review-structure
+description: "Use quando um artefato Wize precisar de revisão estrutural — seções obrigatórias, ordenação e níveis de heading."
 name: Editorial Review — Structure
 module: core
 status: ready

package/src/core-skills/wize-grill/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-grill
+description: "Use quando uma demanda chegar vaga e precisar de entrevista exaustiva para alcançar entendimento compartilhado antes de produzir qualquer artefato."
 name: Grill
 module: core
 status: ready
@@ -9,7 +11,7 @@ status: ready
 
 **Goal.** Interview the user exhaustively about a demand until both sides reach **shared understanding** — before any artifact is drafted. Sharper answers make a sharper brief, PRD, epic, story, or plan. Grill is an input-quality tool, not an artifact of its own.
 
-Any persona about to author an artifact can invoke it: Pepper before a brief, Maria Hill before a PRD, Tony before epics/stories/architecture, Wizer when a demand arrives fuzzy. Wizer also **suggests** it from `/wize-help` — always suggest, never force.
+Any persona about to author an artifact can invoke it: Pepper before a brief, Maria Hill before a PRD, Tony before epics/stories/architecture, Wizer when a demand arrives fuzzy. Wizer also **suggests** it from `/wize` (or `/wize-help`) — always suggest, never force.
 
 ## The five rules
 

package/src/core-skills/wize-index-docs/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-index-docs
+description: "Use quando precisar reconstruir o índice da base de conhecimento (.wize/knowledge/index.md) a partir da árvore real de artefatos."
 name: Index Docs
 module: core
 status: ready
@@ -114,4 +116,4 @@ total_files: 24
 
 ## Hand-off
 
-> "Index rebuilt at `.wize/knowledge/index.md`. {N} files indexed across 5 sections. Next: `/wize-help` reads this file when answering."
+> "Index rebuilt at `.wize/knowledge/index.md`. {N} files indexed across 5 sections. Next: `/wize` (or `/wize-help`) reads this file when answering."

package/src/core-skills/wize-pre-pr-check/skill.md

@@ -0,0 +1,134 @@
+---
+code: wize-pre-pr-check
+name: wize-pre-pr-check
+module: core
+description: "Quando for abrir um Pull Request ou PR leia"
+---
+
+# Pre-PR Check
+
+**Goal.** Rodar os checks obrigatórios localmente antes de abrir um PR, falhando cedo e rápido. Evita ciclagem cara de CI no Actions — principalmente lint, format, build e testes rápidos. O objetivo é ser um portão (gate) antes de submeter código.
+
+**Agnóstica de tecnologia.** Não prescreve ferramentas específicas; lê os comandos disponíveis no repositório e executa o que for aplicável.
+
+## When to run
+
+- Imediatamente antes de `git push` para uma branch de PR.
+- Antes de abrir o PR no GitHub/GitLab.
+- Após `git commit` na branch de feature, como sanity check.
+- A qualquer momento durante o desenvolvimento — fail fast.
+
+## When NOT to run
+
+- Quando o CI já está verde e o PR está em revisão (o gate já passou).
+- Quando o repositório não tem scripts/ferramentas de lint/test configurados.
+
+## Operating contract
+
+- **Leia o projeto antes de rodar.** Procura por `package.json`, `composer.json`, `Makefile`, `justfile`, `pyproject.toml`, `Cargo.toml`, etc. para descobrir os comandos de check existentes.
+- **Só execute o que existir.** Se não houver `eslint`, pule o passo de lint. Se não houver `phpstan`, pule o passo de análise estática. Nunca exija uma ferramenta que não esteja configurada no repo.
+- **Pare no primeiro erro.** A menos que o usuário peça `--continue`, um check que falha interrompe a cadeia — corrija antes de continuar.
+- **Não seja um substituto completo do CI.** O CI continua sendo a fonte da verdade para testes de integração, e2e, banco de dados, Docker, etc. Este gate é para checks rápidos e baratos.
+- **Custo zero no Actions.** Tudo roda localmente.
+
+## Inputs
+
+- Estado atual do working tree (staged + unstaged).
+- Arquivos de config do projeto para descobrir comandos.
+
+## Outputs
+
+- Relatório compacto de quais checks passaram/falharam.
+- Se falhou: mensagem de erro + arquivo(s) sugerido(s) para corrigir.
+- Se passou: confirmação pronta para PR.
+
+## Steps
+
+### 1. Detectar stack
+
+Procurar nos arquivos de config do projeto quais ferramentas estão disponíveis:
+
+| Fonte | O que extrair |
+|-------|---------------|
+| `package.json` → `scripts` | `lint`, `format`, `format:check`, `type-check`, `build`, `test`, `test:unit` |
+| `composer.json` → `scripts` | `test`, `phpstan`, `pint`, `phpcs` |
+| `Makefile` / `justfile` | targets `lint`, `format`, `check`, `test` |
+| `pyproject.toml` / `setup.cfg` | `flake8`, `black`, `mypy`, `pytest` |
+| `Cargo.toml` | `cargo check`, `cargo test`, `cargo clippy`, `cargo fmt` |
+| `.github/workflows/*.yml` | steps de `lint`, `format`, `build`, `test` (como referência, não para rodar) |
+
+Heurística de prioridade: scripts do gerenciador de pacote local (`npm run`, `composer run`) > binários diretos (`vendor/bin/pint`) > comandos genéricos (`cargo clippy`).
+
+### 2. Selecionar checks por velocidade
+
+Separar em **rápido** (executa em segundos) e **lento** (minutos):
+
+**Rápido (executar sempre):**
+- Lint (ESLint, PHPStan, Clippy, Ruff, etc.)
+- Format check (Prettier, Pint, Black, rustfmt)
+- Type check (tsc, mypy)
+- Análise estática (PHPStan, Psalm)
+
+**Lento (executar quando houver mudanças relevantes):**
+- Build (Vite, Webpack, Cargo build)
+- Testes unitários (Vitest, Jest, Pest, pytest, `cargo test`)
+- Guard-rails custom (scripts próprios do projeto, ex: `check:orphans`)
+
+**Muito lento (opcional / em dia de merge):**
+- Testes de integração
+- E2E (Playwright, Cypress)
+- Build de Docker
+
+### 3. Rodar o gate
+
+Na ordem: format → lint → type-check → build → testes unitários → guard-rails.
+
+Comandos típicos por stack (detectados em tempo real, não hardcoded):
+
+| Stack | Comandos comuns |
+|-------|-----------------|
+| Node/JS/TS | `npm run format:check`, `npm run lint`, `npm run check:type` (ou `tsc --noEmit`), `npm run build`, `npm run test` |
+| PHP/Laravel | `vendor/bin/pint --test`, `vendor/bin/phpstan analyse`, `php artisan test` |
+| Python | `black --check`, `ruff check`, `mypy`, `pytest` |
+| Rust | `cargo fmt -- --check`, `cargo clippy`, `cargo check`, `cargo test` |
+| Go | `gofmt -l`, `golangci-lint run`, `go test ./...` |
+
+Se um check falhar, pare e reporte. Não prossiga para o próximo.
+
+### 4. Reportar
+
+Formato compacto, uma linha por check:
+
+```
+✓ format:check   (npm run format:check)     — 0.8s
+✓ lint           (vendor/bin/pint --test)   — 2.1s
+✗ phpstan        (vendor/bin/phpstan)       — 4.5s → FAIL
+  app/Http/Controllers/LegalController.php:11 — FQCN não importado
+→ Corrija antes de abrir o PR.
+```
+
+Se tudo passar:
+
+```
+✓ format:check   — PASS  (0.8s)
+✓ lint           — PASS  (2.1s)
+✓ phpstan        — PASS  (4.5s)
+✓ build          — PASS  (32s)
+✓ test:unit      — PASS  (30s)
+─────────────────────────────
+Gate limpo. Pode abrir o PR.
+```
+
+## Anti-patterns
+
+- **Rodar checks que não existem no repo.** Se não há `composer.json`, não tente `vendor/bin/pint`.
+- **Ignorar falhas de lint.** Lint fail = PR fail. Corrija antes.
+- **Executar E2E localmente toda vez.** E2E é caro; deixe para o CI ou rode antes de merge.
+- **Substituir o CI.** Este gate é complementar, não substituto.
+
+## Hand-off
+
+> Gate `wize-pre-pr-check` concluído. `{passados}/{total}` checks passaram. `{tempo_total}s`. Pronto para PR.
+
+Se houve falha:
+> Gate `wize-pre-pr-check` interrompido em `{check_falho}`. Corrija e re-execute antes de abrir o PR.

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

@@ -1,5 +1,7 @@
 ---
+
 code: wize-review-adversarial
+description: "Use quando um artefato (story, arquitetura, PRD) precisar de revisão adversarial — testar a ideia sob quatro personas hostis."
 name: Adversarial Review
 module: core
 status: stub

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

@@ -1,5 +1,7 @@
 ---
+
 code: wize-review-edge-case-hunter
+description: "Use quando um código ou PR precisar de caça sistemática de edge cases ranqueados por probabilidade × impacto."
 name: Edge Case Hunter
 module: core
 status: ready

package/src/core-skills/wize-shard-doc/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-shard-doc
+description: "Use quando um documento markdown grande (PRD, arquitetura) precisar ser dividido em shards endereçáveis por ID."
 name: Shard Doc
 module: core
 status: stub

package/src/core-skills/wize-spec/skill.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-spec
+description: "Use quando precisar destilar qualquer entrada de intenção (ideia, PRD, RFC, transcrição) em um contrato canônico SPEC.md para consumo downstream."
 name: Spec
 module: core
 status: ready

package/src/method-skills/1-analysis/wize-agent-analyst/agent.yaml

@@ -23,6 +23,9 @@ absorbs:
 skills:
   - wize-product-brief
   - wize-research
+  - wize-market-research
+  - wize-domain-research
+  - wize-technical-research
   - wize-trigger-map
   - wize-prfaq
   - wize-document-project

package/src/method-skills/1-analysis/wize-document-project/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-document-project
+description: "Use quando o kit for instalado em um repositório existente (brownfield) e precisar documentar o estado atual do projeto."
 name: Document Project (brownfield baseline)
 phase: 1-analysis
 owner: wize-agent-analyst   # Pepper Potts (paired with Peggy Carter and Tony Stark)

package/src/method-skills/1-analysis/wize-domain-research/workflow.md

@@ -4,8 +4,15 @@ name: Domain Research
 phase: 1-analysis
 owner: wize-agent-analyst   # Pepper Potts
 status: ready
+description: "Use quando precisar pesquisar um domínio de negócio, indústria ou setor."
 ---
 
+> **Variante de pesquisa.** Para outros tipos de pesquisa, veja:
+> - Mercado/concorrência → `/wize-market-research`
+> - Domínio/indústria → `/wize-domain-research`
+> - Técnica/stack → `/wize-technical-research`
+> - Pesquisa geral (dispatcher) → `/wize-research`
+
 # Domain Research
 
 **Goal.** Conduct domain and industry research to ground the product in its business, regulatory, and technical context.

package/src/method-skills/1-analysis/wize-market-research/workflow.md

@@ -4,8 +4,15 @@ name: Market Research
 phase: 1-analysis
 owner: wize-agent-analyst   # Pepper Potts
 status: ready
+description: "Use quando precisar pesquisar mercado, concorrentes, tendências ou posicionamento."
 ---
 
+> **Variante de pesquisa.** Para outros tipos de pesquisa, veja:
+> - Mercado/concorrência → `/wize-market-research`
+> - Domínio/indústria → `/wize-domain-research`
+> - Técnica/stack → `/wize-technical-research`
+> - Pesquisa geral (dispatcher) → `/wize-research`
+
 # Market Research
 
 **Goal.** Conduct market research on competition and customers to inform the product brief and PRD.

package/src/method-skills/1-analysis/wize-prfaq/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-prfaq
+description: "Use quando precisar forçar alinhamento escrevendo o press release futuro e FAQ antes de construir — estilo Amazon Working Backwards."
 name: PR/FAQ
 phase: 1-analysis
 owner: wize-agent-analyst   # Pepper Potts

package/src/method-skills/1-analysis/wize-product-brief/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-product-brief
+description: "Use quando uma demanda bruta chegar e precisar ser convertida em um product brief de uma página."
 name: Product Brief
 phase: 1-analysis
 owner: wize-agent-analyst   # Pepper Potts

package/src/method-skills/1-analysis/wize-refresh-knowledge/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-refresh-knowledge
+description: "Use quando o document-project acumulou bullets datados durante o sprint e precisar ser consolidado em uma baseline atualizada."
 name: Refresh Project Knowledge
 phase: 1-analysis
 owner: wize-agent-analyst    # Pepper (drives), with Peggy on prose
@@ -16,7 +18,7 @@ Pepper drives the consolidation. Peggy edits prose. Tony reviews architecture-sn
 
 ## When to run
 
-- **End of sprint** (default cadence). `wize-help next` suggests it when it detects the sprint ended.
+- **End of sprint** (default cadence). `/wize next` (or `/wize-help next`) suggests it when it detects the sprint ended.
 - **After a major epic ships.** Architecture often shifts visibly; this is the moment to consolidate.
 - **Before onboarding a new engineer.** The baseline is the first thing they read; keep it fresh.
 - **Before an audit / external review.** Same.