@hyperdrive.bot/bmad-workflow 1.0.23 → 1.0.25

package/README.md

@@ -78,13 +78,22 @@ The BMAD Workflow CLI provides **five core capabilities** for AI-assisted develo
 
 ---
 
+## Channel Transport
+
+Channel transport is an opt-in alternative to subprocess-based agent execution. When enabled via `--use-channels`, the pipeline discovers running Claude Code sessions with Channel support and dispatches task envelopes to them over HTTP. This preserves agent context across multiple invocations (no cold-start overhead) and enables persistent, long-lived agent sessions that accumulate project knowledge throughout a pipeline run. Channel agents must be pre-started before the pipeline runs — the orchestrator does not auto-start them.
+
+[Full documentation](docs/CHANNEL-INTEGRATION.md)
+
+---
+
 ## Installation
 
 ### Prerequisites
 
 - **Node.js 20+** - [Download](https://nodejs.org/)
 - **Claude CLI** - [Install](https://docs.anthropic.com/claude/docs/claude-cli) and run `claude auth login`
-- **BMAD Method** - [Set up in your project](https://github.com/bmad-code-org/BMAD-METHOD#quick-start)
+
+> **No BMAD setup required.** The CLI ships with bundled agents, templates, and config. Just `init` and go — it works self-contained in any empty project directory with only a PRD file.
 
 ### Install
 
@@ -103,6 +112,19 @@ bmad-workflow --help
 
 ## Quick Start
 
+### Zero to Code in 2 Commands
+
+The CLI works fully self-contained — no BMAD repo setup, no `_bmad/` directory, no config files. Just a PRD file:
+
+```bash
+mkdir my-project && cd my-project && git init
+bmad-workflow workflow PRD-my-feature.md
+```
+
+That's it. Bundled agents, templates, and defaults kick in automatically. Output directories are created on the fly.
+
+This was validated with an isolation test: empty git repo + single PRD file → 3 epics, 9 stories, full working React app with tests — zero external dependencies.
+
 ### 1. Full Pipeline (PRD → Code)
 
 ```bash

package/dist/services/file-system/path-resolver.d.ts

@@ -210,5 +210,6 @@ export declare class PathResolver {
      * @param name - Human-readable directory name for error messages
      * @throws {FileSystemError} If directory does not exist
      */
+    private ensureDirectorySync;
     private validateDirectorySync;
 }

package/dist/services/file-system/path-resolver.js

@@ -249,11 +249,11 @@ export class PathResolver {
         const doneStoryDir = resolve(this.projectRoot, 'docs/done/stories');
         // Resolve PRD file
         const prdFile = resolve(this.projectRoot, config.prd?.prdFile || 'docs/prd.md');
-        // Validate directories exist
-        this.validateDirectorySync(storyDir, 'story directory');
-        this.validateDirectorySync(epicDir, 'epic directory');
-        this.validateDirectorySync(qaStoryDir, 'QA story directory');
-        // Note: doneStoryDir is optional, don't validate it
+        // Ensure output directories exist (auto-create for self-contained usage)
+        this.ensureDirectorySync(storyDir, 'story directory');
+        this.ensureDirectorySync(epicDir, 'epic directory');
+        this.ensureDirectorySync(qaStoryDir, 'QA story directory');
+        // Note: doneStoryDir is optional, don't create it eagerly
         // Stories may not have been moved to done yet
         this.cachedPaths = {
             doneStoryDir,
@@ -399,6 +399,13 @@ export class PathResolver {
      * @param name - Human-readable directory name for error messages
      * @throws {FileSystemError} If directory does not exist
      */
+    ensureDirectorySync(dirPath, name) {
+        this.logger.debug('Ensuring directory exists: %s (%s)', dirPath, name);
+        if (!fs.existsSync(dirPath)) {
+            this.logger.info('Auto-creating %s: %s', name, dirPath);
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+    }
     validateDirectorySync(dirPath, name) {
         this.logger.debug('Validating directory: %s (%s)', dirPath, name);
         try {

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.23",
+  "version": "1.0.25",
   "author": {
     "name": "DevSquad",
     "email": "marcelo@devsquad.email",