wize-dev-kit 0.2.5 → 0.3.1

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,66 @@ Format inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [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.
+
+### Added — `wize-dev-kit doctor`
+
+Single-command snapshot of kit + project + environment, plus a ranked list of suggestions. Designed to be the first command a new developer runs in an unfamiliar wize-enabled repo, and the go-to command when something looks off. Sections covered:
+
+- **Kit versions** (installed, project-pinned in `kit_version`, registry-latest) — flags drift between any of them.
+- **Project** — name, profiles, IDE targets, languages, current phase (heuristic: brief → trigger-map → PRD → UX → tech-vision → architecture → stories → risk profile → sprint planning → implementation).
+- **IDE Adapters** — file count per target (`.claude/skills/`, `.cursor/rules/`, etc.). Flags adapters that didn't render and points at `wize-dev-kit sync`.
+- **TEA gates** — counts PASS / CONCERNS / FAIL / WAIVED across `gate.md` files in `.wize/implementation/tea/`. Flags any FAIL or CONCERNS.
+- **Knowledge baseline** — `last_refreshed` age per `document-project/*.md` file, plus inline-note count in `_pending.md`. Suggests `wize-refresh-knowledge` when files go stale (> 60 days) or pending notes pile up (≥ 5).
+- **Harness CLIs on PATH** — claude / codex / opencode, with detected install paths.
+- **Git** — branch / head, repo presence.
+
+Implementation in `tools/installer/commands/doctor.js`. 11 new unit tests cover phase detection, gate counting, knowledge parsing, adapter path mapping, and end-to-end run on a minimal install.
+
+Output is plain text (no colors) so it's grep-friendly and pipe-friendly. Section headers are stable for editors / dashboards to parse.
+
+### Added — GitHub Release on every tag
+
+After a successful `npm publish` from a `v*` tag, the workflow now:
+
+1. Extracts the matching version's CHANGELOG entry (`## [VERSION]` to the next `## [`) with a small awk filter.
+2. Creates a GitHub Release at the tag using `softprops/action-gh-release@v2`, with the CHANGELOG entry as the release body.
+3. If no CHANGELOG entry is found for the version, falls back to GitHub's auto-generated notes.
+
+Pre-release tags (`-alpha`, `-beta`, `-rc`) are marked as pre-release automatically. Requires `permissions: contents: write` (added to the publish job).
+
+### Tests
+
+- Total: **115 passing** (was 104).
+
 ## [0.2.5] — 2026-06-12
 
 Fixes a real install-time bug that bit non-TTY users (CI smoke + anyone piping input into `wize-dev-kit install`).
@@ -262,7 +322,8 @@ Ignore (handled by the suggested block): `.wize/config/user.toml`, `.wize/scratc
 - 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-br/wize-development-kit/compare/v0.2.5...HEAD
+[Unreleased]: https://github.com/qwize-br/wize-development-kit/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/qwize-br/wize-development-kit/compare/v0.2.5...v0.3.0
 [0.2.5]: https://github.com/qwize-br/wize-development-kit/compare/v0.2.4...v0.2.5
 [0.2.4]: https://github.com/qwize-br/wize-development-kit/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/qwize-br/wize-development-kit/compare/v0.2.2...v0.2.3

package/README.md

@@ -144,7 +144,10 @@ npx wize-dev-kit sync            # re-render IDE adapters after editing config
 npx wize-dev-kit agent list      # list built-in + custom agents
 npx wize-dev-kit agent create    # scaffold a new custom agent (validated + dry-run)
 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)
 ```
 
@@ -160,7 +163,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 and the `document-project` engine is wired: quick baseline, initial/full/deep scans, project-type classification, resume state, and IDE adapters for Claude Code, Cursor, Windsurf, and others. The CLI commands listed above are executable and tested. 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.2.5",
+  "version": "0.3.1",
   "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/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_

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

@@ -0,0 +1,36 @@
+---
+status: baseline
+owner: Pepper Potts + Tony Stark
+created: {{date}}
+last_refreshed: {{date}}
+---
+
+# {{project_name}} — Data Models{{#if part_id}} — {{part_id}}{{/if}}
+
+**Date:** {{date}}
+
+## Overview
+
+{{data_model_overview}}
+
+## Entities
+
+{{#each entities}}
+### {{name}}
+- **Purpose:** {{purpose}}
+- **Source:** `{{source_file}}`
+
+#### Fields
+{{#each fields}}
+- `{{name}}` ({{type}}) — {{description}}
+{{/each}}
+
+#### Relationships
+{{#each relationships}}
+- {{description}}
+{{/each}}
+{{/each}}
+
+---
+
+_Generated using Wize Dev Kit `document-project` workflow_