@codemcp/workflows 6.20.2 → 6.22.0

package/packages/core/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AAEzC,8BAA8B;AAC9B,cAAc,uBAAuB,CAAC;AAEtC,wCAAwC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AAEvC,kBAAkB;AAClB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAE1C,8BAA8B;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,2BAA2B;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AAEzC,8BAA8B;AAC9B,cAAc,uBAAuB,CAAC;AAEtC,wCAAwC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AAEvC,kBAAkB;AAClB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAE1C,8BAA8B;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,2BAA2B;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC"}

package/packages/core/dist/instruction-generator.js

@@ -9,6 +9,7 @@
 import { ProjectDocsManager } from './project-docs-manager.js';
 import { createLogger } from './logger.js';
 import { capitalizePhase } from './string-utils.js';
+import { formatCapabilityHint } from './capability-hint.js';
 export class InstructionGenerator {
     projectDocsManager;
     constructor(logger = createLogger('InstructionGenerator')) {
@@ -61,7 +62,7 @@ export class InstructionGenerator {
      * Enhance base instructions with context-specific information
      */
     async enhanceInstructions(baseInstructions, context) {
-        const { phase, conversationContext, allowedFilePatterns } = context;
+        const { phase, conversationContext, allowedFilePatterns, requiredCapability, capabilityConfig, } = context;
         const phaseName = capitalizePhase(phase);
         // IMPORTANT: Directive markers to make instructions stand out from context
         let workflowSection = `---
@@ -81,6 +82,11 @@ export class InstructionGenerator {
             !allowedFilePatterns.includes('*')) {
             workflowSection += `\n- Files allowed: \`${allowedFilePatterns.join('`, `')}\``;
         }
+        // Append optional capability hint. Opt-in: empty hint ⇒ skip entirely.
+        const capabilityHint = formatCapabilityHint(requiredCapability, capabilityConfig);
+        if (capabilityHint) {
+            workflowSection += `\n\n${capabilityHint}`;
+        }
         workflowSection += '\n\nCall `whats_next()` after user messages.';
         return `## ${phaseName} Phase\n\n${baseInstructions}\n\n${workflowSection}`;
     }

package/packages/core/dist/instruction-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"instruction-generator.js","sourceRoot":"","sources":["../src/instruction-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,MAAM,OAAO,oBAAoB;IACvB,kBAAkB,CAAqB;IAE/C,YAAY,SAAkB,YAAY,CAAC,sBAAsB,CAAC;QAChE,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,aAA+B;QAC7C,OAAO;IACT,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CACxB,gBAAwB,EACxB,OAA2B;QAE3B,mDAAmD;QACnD,MAAM,uBAAuB,GAAG,IAAI,CAAC,yBAAyB,CAC5D,gBAAgB,EAChB,OAAO,CAAC,mBAAmB,CAAC,WAAW,EACvC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CACtC,CAAC;QAEF,2DAA2D;QAC3D,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,mBAAmB,CACzD,uBAAuB,EACvB,OAAO,CACR,CAAC;QAEF,OAAO;YACL,YAAY,EAAE,oBAAoB;YAClC,QAAQ,EAAE;gBACR,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,YAAY,EAAE,OAAO,CAAC,mBAAmB,CAAC,YAAY;gBACtD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,yBAAyB,CAC/B,YAAoB,EACpB,WAAmB,EACnB,SAAkB;QAElB,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,wBAAwB,CACpE,WAAW,EACX,SAAS,CACV,CAAC;QAEF,IAAI,MAAM,GAAG,YAAY,CAAC;QAC1B,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9D,oDAAoD;YACpD,MAAM,GAAG,MAAM,CAAC,OAAO,CACrB,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,EAC5C,KAAK,CACN,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,MAAc;QACjC,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAC/B,gBAAwB,EACxB,OAA2B;QAE3B,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC;QAEpE,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAEzC,2EAA2E;QAC3E,IAAI,eAAe,GAAG;;;sBAGJ,mBAAmB,CAAC,YAAY;;+BAEvB,SAAS;;gGAEwD,mBAAmB,CAAC,YAAY;;0FAEtC,CAAC;QAEvF,2DAA2D;QAC3D,IACE,mBAAmB;YACnB,mBAAmB,CAAC,MAAM,GAAG,CAAC;YAC9B,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAClC,CAAC;YACD,eAAe,IAAI,wBAAwB,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAClF,CAAC;QAED,eAAe,IAAI,8CAA8C,CAAC;QAElE,OAAO,MAAM,SAAS,aAAa,gBAAgB,OAAO,eAAe,EAAE,CAAC;IAC9E,CAAC;CACF"}
+{"version":3,"file":"instruction-generator.js","sourceRoot":"","sources":["../src/instruction-generator.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/interfaces/instruction-generator.interface.d.ts

@@ -6,6 +6,7 @@
  */
 import type { ConversationContext } from '../types.js';
 import type { YamlStateMachine } from '../state-machine-types.js';
+import type { CapabilityConfig } from '../capability-hint.js';
 export interface InstructionContext {
     phase: string;
     conversationContext: ConversationContext;
@@ -15,6 +16,19 @@ export interface InstructionContext {
     instructionSource: 'proceed_to_phase' | 'whats_next' | 'start_development';
     /** Glob patterns for files allowed to be edited in this phase (optional) */
     allowedFilePatterns?: string[];
+    /**
+     * Optional capability hint declared on the phase (`required_capability` in
+     * the YAML state machine). When set, the instruction generator embeds a
+     * "Capability hint:" sentence into the phase instructions so the LLM picks
+     * a suitable model/agent for subagent work. Absent ⇒ no hint (opt-in).
+     */
+    requiredCapability?: string;
+    /**
+     * Optional model/agent routing configuration for the capability hint's
+     * subagent clause. Populated from `.vibe/config.yaml` `capability_models`
+     * when present.
+     */
+    capabilityConfig?: CapabilityConfig;
 }
 export interface GeneratedInstructions {
     instructions: string;

package/packages/core/dist/state-machine-types.d.ts

@@ -43,6 +43,13 @@ export interface YamlState {
      * @example ["*"] // Allow all files (same as omitting)
      */
     allowed_file_patterns?: string[];
+    /**
+     * Optional capability hint for this phase.
+     * If absent, no capability routing is applied.
+     * Free-form string; conventional values are `thinking`, `research`, `coding`.
+     * See `.vibe/config.yaml` `capability_models` for optional model/agent mapping.
+     */
+    required_capability?: string;
 }
 /**
  * Complete state machine definition

package/packages/core/dist/system-prompt-generator.js

@@ -25,13 +25,35 @@ export function generateSystemPrompt(stateMachine) {
 function generateSimpleSystemPrompt(_stateMachine) {
     logger.debug('Generating system prompt');
     const systemPrompt = `
-You are an AI assistant that helps users develop software features using the workflows server.
+You are a structured, workflow-driven agent. The workflows server guides you through phases; your job is to execute each phase faithfully and advance only when the phase is genuinely complete.
 
-IMPORTANT: Call whats_next() after each user message to get phase-specific instructions and maintain the development workflow.
+## Core loop
 
-Each tool call returns a JSON response with an "instructions" field. Follow these instructions immediately after you receive them.
+After every user message, call \`whats_next()\`. It returns a JSON object with an \`instructions\` field. Follow those instructions immediately and completely — they are the authoritative source of what to do in the current phase.
 
-Use the development plan which you will retrieve via whats_next() to record important insights and decisions as per the structure of the plan.
+The response also returns a \`plan_file_path\`. That file is your persistent memory for the session. Read it at the start of each phase. Update it as directed by the instructions.
+
+## Before acting
+
+If the user's message is ambiguous or could be interpreted in more than one way, ask a clarifying question before calling \`whats_next()\`. State what is unclear and what you need to know. Do not silently pick an interpretation and proceed.
+
+Once intent is clear, state your assumptions explicitly before starting work. Surface tradeoffs. If a simpler approach exists than what was asked, say so.
+
+## Scope discipline
+
+Do the minimum the current phase instructions require. Do not do work that belongs to a later phase. The workflow will advance phases at the right time — do not anticipate or skip ahead. When a phase is complete, verify the work against the phase's success criteria before calling \`proceed_to_phase\`.
+
+## Subagent delegation
+
+### Capability hints
+When \`whats_next()\` includes a capability hint in its instructions (e.g. \`Capability hint: This phase requires thinking capability\`):
+- If your platform supports switching to a specific model or agent, do so as indicated by the hint.
+- Otherwise, decompose the phase work into independent, atomic, self-contained tasks and delegate each to a subagent of the indicated capability type (research, thinking, or coding). Collect and integrate results before proceeding.
+
+### Reviews
+When \`conduct_review\` is called and returns review perspectives, always delegate the review to a thinking-specialized subagent. Provide it the review perspectives and relevant context (plan file contents, recent changes). Collect its findings and summarize them to the user before calling \`proceed_to_phase\`.
+
+## Task management
 
 Do not use your own task management tools.`;
     logger.info('System prompt generated successfully', {

package/packages/core/dist/system-prompt-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt-generator.js","sourceRoot":"","sources":["../src/system-prompt-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAA8B;IACjE,MAAM,CAAC,KAAK,CAAC,wDAAwD,EAAE;QACrE,gBAAgB,EAAE,YAAY,CAAC,IAAI;QACnC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM;KACpD,CAAC,CAAC;IAEH,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,aAA+B;IACjE,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAEzC,MAAM,YAAY,GAAG;;;;;;;;;2CASoB,CAAC;IAE1C,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;QAClD,YAAY,EAAE,YAAY,CAAC,MAAM;KAClC,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC;AACtB,CAAC"}
+{"version":3,"file":"system-prompt-generator.js","sourceRoot":"","sources":["../src/system-prompt-generator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAA8B;IACjE,MAAM,CAAC,KAAK,CAAC,wDAAwD,EAAE;QACrE,gBAAgB,EAAE,YAAY,CAAC,IAAI;QACnC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM;KACpD,CAAC,CAAC;IAEH,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,aAA+B;IACjE,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAEzC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA+BoB,CAAC;IAE1C,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;QAClD,YAAY,EAAE,YAAY,CAAC,MAAM;KAClC,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemcp/workflows-core",
-  "version": "6.20.2",
+  "version": "6.22.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",

package/packages/core/resources/templates/opencode-agents/coding.md.tmpl

@@ -0,0 +1,13 @@
+---
+description: "Subagent for code generation and editing, focused on idiomatic patterns and minimal scope."
+mode: subagent
+model: ${model}
+---
+
+You are the `${capability}` subagent for the workflows system. Your job is to implement focused, high-quality code changes on behalf of the parent agent.
+
+Read the file you are about to edit before changing it. Match the surrounding style: indentation, naming, import order, error-handling conventions, and test patterns. Prefer small, surgical edits over large rewrites — change as little as possible to satisfy the requirement, and leave unrelated code untouched.
+
+Write idiomatic code for the language and framework in use. Avoid clever one-liners, speculative abstractions, or new dependencies unless they are clearly justified. When a fix could be done two ways, pick the simpler one and note the trade-off in a short comment if it matters.
+
+Run the relevant tests and linters when you can. If a build or test fails, do not declare success — diagnose and fix the root cause rather than papering over it. Never commit, push, or modify git state unless the parent agent explicitly instructs you to.

package/packages/core/resources/templates/opencode-agents/research.md.tmpl

@@ -0,0 +1,13 @@
+---
+description: "Subagent for fast information gathering and codebase exploration."
+mode: subagent
+model: ${model}
+---
+
+You are the `${capability}` subagent for the workflows system. Your job is to gather information quickly and report back concisely to the parent agent.
+
+Search the codebase, documentation, and any provided context before answering. Use the most targeted query you can — exact symbol names, file paths, or distinctive error messages — before falling back to broader patterns. When a question can be answered by reading one or two files, just read them instead of guessing.
+
+Report findings as a tight, structured summary: the direct answer first, then supporting evidence with file paths and line numbers. Quote only the snippets that matter. Do not paraphrase code when the original is clearer.
+
+Avoid making changes. Do not implement, refactor, or "fix while you're there" — your job is to inform the parent's decision, not to make it. If a question cannot be answered from the available context, say so plainly and suggest the next investigation step.

package/packages/core/resources/templates/opencode-agents/thinking.md.tmpl

@@ -0,0 +1,13 @@
+---
+description: "Subagent for deep reasoning, complex planning, and architectural trade-off analysis."
+mode: subagent
+model: ${model}
+---
+
+You are the `${capability}` subagent for the workflows system. Your job is to support the parent agent during phases that demand careful reasoning, planning, and architectural analysis.
+
+Approach problems methodically. Read the relevant code, surrounding tests, and any linked design notes before forming an opinion. When a question involves trade-offs, lay out the options with their concrete consequences rather than jumping to a single answer. Distinguish clearly between observed facts, reasonable inferences, and assumptions that still need verification.
+
+Prefer structured output: short bullet lists, named options, and explicit recommendation with rationale. Call out open questions, risks, and edge cases the parent agent should not overlook. When a decision depends on values (readability, performance, maintainability, scope) name them rather than hand-waving.
+
+Avoid making code changes unless the parent agent explicitly asks you to. Your primary value is sharp thinking, not typing. Do not invent APIs, file paths, or version numbers — when uncertain, say so and point at where to verify.

package/packages/core/resources/workflows/bugfix.yaml

@@ -26,10 +26,13 @@ metadata:
 states:
   reproduce:
     description: 'Reproduce and understand the bug'
+    required_capability: 'research'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
       - '**/*.adoc'
+      - '**/*test*'
+      - '**/*spec*'
     default_instructions: |
       Gather specific information to reliably reproduce the reported bug:
       - What are the exact OS, browser/runtime versions, and hardware specs?
@@ -46,6 +49,7 @@ states:
 
   analyze:
     description: 'Analyze the bug and identify root cause'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -74,6 +78,7 @@ states:
 
   fix:
     description: 'Implement the bug fix'
+    required_capability: 'coding'
     allowed_file_patterns:
       - '**/*'
     default_instructions: |
@@ -110,6 +115,7 @@ states:
 
   verify:
     description: 'Verify the fix and ensure no regressions'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*'
     default_instructions: Test the fix thoroughly to ensure the original bug is resolved and no new issues were introduced. Run existing tests, create new ones if needed, and verify the solution is robust.

package/packages/core/resources/workflows/epcc.yaml

@@ -26,6 +26,7 @@ metadata:
 states:
   explore:
     description: 'Research and exploration phase - understanding the problem space'
+    required_capability: 'research'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -48,6 +49,7 @@ states:
 
   plan:
     description: 'Planning phase - creating a detailed implementation strategy'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -92,6 +94,7 @@ states:
 
   code:
     description: 'Implementation phase - writing and building the solution'
+    required_capability: 'coding'
     allowed_file_patterns:
       - '**/*'
     default_instructions: |

package/packages/core/resources/workflows/greenfield.yaml

@@ -27,6 +27,7 @@ metadata:
 states:
   ideation:
     description: 'Deep requirements discovery and PRD creation phase'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -51,6 +52,7 @@ states:
 
   architecture:
     description: 'Tech stack selection and architecture design phase'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -130,6 +132,7 @@ states:
 
   code:
     description: 'Implementation phase following the established plan and architecture'
+    required_capability: 'coding'
     allowed_file_patterns:
       - '**/*'
     default_instructions: |

package/packages/core/resources/workflows/pr-review.yaml

@@ -57,6 +57,7 @@ states:
 
   review_architecture:
     description: 'Review whether the change is in the right place and respects existing structure'
+    required_capability: 'thinking'
     default_instructions: |
       Evaluate the structural decisions in the change against the confirmed intent:
 
@@ -93,6 +94,7 @@ states:
 
   review_correctness:
     description: 'Review whether the logic correctly achieves the confirmed intent'
+    required_capability: 'thinking'
     default_instructions: |
       Evaluate the logic of the change against the confirmed intent:
 

package/packages/core/resources/workflows/qrspi.yaml

@@ -54,6 +54,7 @@ states:
 
   research:
     description: 'Gather facts without forming conclusions or proposing solutions'
+    required_capability: 'research'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -81,6 +82,7 @@ states:
 
   design:
     description: 'Explore options and reach consensus on WHAT and high-level HOW'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -114,6 +116,7 @@ states:
 
   structure:
     description: 'Decompose the approved design into end-to-end vertical slices'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -143,6 +146,7 @@ states:
 
   plan:
     description: 'Create a detailed implementation plan per vertical slice'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -182,6 +186,7 @@ states:
 
   implement:
     description: 'Build the solution slice by slice'
+    required_capability: 'coding'
     allowed_file_patterns:
       - '**/*'
     default_instructions: |

package/packages/core/resources/workflows/tdd.yaml

@@ -26,6 +26,7 @@ metadata:
 states:
   explore:
     description: 'Research and exploration phase - understanding the problem space and codebase'
+    required_capability: 'research'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -50,6 +51,7 @@ states:
 
   red:
     description: 'RED phase - Write a failing test that defines the expected behavior'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*'
     default_instructions: |
@@ -87,6 +89,7 @@ states:
 
   green:
     description: 'GREEN phase - Write only the necessary code to make the test pass'
+    required_capability: 'coding'
     allowed_file_patterns:
       - '**/*'
     default_instructions: |

package/packages/core/resources/workflows/waterfall.yaml

@@ -27,6 +27,7 @@ metadata:
 states:
   requirements:
     description: 'Gathering and analyzing requirements'
+    required_capability: 'research'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -53,6 +54,7 @@ states:
 
   design:
     description: 'Technical design and architecture planning'
+    required_capability: 'thinking'
     allowed_file_patterns:
       - '**/*.md'
       - '**/*.txt'
@@ -80,6 +82,7 @@ states:
 
   implementation:
     description: 'Building the solution according to design'
+    required_capability: 'coding'
     allowed_file_patterns:
       - '**/*'
     default_instructions: |

package/packages/docs/.vitepress/dist/404.html

@@ -17,7 +17,7 @@
   </head>
   <body>
     <div id="app"></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"CvNKCNdN\",\"dev_development.md\":\"D_3UnLYh\",\"dev_logging.md\":\"ChgMzoxk\",\"dev_publishing.md\":\"9HHCKtL4\",\"index.md\":\"BqtGZhQl\",\"user_advanced-engineering.md\":\"DSy0uwWe\",\"user_agent-setup.md\":\"Cgzr8dYa\",\"user_beads-integration.md\":\"CB1VJJCp\",\"user_crowd-mcp-integration.md\":\"DPSO9u7p\",\"user_custom-workflows.md\":\"CtvQt5R0\",\"user_git-commit-feature.md\":\"IwIx6MMR\",\"user_how-it-works.md\":\"08ZFhWmJ\",\"user_long-term-memory.md\":\"Tss4q2DM\",\"user_packaged-workflows.md\":\"D8DLEuhH\",\"user_tutorial.md\":\"BTP4OqKB\",\"user_workflow-selection.md\":\"G8vSc8iy\",\"workflows.md\":\"B6jknRdS\",\"workflows_adr.md\":\"DQ73iGUh\",\"workflows_big-bang-conversion.md\":\"BgV6R1KI\",\"workflows_boundary-testing.md\":\"RwhcIDcf\",\"workflows_bugfix.md\":\"sZNWPjvx\",\"workflows_business-analysis.md\":\"C3FBbsiu\",\"workflows_c4-analysis.md\":\"MVyWuWSL\",\"workflows_epcc.md\":\"1mWsuIIR\",\"workflows_game-beginner.md\":\"J4UOyAAT\",\"workflows_greenfield.md\":\"DzJ6V7lb\",\"workflows_minor.md\":\"dYZlfSHT\",\"workflows_posts.md\":\"BrkDZjGs\",\"workflows_pr-review.md\":\"CdYxJ5Yu\",\"workflows_qrspi.md\":\"CPYiTyJ8\",\"workflows_sdd-bugfix-crowd.md\":\"BQH-LJXS\",\"workflows_sdd-bugfix.md\":\"CoPY5TS6\",\"workflows_sdd-feature-crowd.md\":\"CCj9xqan\",\"workflows_sdd-feature.md\":\"Dy8SNaX8\",\"workflows_sdd-greenfield-crowd.md\":\"_lPEQnGj\",\"workflows_sdd-greenfield.md\":\"KStU-OJS\",\"workflows_skilled-bugfix.md\":\"CvCekIa2\",\"workflows_skilled-epcc.md\":\"D7Kg_U7p\",\"workflows_skilled-greenfield.md\":\"C_R8GafG\",\"workflows_slides.md\":\"CScRnwcC\",\"workflows_tdd.md\":\"C_hC07yu\",\"workflows_waterfall.md\":\"nMkWHPRt\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Responsible Vibe MCP\",\"description\":\"Model Context Protocol server for intelligent conversation state management and development guidance\",\"base\":\"/workflows/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Documentation\",\"link\":\"/\"},{\"text\":\"Workflows\",\"link\":\"/workflows\"},{\"text\":\"Github\",\"link\":\"https://github.com/codemcp/workflows\"}],\"sidebar\":[{\"text\":\"User Guide\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"How It Works\",\"link\":\"/user/how-it-works\"},{\"text\":\"Agent Setup\",\"link\":\"/user/agent-setup\"},{\"text\":\"Vibe Engineering\",\"link\":\"/user/advanced-engineering\"},{\"text\":\"Long-Term Memory\",\"link\":\"/user/long-term-memory\"},{\"text\":\"Beads-Integration\",\"link\":\"/user/beads-integration\"},{\"text\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Packaged Workflows\",\"link\":\"/user/packaged-workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"dev_architecture.md\":\"CvNKCNdN\",\"dev_development.md\":\"D_3UnLYh\",\"dev_logging.md\":\"ChgMzoxk\",\"dev_publishing.md\":\"9HHCKtL4\",\"index.md\":\"BqtGZhQl\",\"user_advanced-engineering.md\":\"DSy0uwWe\",\"user_agent-setup.md\":\"Cgzr8dYa\",\"user_beads-integration.md\":\"CB1VJJCp\",\"user_capability-routing.md\":\"DbNKvMiS\",\"user_crowd-mcp-integration.md\":\"DPSO9u7p\",\"user_custom-workflows.md\":\"CtvQt5R0\",\"user_git-commit-feature.md\":\"IwIx6MMR\",\"user_how-it-works.md\":\"08ZFhWmJ\",\"user_long-term-memory.md\":\"Tss4q2DM\",\"user_packaged-workflows.md\":\"D8DLEuhH\",\"user_tutorial.md\":\"BTP4OqKB\",\"user_workflow-selection.md\":\"G8vSc8iy\",\"workflows.md\":\"B6jknRdS\",\"workflows_adr.md\":\"DQ73iGUh\",\"workflows_big-bang-conversion.md\":\"BgV6R1KI\",\"workflows_boundary-testing.md\":\"RwhcIDcf\",\"workflows_bugfix.md\":\"sZNWPjvx\",\"workflows_business-analysis.md\":\"C3FBbsiu\",\"workflows_c4-analysis.md\":\"MVyWuWSL\",\"workflows_epcc.md\":\"1mWsuIIR\",\"workflows_game-beginner.md\":\"J4UOyAAT\",\"workflows_greenfield.md\":\"DzJ6V7lb\",\"workflows_minor.md\":\"dYZlfSHT\",\"workflows_posts.md\":\"BrkDZjGs\",\"workflows_pr-review.md\":\"CdYxJ5Yu\",\"workflows_qrspi.md\":\"CPYiTyJ8\",\"workflows_sdd-bugfix-crowd.md\":\"BQH-LJXS\",\"workflows_sdd-bugfix.md\":\"CoPY5TS6\",\"workflows_sdd-feature-crowd.md\":\"CCj9xqan\",\"workflows_sdd-feature.md\":\"Dy8SNaX8\",\"workflows_sdd-greenfield-crowd.md\":\"_lPEQnGj\",\"workflows_sdd-greenfield.md\":\"KStU-OJS\",\"workflows_skilled-bugfix.md\":\"CvCekIa2\",\"workflows_skilled-epcc.md\":\"D7Kg_U7p\",\"workflows_skilled-greenfield.md\":\"C_R8GafG\",\"workflows_slides.md\":\"CScRnwcC\",\"workflows_tdd.md\":\"C_hC07yu\",\"workflows_waterfall.md\":\"nMkWHPRt\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Responsible Vibe MCP\",\"description\":\"Model Context Protocol server for intelligent conversation state management and development guidance\",\"base\":\"/workflows/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"Documentation\",\"link\":\"/\"},{\"text\":\"Workflows\",\"link\":\"/workflows\"},{\"text\":\"Github\",\"link\":\"https://github.com/codemcp/workflows\"}],\"sidebar\":[{\"text\":\"User Guide\",\"items\":[{\"text\":\"Overview\",\"link\":\"/\"},{\"text\":\"How It Works\",\"link\":\"/user/how-it-works\"},{\"text\":\"Agent Setup\",\"link\":\"/user/agent-setup\"},{\"text\":\"Capability Routing\",\"link\":\"/user/capability-routing\"},{\"text\":\"Vibe Engineering\",\"link\":\"/user/advanced-engineering\"},{\"text\":\"Long-Term Memory\",\"link\":\"/user/long-term-memory\"},{\"text\":\"Beads-Integration\",\"link\":\"/user/beads-integration\"},{\"text\":\"Tutorial\",\"link\":\"/user/tutorial\"}]},{\"text\":\"Workflows\",\"items\":[{\"text\":\"Workflow-Selection\",\"link\":\"/user/workflow-selection\"},{\"text\":\"Packaged Workflows\",\"link\":\"/user/packaged-workflows\"},{\"text\":\"Custom Workflows\",\"link\":\"/user/custom-workflows\"},{\"text\":\"Explore All Workflows\",\"link\":\"/workflows\"},{\"text\":\"Crowd MCP Integration\",\"link\":\"/user/crowd-mcp-integration\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
     
   </body>
 </html>

package/packages/docs/.vitepress/dist/assets/user_capability-routing.md.DbNKvMiS.js

@@ -0,0 +1,15 @@
+import{_ as a,c as e,o as s,a0 as t}from"./chunks/framework.FdfEk_gD.js";const k=JSON.parse('{"title":"Capability Routing","description":"","frontmatter":{},"headers":[],"relativePath":"user/capability-routing.md","filePath":"user/capability-routing.md"}'),n={name:"user/capability-routing.md"};function l(o,i,h,d,p,c){return s(),e("div",null,[...i[0]||(i[0]=[t(`<h1 id="capability-routing" tabindex="-1">Capability Routing <a class="header-anchor" href="#capability-routing" aria-label="Permalink to &quot;Capability Routing&quot;">​</a></h1><p>Workflow phases can declare a <code>required_capability</code> to guide the LLM in choosing an appropriate subagent and/or model for that phase. You wire up the capability→model/agent mapping in <code>.vibe/config.yaml</code> — either by hand, or in one command via the <code>setup capabilities</code> CLI wizard.</p><p>The feature is fully opt-in. Phases that don&#39;t declare <code>required_capability</code> behave exactly as before, and a project with no <code>capability_models</code> config still gets label-only hints for any annotated phase.</p><h2 id="what-you-get" tabindex="-1">What you get <a class="header-anchor" href="#what-you-get" aria-label="Permalink to &quot;What you get&quot;">​</a></h2><p>When a phase declares <code>required_capability: thinking</code> and you have mapped it to a model in <code>.vibe/config.yaml</code>, the LLM sees an instruction like:</p><blockquote><p>Capability hint: This phase requires thinking capability (deep reasoning, complex planning). When launching subagents, use agent: thinking (model: anthropic/claude-opus-4-7).</p></blockquote><p>With no <code>capability_models</code> config, the hint reduces to:</p><blockquote><p>Capability hint: This phase requires thinking capability (deep reasoning, complex planning).</p></blockquote><p>Built-in descriptions ship for <code>thinking</code> and <code>research</code>. <code>coding</code> is self-evident (no description); any other term is echoed verbatim.</p><h2 id="declaring-capabilities-in-a-workflow" tabindex="-1">Declaring capabilities in a workflow <a class="header-anchor" href="#declaring-capabilities-in-a-workflow" aria-label="Permalink to &quot;Declaring capabilities in a workflow&quot;">​</a></h2><p>Add <code>required_capability</code> to a phase in your workflow YAML:</p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">phases</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">Architecture</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    required_capability</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">thinking</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  - </span><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">name</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">Code</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    required_capability</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">coding</span></span></code></pre></div><p>Conventional values are <code>thinking</code>, <code>research</code>, <code>coding</code>, and <code>default</code>. Any other term works too.</p><h2 id="configuring-capabilities" tabindex="-1">Configuring capabilities <a class="header-anchor" href="#configuring-capabilities" aria-label="Permalink to &quot;Configuring capabilities&quot;">​</a></h2><p>Add a <code>capability_models</code> map to <code>.vibe/config.yaml</code>:</p><div class="language-yaml vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">yaml</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">capability_models</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">  thinking</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    model</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">anthropic/claude-opus-4-7</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    agent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">thinking</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">  coding</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    model</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">anthropic/claude-sonnet-4-5</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">  research</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span></span>
+<span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">    model</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">anthropic/claude-haiku-4-5</span></span></code></pre></div><p>Each entry has two optional fields:</p><ul><li><code>model</code> — model identifier used in the hint.</li><li><code>agent</code> — subagent name the LLM should use when launching subagents.</li></ul><p>Either, neither, or both may be set per capability. Capabilities with no entry are not mentioned in the hint beyond the label.</p><h2 id="setting-up-automatically" tabindex="-1">Setting up automatically <a class="header-anchor" href="#setting-up-automatically" aria-label="Permalink to &quot;Setting up automatically&quot;">​</a></h2><p><code>npx @codemcp/workflows setup capabilities &lt;target&gt;</code> generates both the per-target agent files and the matching <code>capability_models</code> entries in <code>.vibe/config.yaml</code> in a single command.</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npx</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> @codemcp/workflows</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> capabilities</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> opencode</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> \\</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  --model-thinking</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> anthropic/claude-opus-4-7</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> \\</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  --model-coding</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> anthropic/claude-sonnet-4-5</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> \\</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  --model-research</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> anthropic/claude-haiku-4-5</span></span></code></pre></div><p>For OpenCode, the command writes <code>.opencode/agents/&lt;capability&gt;.md</code> for each provided capability (with <code>mode: subagent</code> and the chosen <code>model:</code>) and merges the matching entries into <code>.vibe/config.yaml</code>.</p><h3 id="flags" tabindex="-1">Flags <a class="header-anchor" href="#flags" aria-label="Permalink to &quot;Flags&quot;">​</a></h3><ul><li><code>--model-thinking &lt;model&gt;</code> — set the model for the thinking agent</li><li><code>--model-coding &lt;model&gt;</code> — set the model for the coding agent</li><li><code>--model-research &lt;model&gt;</code> — set the model for the research agent</li><li><code>--force</code> — overwrite existing per-target agent files (default: skip if they exist)</li><li><code>--help</code>, <code>-h</code> — show help, including the full target list</li></ul><h3 id="targets" tabindex="-1">Targets <a class="header-anchor" href="#targets" aria-label="Permalink to &quot;Targets&quot;">​</a></h3><p>Only <code>opencode</code> is currently implemented. The wizard also knows about <code>kiro</code>, <code>claude</code>, <code>gemini</code>, <code>vscode</code>, and <code>github-copilot</code>; they are listed in <code>setup capabilities --help</code> with a ⏳ status and throw a clear &quot;not yet supported&quot; error if you invoke them. Adding a new target is a single class — see the <a href="https://github.com/codemcp/workflows/tree/main/packages/cli/src/capability-generator.ts" target="_blank" rel="noreferrer">CLI source</a> for the registry.</p><h2 id="annotations-in-built-in-workflows" tabindex="-1">Annotations in built-in workflows <a class="header-anchor" href="#annotations-in-built-in-workflows" aria-label="Permalink to &quot;Annotations in built-in workflows&quot;">​</a></h2><p>The seven built-in workflows ship with phase annotations out of the box:</p><ul><li><code>qrspi</code>, <code>epcc</code>, <code>greenfield</code>, <code>waterfall</code>, <code>bugfix</code>, <code>tdd</code>, <code>pr-review</code> — 23 annotated phases total</li></ul><p>You don&#39;t need to do anything to get the label-only hints; just run any built-in workflow and the annotations are picked up automatically.</p><h2 id="see-also" tabindex="-1">See also <a class="header-anchor" href="#see-also" aria-label="Permalink to &quot;See also&quot;">​</a></h2><ul><li><a href="./agent-setup.html">Agent Setup</a> — get the workflow system running in your IDE/CLI</li><li><a href="./custom-workflows.html">Custom Workflows</a> — write your own workflow YAMLs</li><li><a href="./tutorial.html">Tutorial</a> — hands-on walkthrough</li></ul>`,33)])])}const g=a(n,[["render",l]]);export{k as __pageData,g as default};

package/packages/docs/.vitepress/dist/assets/user_capability-routing.md.DbNKvMiS.lean.js

@@ -0,0 +1 @@
+import{_ as a,c as e,o as s,a0 as t}from"./chunks/framework.FdfEk_gD.js";const k=JSON.parse('{"title":"Capability Routing","description":"","frontmatter":{},"headers":[],"relativePath":"user/capability-routing.md","filePath":"user/capability-routing.md"}'),n={name:"user/capability-routing.md"};function l(o,i,h,d,p,c){return s(),e("div",null,[...i[0]||(i[0]=[t("",33)])])}const g=a(n,[["render",l]]);export{k as __pageData,g as default};