wize-dev-kit 0.1.0

package/ROSTER.md

@@ -0,0 +1,25 @@
+# Wize Dev Kit — Roster de Agentes (proposta v1)
+
+> Tema: **Marvel**. Cada persona representa um papel específico no método.
+> Equivalências BMAD listadas para referência cruzada com o repositório-pai.
+
+## Quadro
+
+| # | Persona | Code | Papel | Fase | Lema / Estilo | Equiv. BMAD |
+|---|---|---|---|---|---|---|
+| 1 | **Wizer** | `wize-orchestrator` | Orchestrator / Knowledge Base / Briefing | Todas | "Conheço o time, conheço o André, ative o agente certo." Estilo: anfitrião, escolhe, distribui. Tools: globais. | (não existe — papel de orchestrator surge no `party-mode` do BMAD) |
+| 2 | **Pepper Potts** | `wize-agent-analyst` | Business Analyst | 1 — Analysis | "Eficiência implacável." Brainstorming, market research, product-brief, PRFAQ, ROI, stakeholder map. Estilo: pragmática, antecipa, conecta business → tech. | Mary (`bmad-agent-analyst`) |
+| 3 | **Peggy Carter** | `wize-agent-tech-writer` | Technical Writer | Transversal (1–4) | "Estrutura, audiência, clareza." DITA, CommonMark, OpenAPI, READMEs, runbooks. Estilo: organizada, didática, técnica-mas-acessível. | Paige (`bmad-agent-tech-writer`) |
+| 4 | **Maria Hill** | `wize-agent-pm` | Product Manager | 2 — Planning | "Mission first." PRD, epics, sprint planning, cobrança de prazos. Estilo: militar, disciplinado, sem desculpas. | John (`bmad-agent-pm`) |
+| 5 | **Mantis** | `wize-agent-ux-designer` | UX Designer (Whiteport Strategic UX v0.4.3) | 2–3 | "Sinto o usuário antes de desenhar." Jobs-to-be-done, jornadas, empathy mapping, design tokens, IA, design system. Estilo: research-heavy, qualitative, narrativa empática. | Sally (`bmad-agent-ux-designer`) — substituída + metodologia Whiteport |
+| 6 | **Nick Fury** | `wize-agent-solution-strategist` | Solution Strategy / Tech Vision | 2 → 3 (boundary) | "Pessoas > Objetivo." Big-picture, NFRs, escolha de stack, princípios, trade-offs estratégicos. Estilo: autoritário, direto, poucas palavras. | (parcial de) Winston — vertente estratégica |
+| 7 | **Tony Stark** | `wize-agent-architect` | System Architect | 3 — Solutioning | "Eu construo as coisas." System design, componentes, ADRs, prototipagem, escolha de patterns. Estilo: confiante, irreverente, mostra com código. | Winston (`bmad-agent-architect`) — vertente sistêmica |
+| 8 | **Hawkeye** | `wize-agent-test-architect` | Test Architect (TEA) | Transversal (gates em 2, 3, 4) | "Sempre acerto onde dói." Risk profile, test design, traceability, NFR assessment, review, gate decision. Estilo: pragmático, edge-case hunter, foca no que importa. | (novo — não existe no BMAD, inspirado no TEA do BMAD-Method v5) |
+| 9 | **Shuri** | `wize-agent-dev` | Senior Developer | 4 — Implementation | "Wakanda forever — agora compila." TDD red-green-refactor, segurança, performance. Estilo: gênio inovador, rápida, protetora do ecossistema, código limpo. | Amelia (`bmad-agent-dev`) |
+
+## Notas
+
+- **Tema visual:** ícones podem usar emojis (📊 🛡️ 🦾 etc.) mas a identidade visual fica para a Fase 8 de consolidação.
+- **Agent Builder:** decidido na Fase 3 como **skill**, não agente (`wize-create-agent`). Wizer chama essa skill quando precisa registrar um novo persona/módulo custom.
+- **Times:** todos no time default `software-development`. Times opcionais (`web-dev`, `app-dev`) ativam variantes de Tony e Shuri por perfil (decisão pendente para Fase 4).
+- **Adições futuras (fora do kit dev):** Pepper já está usada como Analyst; Fury já como Strategist. Outras personas do ecossistema Marvel (Black Panther, Wanda, Falcon, Vision, Riri Williams) ficam livres para kits futuros (Wize Ops Kit, Wize Data Kit, Wize Security Kit, etc.).

