@wefter/opencode 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.2.1 - 2026-06-04
+
+Stabilizes the `0.2.x` workflow contracts after the product-shaping release.
+
+- Clarified that planned workflows do not install executable CLI or OpenCode commands until implemented.
+- Moved future `technical-shaping` command names to planning metadata instead of executable command metadata.
+- Hardened work-unit config and workflow manifest schemas to better match runtime validation.
+- Added per-command CLI flag validation so unsupported options fail fast instead of being silently ignored.
+- Added CI coverage across Node 18, 20, 22 and 24, and hardened manual npm publish inputs to require an existing tag.
+- Updated local development, installation and self-audit documentation to distinguish package defaults from Wefter dogfooding config.
+
+## 0.2.0 - 2026-06-02
+
+Promotes `product-shaping` to an available workflow.
+
+- Added available-by-default product-shaping workflow installation, CLI run generation, OpenCode command, agents, skill, prompts, contracts and schemas.
+- Added product-shaping completion gate validation for required specs, ready deliverables, adversarial review evidence and final validation evidence.
+- Added `DELIVERABLES.md` handoff validation before legacy work-unit implementation can consume product-shaping output.
+- Added product-shaping doctrine autoaudit profile and repaired audit findings across schemas, prompts, agents, CLI behavior and docs.
+- Hardened product-shaping schemas and runtime checks for canonical file order, vocabulary, relative paths, manifest outputs, handoff and gate evidence.
+- Expanded CLI tests for product-shaping availability, path safety, handoff validation and OpenCode installation.
+
 ## 0.1.0 - 2026-06-02
 
 Initial public release of Wefter for OpenCode.

package/README.md

@@ -4,24 +4,24 @@ Wefter installs reusable OpenCode workflows that weave product intent into audit
 
 ## Status
 
-Early product extraction. The package is usable locally for `documentation-audit`, `documentation-repair`, and `work-unit-implementation`; the other workflows are architecture scaffolds.
+Wefter is usable locally for `product-shaping`, `documentation-audit`, `documentation-repair`, and `work-unit-implementation`. Product shaping is available by default and includes CLI run generation, OpenCode integration, validation gates and audited `DELIVERABLES.md` handoff.
 
 ## Package
 
 ```text
 package: @wefter/opencode
-repo: opencode-wefter
+repo: wefter
 cli: wefter
 config: wefter.config.json
 local workflow files: .wefter/
-runtime artifacts: .audit/wefter/
+runtime artifacts: .audit/wefter/ for legacy workflows; .wefter/runs/ for product-shaping
 ```
 
 ## Workflows
 
 | Workflow ID | Status | Purpose |
 | --- | --- | --- |
-| `product-shaping` | Planned | Shape an initial idea into product docs, scope and explicit decisions. |
+| `product-shaping` | Available | Shape an initial idea into product specs, release scope, acceptance criteria and deliverables. |
 | `documentation-audit` | Available | Run redundant, adversarial documentation consistency audits. |
 | `documentation-repair` | Available | Repair docs from a validated audit report without mixing detection and correction. |
 | `technical-shaping` | Planned | Convert product docs into explicit technical decisions and implementation constraints. |
@@ -31,13 +31,14 @@ runtime artifacts: .audit/wefter/
 
 ```bash
 npm run check
+npm test
 node bin/wefter.js --help
 ```
 
 Install into another project from this checkout:
 
 ```bash
-node <path-to-opencode-wefter>/bin/wefter.js init --target <path-to-project> --yes
+node <path-to-wefter>/bin/wefter.js init --target <path-to-project> --yes
 ```
 
 ## Intended User Flow
@@ -46,10 +47,11 @@ node <path-to-opencode-wefter>/bin/wefter.js init --target <path-to-project> --y
 npx @wefter/opencode init
 ```
 
-Restart OpenCode, then use:
+Restart OpenCode, then use the available default commands:
 
 ```text
 /wefter-generate-doc-audit-profile
+/wefter-shape-product
 /wefter-audit-docs
 /wefter-repair-docs
 /wefter-run-work-unit
