@hyperdrive.bot/bmad-workflow 1.0.20 → 1.0.22

package/dist/commands/workflow.d.ts

@@ -27,6 +27,7 @@ export default class Workflow extends Command {
         'auto-fix': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'dev-agent': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'sm-agent': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'epic-interval': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         parallel: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/workflow.js

@@ -60,6 +60,9 @@ export default class Workflow extends Command {
         'dev-agent': Flags.string({
             description: 'Absolute path to a custom dev agent file (default: .bmad-core/agents/dev.md)',
         }),
+        'sm-agent': Flags.string({
+            description: 'Absolute path to a custom SM (scrum master) agent file (default: .bmad-core/agents/sm.md)',
+        }),
         'dry-run': Flags.boolean({
             default: false,
             description: 'Preview actions without execution',
@@ -281,6 +284,7 @@ export default class Workflow extends Command {
                 reviewScanners: flags['review-scanners'],
                 reviewTimeout: flags['review-timeout'],
                 skipDev: flags['skip-dev'],
+                smAgent: flags['sm-agent'],
                 skipEpics: flags['skip-epics'],
                 skipStories: flags['skip-stories'],
                 storyInterval: flags['story-interval'],

package/dist/models/workflow-config.d.ts

@@ -23,6 +23,14 @@ export interface WorkflowConfig {
      * @example '/Users/marcelo/Developer/ds/super-repo/_bmad/bmm/agents/ibra.md'
      */
     devAgent?: string;
+    /**
+     * Absolute path to a custom SM (scrum master) agent file
+     *
+     * When specified, this file is used instead of the default `.bmad-core/agents/sm.md`
+     * in epic and story phase prompts.
+     * @example '/Users/marcelo/Developer/ds/super-repo/_bmad/bmm/agents/sm-custom.md'
+     */
+    smAgent?: string;
     /**
      * Working directory for agent execution
      *

package/dist/services/orchestration/workflow-orchestrator.d.ts

@@ -118,6 +118,8 @@ export interface EpicPromptOptions {
     prefix: string;
     /** Reference file paths */
     references: string[];
+    /** Absolute path to a custom SM agent file (optional) */
+    smAgent?: string;
 }
 /**
  * Options for building a story creation prompt
@@ -133,6 +135,8 @@ export interface StoryPromptOptions {
     prefix: string;
     /** Reference file paths */
     references: string[];
+    /** Absolute path to a custom SM agent file (optional) */
+    smAgent?: string;
 }
 /**
  * WorkflowOrchestrator service for coordinating multi-phase workflows
@@ -726,6 +730,13 @@ export declare class WorkflowOrchestrator {
      * @private
      */
     private sleep;
+    /**
+     * Parse the `### Dev Context` section from a story file's content.
+     *
+     * Returns sidecar reference paths and an optional deploy target string.
+     * If the section is missing or empty, returns empty arrays / undefined (backward compatible).
+     */
+    private parseDevContext;
     /**
      * Update story status in file
      *

package/dist/services/orchestration/workflow-orchestrator.js

@@ -170,10 +170,11 @@ export class WorkflowOrchestrator {
      * @private
      */
     buildEpicPrompt(epic, options) {
-        const { cwd, outputPath, prdPath, references } = options;
+        const { cwd, outputPath, prdPath, references, smAgent } = options;
         const referencesText = references.length > 0 ? `\nReferences: ${references.join(', ')}` : '';
         const cwdText = cwd ? `\n\nWorking directory: ${cwd}` : '';
-        return `@.bmad-core/agents/sm.md${cwdText}
+        const agentRef = smAgent ? `@${smAgent}` : `@.bmad-core/agents/sm.md`;
+        return `${agentRef}${cwdText}
 
 Create epic '${epic.number}: ${epic.title}' for PRD '${prdPath}'.${referencesText}.
 
@@ -216,10 +217,11 @@ Write output to: '${outputPath}'`;
      * @private
      */
     buildStoryPrompt(story, options) {
-        const { cwd, epicPath, outputPath, references } = options;
+        const { cwd, epicPath, outputPath, references, smAgent } = options;
         const referencesText = references.length > 0 ? `\nReferences: ${references.join(', ')}` : '';
         const cwdText = cwd ? `\n\nWorking directory: ${cwd}` : '';
-        return `@.bmad-core/agents/sm.md${cwdText}
+        const agentRef = smAgent ? `@${smAgent}` : `@.bmad-core/agents/sm.md`;
+        return `${agentRef}${cwdText}
 
 Create story '${story.fullNumber}: ${story.title}' for epic '${epicPath}'. ${referencesText}
 
@@ -630,8 +632,10 @@ Write output to: ${outputPath}`;
                         prompt += `Working directory: ${config.cwd}\n\n`;
                     }
                     prompt += `*develop-story ${storyFilePath}\n\n`;
-                    // Combine auto-detected references with user-provided references
-                    const allReferences = [...autoReferences, ...(config.references || [])];
+                    // Parse Dev Context section for sidecars and deploy target
+                    const devContext = this.parseDevContext(storyContent);
+                    // Combine auto-detected references with user-provided references and sidecars
+                    const allReferences = [...autoReferences, ...(config.references || []), ...devContext.sidecarRefs];
                     if (allReferences.length > 0) {
                         prompt += 'References:\n';
                         for (const ref of allReferences) {
@@ -639,6 +643,10 @@ Write output to: ${outputPath}`;
                         }
                         prompt += '\n';
                     }
+                    // Add deploy target context if specified in story
+                    if (devContext.deployTarget) {
+                        prompt += `Deploy target: ${devContext.deployTarget}\n\n`;
+                    }
                     prompt += '*yolo mode*\n';
                     // Generate unique spawn ID
                     const spawnId = `dev-${story.fullNumber}-${storyStartTime}`;
@@ -905,8 +913,10 @@ Write output to: ${outputPath}`;
                     prompt += `Working directory: ${config.cwd}\n\n`;
                 }
                 prompt += `Implement story: ${storyFilePath}\n\n`;
-                // Combine auto-detected references with user-provided references
-                const allReferences = [...autoReferences, ...(config.references || [])];
+                // Parse Dev Context section for sidecars and deploy target
+                const devContext = this.parseDevContext(storyContent);
+                // Combine auto-detected references with user-provided references and sidecars
+                const allReferences = [...autoReferences, ...(config.references || []), ...devContext.sidecarRefs];
                 if (allReferences.length > 0) {
                     prompt += 'References:\n';
                     for (const ref of allReferences) {
@@ -914,6 +924,10 @@ Write output to: ${outputPath}`;
                     }
                     prompt += '\n';
                 }
+                // Add deploy target context if specified in story
+                if (devContext.deployTarget) {
+                    prompt += `Deploy target: ${devContext.deployTarget}\n\n`;
+                }
                 prompt += '*yolo mode*\n';
                 // Generate unique spawn ID and timestamp
                 const spawnStartTime = Date.now();
@@ -1241,6 +1255,7 @@ Write output to: ${outputPath}`;
                         prdPath: prdFilePath,
                         prefix,
                         references: config.references,
+                        smAgent: config.smAgent,
                     });
                     const prompt = mcpPrefix ? `${mcpPrefix}\n\n${basePrompt}` : basePrompt;
                     // Log prompt if verbose
@@ -2232,6 +2247,7 @@ Write output to: ${outputPath}`;
                         outputPath: storyFilePath,
                         prefix,
                         references: config.references,
+                        smAgent: config.smAgent,
                     });
                     const prompt = mcpPrefix ? `${mcpPrefix}\n\n${basePrompt}` : basePrompt;
                     // Log prompt if verbose
@@ -2556,6 +2572,7 @@ Write output to: ${outputPath}`;
                         outputPath: storyFilePath,
                         prefix,
                         references: config.references,
+                        smAgent: config.smAgent,
                     });
                     const prompt = mcpPrefix ? `${mcpPrefix}\n\n${basePrompt}` : basePrompt;
                     // Log prompt if verbose
@@ -3080,6 +3097,49 @@ Write output to: ${outputPath}`;
     async sleep(ms) {
         await new Promise((resolve) => setTimeout(resolve, ms));
     }
+    /**
+     * Parse the `### Dev Context` section from a story file's content.
+     *
+     * Returns sidecar reference paths and an optional deploy target string.
+     * If the section is missing or empty, returns empty arrays / undefined (backward compatible).
+     */
+    parseDevContext(storyContent) {
+        const sidecarRefs = [];
+        let deployTarget;
+        // Find the ### Dev Context section
+        const devCtxMatch = storyContent.match(/^### Dev Context\s*$/m);
+        if (!devCtxMatch || devCtxMatch.index === undefined) {
+            return { deployTarget, sidecarRefs };
+        }
+        // Extract section content up to the next heading or end of file
+        const sectionStart = devCtxMatch.index + devCtxMatch[0].length;
+        const nextHeadingMatch = storyContent.slice(sectionStart).match(/^#{1,3} /m);
+        const sectionEnd = nextHeadingMatch?.index !== undefined ? sectionStart + nextHeadingMatch.index : storyContent.length;
+        const sectionContent = storyContent.slice(sectionStart, sectionEnd);
+        // Parse Sidecars line — supports "- **Sidecars:**" or "- Sidecars:" (flexible)
+        const sidecarsMatch = sectionContent.match(/^-\s+\*{0,2}Sidecars:?\*{0,2}\s*(.+)$/im);
+        if (sidecarsMatch?.[1]) {
+            const raw = sidecarsMatch[1].trim();
+            for (const part of raw.split(',')) {
+                const name = part.trim();
+                if (name.length === 0)
+                    continue;
+                // If already a path, use as-is; otherwise prefix with _bmad/bmm/agents/
+                if (name.includes('/')) {
+                    sidecarRefs.push(name);
+                }
+                else {
+                    sidecarRefs.push(`_bmad/bmm/agents/${name}`);
+                }
+            }
+        }
+        // Parse Deploy target line
+        const deployMatch = sectionContent.match(/^-\s+\*{0,2}Deploy target:?\*{0,2}\s*(.+)$/im);
+        if (deployMatch?.[1]) {
+            deployTarget = deployMatch[1].trim();
+        }
+        return { deployTarget, sidecarRefs };
+    }
     /**
      * Update story status in file
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hyperdrive.bot/bmad-workflow",
   "description": "AI-driven development workflow orchestration CLI for BMAD projects",
-  "version": "1.0.20",
+  "version": "1.0.22",
   "author": {
     "name": "DevSquad",
     "email": "marcelo@devsquad.email",