package/adapters/README.md

@@ -0,0 +1,26 @@
+# Wize Dev Kit — IDE Adapters
+
+Each adapter renders the kit's agents/skills/workflows into the file layout that a particular IDE or AI runtime expects.
+
+## Targets shipped in v0.1
+
+| Code | Target path in repo | File format | Notes |
+|---|---|---|---|
+| `claude-code` | `.claude/skills/wize-*/` | `SKILL.md` per agent/workflow | Default. Uses Claude Code skill folder pattern. |
+| `cursor` | `.cursor/rules/wize-*.mdc` | MDC | Each agent/skill becomes a rule file. |
+| `windsurf` | `.windsurf/agents/wize-*.md` | Markdown | Cascade-friendly. |
+| `codex` | `.codex/wize-*.md` | Markdown | OpenAI Codex CLI. |
+| `continue` | `.continue/agents/wize-*.md` | Markdown | Continue agent slot. |
+| `kimi-code` | `.kimi/agents/wize-*.md` | Markdown | Moonshot Kimi Code. |
+| `opencode` | `.opencode/agents/wize-*.md` | Markdown | OpenCode CLI. |
+| `antigravity` | `.antigravity/agents/wize-*.md` | Markdown | Antigravity CLI + IDE. |
+| `generic` | `.wize/agents/wize-*.md` | Markdown | Fallback for any agent that can read a folder of markdown. |
+
+## Adapter shape
+
+Every adapter is a folder under `adapters/{code}/` with:
+- `adapter.yaml` — descriptor (target path, file pattern, post-install hooks).
+- `render.js` — function `(kitRoot, projectRoot, opts) => void` that emits files.
+- `README.md` — adapter-specific notes.
+
+In v0.1 only the descriptors and READMEs are present; `render.js` is a stub printing what it would emit. Wiring is on the v0.2 roadmap.

package/adapters/antigravity/README.md

@@ -0,0 +1,9 @@
+# Adapter — antigravity
+
+Antigravity CLI + IDE.
+
+- **Target path:** `.antigravity/agents/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
+
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/antigravity/adapter.yaml

@@ -0,0 +1,8 @@
+code: antigravity
+description: "Antigravity CLI + IDE."
+target_path: ".antigravity/agents/"
+file_pattern: "wize-*.md"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/antigravity/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/adapters/claude-code/README.md

@@ -0,0 +1,9 @@
+# Adapter — claude-code
+
+Native Claude Code skills.
+
+- **Target path:** `.claude/skills/`
+- **File pattern:** `wize-*/SKILL.md`
+- **Format:** markdown
+
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/claude-code/adapter.yaml

@@ -0,0 +1,8 @@
+code: claude-code
+description: "Native Claude Code skills."
+target_path: ".claude/skills/"
+file_pattern: "wize-*/SKILL.md"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/claude-code/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/adapters/codex/README.md

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

package/adapters/codex/adapter.yaml

@@ -0,0 +1,8 @@
+code: codex
+description: "OpenAI Codex CLI agents."
+target_path: ".codex/"
+file_pattern: "wize-*.md"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/codex/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/adapters/continue/README.md

@@ -0,0 +1,9 @@
+# Adapter — continue
+
+Continue agent slot.
+
+- **Target path:** `.continue/agents/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
+
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/continue/adapter.yaml

@@ -0,0 +1,8 @@
+code: continue
+description: "Continue agent slot."
+target_path: ".continue/agents/"
+file_pattern: "wize-*.md"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/continue/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/adapters/cursor/README.md

