wize-dev-kit 0.15.0 → 0.16.0

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

@@ -1,40 +0,0 @@
----
-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

@@ -1,20 +0,0 @@
-# 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

@@ -1,112 +0,0 @@
----
-
-code: wize-spec
-description: "Use quando precisar destilar qualquer entrada de intenção (ideia, PRD, RFC, transcrição) em um contrato canônico SPEC.md para consumo downstream."
-name: Spec
-module: core
-status: ready
----
-
-# 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, `wize-grill` style: one question per turn, recommendation attached
-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

@@ -1,12 +0,0 @@
-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

@@ -1,38 +0,0 @@
----
-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

@@ -1,54 +0,0 @@
----
-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

@@ -1,40 +0,0 @@
----
-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

@@ -1,34 +0,0 @@
----
-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

@@ -1,36 +0,0 @@
----
-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_