@exaudeus/workrail 3.9.1 → 3.9.2

package/README.md

@@ -175,7 +175,7 @@ The agent will find the workflow, start at step 1, and proceed systematically.
 | `coding-task-workflow-agentic` | Feature development with notes-first durability and audit loops |
 | `bug-investigation-agentic` | Systematic debugging with evidence-based analysis |
 | `mr-review-workflow-agentic` | Code review with parallel reviewer families |
-| `exploration-workflow` | Understanding an unfamiliar codebase |
+| `wr.discovery` | Upstream exploration, framing, and design synthesis |
 | `document-creation-workflow` | Technical documentation with structure |
 
 Workflows adapt to complexity - simple tasks get fast-tracked, complex tasks get full rigor.

package/dist/application/services/compiler/feature-registry.js

@@ -11,6 +11,24 @@ const FEATURE_DEFINITIONS = [
             ],
         ],
     },
+    {
+        id: 'wr.features.capabilities',
+        constraints: [
+            'Do not assume optional capabilities are available just because this workflow can use them.',
+            'If delegation, web access, or another optional capability matters here, verify it through a real probe or attempt before relying on it.',
+            'If a capability is unavailable, degrade explicitly instead of silently acting as if it existed.',
+        ],
+        procedure: [
+            'When an optional capability would materially affect the quality of this step, decide whether using it is worth it here.',
+            'If you take a capability-dependent path, record the observation or attempt that justified it.',
+            'If you skip delegation or another optional capability, keep going yourself and record why the fallback path is sufficient.',
+        ],
+        verify: [
+            'No capability-dependent path was taken without an explicit observation, probe, or attempted use.',
+            'If a capability was unavailable or skipped, the fallback path and its limitation were made explicit.',
+            'The main agent still owns synthesis and final judgment.',
+        ],
+    },
     {
         id: 'wr.features.subagent_guidance',
         constraints: [

package/dist/manifest.json

@@ -14,8 +14,8 @@
       "bytes": 740
     },
     "application/services/compiler/feature-registry.js": {
-      "sha256": "350bc4b849426ed5c8ba64801b13ad47130ec7084d1ee693eed065bf158f10ab",
-      "bytes": 2239
+      "sha256": "ee7efd8b3594e2f02a2ecc6fe024ed9fb96ba0f8b5f1683d0c63c6196eab20e2",
+      "bytes": 3436
     },
     "application/services/compiler/prompt-blocks.d.ts": {
       "sha256": "2f40fd7599bd351584505152e9916fdea60891833d22c774c8ac9955f01ccf66",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "3.9.1",
+  "version": "3.9.2",
   "description": "Step-by-step workflow enforcement for AI agents via MCP",
   "license": "MIT",
   "repository": {

package/spec/workflow.schema.json

@@ -20,7 +20,7 @@
     },
     "description": {
       "type": "string",
-      "description": "What this workflow accomplishes",
+      "description": "What this workflow accomplishes. Prefer clear user-facing language for bundled/user-facing workflows; schema does not enforce prose style.",
       "minLength": 1,
       "maxLength": 512
     },
@@ -42,7 +42,7 @@
     },
     "clarificationPrompts": {
       "type": "array",
-      "description": "Questions to ask upfront to resolve ambiguities",
+      "description": "Questions to ask upfront to resolve ambiguities. Prefer direct, user-grounded wording over abstract framework narration.",
       "items": {
         "type": "string",
         "minLength": 1,
@@ -67,7 +67,7 @@
     },
     "metaGuidance": {
       "type": "array",
-      "description": "Persistent behavioral rules surfaced on start and resume. Not repeated on every step advance. For external document pointers, use 'references' instead.",
+      "description": "Persistent behavioral rules surfaced on start and resume. Not repeated on every step advance. Use this to define quality bars and anti-failure guidance without rigidly scripting every thought. For external document pointers, use 'references' instead.",
       "items": {
         "type": "string",
         "minLength": 1,
@@ -127,7 +127,7 @@
     },
     "features": {
       "type": "array",
-      "description": "Compiler features to apply to this workflow (e.g. wr.features.memory_context). Features inject content into promptBlocks at compile time.",
+      "description": "Compiler features to apply to this workflow (e.g. wr.features.memory_context). Features inject content into promptBlocks at compile time and work best when the workflow uses structured promptBlocks instead of relying entirely on raw prompt prose.",
       "items": {
         "type": "string",
         "minLength": 1,
@@ -137,7 +137,7 @@
     },
     "extensionPoints": {
       "type": "array",
-      "description": "Bounded cognitive slots that users can customize via .workrail/bindings.json. Each slot is referenced in step prompts via {{wr.bindings.slotId}} and resolved at compile time.",
+      "description": "Bounded cognitive slots that users can customize via .workrail/bindings.json. Each slot is referenced in step prompts via {{wr.bindings.slotId}} and resolved at compile time. Use extension points for bounded cognitive units, not for core orchestration or final synthesis ownership.",
       "items": {
         "$ref": "#/$defs/extensionPoint"
       },
@@ -163,7 +163,7 @@
   "$defs": {
     "extensionPoint": {
       "type": "object",
-      "description": "A bounded cognitive slot that can be customized via .workrail/bindings.json",
+      "description": "A bounded cognitive slot that can be customized via .workrail/bindings.json. Good uses include candidate generation, review, and validation passes; poor uses include replacing the parent workflow's core orchestration contract.",
       "properties": {
         "slotId": {
           "type": "string",
@@ -283,7 +283,7 @@
       "properties": {
         "id": { "$ref": "#/$defs/stepId", "description": "Unique identifier for the step" },
         "title": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "prompt": { "type": "string", "minLength": 1, "maxLength": 8192 },
+        "prompt": { "type": "string", "minLength": 1, "maxLength": 8192, "description": "Traditional single-string prompt. Use when structure is simple; prefer promptBlocks when you need stronger quality bars without over-scripting cognition." },
         "promptBlocks": { "$ref": "#/$defs/promptBlocks" },
         "agentRole": { "type": "string", "minLength": 10, "maxLength": 1024 },
         "guidance": { "type": "array", "items": { "type": "string" } },