@@ -0,0 +1,9 @@
+# Adapter — cursor
+
+Cursor MDC rules.
+
+- **Target path:** `.cursor/rules/`
+- **File pattern:** `wize-*.mdc`
+- **Format:** markdown
+
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/cursor/adapter.yaml

@@ -0,0 +1,8 @@
+code: cursor
+description: "Cursor MDC rules."
+target_path: ".cursor/rules/"
+file_pattern: "wize-*.mdc"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/cursor/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/adapters/generic/README.md

@@ -0,0 +1,9 @@
+# Adapter — generic
+
+Generic markdown fallback for any AI agent runtime that can read a folder of markdown.
+
+- **Target path:** `.wize/agents/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
+
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/generic/adapter.yaml

@@ -0,0 +1,8 @@
+code: generic
+description: "Generic markdown fallback for any AI agent runtime that can read a folder of markdown."
+target_path: ".wize/agents/"
+file_pattern: "wize-*.md"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/generic/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/adapters/kimi-code/README.md

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

package/adapters/kimi-code/adapter.yaml

@@ -0,0 +1,8 @@
+code: kimi-code
+description: "Moonshot Kimi Code agents."
+target_path: ".kimi/agents/"
+file_pattern: "wize-*.md"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/kimi-code/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/adapters/opencode/README.md

@@ -0,0 +1,9 @@
+# Adapter — opencode
+
+OpenCode CLI agents.
+
+- **Target path:** `.opencode/agents/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
+
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/opencode/adapter.yaml

@@ -0,0 +1,8 @@
+code: opencode
+description: "OpenCode CLI agents."
+target_path: ".opencode/agents/"
+file_pattern: "wize-*.md"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/opencode/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/adapters/windsurf/README.md

@@ -0,0 +1,9 @@
+# Adapter — windsurf
+
+Windsurf Cascade-friendly markdown agents.
+
+- **Target path:** `.windsurf/agents/`
+- **File pattern:** `wize-*.md`
+- **Format:** markdown
+
+This v0.1 adapter ships the descriptor only. Actual rendering of `wize-*` agents/skills/workflows into the target IDE format is on the v0.2 roadmap.

package/adapters/windsurf/adapter.yaml

@@ -0,0 +1,8 @@
+code: windsurf
+description: "Windsurf Cascade-friendly markdown agents."
+target_path: ".windsurf/agents/"
+file_pattern: "wize-*.md"
+file_format: markdown
+hooks:
+  pre_render: []
+  post_render: []

package/adapters/windsurf/render.js

@@ -0,0 +1,15 @@
+/* Stub renderer for this adapter — emits a console preview of what would be written. */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function render(kitRoot, projectRoot, opts = {}) {
+  const adapterDir = __dirname;
+  const cfg = require('node:fs').readFileSync(path.join(adapterDir, 'adapter.yaml'), 'utf-8');
+  const targetPath = (cfg.match(/^target_path:\s*"(.+)"$/m) || [])[1] || '';
+  const filePattern = (cfg.match(/^file_pattern:\s*"(.+)"$/m) || [])[1] || '';
+  console.log(`[adapter:${path.basename(adapterDir)}] would emit ${filePattern} under ${path.join(projectRoot, targetPath)}`);
+}
+
+module.exports = { render };

