wize-dev-kit 0.1.0

package/ARCH.md

@@ -0,0 +1,341 @@
+# Wize Development Kit — Arquitetura Proposta v1
+
+> Consolidação das Fases 1-7 da entrevista. Pré-build.
+> Referências de inspiração: BMAD Method v6.8.0 + WDS Expansion (Norse).
+> Tema do roster: **Marvel**.
+
+---
+
+## 1. Identidade
+
+- **Nome do pacote npm:** `wize-dev-kit`
+- **CLI:** `wize-dev-kit` (subcomandos: `install`, `update`, `uninstall`, `agent`, `workflow`, `sync`)
+- **Namespace de arquivos/agentes/skills:** `wize-*`
+- **Licença:** MIT — open-source desde o dia 1.
+- **Tema visual do roster:** Marvel.
+- **Tema visual do WDS embarcado:** Norse (mantido por dentro como tributo à referência).
+
+---
+
+## 2. Modelo de distribuição
+
+**1 pacote, 3 perfis selecionáveis, overlays combináveis.**
+
+```
+wize-dev-kit (pacote npm)
+│
+├── Wize Dev Core      ← base completa (sempre instalada)
+├── Wize Web Dev       ← overlay opt-in
+└── Wize App Development ← overlay opt-in
+                     (Web + App podem coexistir no mesmo repo)
+```
+
+- Selecionar perfil no installer aplica Core + overlay correspondente.
+- Multi-perfil suportado (monorepo).
+- TEA (Hawkeye) e WDS (Pepper+Mantis) **sempre embutidos** no Core — não são opcionais.
+
+---
+
+## 3. Roster final (9 personas Marvel)
+
+| Persona | Code | Papel | Fase principal |
+|---|---|---|---|
+| Wizer | `wize-orchestrator` | Orchestrator / KB / Briefing | Todas |
+| Pepper Potts | `wize-agent-analyst` | Business Analyst + WDS-Saga | 1 (Analysis) |
+| Peggy Carter | `wize-agent-tech-writer` | Technical Writer | Transversal |
+| Maria Hill | `wize-agent-pm` | Product Manager | 2 (Planning) |
+| Mantis | `wize-agent-ux-designer` | UX (Whiteport / WDS-Freya) | 2-3 |
+| Nick Fury | `wize-agent-solution-strategist` | Solution Strategy / Tech Vision | 2→3 boundary |
+| Tony Stark | `wize-agent-architect` | System Architect | 3 (Solutioning) |
+| Hawkeye | `wize-agent-test-architect` | Test Architect (TEA) | Gates 2/3/4 |
+| Shuri | `wize-agent-dev` | Senior Developer | 4 (Implementation) |
+
+---
+
+## 4. Fluxo canônico (full-cycle)
+
+```
+┌─ FASE 1: Analysis ───────────────────────────────┐
+│  Pepper Potts (Analyst + WDS Saga)              │
+│    → brief.md                                   │
+│    → research.md                                │
+│    → trigger-map.md  (WDS)                      │
+│  Peggy Carter (transversal): edita docs.        │
+└──────────────────────────────────────────────────┘
+         │
+         ▼
+┌─ FASE 2: Planning ──────────────────────────────┐
+│  Maria Hill (PM)                                │
+│    → prd.md                                     │
+│  Mantis (UX/WDS Freya, depois do PRD)           │
+│    → ux-scenarios.md   (WDS 8-question dialog) │
+│    → ux-design/        (page specs)             │
+│  Hawkeye: pre-risk advisory (leve, opcional).   │
+└──────────────────────────────────────────────────┘
+         │
+         ▼
+┌─ FASE 2→3 Boundary: Strategy ───────────────────┐
+│  Nick Fury (Solution Strategy)                  │
+│    → tech-vision.md                             │
+│    → nfr-principles.md                          │
+└──────────────────────────────────────────────────┘
+         │
+         ▼
+┌─ FASE 3: Solutioning ───────────────────────────┐
+│  Tony Stark (System Architect)                  │
+│    → architecture.md                            │
+│    → adrs/                                      │
+│    → epics/                                     │
+│    → stories/                                   │
+│  Mantis (continua): design-system/ + tokens     │
+│  Hawkeye:                                       │
+│    → risk-profile.md  (gate global)             │
+└──────────────────────────────────────────────────┘
+         │
+         ▼
+┌─ FASE 4: Implementation ────────────────────────┐
+│  Por story:                                     │
+│    Hawkeye → design.md (test design)            │
+│    Shuri   → implementa (TDD)                   │
+│    Hawkeye → trace.md (AC↔Test)                 │
+│    Hawkeye → review.md                          │
+│    Hawkeye → gate.md (PASS/CONCERNS/FAIL/WAIVE) │
+│  Por epic:                                      │
+│    Hawkeye → nfr/{epic}.md                      │
+│  Por sprint:                                    │
+│    Maria Hill → sprint-status.md                │
+│    Wizer/Maria → retrospective.md               │
+└──────────────────────────────────────────────────┘
+```
+
+### Atalho quick-dev
+
+`wize-quick-dev` (disponível em todos os perfis): pula brief/PRD/architecture. Shuri executa direto sob supervisão leve de Hawkeye (smoke test + lint). Para bugs, ajustes pequenos, manutenção.
+
+---
+
+## 5. Layout do repo-alvo (após install)
+
+```
+.wize/
+├── config/
+│   ├── project.toml         # Perfil(s), stack, conventions, idioma
+│   ├── user.toml            # Customizações (preservado em updates)
+│   └── tea.toml             # Granularidade gates, política de bloqueio
+│
+├── planning/
+│   ├── brief.md
+│   ├── research.md
+│   ├── ux/
+│   │   ├── trigger-map.md      (Pepper / WDS Saga)
+│   │   ├── ux-scenarios.md     (Mantis / WDS Freya)
+│   │   ├── ux-design/          (Mantis)
+│   │   └── design-system/      (Mantis)
+│   ├── prd.md                  (Maria Hill)
+│   ├── tech-vision.md          (Fury)
+│   └── nfr-principles.md       (Fury)
+│
+├── solutioning/
+│   ├── architecture.md         (Tony)
+│   ├── adrs/                   (Tony)
+│   ├── epics/                  (Tony)
+│   └── stories/                (Tony)
+│
+├── implementation/
+│   ├── sprint-status.md
+│   ├── retrospective.md
+│   └── tea/                    (Hawkeye)
+│       ├── risk-profile.md
+│       ├── nfr/{epic}.md
+│       └── {epic}/{story}/{design,trace,review,gate}.md
+│
+├── knowledge/                  (long-lived: docs, research, references)
+│
+└── custom/                     (Agent Builder output)
+    ├── agents/{code}/
+    ├── skills/{code}/
+    └── workflows/{code}/
+```
+
+E nos IDE-targets (selecionáveis no install):
+
+```
+.claude/skills/wize-*           (Claude Code)
+.cursor/rules/wize-*.mdc        (Cursor)
+.windsurf/...                   (Windsurf)
+.codex/...                      (Codex)
+.continue/...                   (Continue)
+.kimi/...                       (Kimi Code)
+.opencode/...                   (OpenCode)
+.antigravity/...                (Antigravity CLI/IDE)
+.wize/agents/                   (fallback genérico)
+```
+
+---
+
+## 6. Test Architect (Hawkeye) — gates
+
+| Gate | Quando roda | Output | Quem aprova |
+|---|---|---|---|
+| `risk` | 1× pós-architecture | `tea/risk-profile.md` (matriz prob × impact) | Hawkeye + humano |
+| `design` | Início da story | `tea/{epic}/{story}/design.md` | Hawkeye |
+| `trace` | Durante/após implementação | `tea/{epic}/{story}/trace.md` | Hawkeye |
+| `nfr` | Pré-merge do epic | `tea/nfr/{epic}.md` | Hawkeye + humano |
+| `review` | Fim da story | `tea/{epic}/{story}/review.md` | Hawkeye |
+| `gate` | Final da story | `tea/{epic}/{story}/gate.md` (PASS/CONCERNS/FAIL/WAIVED) | Hawkeye + humano |
+
+- Formato: Markdown + YAML frontmatter (status, score, findings, AC IDs).
+- Política default: **advisory**; enforcing opt-in via `tea.toml`.
+
+---
+
+## 7. Installer
+
+```
+wize-dev-kit install
+  ├─ Detecta: greenfield vs brownfield
+  ├─ Pergunta: perfil(s) — Core / +Web / +App
+  ├─ Pergunta: IDE targets — multi-select
+  ├─ Pergunta: idioma e output_folder
+  ├─ Cria .wize/ + adapters IDE
+  ├─ Se brownfield: oferece `wize-document-project`
+  └─ Se ok: dispara onboarding (Wizer → Pepper/Mantis/Tony)
+
+wize-dev-kit update   # diff + preserva customizações
+wize-dev-kit uninstall # remove kit, preserva código
+wize-dev-kit agent create | edit | list
+wize-dev-kit workflow create
+wize-dev-kit sync     # regera adapters IDE
+```
+
+---
+
+## 8. Overlays Web e App
+
+### Wize Web Dev (overlay)
+
+- Workflows extras: `wize-web-scaffold` (Next/Vue/etc), `wize-web-deploy`, `wize-web-seo-audit`.
+- Artefatos extras: `seo-strategy.md`, `analytics-plan.md`, `design-tokens.json` (responsivo).
+- Hawkeye playbook: Playwright/Vitest patterns.
+- Mantis playbook: WCAG, breakpoints, semantic HTML.
+
+### Wize App Development (overlay)
+
+- Workflows extras: `wize-app-scaffold` (RN/Expo/Flutter/native), `wize-app-release-channels`, `wize-app-store-listing`.
+- Artefatos extras: `mobile-store-listing.md`, `app-perms-and-privacy.md`, `release-channels.md`.
+- Hawkeye playbook: Detox/Maestro patterns.
+- Mantis playbook: HIG/Material 3, touch targets, gestures, permissions UX.
+
+---
+
+## 9. Agent Builder
+
+- 3 skills meta: `wize-create-agent`, `wize-create-skill`, `wize-create-workflow`.
+- Customização de built-ins via `.wize/custom/{tipo}/{code}/customize.toml` (override sem fork).
+- Validação obrigatória: schema → lint → dry-run.
+- Auto-sync: regera adapters de todos os IDEs ativos a cada criação/edição.
+
+---
+
+## 10. Onboarding pós-install (Wizer)
+
+1. Wizer triages: greenfield vs brownfield, perfil, objetivo do projeto.
+2. Se brownfield: oferece rodar `wize-document-project` (Tony + Peggy geram baseline).
+3. Wizer chama Pepper para começar brief (ou direto Maria Hill se brief existe).
+4. Wizer roteia entre personas conforme a conversa avança.
+
+---
+
+## 11. Estrutura do repo `wize-dev-kit/` (source code do kit)
+
+```
+wize-dev-kit/
+├── package.json                # main: tools/installer/wize-cli.js, bin: { wize-dev-kit }
+├── README.md
+├── LICENSE                     # MIT
+├── CHANGELOG.md
+├── DECISIONS.md                # ← este log (preservado no repo)
+├── ARCH.md                     # ← este doc
+├── ROSTER.md                   # ← quadro Marvel
+│
+├── src/
+│   ├── core-skills/            # Core (advanced-elicitation, brainstorming, party-mode, etc)
+│   │   └── wize-*/
+│   ├── method-skills/          # AI Agile dev: 1-analysis, 2-plan, 3-solutioning, 4-implementation
+│   │   ├── 1-analysis/
+│   │   │   ├── wize-agent-analyst/        (Pepper)
+│   │   │   ├── wize-agent-tech-writer/    (Peggy)
+│   │   │   ├── wize-document-project/
+│   │   │   ├── wize-product-brief/
+│   │   │   ├── wize-trigger-map/          (WDS)
+│   │   │   ├── wize-prfaq/
+│   │   │   └── research/
+│   │   ├── 2-plan-workflows/
+│   │   │   ├── wize-agent-pm/             (Maria Hill)
+│   │   │   ├── wize-agent-ux-designer/    (Mantis)
+│   │   │   ├── wize-create-prd/
+│   │   │   ├── wize-ux-scenarios/         (WDS)
+│   │   │   ├── wize-ux-design/            (WDS)
+│   │   │   └── wize-validate-prd/
+│   │   ├── 3-solutioning/
+│   │   │   ├── wize-agent-solution-strategist/ (Fury)
+│   │   │   ├── wize-agent-architect/      (Tony)
+│   │   │   ├── wize-create-architecture/
+│   │   │   ├── wize-create-epics-and-stories/
+│   │   │   ├── wize-design-system/        (WDS)
+│   │   │   └── wize-check-implementation-readiness/
+│   │   └── 4-implementation/
+│   │       ├── wize-agent-dev/            (Shuri)
+│   │       ├── wize-create-story/
+│   │       ├── wize-dev-story/
+│   │       ├── wize-quick-dev/
+│   │       ├── wize-sprint-planning/
+│   │       ├── wize-sprint-status/
+│   │       ├── wize-retrospective/
+│   │       └── wize-code-review/
+│   ├── tea-skills/             # Test Architect (Hawkeye)
+│   │   ├── wize-agent-test-architect/
+│   │   ├── wize-tea-risk/
+│   │   ├── wize-tea-design/
+│   │   ├── wize-tea-trace/
+│   │   ├── wize-tea-nfr/
+│   │   ├── wize-tea-review/
+│   │   └── wize-tea-gate/
+│   ├── orchestrator-skills/    # Wizer
+│   │   ├── wize-orchestrator/
+│   │   ├── wize-onboarding/
+│   │   └── wize-party-mode/
+│   ├── builder-skills/         # Agent Builder
+│   │   ├── wize-create-agent/
+│   │   ├── wize-create-skill/
+│   │   └── wize-create-workflow/
+│   ├── web-overlay/            # Wize Web Dev overlay
+│   │   ├── wize-web-scaffold/
+│   │   ├── wize-web-seo-audit/
+│   │   └── module.yaml
+│   └── app-overlay/            # Wize App Development overlay
+│       ├── wize-app-scaffold/
+│       ├── wize-app-release-channels/
+│       └── module.yaml
+│
+├── adapters/                   # IDE adapters
+│   ├── claude-code/
+│   ├── cursor/
+│   ├── windsurf/
+│   ├── codex/
+│   ├── continue/
+│   ├── kimi-code/
+│   ├── opencode/
+│   ├── antigravity/
+│   └── generic/
+│
+├── tools/
+│   └── installer/
+│       ├── wize-cli.js
+│       ├── detect.js           # greenfield/brownfield detector
+│       ├── onboarding.js
+│       ├── sync.js
+│       └── validators/         # schema, lint, dry-run
+│
+└── test/                       # specs validating skills + workflows
+```

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to **wize-dev-kit** are documented here.
+Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [Unreleased]
+
+### Added
+
+- Initial skeleton (v0.1.0 scaffold).
+- 9-persona Marvel roster: Wizer, Pepper Potts, Peggy Carter, Maria Hill, Mantis, Nick Fury, Tony Stark, Hawkeye, Shuri.
+- Three profile structure: Wize Dev Core + Wize Web Dev overlay + Wize App Development overlay.
+- Test Architect (Hawkeye) with 6 canonical gates: risk, design, trace, nfr, review, gate.
+- Whiteport Design Studio embedded: Pepper absorbs Saga (Analyst), Mantis absorbs Freya (Designer).
+- Agent Builder skill set: `wize-create-agent`, `wize-create-skill`, `wize-create-workflow`.
+- Multi-IDE adapters: Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, OpenCode, Antigravity, generic fallback.
+- Installer CLI skeleton with greenfield/brownfield detection.
+
+### References
+
+- Inspired by [BMAD Method v6.8.0](https://github.com/bmad-code-org/BMAD-METHOD).
+- WDS module inspired by [bmad-method-wds-expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion).
+
+[Unreleased]: https://github.com/qwize/wize-dev-kit/compare/v0.1.0...HEAD

package/DECISIONS.md

@@ -0,0 +1,141 @@
+# Wize Development Kit — Decisions Log
+
+> Log vivo de decisões tomadas durante a entrevista de design.
+> Inspiração: BMAD Method v6.8.0 (repositório-pai deste workspace).
+> Data início: 2026-05-31.
+
+## Estado
+
+- **Fase atual:** Entrevista — Discovery
+- **Pasta destino:** `wize-dev-kit/`
+- **Repositório de inspiração:** BMAD Method (raiz deste repo)
+
+## Escopo confirmado pelo usuário
+
+- Pacote instalável em qualquer repositório (greenfield ou brownfield).
+- **Não importar** todos os stacks do BMAD; selecionar:
+  - **Core** (core-skills do BMAD).
+  - **Method**: Full-lifecycle AI agile development (analysis, planning, architecture, implementation).
+  - **Test Architect (Q/A)** — embutido em todos os produtos.
+  - **Agent Builder** — incluso.
+  - **UX — Whiteport Design Studio v0.4.3** — embutido em todos os produtos.
+- **Três produtos derivados:**
+  1. **Wize Development Core** = Core + AI Agile Dev.
+  2. **Wize Web Dev**.
+  3. **Wize App Development**.
+- Todos os três embutem Test Architect + UX (Whiteport).
+- Documentação de inspiração: https://docs.bmad-method.org//llms-full.txt
+
+## Decisões
+
+### Fase 1 — Posicionamento, naming, distribuição
+
+- **D1.1 — Distribuição:** 1 pacote npm único (`wize-dev-kit`) com 3 perfis selecionáveis no install (Core / Web / App). Inspirado no installer único do BMAD. _Single source of truth, menor custo de manutenção._
+- **D1.2 — CLI:** comando principal `wize-dev-kit`. Subcomandos: `wize-dev-kit install`, `wize-dev-kit agent`, `wize-dev-kit workflow`, etc. _(Nome custom do usuário, não abreviar para `wize` nem `wdk`.)_
+- **D1.3 — Namespace de arquivos/skills/agents:** prefixo `wize-` (ex.: `wize-agent-architect`, `wize-create-prd`). Espelha a convenção `bmad-*` do original.
+- **D1.4 — Público-alvo:** **Open-source desde o dia 1**. Licença MIT, docs públicas, contribuições externas bem-vindas. Decisões de design devem favorecer generalidade e clareza.
+
+### Fase 2 — Installer (greenfield + brownfield)
+
+- **D2.1 — Brownfield:** installer **auto-detecta** sinais (`package.json`, `src/`, histórico git) e **oferece rodar `wize-document-project`** antes de qualquer planning para gerar baseline de arquitetura/docs do estado atual.
+- **D2.2 — Pasta de artefatos:** `.wize/` na raiz do repo-alvo (oculta, isolada). Subpastas padrão: `.wize/planning/`, `.wize/implementation/`, `.wize/knowledge/`, `.wize/config/`.
+- **D2.3 — IDE targets (multi-runtime):** suporte verboso no installer, **selecionável** durante o setup (estilo BMAD). Targets:
+  - **Claude Code** — `.claude/skills/wize-*` (skills nativas).
+  - **Cursor** — `.cursor/rules/` (regras MDC).
+  - **Windsurf**, **Codex**, **Continue** — adaptadores específicos.
+  - **Kimi Code**, **OpenCode**, **Antigravity (CLI e IDE)** — adaptadores específicos (não cobrir via fallback genérico).
+  - **Fallback genérico:** `.wize/agents/` em markdown para qualquer outro agente.
+  - **Web bundles:** _decisão adiada_ — não selecionado nesta rodada; reavaliar na Fase 8 se útil para distribuição open-source.
+- **D2.4 — Lifecycle do installer:** **idempotente, com install / update / uninstall completos**. Re-rodar `install` aplica diff preservando customizações em `config.user.toml`. `uninstall` remove tudo do kit sem tocar código do projeto. Espelha BMAD.
+
+### Fase 3 — Roster de agentes (tema Marvel)
+
+- **D3.1 — Personas:** tema **Marvel**, não herdar nomes BMAD. Roster final em `ROSTER.md`.
+- **D3.2 — 9 papéis no kit dev:**
+  1. **Wizer** — `wize-orchestrator` (Knowledge Base / Briefing / Distribuição, tools globais).
+  2. **Pepper Potts** — `wize-agent-analyst` (Business Analyst — brief, research, PRFAQ).
+  3. **Peggy Carter** — `wize-agent-tech-writer` (Technical Writer transversal).
+  4. **Maria Hill** — `wize-agent-pm` (PM — PRD, epics, sprints).
+  5. **Mantis** — `wize-agent-ux-designer` (UX/Whiteport v0.4.3 — empathy, JTBD).
+  6. **Nick Fury** — `wize-agent-solution-strategist` (Solution Strategy / Tech Vision — boundary Fase 2→3).
+  7. **Tony Stark** — `wize-agent-architect` (System Architect — Fase 3).
+  8. **Hawkeye** — `wize-agent-test-architect` (TEA — gates em 2, 3, 4).
+  9. **Shuri** — `wize-agent-dev` (Senior Developer — Fase 4).
+- **D3.3 — Agent Builder:** entregue como **skill** (`wize-create-agent`), não como agente. Wizer chama a skill quando precisa registrar nova persona/módulo custom em `_wize/custom/`.
+- **D3.4 — Team default:** `software-development`. Times variantes (`web-dev`, `app-dev`) — decisão movida para Fase 4 (fluxos).
+- **D3.5 — Escopo Marvel fora do kit:** Fury e Pepper já alocados aqui. Outras personas (Black Panther, Wanda, Falcon, Vision, Riri, Kamala) ficam reservadas para kits futuros (Wize Ops, Wize Data, Wize Security).
+
+### Fase 4 — Fluxos por produto (Core / Web / App)
+
+- **D4.1 — Arquitetura de perfis:** Core é a **base completa** (todas as fases + TEA + UX). Web e App são **overlays** que adicionam skills/workflows extras (scaffolds, deploy, stack-specific). Selecionar perfil no install = Core + overlay(s).
+- **D4.2 — Stack-agnóstico:** kit **não impõe stack**. Conhecimento de opções (Web: Laravel/Vue, Next/React, Supabase, etc.; App: native, Expo, etc.) vive como **catálogo de referência** dentro dos agentes (Tony e Fury). Stack é decidido em **entrevista pós-install** conduzida por Wizer → Tony.
+- **D4.3 — Quick-dev:** workflow `wize-quick-dev` disponível em **todos os 3 perfis**. Pula brief/PRD/architecture para tasks pequenas. Mantém TEA leve (smoke + lint). Espelha o quick-dev do BMAD.
+- **D4.4 — Test Architect cross-stack:** **um único agente** Hawkeye, **genérico**, sem stack-awareness. Ferramentas concretas de teste vêm de Tony (na arquitetura) e Shuri (na implementação). Hawkeye decide gates, define critérios, avalia risco — independente de stack.
+- **D4.5 — Ordem das fases:** seguir ordem **BMAD canônica** — Whiteport (Mantis) entra **depois** do PRD (Maria Hill). Sequência: Pepper (brief/research) → Maria Hill (PRD) → Mantis (UX strategy + flows) → Fury (solution strategy) → Tony (architecture/ADR) → Hawkeye (TEA gates) → Shuri (implementation).
+- **D4.6 — Onboarding pós-install:** **Wizer abre** a sessão pós-install, faz triagem (greenfield/brownfield, perfil, objetivo) e **delega** para especialistas: Pepper (brief), Mantis (UX baseline), Tony (architecture preferences/stack). Cada agente pergunta o que precisa. Modelo distribuído.
+- **D4.7 — Multi-perfil:** Web e App podem coexistir no **mesmo repo** (monorepo). Installer aceita ativar múltiplos overlays. Wizer roteia conforme path/pacote.
+- **D4.8 — Catálogo de artefatos:** **fixo no Core**, **extensível nos overlays**.
+  - Core: `brief.md`, `research.md`, `prd.md`, `ux-strategy.md`, `ux-flows.md`, `architecture.md`, `epics/`, `stories/`, `sprint-status.md`, `retrospective.md`, `tea/risk.md`, `tea/test-design.md`, `tea/trace.md`, `tea/nfr.md`, `tea/gate.md`.
+  - Web overlay (exemplos): `design-tokens.json`, `seo-strategy.md`, `analytics-plan.md`.
+  - App overlay (exemplos): `mobile-store-listing.md`, `app-perms-and-privacy.md`, `release-channels.md`.
+
+### Fase 5 — Test Architect (Hawkeye)
+
+- **D5.1 — Gates oferecidos:** **pacote completo de 6 gates** (espelha BMAD QA):
+  1. `risk` — Risk Profile (matriz prob × impact), 1× pós-architecture.
+  2. `design` — Test Design por story (unit/integration/e2e splits, mocks, fixtures).
+  3. `trace` — Traceability AC ↔ Test.
+  4. `nfr` — NFR Assessment (perf, sec, reliability, maintainability, a11y), por epic.
+  5. `review` — Story Review estruturado (independente do code-review do Shuri).
+  6. `gate` — Gate Decision final (`PASS` / `CONCERNS` / `FAIL` / `WAIVED`) com justificativa.
+- **D5.2 — Granularidade:** **por story** (default). Risk roda 1× pós-architecture; NFR roda por epic; design/trace/review/gate rodam por story. Configurável via `.wize/config/tea.toml` para times maduros reduzirem.
+- **D5.3 — Formato:** **Markdown + YAML frontmatter** estruturado (status, score, findings, AC IDs). Humano-legível + parseável por CI. Espelha BMAD QA.
+- **D5.4 — Política de bloqueio:** **advisory por padrão, enforcing opt-in**. Gate `FAIL` gera warning visível mas não bloqueia merge default. Opt-in via `.wize/config/tea.toml` para CI bloquear. Permite adoção gradual.
+- **D5.5 — Localização:** `.wize/implementation/tea/{epic}/{story}/{gate}.md` (gates por story); `.wize/implementation/tea/risk-profile.md` (global pós-architecture); `.wize/implementation/tea/nfr/{epic}.md` (por epic).
+
+### Fase 6 — Whiteport Design Studio (WDS) — Mantis
+
+> **Referência canônica:** [bmad-code-org/bmad-method-wds-expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion) (Pantheon Norse: Saga + Freya).
+
+- **D6.1 — Mapeamento WDS → Marvel:**
+  - **Pepper Potts** absorve **Saga** (Analyst): Product Brief + Trigger Mapping.
+  - **Mantis** absorve **Freya** (Designer): UX Scenarios + UX Design + Design System.
+  - Sem novos agentes; roster permanece com 9 personas.
+- **D6.2 — Fases adotadas (subset essencial 5 de 8):**
+  1. Product Brief — **Pepper**.
+  2. Trigger Map (user psychology + business goals) — **Pepper**.
+  3. UX Scenarios (8-question dialog) — **Mantis**.
+  4. UX Design (page specs, interactions) — **Mantis**.
+  5. Design System (component library, design tokens) — **Mantis**.
+  - **Não adotadas:** Asset Generation (fora do escopo dev kit), Agentic Development (já é responsabilidade de Shuri), Product Evolution (já é responsabilidade de Wizer + retrospective).
+- **D6.3 — Estrutura de pastas:** `.wize/planning/ux/` com nomes Wize.
+  - `brief.md` (Pepper)
+  - `trigger-map.md` (Pepper)
+  - `ux-scenarios.md` (Mantis)
+  - `ux-design/` (Mantis: page specs)
+  - `design-system/` (Mantis: tokens + components)
+- **D6.4 — Handoff:** Pepper escreve brief + trigger-map em `.wize/planning/ux/`. Maria Hill lê os 2 + escreve PRD em `.wize/planning/prd.md`. Mantis lê PRD + brief + trigger-map e escreve ux-scenarios → ux-design → design-system. Tony lê PRD + UX docs e escreve architecture.
+- **D6.5 — Design tools MCPs:** **fora do escopo** do kit. Mantis trabalha com markdown, ASCII wireframes e specs textuais. Usuário pode integrar Figma/Penpot/Stitch externamente se quiser.
+- **D6.6 — Overlays por perfil:**
+  - **Web overlay:** Mantis recebe playbook extra com WCAG, breakpoints responsivos, semantic HTML, design tokens com unidades web (rem/em).
+  - **App overlay:** Mantis recebe playbook extra com platform guidelines (Apple HIG / Material Design 3), touch targets, gestures, system permissions UX.
+
+### Fase 7 — Agent Builder (skills meta)
+
+- **D7.1 — Escopo: pacote completo de 3 skills meta:**
+  - `wize-create-agent` — cria nova persona/agente.
+  - `wize-create-skill` — cria skill simples.
+  - `wize-create-workflow` — cria workflow composto (multi-step).
+- **D7.2 — Customização de built-ins:** **permitida via override em `.wize/custom/`**. Built-ins ficam intocados em `node_modules/wize-dev-kit/`; overrides em `.wize/custom/agents/{code}/customize.toml` aplicam mudanças (persona, lema, tools). Preserva updates do upstream sem fork. Espelha mecanismo `config.user.toml` do BMAD.
+- **D7.3 — Validação completa:** **schema + lint + dry-run**.
+  - Schema check no `agent.yaml` (JSON Schema).
+  - Markdown lint na persona.
+  - Dry-run: invoca o agente com input fake e checa output.
+  - Falha em qualquer etapa = registro abortado, mensagem clara de erro.
+- **D7.4 — Multi-IDE auto-sync:** ao criar/editar agente/skill/workflow, Builder regera adapters para **todos os IDEs ativos** do repo-alvo (Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, OpenCode, Antigravity). Consistência sem passo manual.
+- **D7.5 — Localização das custom:** `.wize/custom/agents/{code}/`, `.wize/custom/skills/{code}/`, `.wize/custom/workflows/{code}/`. Estrutura espelha a do kit core.
+- **D7.6 — Ponto de entrada:** `wize-dev-kit agent create` no CLI + skill nativo `wize-create-agent` chamável pelo Wizer dentro do IDE.
+
+## Perguntas em aberto
+
+_(serão preenchidas conforme a entrevista avança)_

package/LICENSE

@@ -0,0 +1,31 @@
+MIT License
+
+Copyright (c) 2026 Qwize
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This project is inspired by:
+
+- BMAD Method (Apache-2.0 / MIT). https://github.com/bmad-code-org/BMAD-METHOD
+- Whiteport Design Studio expansion (MIT). https://github.com/bmad-code-org/bmad-method-wds-expansion
+
+Wize Development Kit is an independent adaptation; it is not affiliated with or
+endorsed by the BMAD or Whiteport projects.

package/README.md

@@ -0,0 +1,113 @@
+# Wize Development Kit
+
+> **Full-lifecycle AI-assisted development kit** with Test Architect and Whiteport Design Studio embedded.
+> Inspired by [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) and [WDS Expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion).
+
+[![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-alpha-orange)](#status)
+[![Repo](https://img.shields.io/badge/repo-qwize--br%2Fwize--development--kit-181717?logo=github)](https://github.com/qwize-br/wize-development-kit)
+
+---
+
+## What it is
+
+Wize Development Kit (WDK) is an installable AI agent stack that takes a project from **brief → PRD → UX strategy → architecture → tested implementation** through 9 specialized agents (Marvel-themed) and a structured workflow library. It runs inside your AI IDE (Claude Code, Cursor, Windsurf, and others) and writes structured artifacts to a hidden `.wize/` folder in the target repo.
+
+Three profiles, combinable in monorepos:
+
+| Profile | What it adds |
+|---|---|
+| **Wize Dev Core** | Full lifecycle (analysis → plan → solution → implementation) + Test Architect + Whiteport UX + Agent Builder. Always installed. |
+| **Wize Web Dev** (overlay) | Web stack scaffolds, SEO, analytics, WCAG playbook for Mantis, Playwright/Vitest playbook for Hawkeye. |
+| **Wize App Development** (overlay) | Mobile scaffolds, store-listing, platform guidelines (HIG/Material 3), Detox/Maestro playbook for Hawkeye. |
+
+---
+
+## The roster
+
+| # | Persona | Code | Role |
+|---|---|---|---|
+| 1 | **Wizer** | `wize-orchestrator` | Orchestrator, knowledge base, briefing, routing |
+| 2 | **Pepper Potts** | `wize-agent-analyst` | Business Analyst + WDS Saga (product brief, trigger map) |
+| 3 | **Peggy Carter** | `wize-agent-tech-writer` | Technical Writer (transversal) |
+| 4 | **Maria Hill** | `wize-agent-pm` | Product Manager (PRD, epics, sprints) |
+| 5 | **Mantis** | `wize-agent-ux-designer` | UX Designer + WDS Freya (scenarios, design, design system) |
+| 6 | **Nick Fury** | `wize-agent-solution-strategist` | Solution Strategy, tech vision, NFR principles |
+| 7 | **Tony Stark** | `wize-agent-architect` | System Architect (architecture, ADRs, epics, stories) |
+| 8 | **Hawkeye** | `wize-agent-test-architect` | Test Architect — 6 gates (risk, design, trace, nfr, review, gate) |
+| 9 | **Shuri** | `wize-agent-dev` | Senior Developer (TDD, code, refactor) |
+
+See [`ROSTER.md`](ROSTER.md) for personas, styles and BMAD equivalences.
+
+---
+
+## Quick start
+
+```bash
+# In any greenfield or brownfield repo
+npx wize-dev-kit install
+```
+
+Or, before this is published in your environment, install straight from GitHub:
+
+```bash
+npx github:qwize-br/wize-development-kit install
+```
+
+The installer asks:
+
+1. Profile(s) to enable (Core / +Web / +App — multi-select).
+2. IDE target(s) (Claude Code, Cursor, Windsurf, Codex, Continue, Kimi Code, OpenCode, Antigravity, or generic fallback — multi-select).
+3. Language preferences (communication + document output).
+4. Output folder (default `.wize/`).
+5. For brownfield repos: offers to run `wize-document-project` to baseline the existing codebase.
+
+After install, open your IDE and start with:
+
+> "Activate Wizer and brief him on the project."
+
+Wizer will route you to the right persona (Pepper for brief, Mantis for UX baseline, Tony for architecture preferences, etc.).
+
+---
+
+## Output layout (in the target repo)
+
+```
+.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/          # long-lived docs and references
+└── custom/             # agents/skills/workflows created by Agent Builder
+```
+
+---
+
+## Documentation
+
+- [`ARCH.md`](ARCH.md) — full architecture: distribution, fluxos, layout, installer.
+- [`ROSTER.md`](ROSTER.md) — 9 personas with style, role, BMAD equivalences.
+- [`DECISIONS.md`](DECISIONS.md) — decisions log from the design interview.
+
+---
+
+## Status
+
+**Alpha — v0.1.0.** This release is a working skeleton: directory tree, agent descriptors, workflow stubs, installer scaffolding, and IDE adapter placeholders. The core flow (brief → PRD → architecture → story → TEA gates) is **scaffolded but not yet wired end-to-end**. Production-readiness target: v0.5.0.
+
+---
+
+## Inspiration & credits
+
+- [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) by Brian (BMad) Madison — for the agile AI lifecycle, agent personas, installer pattern, module system.
+- [Whiteport Design Studio expansion](https://github.com/bmad-code-org/bmad-method-wds-expansion) — for the UX-first methodology, Norse pantheon (Saga, Freya), phase structure.
+
+Wize Development Kit is an **independent adaptation** — not affiliated with or endorsed by BMAD or WDS authors. Marvel persona names are used as creative references under nominative fair use.
+
+---
+
+## License
+
+MIT — see [`LICENSE`](LICENSE).