@@ -59,6 +61,8 @@ CLI checks are also available:
 
 ```bash
 wefter doctor
+wefter product shape --dry-run
+wefter product validate --json
 wefter docs audit --passes-per-lens 1 --max-audits 12
 wefter docs audit --profile-path docs/audits/lenses.json --passes-per-lens 1 --max-audits 12
 wefter profile import --source docs/audits/lenses.json --force
@@ -78,7 +82,14 @@ wefter new-run documentation-audit --passes-per-lens 1 --max-audits 12
   "processDocPath": ".wefter/workflows/documentation-audit/README.md",
   "runnerCommand": "node <path-to-wefter>/bin/wefter.js",
   "workflows": {
-    "product-shaping": { "status": "planned", "enabled": false },
+    "product-shaping": {
+      "status": "available",
+      "enabled": true,
+      "specRoot": ".wefter/specs",
+      "runRoot": ".wefter/runs/product-shaping",
+      "configPath": ".wefter/workflows/product-shaping/config.json",
+      "profilePath": ".wefter/workflows/product-shaping/profile.json"
+    },
     "documentation-audit": { "status": "available", "enabled": true },
     "documentation-repair": { "status": "available", "enabled": true },
     "technical-shaping": { "status": "planned", "enabled": false },
@@ -101,12 +112,15 @@ wefter new-run documentation-audit --passes-per-lens 1 --max-audits 12
 - `docs repair` writes through a staging directory and requires an existing repository-relative audit report path.
 - Paths in `wefter.config.json` must be relative to the target repository and must not contain `..`.
 - Run names are plain directory names and cannot contain path separators.
+- `product-shaping` writes versioned product specs under `.wefter/specs/` and runtime runs under `.wefter/runs/product-shaping/` by default.
+- `product validate` fails the publication/handoff gate when required product specs, blocking questions or deliverable statuses are invalid.
 - Audit execution must not edit source documentation; correction is a separate workflow.
 - Repair execution must pause when validated findings require unresolved human decisions.
 
 ## Product Direction
 
-Next steps before a stable release:
+Next hardening steps after the `0.2.1` stabilization release:
 
 1. Add installation manifest/uninstall support.
-2. Harden release and package publishing automation.
+2. Continue migration from legacy `work-unit-implementation` naming toward `delivery-implementation`.
+3. Implement `technical-shaping` only after its contract, CLI behavior and OpenCode command are ready.

package/docs/ARCHITECTURE.md

@@ -19,7 +19,7 @@ These files must not encode any single product domain.
 `wefter.config.json` stores installation choices for one repository:
 
 - `workflowRoot`: versioned Wefter workflow files installed in the target repository.
-- `artifactRoot`: generated runtime output root for the currently available documentation audit workflow.
+- `artifactRoot`: generated runtime output root for legacy audit workflows. Product-shaping uses its workflow-specific run root under `.wefter/runs/product-shaping` by default.
 - `profilePath`: project-specific documentation audit profile.
 - `templateRoot`: installed documentation audit prompt templates.
 - `processDocPath`: installed workflow documentation.
@@ -38,7 +38,7 @@ Workflow modules live under `src/workflows/<workflow-id>/` and expose `workflow.
 - `technical-shaping`
 - `work-unit-implementation`
 
-`documentation-audit` is executable end-to-end through the CLI. `documentation-repair` generates gated repair runs from validated audit reports. `work-unit-implementation` can generate planning runs, install OpenCode agents, enforce deterministic task/review guards and validate completed work units.
+`product-shaping` is available for product spec generation and gated `DELIVERABLES.md` handoff. `documentation-audit` is executable end-to-end through the CLI. `documentation-repair` generates gated repair runs from validated audit reports. `work-unit-implementation` can generate planning runs, install OpenCode agents, enforce deterministic task/review guards and validate completed work units.
 
 ## Documentation Audit Run
 
@@ -63,17 +63,13 @@ Repair runs contain prompts for planning, applying approved repairs and reviewin
 
 The installer writes:
 
-- `.opencode/agent/wefter-doc-audit-orchestrator.md`
-- `.opencode/agent/wefter-doc-auditor.md`
-- `.opencode/agent/wefter-doc-audit-consolidator.md`
-- `.opencode/agent/wefter-doc-audit-validator.md`
-- `.opencode/agent/wefter-doc-audit-profile-builder.md`
-- `.opencode/agent/wefter-doc-repair-orchestrator.md`
-- `.opencode/agent/wefter-doc-repair-planner.md`
-- `.opencode/agent/wefter-doc-repairer.md`
-- `.opencode/agent/wefter-doc-repair-reviewer.md`
+- `.opencode/agent/wefter-doc-*.md`
+- `.opencode/agent/wefter-product-*.md`
+- `.opencode/agent/wefter-work-unit-*.md`
 - `.opencode/skills/documentation-audit/SKILL.md`
 - `.opencode/skills/documentation-repair/SKILL.md`