package/package.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "wize-dev-kit",
+  "version": "0.1.0",
+  "description": "Full-lifecycle AI-assisted development kit with Test Architect and Whiteport Design Studio embedded. Inspired by BMAD Method and WDS.",
+  "keywords": [
+    "ai",
+    "agile",
+    "agents",
+    "orchestrator",
+    "test-architect",
+    "whiteport",
+    "wize",
+    "development-kit"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qwize-br/wize-development-kit.git"
+  },
+  "homepage": "https://github.com/qwize-br/wize-development-kit#readme",
+  "bugs": {
+    "url": "https://github.com/qwize-br/wize-development-kit/issues"
+  },
+  "license": "MIT",
+  "author": "Qwize <desenvolvimento@qwize.io>",
+  "main": "tools/installer/wize-cli.js",
+  "bin": {
+    "wize-dev-kit": "tools/installer/wize-cli.js"
+  },
+  "scripts": {
+    "install:wize": "node tools/installer/wize-cli.js install",
+    "uninstall:wize": "node tools/installer/wize-cli.js uninstall",
+    "validate": "node tools/installer/validators/run-all.js",
+    "test": "node --test test/*.test.js",
+    "prepublishOnly": "npm test && npm run validate"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "src/",
+    "adapters/",
+    "tools/",
+    "schemas/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "ARCH.md",
+    "ROSTER.md",
+    "DECISIONS.md"
+  ]
+}

package/schemas/agent.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qwize.io/wize-dev-kit/schemas/agent.schema.json",
+  "title": "Wize Agent",
+  "type": "object",
+  "required": ["code", "name", "title", "module", "description"],
+  "additionalProperties": true,
+  "properties": {
+    "code": { "type": "string", "pattern": "^wize-(agent|orchestrator)-[a-z0-9-]+$|^wize-orchestrator$" },
+    "name": { "type": "string", "minLength": 1 },
+    "title": { "type": "string", "minLength": 1 },
+    "icon": { "type": "string" },
+    "team": { "type": "string" },
+    "module": { "enum": ["orchestrator", "method", "tea", "builder", "core", "web-overlay", "app-overlay", "custom"] },
+    "phase": { "type": "string" },
+    "description": { "type": "string", "minLength": 10 },
+    "style": {
+      "type": "object",
+      "properties": {
+        "voice": { "type": "string" },
+        "brevity": { "type": "string" },
+        "motto": { "type": "string" },
+        "approach": { "type": "string" }
+      }
+    },
+    "capabilities": { "type": "array", "items": { "type": "string" } },
+    "skills": { "type": "array", "items": { "type": "string" } },
+    "inputs": { "type": "array", "items": { "type": "string" } },
+    "outputs": { "type": "array", "items": { "type": "string" } },
+    "absorbs": { "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] },
+    "routes_to": { "type": "array", "items": { "type": "string" } },
+    "overlays_aware": { "type": "array", "items": { "type": "string" } },
+    "gates": { "type": "array", "items": { "enum": ["risk", "design", "trace", "nfr", "review", "gate"] } },
+    "policy": { "enum": ["advisory", "enforcing"] },
+    "format": { "type": "string" }
+  }
+}

package/schemas/module.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qwize.io/wize-dev-kit/schemas/module.schema.json",
+  "title": "Wize Module",
+  "type": "object",
+  "required": ["code", "name", "description"],
+  "additionalProperties": true,
+  "properties": {
+    "code": { "type": "string" },
+    "name": { "type": "string" },
+    "description": { "type": "string" },
+    "default_selected": { "type": "boolean" },
+    "required": { "type": "boolean" },
+    "overlay_of": { "type": "string" },
+    "agents": { "type": "array" },
+    "skills": { "type": "array" }
+  }
+}

package/schemas/skill.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qwize.io/wize-dev-kit/schemas/skill.schema.json",
+  "title": "Wize Skill (frontmatter)",
+  "type": "object",
+  "required": ["code", "name"],
+  "additionalProperties": true,
+  "properties": {
+    "code": { "type": "string", "pattern": "^wize-[a-z0-9-]+$" },
+    "name": { "type": "string", "minLength": 1 },
+    "module": { "type": "string" },
+    "status": { "enum": ["stub", "draft", "ready", "stable"] }
+  }
+}

