wize-dev-kit 0.3.0 → 0.4.0

package/AGENTS.md

@@ -0,0 +1,21 @@
+# 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 all read this file).
+
+## Roster
+
+- **Hawkeye** (`wize-agent-test-architect`) — Test Architect (TEA). |
+- **Wizer** (`wize-orchestrator`) — Orchestrator / Knowledge Base. |
+- **Shuri** (`wize-agent-dev`) — Senior Developer. |
+- **Nick Fury** (`wize-agent-solution-strategist`) — Solution Strategy / Tech Vision. |
+- **Tony Stark** (`wize-agent-architect`) — System Architect. |
+- **Mantis** (`wize-agent-ux-designer`) — UX Designer (Whiteport Design Studio). |
+- **Maria Hill** (`wize-agent-pm`) — Product Manager. |
+- **Peggy Carter** (`wize-agent-tech-writer`) — Technical Writer. |
+- **Pepper Potts** (`wize-agent-analyst`) — Business Analyst (incl. WDS Saga). |
+
+## Where to start
+
+Activate the orchestrator: `wize-orchestrator` (Wizer). Then ask `/wize-help`.

package/ARCH.md

@@ -210,7 +210,43 @@ wize-dev-kit sync     # regera adapters IDE
 
 ---
 
-## 8. Overlays Web e App
+## 8. Document Project Engine
+
+`wize-dev-kit document-project` é a ferramenta de baseline e documentação brownfield do kit.
+
+### Modos
+
+| Modo | O que faz | Nível de scan |
+|---|---|---|
+| `quick` | Gera 6 arquivos de baseline leves (`overview.md`, `architecture-snapshot.md`, `conventions.md`, `dependencies.md`, `risk-spots.md`, `open-questions.md`). | `quick` apenas |
+| `initial_scan` | Classifica o tipo do projeto, gera `index.md` + docs condicionais conforme o tipo. | `quick`, `deep`, `exhaustive` |
+| `full_rescan` | Arquiva o estado anterior e re-executa `initial_scan` do zero. | `quick`, `deep`, `exhaustive` |
+| `deep_dive` | Análise exaustiva de uma pasta, arquivo, feature, api_group ou component_group. | `exhaustive` |
+
+### Arquivo de estado
+
+- `.wize/knowledge/document-project/project-scan-report.json` mantém progresso, passos completados e instruções de resume.
+- Arquivos antigos são arquivados em `.wize/knowledge/document-project/_archive/`.
+- `--resume` continua a partir do `current_step`.
+
+### Index mestre
+
+- `index.md` lista toda a documentação gerada e documentação existente.
+- Docs condicionais que ainda não foram gerados aparecem com `_(To be generated)_`.
+- Re-gerar o index remove os marcadores conforme os arquivos são produzidos.
+
+### Componentes de código
+
+- `tools/installer/commands/document-project.js` — dispatcher CLI e parsing de args.
+- `tools/installer/document-project/modes/{quick,initial-scan,full-rescan,deep-dive}.js` — implementação dos modos.
+- `tools/installer/document-project/classify.js` — classificador de tipo de projeto via CSV.
+- `tools/installer/document-project/batch-scanner.js` — varredura em batches para evitar estouro de contexto.
+- `tools/installer/document-project/render-index.js` — renderizador do `index.md`.
+- `tools/installer/document-project/state.js` — leitura/escrita do `project-scan-report.json`.
+- `src/method-skills/1-analysis/wize-document-project/templates/` — templates markdown/Handlebars para cada doc condicional.
+- `src/method-skills/1-analysis/wize-document-project/documentation-requirements.csv` — regras de tipo de projeto e flags de scan.
+
+## 9. Overlays Web e App
 
 ### Wize Web Dev (overlay)
 
@@ -228,7 +264,7 @@ wize-dev-kit sync     # regera adapters IDE
 
 ---
 
-## 9. Agent Builder
+## 10. 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).
@@ -237,7 +273,7 @@ wize-dev-kit sync     # regera adapters IDE
 
 ---
 
-## 10. Onboarding pós-install (Wizer)
+## 11. 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).
@@ -246,7 +282,7 @@ wize-dev-kit sync     # regera adapters IDE
 
 ---
 