-- `opencode.json` commands `/wefter-audit-docs`, `/wefter-generate-doc-audit-profile`, `/wefter-repair-docs` and `/wefter-run-work-unit`
+- `.opencode/skills/product-shaping/SKILL.md`
+- `.opencode/skills/work-unit-implementation/SKILL.md`
+- `opencode.json` commands `/wefter-generate-doc-audit-profile`, `/wefter-shape-product`, `/wefter-audit-docs`, `/wefter-repair-docs` and `/wefter-run-work-unit`
 
 OpenCode must be restarted after installation because configuration is loaded once at startup.

package/docs/INSTALLATION.md

@@ -9,13 +9,14 @@ npx @wefter/opencode init
 From a local checkout:
 
 ```bash
-node <path-to-opencode-wefter>/bin/wefter.js init --target <path-to-project> --yes
+node <path-to-wefter>/bin/wefter.js init --target <path-to-project> --yes
 ```
 
 Then restart OpenCode and run:
 
 ```text
 /wefter-generate-doc-audit-profile
+/wefter-shape-product
 /wefter-audit-docs
 /wefter-repair-docs
 /wefter-run-work-unit

package/docs/SAFETY_MODEL.md

@@ -7,7 +7,7 @@ Core rules:
 - Detection and correction are separate workflows.
 - Documentation audit agents must not edit source documentation.
 - Documentation repair must plan before editing and pause on unresolved human decisions.
-- Runtime artifacts are written under `.audit/wefter/` by default.
+- Runtime artifacts are written under workflow-specific configured roots: legacy audit, repair and work-unit workflows default to `.audit/wefter/`, while product-shaping defaults to `.wefter/runs/`.
 - Versioned workflow configuration is written under `.wefter/` by default.
 - Paths are target-repository relative and must not contain `..`.
 - Run directories are staged before becoming visible as final runs.

package/docs/SELF_AUDIT.md

@@ -0,0 +1,37 @@
+# Self Audit
+
+Wefter can run `documentation-audit` against its own workflow source before publishing a workflow as available.
+
+The CLI command generates the audit run and auditor prompts. It does not execute the prompts by itself; a documentation-audit orchestrator or agent must resume the generated run and complete the raw audit, consolidation and validation steps.
+
+Use this pattern for any workflow-specific audit profile:
+
+```bash
+node bin/wefter.js docs audit --profile-path <workflow-audit-profile.json> --run-name <workflow-id>-self-audit --passes-per-lens 1 --max-audits 0
+```
+
+`--max-audits 0` means no audit prompt cap.
+
+Product-shaping example:
+
+```bash
+node bin/wefter.js docs audit --profile-path src/workflows/product-shaping/templates/documentation-audit-profile.json --run-name product-shaping-self-audit --passes-per-lens 1 --max-audits 0
+```
+
+The Wefter repository dogfoods documentation-audit with `artifactRoot` set to `.wefter/runs/documentation-audit` in its local `wefter.config.json`. Installed projects use the public default `.audit/wefter/documentation-audit` unless their config overrides it.
+
+Seed prompt:
+
+```text
+Audit the current workflow release against CHANGELOG.md and the workflow README.
+Focus on doctrine drift, missing runtime enforcement, handoff or gate bypasses, OpenCode execution gaps, schema/contract mismatch, weak tests and release artifacts that should not be committed.
+Treat prior review findings as hypotheses, not conclusions.
+```
+
+After the run is generated, resume it with:
+
+```text
+Resume the documentation audit run at .wefter/runs/documentation-audit/<run-id>.
+Read manifest.json, execute every auditor prompt listed there, write each raw output to its assigned path, then run prompts/consolidate.md and prompts/validate.md.
+Do not edit source files. Write only under the run directory.
+```

package/docs/WORKFLOWS.md

@@ -4,10 +4,14 @@ Wefter workflow IDs are stable nouns. CLI and OpenCode commands use verbs.
 
 | Workflow ID | CLI | OpenCode | Status |
 | --- | --- | --- | --- |
-| `product-shaping` | `wefter product shape` | `/wefter-shape-product` | Planned |
+| `product-shaping` | `wefter product shape`, `wefter product validate` | `/wefter-shape-product` | Available |
 | `documentation-audit` | `wefter docs audit` | `/wefter-audit-docs` | Available |
 | `documentation-repair` | `wefter docs repair` | `/wefter-repair-docs` | Available |
-| `technical-shaping` | `wefter technical shape` | `/wefter-shape-technical` | Planned |
+| `technical-shaping` | Not installed while planned | Not installed while planned | Planned |
 | `work-unit-implementation` | `wefter work-unit run`, `wefter work-unit guard` | `/wefter-run-work-unit` | Available |
 
-The first implementation release keeps `documentation-audit` executable and registers the full architecture. `documentation-repair` can generate repair runs from final audit reports with planning, human-decision gates, repair application and review prompts. `work-unit-implementation` can generate planning runs, orchestrate plan review, enforce deterministic task/review guards and validate a completed work unit.
+The `0.2.0` release promotes `product-shaping` to available. `documentation-audit` remains executable end-to-end. `documentation-repair` can generate repair runs from final audit reports with planning, human-decision gates, repair application and review prompts. `work-unit-implementation` can generate planning runs, orchestrate plan review, enforce deterministic task/review guards and validate a completed work unit.
+
+Planned workflows may document future command names in their workflow manifest, but only commands under `commands` are executable/installed. `technical-shaping` is intentionally not installed until its contract and CLI are implemented.
+
+For workflow dogfooding and release self-audit, see `docs/SELF_AUDIT.md`.

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@wefter/opencode",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Installable Wefter workflows for OpenCode projects.",
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/Wuerike/wefter.git"
+    "url": "git+https://github.com/Wuerike/wefter.git"
   },
   "bugs": {
     "url": "https://github.com/Wuerike/wefter/issues"

package/schemas/documentation-audit-profile.schema.json

@@ -5,6 +5,7 @@
   "required": ["version", "corpus", "variants", "lenses"],
   "properties": {
     "version": { "const": 1 },
+    "auditorPromptPath": { "$ref": "#/$defs/relativePath" },
     "corpus": {
       "type": "object",
       "required": ["include", "exclude"],
@@ -43,5 +44,12 @@
       }
     }
   },
-  "additionalProperties": false
+  "additionalProperties": false,
+  "$defs": {
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!.*(?:^|/)\\.\\.(?:/|$))[^\\\\\r\n]+$"
+    }
+  }
 }

package/schemas/product-shaping-config.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://wefter.dev/schemas/product-shaping-config.schema.json",
+  "type": "object",
+  "required": ["version", "workflowName", "releaseId", "specRoot", "runRoot", "contractPath", "processDocPath", "requiredFiles", "completionGate"],
+  "properties": {
+    "version": { "const": 1 },
+    "workflowName": { "const": "product-shaping" },
+    "releaseId": { "type": "string", "minLength": 1 },
+    "specRoot": { "$ref": "#/$defs/relativePath", "default": ".wefter/specs" },
+    "runRoot": { "$ref": "#/$defs/relativePath", "default": ".wefter/runs/product-shaping" },
+    "contractPath": { "$ref": "#/$defs/relativePath" },
+    "processDocPath": { "$ref": "#/$defs/relativePath" },
+    "requiredFiles": {
+      "type": "array",
+      "minItems": 17,
+      "maxItems": 17,
+      "prefixItems": [
+        { "const": "README.md" },
+        { "const": "discovery/SOURCE_MATERIALS.md" },
+        { "const": "discovery/IDEA_BRIEF.md" },
+        { "const": "discovery/OPEN_QUESTIONS.md" },
+        { "const": "references/README.md" },
+        { "const": "PRODUCT_VISION.md" },
+        { "const": "product/FEATURE_CATALOG.md" },
+        { "const": "product/MODULE_ROADMAP.md" },
+        { "const": "product/DOMAIN_MODEL.md" },
+        { "const": "product/OPERATIONAL_FLOW.md" },
+        { "const": "product/PRODUCT_DECISIONS.md" },
+        { "const": "releases/README.md" },
+        { "const": "releases/<release-id>/README.md" },
+        { "const": "releases/<release-id>/SCOPE.md" },
+        { "const": "releases/<release-id>/DOMAIN_SPEC.md" },
+        { "const": "releases/<release-id>/ACCEPTANCE_CRITERIA.md" },
+        { "const": "releases/<release-id>/DELIVERABLES.md" }
+      ],
+      "items": false
+    },
+    "completionGate": {
+      "type": "object",
+      "required": ["requireNoReleaseBlockingQuestions", "requireAdversarialReview", "requireFinalValidation", "readyDeliverableStatuses"],
+      "properties": {
+        "requireNoReleaseBlockingQuestions": { "type": "boolean" },
+        "requireAdversarialReview": { "const": true },
+        "requireFinalValidation": { "const": true },
+        "readyDeliverableStatuses": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "enum": ["ready"] }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!.*(?:^|/)\\.\\.(?:/|$))[^\\\\\r\n]+$"
+    }
+  }
+}

package/schemas/product-shaping-contract.schema.json

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://wefter.dev/schemas/product-shaping-contract.schema.json",
+  "type": "object",
+  "required": ["version", "workflowId", "defaultRoots", "vocabulary", "statusEnums", "dynamicCollections", "creationOrderScope", "creationOrder", "utilizationOrder", "precedence", "requiredFiles"],
+  "properties": {
+    "version": { "const": 1 },
+    "workflowId": { "const": "product-shaping" },
+    "defaultRoots": {
+      "type": "object",
+      "required": ["specRoot", "workflowRoot", "runRoot"],
+      "properties": {
+        "specRoot": { "const": ".wefter/specs" },
+        "workflowRoot": { "const": ".wefter/workflows" },
+        "runRoot": { "const": ".wefter/runs/product-shaping" }
+      },
+      "additionalProperties": false
+    },
+    "vocabulary": {
+      "type": "array",
+      "minItems": 5,
+      "maxItems": 5,
+      "prefixItems": [
+        { "const": "idea" },
+        { "const": "product specs" },
+        { "const": "release" },
+        { "const": "deliverable" },
+        { "const": "task" }
+      ],
+      "items": false
+    },
+    "statusEnums": {
+      "type": "object",
+      "required": ["feature", "question", "decision", "deliverable"],
+      "properties": {
+        "feature": { "const": ["candidate", "core", "future", "rejected", "needs-decision"] },
+        "question": { "const": ["open", "answered", "deferred", "obsolete"] },
+        "decision": { "const": ["accepted", "superseded", "rejected"] },
+        "deliverable": { "const": ["candidate", "ready", "blocked", "deferred", "done"] }
+      },
+      "additionalProperties": false
+    },
+    "dynamicCollections": {
+      "type": "object",
+      "required": ["references"],
+      "properties": {
+        "references": {
+          "type": "object",
+          "required": ["index", "itemPattern", "listingPattern", "creationOrder", "zeroItemsAllowedWithExplicitIndexStatement", "rule"],
+          "properties": {
+            "index": { "const": "references/README.md" },
+            "itemPattern": { "const": "references/<reference>.md" },
+            "listingPattern": { "const": "references/<reference>.md" },
+            "creationOrder": { "type": "string", "minLength": 1 },
+            "zeroItemsAllowedWithExplicitIndexStatement": { "const": true },
+            "rule": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "creationOrderScope": { "const": "fixed-required-files" },
+    "creationOrder": { "$ref": "#/$defs/creationOrder" },
+    "utilizationOrder": { "$ref": "#/$defs/utilizationOrder" },
+    "precedence": {
+      "type": "object",
+      "required": ["release", "product", "decision", "blockingQuestionRule"],
+      "properties": {
+        "release": { "$ref": "#/$defs/pathList" },
+        "product": { "$ref": "#/$defs/pathList" },
+        "decision": { "type": "string", "minLength": 1 },
+        "blockingQuestionRule": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "requiredFiles": {
+      "type": "array",
+      "minItems": 17,
+      "maxItems": 17,
+      "items": {
+        "type": "object",
+        "required": ["path", "responsibility", "limits", "createdAfter", "usedBefore", "consumers", "minimumContent", "hardRules"],
+        "properties": {
+          "path": { "$ref": "#/$defs/requiredFilePath" },
+          "responsibility": { "type": "string", "minLength": 1 },
+          "limits": { "type": "string", "minLength": 1 },
+          "createdAfter": { "$ref": "#/$defs/pathList" },
+          "usedBefore": { "$ref": "#/$defs/pathList" },
+          "consumers": { "$ref": "#/$defs/stringList" },
+          "minimumContent": { "$ref": "#/$defs/stringList" },
+          "hardRules": { "$ref": "#/$defs/stringList" }
+        },
+        "additionalProperties": false
+      },
+      "allOf": [
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "README.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "discovery/SOURCE_MATERIALS.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "discovery/IDEA_BRIEF.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "discovery/OPEN_QUESTIONS.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "references/README.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "PRODUCT_VISION.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "product/FEATURE_CATALOG.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "product/MODULE_ROADMAP.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "product/DOMAIN_MODEL.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "product/OPERATIONAL_FLOW.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "product/PRODUCT_DECISIONS.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "releases/README.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "releases/<release-id>/README.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "releases/<release-id>/SCOPE.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "releases/<release-id>/DOMAIN_SPEC.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "releases/<release-id>/ACCEPTANCE_CRITERIA.md" } } } },
+        { "contains": { "type": "object", "required": ["path"], "properties": { "path": { "const": "releases/<release-id>/DELIVERABLES.md" } } } }
+      ]
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "pathList": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "requiredFilePath": {
+      "enum": [
+        "README.md",
+        "discovery/SOURCE_MATERIALS.md",
+        "discovery/IDEA_BRIEF.md",
+        "discovery/OPEN_QUESTIONS.md",
+        "references/README.md",
+        "PRODUCT_VISION.md",
+        "product/FEATURE_CATALOG.md",
+        "product/MODULE_ROADMAP.md",
+        "product/DOMAIN_MODEL.md",
+        "product/OPERATIONAL_FLOW.md",
+        "product/PRODUCT_DECISIONS.md",
+        "releases/README.md",
+        "releases/<release-id>/README.md",
+        "releases/<release-id>/SCOPE.md",
+        "releases/<release-id>/DOMAIN_SPEC.md",
+        "releases/<release-id>/ACCEPTANCE_CRITERIA.md",
+        "releases/<release-id>/DELIVERABLES.md"
+      ]
+    },
+    "creationOrder": {
+      "type": "array",
+      "minItems": 17,
+      "maxItems": 17,
+      "prefixItems": [
+        { "const": "README.md" },
+        { "const": "discovery/SOURCE_MATERIALS.md" },
+        { "const": "discovery/IDEA_BRIEF.md" },
+        { "const": "discovery/OPEN_QUESTIONS.md" },
+        { "const": "references/README.md" },
+        { "const": "PRODUCT_VISION.md" },
+        { "const": "product/FEATURE_CATALOG.md" },
+        { "const": "product/MODULE_ROADMAP.md" },
+        { "const": "product/DOMAIN_MODEL.md" },
+        { "const": "product/OPERATIONAL_FLOW.md" },
+        { "const": "product/PRODUCT_DECISIONS.md" },
+        { "const": "releases/README.md" },
+        { "const": "releases/<release-id>/README.md" },
+        { "const": "releases/<release-id>/SCOPE.md" },
+        { "const": "releases/<release-id>/DOMAIN_SPEC.md" },
+        { "const": "releases/<release-id>/ACCEPTANCE_CRITERIA.md" },
+        { "const": "releases/<release-id>/DELIVERABLES.md" }
+      ],
+      "items": false
+    },
+    "utilizationOrder": {
+      "type": "array",
+      "minItems": 15,
+      "maxItems": 15,
+      "prefixItems": [
+        { "const": "README.md" },
+        { "const": "releases/<release-id>/README.md" },
+        { "const": "PRODUCT_VISION.md" },
+        { "const": "product/PRODUCT_DECISIONS.md" },
+        { "const": "releases/<release-id>/SCOPE.md" },
+        { "const": "releases/<release-id>/DOMAIN_SPEC.md" },
+        { "const": "releases/<release-id>/ACCEPTANCE_CRITERIA.md" },
+        { "const": "releases/<release-id>/DELIVERABLES.md" },
+        { "const": "product/DOMAIN_MODEL.md" },
+        { "const": "product/OPERATIONAL_FLOW.md" },
+        { "const": "product/FEATURE_CATALOG.md" },
+        { "const": "product/MODULE_ROADMAP.md" },
+        { "const": "discovery/OPEN_QUESTIONS.md" },
+        { "const": "discovery/IDEA_BRIEF.md" },
+        { "const": "references/" }
+      ],
+      "items": false
+    },
+    "stringList": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "stringEnum": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/schemas/product-shaping-profile.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://wefter.dev/schemas/product-shaping-profile.schema.json",
+  "type": "object",
+  "required": ["version", "workflowName", "variants", "lenses"],
+  "properties": {
+    "version": { "const": 1 },
+    "workflowName": { "const": "product-shaping" },
+    "variants": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "instruction"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+          "title": { "type": "string", "minLength": 1 },
+          "instruction": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    },
+    "lenses": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "focus"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+          "title": { "type": "string", "minLength": 1 },
+          "focus": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}