package/schemas/workflow.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qwize.io/wize-dev-kit/schemas/workflow.schema.json",
+  "title": "Wize Workflow (frontmatter)",
+  "type": "object",
+  "required": ["code", "name"],
+  "additionalProperties": true,
+  "properties": {
+    "code": { "type": "string", "pattern": "^wize-[a-z0-9-]+$" },
+    "name": { "type": "string", "minLength": 1 },
+    "phase": { "type": "string" },
+    "owner": { "type": "string" },
+    "absorbs": { "type": "string" },
+    "overlay": { "enum": ["web", "app"] },
+    "status": { "enum": ["stub", "draft", "ready", "stable"] },
+    "gate": { "enum": ["risk", "design", "trace", "nfr", "review", "gate"] },
+    "when": { "type": "string" }
+  }
+}

package/src/app-overlay/module.yaml

@@ -0,0 +1,40 @@
+code: app-overlay
+name: "Wize App Development (overlay)"
+description: "Mobile-stack extension: scaffolds (RN/Expo/Flutter/native), store-listing, release channels, HIG/Material 3 playbook for Mantis, Detox/Maestro playbook for Hawkeye."
+default_selected: false
+required: false
+overlay_of: method
+
+# Stack catalog:
+stack_catalog:
+  - React Native + Expo
+  - React Native bare (no Expo)
+  - Flutter
+  - SwiftUI (iOS native)
+  - Jetpack Compose (Android native)
+  - Capacitor / Ionic (hybrid)
+
+# Extra artifacts:
+artifacts:
+  - ".wize/planning/app/mobile-store-listing.md"
+  - ".wize/planning/app/app-perms-and-privacy.md"
+  - ".wize/planning/app/release-channels.md"
+
+skills:
+  - code: wize-app-scaffold
+    description: "Scaffold a mobile app skeleton per chosen runtime."
+  - code: wize-app-release-channels
+    description: "Define release channel strategy (dev/preview/prod, EAS branches, beta tracks)."
+  - code: wize-app-store-listing
+    description: "Draft store listing copy + screenshots brief + ASO keywords."
+
+agent_playbooks:
+  wize-agent-ux-designer:
+    - "playbooks/apple-hig.md"
+    - "playbooks/material-design-3.md"
+    - "playbooks/touch-targets-and-gestures.md"
+    - "playbooks/permissions-ux.md"
+  wize-agent-test-architect:
+    - "playbooks/detox-maestro.md"
+    - "playbooks/mobile-perf-budgets.md"
+    - "playbooks/device-matrix.md"

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

@@ -0,0 +1,21 @@
+---
+code: wize-app-release-channels
+name: App Release Channels
+overlay: app
+owner: wize-agent-pm   # Maria Hill
+status: stub
+---
+
+# App Release Channels
+
+**Goal.** Define release-channel strategy for a mobile app.
+
+## Output
+- `.wize/planning/app/release-channels.md`
+
+## Sections
+- Channels: dev / preview / production (and any beta tracks).
+- Distribution: App Store / TestFlight / Play Store / internal track / EAS Updates / Firebase App Distribution.
+- OTA strategy (Expo Updates, CodePush) — when in scope.
+- Versioning policy (semver + build number).
+- Rollback / kill-switch.

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

@@ -0,0 +1,27 @@
+---
+code: wize-app-scaffold
+name: App Scaffold
+overlay: app
+owner: wize-agent-architect   # Tony
+status: stub
+---
+
+# App Scaffold
+
+**Goal.** Scaffold an empty-but-runnable mobile app per chosen runtime.
+
+## Supported runtimes (catalog)
+- React Native + Expo
+- React Native bare
+- Flutter
+- SwiftUI (iOS native)
+- Jetpack Compose (Android native)
+- Capacitor / Ionic (hybrid)
+
+## Steps
+1. Runtime interview (Tony asks; Fury approves).
+2. Run the runtime's create command (e.g., `npx create-expo-app`).
+3. Wire up design tokens from `.wize/solutioning/design-system/tokens.json`.
+4. Configure linter, formatter, test runner (Detox / Maestro placeholder).
+5. Generate baseline navigation from `.wize/planning/ux/ux-design/`.
+6. Commit "initial scaffold (story E00-S01)".