-## 11. Estrutura do repo `wize-dev-kit/` (source code do kit)
+## 12. Estrutura do repo `wize-dev-kit/` (source code do kit)
 
 ```
 wize-dev-kit/

package/CHANGELOG.md

@@ -5,6 +5,56 @@ Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.4.0] — 2026-06-13
+
+Adapts four BMAD Method step-based flows into the Wize universe: spec, architecture, code review, and research.
+
+### Added
+
+- **`wize-spec`** (core skill) — distills any intent input into a canonical five-field `SPEC.md` (Why, Capabilities, Constraints, Non-goals, Success signal) plus optional companion files. Includes template and headless response schemas.
+- **Vertical research skills** under `src/method-skills/1-analysis/`:
+  - `wize-market-research` — 6-step competition and customer research.
+  - `wize-domain-research` — 6-step industry, regulatory, and trend research.
+  - `wize-technical-research` — 6-step technology and architecture research.
+- Registered new skills in `src/core-skills/module.yaml` and `src/method-skills/module.yaml`.
+
+### Changed
+
+- **`wize-create-architecture`** rewritten as an 8-step micro-file workflow: init → context → starter → decisions → patterns → structure → validation → complete. Old monolithic body archived in `.wize/knowledge/decisions/`.
+- **`wize-code-review`** rewritten as a 4-step adversarial triage workflow: gather-context → review (Blind Hunter, Edge Case Hunter, Acceptance Auditor) → triage → present. Integrates with existing `wize-review-adversarial` and `wize-review-edge-case-hunter`.
+- `README.md`, `DECISIONS.md`, and `.wize/knowledge/decisions/ADR-001-bmad-steps-import.md` document the import rationale and scope.
+- `test/workflow-bodies.test.js` allowlists the short research dispatcher workflows.
+
+### Tests
+
+- Total: **222 passing**.
+
+## [0.3.1] — 2026-06-13
+
+Expands `wize-document-project` from a single lightweight baseline into a multi-mode documentation engine with project-type classification, resume state, and BMAD-equivalent templates.
+
+### Added — `wize-document-project` engine
+
+- **CLI modes:** `quick`, `initial_scan`, `full_rescan`, `deep_dive` via `wize-dev-kit document-project [mode]`.
+- **Project-type classification:** `documentation-requirements.csv` with 12 types + `classifyProject()` module; detects monolith, multi-part repos, and the kit itself as `cli` + `library`.
+- **JSON state file:** `project-scan-report.json` with schema, init/load/update/archive helpers, and `--resume` support.
+- **Batch scanner:** subfolder-sized scans that skip noise directories and flag files >5000 LOC.
+- **Master index renderer:** `index.md` with links + `_(To be generated)_` markers for missing conditional docs.
+- **Deep-dive mode:** folder, file, feature, `api_group`, `component_group` targets with typed resolution.
+- **11 BMAD-equivalent templates:** index, project-overview, source-tree-analysis, architecture, component-inventory, development-guide, api-contracts, data-models, deployment-guide, contribution-guide, deep-dive.
+
+### Added — integration
+
+- `doctor` now reports scan-state age, `index.md` "To be generated" marker count, and suggests `document-project` / `wize-refresh-knowledge` when stale.
+- Brownfield installer prompts for documentation mode (quick / initial_scan / full_rescan / skip) with non-TTY fallback to quick.
+- `wize-tea-risk` workflow adds documentation gaps as a risk category.
+- CI smoke E2E now runs `wize-dev-kit document-project quick` and asserts the 6 baseline files.
+- `README.md` and `ARCH.md` updated to describe the new engine and current maturity.
+
+### Tests
+
+- Total: **219 passing** (was 115).
+
 ## [0.3.0] — 2026-06-12
 
 Adds a single-command diagnostic plus traceable GitHub Releases on every tag.

package/DECISIONS.md

@@ -136,6 +136,19 @@
 - **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.
 
+### Fase 8 — Importação de fluxos Steps do BMAD
+
+- **D8.1 — Seleção:** dos fluxos de Steps do BMAD ainda não importados, selecionamos quatro para adaptação imediata:
+  - `bmad-spec` → `wize-spec` (core skill).
+  - `bmad-create-architecture` → `wize-create-architecture` reescrito em 8 steps (micro-file architecture).
+  - `bmad-code-review` → `wize-code-review` reescrito em 4 steps com triagem adversarial.
+  - Research do BMAD (`bmad-market-research`, `bmad-domain-research`, `bmad-technical-research`) → três skills verticais Wize em `src/method-skills/1-analysis/`.
+- **D8.2 — Micro-file architecture:** workflows substituídos por step files auto-contidos em `steps/` ou `{vertical}-steps/`. Cada step controla frontmatter `stepsCompleted` e só avança com confirmação do usuário.
+- **D8.3 — Manter dispatcher genérico:** `wize-research` continua existindo como skill genérico, mas as três vertentes oferecem passos estruturados e templates próprios.
+- **D8.4 — Versionamento dos workflows antigos:** cópias dos `workflow.md` monolíticos de `wize-create-architecture` e `wize-code-review` são arquivadas em `.wize/knowledge/decisions/` para referência, não mantidas em produção.
+- **D8.5 — Registro em catálogos:** skills adicionados a `src/core-skills/module.yaml` e `src/method-skills/module.yaml`; fluxos refletidos no `README.md`.
+
 ## Perguntas em aberto
 
 _(serão preenchidas conforme a entrevista avança)_
+

package/README.md

@@ -83,6 +83,9 @@ Below is the canonical flow Wizer drives in a real session. Each step is a slash
 2.  /wize-product-brief         Pepper turns raw demand into brief.md.
     /wize-trigger-map           Pepper maps user psychology → business goals (WDS).
     /wize-research              Pepper synthesizes external evidence (optional).
+                                Or run a focused pass:
+                                /wize-market-research, /wize-domain-research,
+                                /wize-technical-research.
 
 3.  /wize-create-prd            Maria Hill writes prd.md (goals, scope, ACs).
     /wize-validate-prd          Maria Hill (+ Mantis/Fury) signs off.
@@ -93,7 +96,8 @@ Below is the canonical flow Wizer drives in a real session. Each step is a slash
 5.  /wize-tech-vision           Fury picks the stack family + non-negotiables.
     /wize-nfr-principles        Fury writes the NFR budget (perf, sec, a11y…).
 
-6.  /wize-create-architecture   Tony writes architecture.md + ADRs.
+6.  /wize-create-architecture   Tony writes architecture.md + ADRs via 8 steps
+                                (context → decisions → patterns → structure → validation).
     /wize-design-system         Mantis writes design-system/ (tokens + components).
     /wize-create-epics-and-stories
                                 Tony slices epics → stories (each has ACs).
@@ -113,6 +117,9 @@ Cross-cutting:
     /wize-help                  Wizer figures out where you are and proposes
                                 the next step (use anytime).
     /wize-quick-dev             Shuri takes a small fix without the full ride.
+    /wize-code-review           Shuri runs an adversarial peer review (Blind Hunter,
+                                Edge Case Hunter, Acceptance Auditor) before Hawkeye's TEA review.
+    /wize-spec                  Distill any intent into a canonical five-field spec.
     /wize-party-mode            Wizer convenes multi-persona for hard calls.
 ```
 
@@ -146,6 +153,8 @@ npx wize-dev-kit agent create    # scaffold a new custom agent (validated + dry-
 npx wize-dev-kit agent edit <code>  # override a built-in via .wize/custom/agents/<code>/customize.toml
 npx wize-dev-kit doctor          # diagnose kit / project / adapters / gates and suggest fixes
 npx wize-dev-kit validate        # structural checks on the kit assets
+npx wize-dev-kit document-project [quick|initial_scan|full_rescan|deep_dive] [--resume] [--target <path>]
+                                 # document the current repo; quick baseline by default
 npx wize-dev-kit uninstall       # remove .wize/ (your code is left untouched)
 ```
 
@@ -161,7 +170,7 @@ npx wize-dev-kit uninstall       # remove .wize/ (your code is left untouched)
 
 ## 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.
+**v0.3.0+ — beta.** The core lifecycle is scaffolded, the `document-project` engine is wired, and selected BMAD step flows have been adapted into Wize skills: `wize-spec`, `wize-create-architecture` (8-step), `wize-code-review` (adversarial triage), and vertical research skills (`wize-market-research`, `wize-domain-research`, `wize-technical-research`). IDE adapters for Claude Code, Cursor, Windsurf, and others are regenerated automatically. Production-readiness target remains v0.5.0.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wize-dev-kit",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Full-lifecycle AI-assisted development kit with Test Architect and Whiteport Design Studio embedded. Inspired by BMAD Method and WDS.",
   "keywords": [
     "ai",
@@ -47,7 +47,8 @@
     "CHANGELOG.md",
     "ARCH.md",
     "ROSTER.md",
-    "DECISIONS.md"
+    "DECISIONS.md",
+    "AGENTS.md"
   ],
   "dependencies": {
     "prompts": "^2.4.2"

package/src/core-skills/module.yaml

@@ -22,3 +22,7 @@ skills:
   - code: wize-review-adversarial
     name: "Adversarial Review"
     description: "Red-team review of artifacts — challenges assumptions, surfaces edge cases."
+  - code: wize-spec
+    name: "Spec"
+    description: "Distills any intent input into a canonical five-field spec kernel + companions."
+

package/src/core-skills/wize-spec/assets/headless-schemas.md

@@ -0,0 +1,39 @@
+# Headless response schemas for wize-spec
+
+Used when `wize-spec` is invoked non-interactively (headless).
+
+## Create / Update
+
+```json
+{
+  "error_code": null,
+  "spec_path": "{project-root}/.wize/specs/spec-{slug}/SPEC.md",
+  "slug": "{slug}",
+  "capabilities": ["CAP-1", "CAP-2"],
+  "companions": ["glossary.md"],
+  "assumptions": [],
+  "open_questions": [],
+  "verdict": "Coherence: pass. Preservation: pass."
+}
+```
+
+## Error codes
+
+- `missing_slug` — headless caller did not provide a slug and it could not be derived.
+- `insufficient_intent` — no input content provided.
+- `too_sparse` — input too thin to distill; suggest `wize-product-brief` or `wize-create-prd`.
+
+## Validate
+
+```json
+{
+  "error_code": null,
+  "violations": [
+    {
+      "rule": "4",
+      "message": "No explicit non-goals found."
+    }
+  ],
+  "verdict": "Coherence: 1 issue. Preservation: pass."
+}
+```

package/src/core-skills/wize-spec/assets/spec-template.md

@@ -0,0 +1,40 @@
+---
+slug: "{{slug}}"
+status: draft
+owner: "{{owner}}"
+companions: []
+sources: []
+assumptions: []
+open_questions: []
+---
+
+# SPEC — {{slug}}
+
+## Why
+
+{{One paragraph: what problem this thing exists to solve and for whom.}}
+
+## Capabilities
+
+| ID | Intent | Success |
+|---|---|---|
+| CAP-1 | {{what the system does for the user}} | {{observable outcome that proves it works}} |
+| CAP-2 | … | … |
+
+## Constraints
+
+- {{Constraint that bends a design decision.}}
+- …
+
+## Non-goals
+
+- {{Explicitly out of scope.}}
+- …
+
+## Success signal
+
+{{Concrete, testable or demonstrable signal that the spec is satisfied.}}
+
+## Decision log
+
+See `.decision-log.md`.

package/src/core-skills/wize-spec/customize.toml

@@ -0,0 +1,20 @@
+# Wize Dev Kit — overrides for the built-in skill "wize-spec".
+# DO NOT EDIT in the installed kit; copy to .wize/custom/skills/wize-spec/
+# for project-level overrides.
+
+[workflow]
+
+# Steps to run before standard activation (config load, greet).
+activation_steps_prepend = []
+
+# Steps to run after greet but before the workflow begins.
+activation_steps_append = []
+
+# Persistent facts the skill keeps in mind for the whole run.
+persistent_facts = [
+  "file:{project-root}/.wize/knowledge/document-project/conventions.md",
+]
+
+# Scalar executed when the spec is finalized and the decision-log verdict is written.
+# Override wins. Leave empty for no custom post-completion behavior.
+on_complete = ""

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

@@ -0,0 +1,110 @@
+---
+code: wize-spec
+name: Spec
+module: core
+status: ready
+---
+
+# Spec
+
+**Goal.** Distill any intent input into a canonical, preservation-validated machine contract for downstream Wize work.
+
+Takes any intent input — vague idea, brain dump, PRD, RFC, brief, Slack thread, customer email, meeting transcript, mockups, mixed multi-source — and produces `SPEC.md` carrying the five-field kernel (Why, Capabilities, Constraints, Non-goals, Success signal) plus companion files for load-bearing content that does not fit or would bloat the kernel.
+
+Peggy Carter edits prose; Tony, Maria Hill, and Shuri consume the spec downstream.
+
+## When to use
+
+- "Create a spec for this idea."
+- "Distill this PRD into a spec."
+- "Validate this spec."
+- "Update the spec."
+
+Multiple skills may call to update the same spec over time.
+
+## Workspace
+
+The spec is **always a folder** named `{output_folder}/specs/spec-{slug}/`.
+
+`{slug}` describes the thing being specced, not the input shape:
+
+- Source artifact already carries a slug (e.g., `prd-foo-bar-2026-05-23/`): inherit (`foo-bar`).
+- Sparse, in-chat, or multi-source input: ask interactively. Headless callers must provide it.
+- Same slug = same folder. A second invocation updates in place, preserving capability IDs.
+
+Inside the spec folder:
+
+```
+<spec-folder>/
+  SPEC.md                  ← uppercase, the kernel
+  <companion-1>.md         ← optional, content-typed
+  <companion-2>.md
+  .decision-log.md         ← canonical memory for this spec
+```
+
+## The Operation
+
+1. Read the input and its ancillary linked materials. If no input, ask or block.
+2. If a prior `SPEC.md` exists at the target folder, read it — the operation becomes an **update**. Preserve capability IDs; new capabilities get the next unused `CAP-N`; never reuse retired IDs.
+3. When input is structured and pre-sorted (PRD with addendum, brief from Pepper, UX spec from Mantis), trust the authored separation.
+4. When input is mixed (brain dump, transcript, email), sort claims using the three-lens load-bearing test and route to the kernel field or a companion.
+5. Distill into the five-field kernel using `assets/spec-template.md`. When input is rich, extract directly. When input is sparse, choose:
+   - **express** — best-effort distill, every gap becomes an `open_questions[]` entry
+   - **guided** — walk the five fields with the user one at a time
+6. Write lean: every sentence must earn its place.
+7. If input is genuinely too thin (e.g. "an app for hikers" with no context), stop and suggest `wize-product-brief` or `wize-create-prd`.
+
+## Load-bearing
+
+A claim is **load-bearing** if any downstream consumer (skill, implementing agent, verification pass) would change a decision without it.
+
+## Companions
+
+When load-bearing content does not fit the five-field kernel, it lives in a companion. The kernel cites it; the companion holds it. Companions are part of the contract; every consumer reads `companions:` in `SPEC.md` frontmatter to discover them.
+
+**Spawn a companion when the content needs more than one kernel-shape line:** multi-item catalogs (archetypes, modes, routes, entity matrices), tables, diagrams (always), editorial voice rules, long-form reference material the kernel cites by name.
+
+Companions are either:
+
+- **Spec-authored** — written by `wize-spec` and live as siblings of `SPEC.md` (e.g., `glossary.md`, `patron-archetypes.md`, `stack.md`, `conventions.md`, `brownfield.md`, `architecture-diagrams.md`, `state-machines.md`, `failure-modes.md`).
+- **Adopted** — load-bearing artifacts written by upstream skills that downstream still needs to read (e.g., a `DESIGN.md` from Mantis, an API spec from a partner). The originating skill owns them; `wize-spec` references them in `companions:` but does not edit them.
+
+Two rules govern companions:
+
+1. Name spec-authored companions for the content type they hold.
+2. Diagrams always land in a companion, regardless of size. Mermaid/ASCII/image references live there; `SPEC.md` holds prose only.
+
+Pre-existing project-wide docs (e.g., `.wize/knowledge/document-project/conventions.md`) that downstream needs are listed as **adopted companions**, never duplicated.
+
+## Spec Law
+
+1. Each capability has both `intent` and `success`.
+2. Intents describe WHAT, not HOW.
+3. Constraints actually bend design decisions.
+4. Non-goals are explicit — at least one.
+5. Success signal is concrete enough to test or demonstrate against.
+6. Capability IDs are stable and unique — never reused, never renumbered.
+7. Preservation — every load-bearing source claim lands in `SPEC.md` or a companion.
+8. Lean prose — every sentence carries load-bearing content.
+
+## Self-Validate
+
+After every create or update, sweep the artifact in two passes:
+
+- **Pass 1 — Coherence.** Judge against Spec Law rules 1–6 and 8. Calls made without direct confirmation become `assumptions[]`; gaps become `open_questions[]`.
+- **Pass 2 — Preservation.** Walk source claims; confirm each landed in `SPEC.md` or a companion. Wrapper-only drops are logged under "Wrapper-only content" so the drop is on the record.
+
+Append a one-paragraph verdict to `.decision-log.md`.
+
+## Output
+
+- **Interactive** — share the spec folder path, name capability count, companions produced, and verdict in one or two sentences. List `assumptions[]` and `open_questions[]` if non-empty.
+- **Headless** — return JSON per `assets/headless-schemas.md`.
+
+## After the spec is output
+
+Any update to assumptions, open questions, or other changes is appended to `.decision-log.md` and, when applicable, to the source artifact's decision log.
+
+## Hand-off
+
+> Spec `{slug}` distilled into `{output_folder}/specs/spec-{slug}/SPEC.md` with `{n}` capabilities and `{m}` companions. Verdict: `{verdict}`. Open questions: `{list}`.

package/src/method-skills/1-analysis/wize-document-project/documentation-requirements.csv

@@ -0,0 +1,12 @@
+project_type_id,requires_api_scan,requires_data_models,requires_state_management,requires_ui_components,requires_deployment_config,key_file_patterns,critical_directories,integration_scan_patterns,test_file_patterns,config_patterns,auth_security_patterns,schema_migration_patterns,entry_point_patterns,shared_code_patterns,monorepo_workspace_patterns,async_event_patterns,ci_cd_patterns,asset_patterns,hardware_interface_patterns,protocol_schema_patterns,localization_patterns,requires_hardware_docs,requires_asset_inventory
+web,true,true,true,true,true,package.json;tsconfig.json;*.config.js;*.config.ts;vite.config.*;webpack.config.*;next.config.*;nuxt.config.*,src/;app/;pages/;components/;api/;lib/;styles/;public/;static/,*client.ts;*service.ts;*api.ts;fetch*.ts;axios*.ts;*http*.ts,*.test.ts;*.spec.ts;*.test.tsx;*.spec.tsx;**/__tests__/**;**/*.test.*;**/*.spec.*,.env*;config/*;*.config.*;.config/;settings/,*auth*.ts;*session*.ts;middleware/auth*;*.guard.ts;*authenticat*;*permission*;guards/,migrations/**;prisma/**;*.prisma;alembic/**;knex/**;*migration*.sql;*migration*.ts,main.ts;index.ts;app.ts;server.ts;_app.tsx;_app.ts;layout.tsx,shared/**;common/**;utils/**;lib/**;helpers/**;@*/**;packages/**,pnpm-workspace.yaml;lerna.json;nx.json;turbo.json;workspace.json;rush.json,*event*.ts;*queue*.ts;*subscriber*.ts;*consumer*.ts;*producer*.ts;*worker*.ts;jobs/**,.github/workflows/**;.gitlab-ci.yml;Jenkinsfile;.circleci/**;azure-pipelines.yml;bitbucket-pipelines.yml;.drone.yml,public/**;static/**;assets/**;images/**;media/**,N/A,*.proto;*.graphql;graphql/**;schema.graphql;*.avro;openapi.*;swagger.*,i18n/**;locales/**;lang/**;translations/**;messages/**;*.po;*.pot,false,false
+mobile,true,true,true,true,true,package.json;pubspec.yaml;Podfile;build.gradle;app.json;capacitor.config.*;ionic.config.json,src/;app/;screens/;components/;services/;models/;assets/;ios/;android/,*client.ts;*service.ts;*api.ts;fetch*.ts;axios*.ts;*http*.ts,*.test.ts;*.test.tsx;*_test.dart;*.test.dart;**/__tests__/**,.env*;config/*;app.json;capacitor.config.*;google-services.json;GoogleService-Info.plist,*auth*.ts;*session*.ts;*authenticat*;*permission*;*biometric*;secure-store*,migrations/**;realm/**;*.realm;watermelondb/**;sqlite/**,main.ts;index.ts;App.tsx;App.ts;main.dart,shared/**;common/**;utils/**;lib/**;components/shared/**;@*/**,pnpm-workspace.yaml;lerna.json;nx.json;turbo.json,*event*.ts;*notification*.ts;*push*.ts;background-fetch*,fastlane/**;.github/workflows/**;.gitlab-ci.yml;bitbucket-pipelines.yml;appcenter-*,assets/**;Resources/**;res/**;*.xcassets;drawable*/;mipmap*/;images/**,N/A,*.proto;graphql/**;*.graphql,i18n/**;locales/**;translations/**;*.strings;*.xml,false,true
+backend,true,true,false,false,true,package.json;requirements.txt;go.mod;Gemfile;pom.xml;build.gradle;Cargo.toml;*.csproj,src/;api/;services/;models/;routes/;controllers/;middleware/;handlers/;repositories/;domain/,*client.ts;*repository.ts;*service.ts;*connector*.ts;*adapter*.ts,*.test.ts;*.spec.ts;*_test.go;test_*.py;*Test.java;*_test.rs,.env*;config/*;*.config.*;application*.yml;application*.yaml;appsettings*.json;settings.py,*auth*.ts;*session*.ts;*authenticat*;*authorization*;middleware/auth*;guards/;*jwt*;*oauth*,migrations/**;alembic/**;flyway/**;liquibase/**;prisma/**;*.prisma;*migration*.sql;*migration*.ts;db/migrate,main.ts;index.ts;server.ts;app.ts;main.go;main.py;Program.cs;__init__.py,shared/**;common/**;utils/**;lib/**;core/**;@*/**;pkg/**,pnpm-workspace.yaml;lerna.json;nx.json;go.work,*event*.ts;*queue*.ts;*subscriber*.ts;*consumer*.ts;*producer*.ts;*worker*.ts;*handler*.ts;jobs/**;workers/**,.github/workflows/**;.gitlab-ci.yml;Jenkinsfile;.circleci/**;azure-pipelines.yml;.drone.yml,N/A,N/A,*.proto;*.graphql;graphql/**;*.avro;*.thrift;openapi.*;swagger.*;schema/**,N/A,false,false
+cli,false,false,false,false,false,package.json;go.mod;Cargo.toml;setup.py;pyproject.toml;*.gemspec,src/;cmd/;cli/;bin/;lib/;commands/,N/A,*.test.ts;*_test.go;test_*.py;*.spec.ts;*_spec.rb,.env*;config/*;*.config.*;.*.rc;.*rc,N/A,N/A,main.ts;index.ts;cli.ts;main.go;main.py;__main__.py;bin/*,shared/**;common/**;utils/**;lib/**;helpers/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml;goreleaser.yml,N/A,N/A,N/A,N/A,false,false
+library,false,false,false,false,false,package.json;setup.py;Cargo.toml;go.mod;*.gemspec;*.csproj;pom.xml,src/;lib/;dist/;pkg/;build/;target/,N/A,*.test.ts;*_test.go;test_*.py;*.spec.ts;*Test.java;*_test.rs,.*.rc;tsconfig.json;rollup.config.*;vite.config.*;webpack.config.*,N/A,N/A,index.ts;index.js;lib.rs;main.go;__init__.py,src/**;lib/**;core/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml;.circleci/**,N/A,N/A,N/A,N/A,false,false
+desktop,false,false,true,true,true,package.json;Cargo.toml;*.csproj;CMakeLists.txt;tauri.conf.json;electron-builder.yml;wails.json,src/;app/;components/;main/;renderer/;resources/;assets/;build/,*service.ts;ipc*.ts;*bridge*.ts;*native*.ts;invoke*,*.test.ts;*.spec.ts;*_test.rs;*.spec.tsx,.env*;config/*;*.config.*;app.config.*;forge.config.*;builder.config.*,*auth*.ts;*session*.ts;keychain*;secure-storage*,N/A,main.ts;index.ts;main.js;src-tauri/main.rs;electron.ts,shared/**;common/**;utils/**;lib/**;components/shared/**,N/A,*event*.ts;*ipc*.ts;*message*.ts,.github/workflows/**;.gitlab-ci.yml;.circleci/**,resources/**;assets/**;icons/**;static/**;build/resources,N/A,N/A,i18n/**;locales/**;translations/**;lang/**,false,true
+game,false,false,true,false,false,*.unity;*.godot;*.uproject;package.json;project.godot,Assets/;Scenes/;Scripts/;Prefabs/;Resources/;Content/;Source/;src/;scenes/;scripts/,N/A,*Test.cs;*_test.gd;*Test.cpp;*.test.ts,.env*;config/*;*.ini;settings/;GameSettings/,N/A,N/A,main.gd;Main.cs;GameManager.cs;main.cpp;index.ts,shared/**;common/**;utils/**;Core/**;Framework/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml,Assets/**;Scenes/**;Prefabs/**;Materials/**;Textures/**;Audio/**;Models/**;*.fbx;*.blend;*.shader;*.hlsl;*.glsl;Shaders/**;VFX/**,N/A,N/A,Localization/**;Languages/**;i18n/**,false,true
+data,false,true,false,false,true,requirements.txt;pyproject.toml;dbt_project.yml;airflow.cfg;setup.py;Pipfile,dags/;pipelines/;models/;transformations/;notebooks/;sql/;etl/;jobs/,N/A,test_*.py;*_test.py;tests/**,.env*;config/*;profiles.yml;dbt_project.yml;airflow.cfg,N/A,migrations/**;dbt/models/**;*.sql;schemas/**,main.py;__init__.py;pipeline.py;dag.py,shared/**;common/**;utils/**;lib/**;helpers/**,N/A,*event*.py;*consumer*.py;*producer*.py;*worker*.py;jobs/**;tasks/**,.github/workflows/**;.gitlab-ci.yml;airflow/dags/**,N/A,N/A,*.proto;*.avro;schemas/**;*.parquet,N/A,false,false
+extension,true,false,true,true,false,manifest.json;package.json;wxt.config.ts,src/;popup/;content/;background/;assets/;components/,*message.ts;*runtime.ts;*storage.ts;*tabs.ts,*.test.ts;*.spec.ts;*.test.tsx,.env*;wxt.config.*;webpack.config.*;vite.config.*,*auth*.ts;*session*.ts;*permission*,N/A,index.ts;popup.ts;background.ts;content.ts,shared/**;common/**;utils/**;lib/**,N/A,*message*.ts;*event*.ts;chrome.runtime*;browser.runtime*,.github/workflows/**,assets/**;icons/**;images/**;static/**,N/A,N/A,_locales/**;locales/**;i18n/**,false,false
+infra,false,false,false,false,true,*.tf;*.tfvars;pulumi.yaml;cdk.json;*.yml;*.yaml;Dockerfile;docker-compose*.yml,terraform/;modules/;k8s/;charts/;playbooks/;roles/;policies/;stacks/,N/A,*_test.go;test_*.py;*_test.tf;*_spec.rb,.env*;*.tfvars;config/*;vars/;group_vars/;host_vars/,N/A,N/A,main.tf;index.ts;__main__.py;playbook.yml,modules/**;shared/**;common/**;lib/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml;.circleci/**,N/A,N/A,N/A,N/A,false,false
+embedded,false,false,false,false,false,platformio.ini;CMakeLists.txt;*.ino;Makefile;*.ioc;mbed-os.lib,src/;lib/;include/;firmware/;drivers/;hal/;bsp/;components/,N/A,test_*.c;*_test.cpp;*_test.c;tests/**,.env*;config/*;sdkconfig;*.json;settings/,N/A,N/A,main.c;main.cpp;main.ino;app_main.c,lib/**;shared/**;common/**;drivers/**,N/A,N/A,.github/workflows/**;.gitlab-ci.yml,N/A,*.h;*.hpp;drivers/**;hal/**;bsp/**;pinout.*;peripheral*;gpio*;*.fzz;schematics/**,*.proto;mqtt*;coap*;modbus*,N/A,true,false

package/src/method-skills/1-analysis/wize-document-project/templates/api-contracts-template.md

@@ -0,0 +1,38 @@
+---
+status: baseline
+owner: Pepper Potts + Tony Stark
+created: {{date}}
+last_refreshed: {{date}}
+---
+
+# {{project_name}} — API Contracts{{#if part_id}} — {{part_id}}{{/if}}
+
+**Date:** {{date}}
+
+## Overview
+
+{{api_overview}}
+
+## Endpoints
+
+{{#each endpoints}}
+### {{name}}
+- **Method:** {{method}}
+- **Path:** `{{path}}`
+- **Description:** {{description}}
+
+#### Request
+{{request_schema}}
+
+#### Response
+{{response_schema}}
+
+#### Errors
+{{#each errors}}
+- **{{status}}** — {{description}}
+{{/each}}
+{{/each}}
+
+---
+
+_Generated using Wize Dev Kit `document-project` workflow_

package/src/method-skills/1-analysis/wize-document-project/templates/architecture-template.md

@@ -0,0 +1,54 @@
+---
+status: baseline
+owner: Pepper Potts + Tony Stark
+created: {{date}}
+last_refreshed: {{date}}
+---
+
+# {{project_name}} — Architecture{{#if part_id}} — {{part_id}}{{/if}}
+
+**Date:** {{date}}
+**Type:** {{project_type}}
+**Architecture Pattern:** {{architecture_pattern}}
+
+## Executive Summary
+
+{{architecture_summary}}
+
+## Entry Points
+
+{{#each entry_points}}
+- **`{{path}}`** — {{description}}
+{{/each}}
+
+## Components
+
+{{#each components}}
+### {{name}}
+- **Responsibility:** {{responsibility}}
+- **Location:** `{{location}}`
+- **Depends on:** {{dependencies}}
+- **Used by:** {{dependents}}
+{{/each}}
+
+## Data Flow
+
+{{data_flow_description}}
+
+## Integrations
+
+{{#each integrations}}
+- **{{name}}** — {{description}}
+- **Type:** {{integration_type}}
+- **Boundary:** {{boundary}}
+{{/each}}
+
+## Decisions & Trade-offs
+
+{{#each decisions}}
+- {{description}}
+{{/each}}
+
+---
+
+_Generated using Wize Dev Kit `document-project` workflow_

package/src/method-skills/1-analysis/wize-document-project/templates/component-inventory-template.md

@@ -0,0 +1,40 @@
+---
+status: baseline
+owner: Pepper Potts + Mantis
+created: {{date}}
+last_refreshed: {{date}}
+---
+
+# {{project_name}} — Component Inventory{{#if part_id}} — {{part_id}}{{/if}}
+
+**Date:** {{date}}
+**Type:** {{project_type}}
+
+## Categorization
+
+{{#each categories}}
+### {{name}}
+{{#each components}}
+- **{{name}}** (`{{location}}`) — {{purpose}}
+{{/each}}
+{{/each}}
+
+## Reuse
+
+{{#each reusable_components}}
+- **{{name}}** — {{usage_guidance}}
+{{/each}}
+
+## Design System
+
+{{design_system_notes}}
+
+## Component Dependencies
+
+{{#each dependency_notes}}
+- {{description}}
+{{/each}}
+
+---
+
+_Generated using Wize Dev Kit `document-project` workflow_

package/src/method-skills/1-analysis/wize-document-project/templates/contribution-guide-template.md

@@ -0,0 +1,34 @@
+---
+status: baseline
+owner: Peggy Carter + Pepper Potts
+created: {{date}}
+last_refreshed: {{date}}
+---
+
+# {{project_name}} — Contribution Guide{{#if part_id}} — {{part_id}}{{/if}}
+
+**Date:** {{date}}
+
+## Local Setup
+
+{{local_setup}}
+
+## Conventions
+
+{{contribution_conventions}}
+
+## Pull Request Process
+
+{{pr_process}}
+
+## Testing
+
+{{testing_requirements}}
+
+## Questions
+
+{{contact_notes}}
+
+---
+
+_Generated using Wize Dev Kit `document-project` workflow_