bmad-method 6.0.0-alpha.1 → 6.0.0-alpha.3

package/src/modules/cis/README.md

@@ -0,0 +1,153 @@
+# CIS - Creative Intelligence Suite
+
+AI-powered creative facilitation transforming strategic thinking through expert coaching across five specialized domains.
+
+## Table of Contents
+
+- [Core Capabilities](#core-capabilities)
+- [Specialized Agents](#specialized-agents)
+- [Interactive Workflows](#interactive-workflows)
+- [Quick Start](#quick-start)
+- [Key Differentiators](#key-differentiators)
+- [Configuration](#configuration)
+
+## Core Capabilities
+
+CIS provides structured creative methodologies through distinctive agent personas who act as master facilitators, drawing out insights through strategic questioning rather than generating solutions directly.
+
+## Specialized Agents
+
+[View detailed agent descriptions →](./agents/README.md)
+
+- **Carson** - Brainstorming Specialist (energetic facilitator)
+- **Maya** - Design Thinking Maestro (jazz-like improviser)
+- **Dr. Quinn** - Problem Solver (detective-scientist hybrid)
+- **Victor** - Innovation Oracle (bold strategic precision)
+- **Sophia** - Master Storyteller (whimsical narrator)
+
+## Interactive Workflows
+
+[View all workflows →](./workflows/README.md)
+
+**5 Workflows** with **150+ Creative Techniques:**
+
+### Brainstorming
+
+36 techniques across 7 categories for ideation
+
+- Divergent/convergent thinking
+- Lateral connections
+- Forced associations
+
+### Design Thinking
+
+Complete 5-phase human-centered process
+
+- Empathize → Define → Ideate → Prototype → Test
+- User journey mapping
+- Rapid iteration
+
+### Problem Solving
+
+Systematic root cause analysis
+
+- 5 Whys, Fishbone diagrams
+- Solution generation
+- Impact assessment
+
+### Innovation Strategy
+
+Business model disruption
+
+- Blue Ocean Strategy
+- Jobs-to-be-Done
+- Disruptive innovation patterns
+
+### Storytelling
+
+25 narrative frameworks
+
+- Hero's Journey
+- Story circles
+- Compelling pitch structures
+
+## Quick Start
+
+### Direct Workflow
+
+```bash
+# Start interactive session
+workflow brainstorming
+
+# With context document
+workflow design-thinking --data /path/to/context.md
+```
+
+### Agent-Facilitated
+
+```bash
+# Load agent
+agent cis/brainstorming-coach
+
+# Start workflow
+> *brainstorm
+```
+
+## Key Differentiators
+
+- **Facilitation Over Generation** - Guides discovery through questions
+- **Energy-Aware Sessions** - Adapts to engagement levels
+- **Context Integration** - Domain-specific guidance support
+- **Persona-Driven** - Unique communication styles
+- **Rich Method Libraries** - 150+ proven techniques
+
+## Configuration
+
+Edit `/bmad/cis/config.yaml`:
+
+```yaml
+output_folder: ./creative-outputs
+user_name: Your Name
+communication_language: english
+```
+
+## Module Structure
+
+```
+cis/
+├── agents/              # 5 specialized facilitators
+├── workflows/           # 5 interactive processes
+│   ├── brainstorming/
+│   ├── design-thinking/
+│   ├── innovation-strategy/
+│   ├── problem-solving/
+│   └── storytelling/
+├── tasks/              # Supporting operations
+└── teams/              # Agent collaborations
+```
+
+## Integration Points
+
+CIS workflows integrate with:
+
+- **BMM** - Powers project brainstorming
+- **BMB** - Creative module design
+- **Custom Modules** - Shared creative resource
+
+## Best Practices
+
+1. **Set clear objectives** before starting sessions
+2. **Provide context documents** for domain relevance
+3. **Trust the process** - Let facilitation guide you
+4. **Take breaks** when energy flags
+5. **Document insights** as they emerge
+
+## Related Documentation
+
+- **[Workflow Guide](./workflows/README.md)** - Detailed workflow instructions
+- **[Agent Personas](./agents/README.md)** - Full agent descriptions
+- **[BMM Integration](../bmm/README.md)** - Development workflow connection
+
+---
+
+Part of BMad Method v6.0 - Transform creative potential through expert AI facilitation.

package/src/modules/cis/workflows/README.md

@@ -1,67 +1,139 @@
----
-last-redoc-date: 2025-09-28
----
-
 # CIS Workflows
 
-The Creative Intelligence System includes five interactive workflows that facilitate different creative and strategic processes. Each workflow uses curated technique libraries and structured facilitation to guide users through proven methodologies.
+Five interactive workflows facilitating creative and strategic processes through curated technique libraries and structured facilitation.
+
+## Table of Contents
+
+- [Workflow Overview](#workflow-overview)
+- [Common Features](#common-features)
+- [Usage](#usage)
+- [Configuration](#configuration)
 
-## Available Workflows
+## Workflow Overview
 
 ### [Brainstorming](./brainstorming)
 
-Facilitates interactive ideation sessions using 36 creative techniques across 7 categories. AI acts as master facilitator using "Yes, and..." methodology. Supports user-selected, AI-recommended, random, or progressive technique flows.
+**Purpose:** Interactive ideation using 36 techniques across 7 categories
 
-**Key Feature:** Comprehensive technique library spanning collaborative, structured, creative, deep, theatrical, wild, and introspective approaches.
+**Approach:** Master facilitation with "Yes, and..." methodology
+
+**Techniques:** Collaborative, structured, creative, deep, theatrical, wild, introspective
+
+**Selection Modes:** User-selected, AI-recommended, random, or progressive
 
 ### [Design Thinking](./design-thinking)
 
-Guides human-centered design through the complete five-phase methodology: Empathize, Define, Ideate, Prototype, and Test. Emphasizes divergent thinking before convergent action with rapid prototyping focus.
+**Purpose:** Human-centered design through five phases
+
+**Process:** Empathize → Define → Ideate → Prototype → Test
+
+**Focus:** Divergent thinking before convergent action
 
-**Key Feature:** Phase-specific method library and systematic user empathy development.
+**Output:** User empathy insights and rapid prototypes
 
 ### [Innovation Strategy](./innovation-strategy)
 
-Identifies disruption opportunities and architects business model innovation. Analyzes markets, competitive dynamics, and value chains using frameworks like Jobs-to-be-Done and Blue Ocean Strategy.
+**Purpose:** Identify disruption opportunities and business model innovation
 
-**Key Feature:** Strategic focus on sustainable competitive advantage over feature innovation.
+**Frameworks:** Jobs-to-be-Done, Blue Ocean Strategy, Value Chain Analysis
+
+**Focus:** Sustainable competitive advantage over features
+
+**Output:** Strategic innovation roadmap
 
 ### [Problem Solving](./problem-solving)
 
-Applies systematic problem-solving methodologies combining TRIZ, Theory of Constraints, Systems Thinking, and Root Cause Analysis. Detective approach treats challenges as elegant puzzles.
+**Purpose:** Systematic challenge resolution
+
+**Methods:** TRIZ, Theory of Constraints, Systems Thinking, Root Cause Analysis
 
-**Key Feature:** Relentless root cause focus using framework-driven analysis.
+**Approach:** Detective-style puzzle solving
+
+**Output:** Root cause identification and solution strategies
 
 ### [Storytelling](./storytelling)
 
-Crafts compelling narratives using proven story frameworks (Hero's Journey, Three-Act Structure, Story Brand). Tailors emotional psychology and structure to platform and audience.
+**Purpose:** Craft compelling narratives
+
+**Frameworks:** Hero's Journey, Three-Act Structure, Story Brand (25 total)
 
-**Key Feature:** Whimsical facilitation style that embodies master storytelling craft.
+**Customization:** Platform and audience-specific adaptation
 
-## Common Patterns
+**Style:** Whimsical master storyteller facilitation
 
-All CIS workflows share these characteristics:
+## Common Features
 
-- **Interactive Facilitation**: AI guides rather than generates, asking questions to draw out user insights
-- **Technique Libraries**: CSV databases of methods, frameworks, and approaches
-- **Context Awareness**: Accept optional context documents via data attribute
-- **Structured Output**: Comprehensive reports capturing insights, decisions, and action plans
-- **Energy Monitoring**: Check-ins throughout to adapt pace and approach
+All workflows share:
+
+- **Interactive Facilitation** - AI guides through questions, not generation
+- **Technique Libraries** - CSV databases of proven methods
+- **Context Integration** - Optional document input for domain relevance
+- **Structured Output** - Comprehensive reports with insights and actions
+- **Energy Monitoring** - Adaptive pacing based on engagement
 
 ## Usage
 
+### Basic Invocation
+
 ```bash
-# Basic invocation
-workflow [workflow-name]
+workflow brainstorming
+workflow design-thinking
+workflow innovation-strategy
+workflow problem-solving
+workflow storytelling
+```
+
+### With Context
 
-# With context document
+```bash
 workflow [workflow-name] --data /path/to/context.md
 ```
 
+### Via Agent
+
+```bash
+agent cis/brainstorming-coach
+> *brainstorm
+```
+
 ## Configuration
 
-All workflows reference `/bmad/cis/config.yaml` for:
+Edit `/bmad/cis/config.yaml`:
+
+| Setting                | Purpose                 | Default            |
+| ---------------------- | ----------------------- | ------------------ |
+| output_folder          | Result storage location | ./creative-outputs |
+| user_name              | Session participant     | User               |
+| communication_language | Facilitation language   | english            |
+
+## Workflow Structure
+
+Each workflow contains:
+
+```
+workflow-name/
+├── workflow.yaml      # Configuration
+├── instructions.md    # Facilitation guide
+├── techniques.csv     # Method library
+└── README.md         # Documentation
+```
+
+## Best Practices
+
+1. **Prepare context** - Provide background documents for better results
+2. **Set clear objectives** - Define goals before starting
+3. **Trust the process** - Let facilitation guide discovery
+4. **Capture everything** - Document insights as they emerge
+5. **Take breaks** - Pause when energy drops
+
+## Integration
+
+CIS workflows integrate with:
+
+- **BMM** - Project brainstorming and ideation
+- **BMB** - Creative module design
+- **Custom Modules** - Shared creative resource
+
+---
 
-- `output_folder` - Where workflow results are saved
-- `user_name` - Session participant identification
-- `communication_language` - Facilitation language preference
+For detailed workflow instructions, see individual workflow directories.

package/src/modules/cis/workflows/storytelling/instructions.md

@@ -50,9 +50,17 @@ I can help craft your story using these proven narrative frameworks:
 3. **Customer Journey Story** - Before/after transformation narrative
 4. **Challenge-Overcome Arc** - Dramatic obstacle-to-victory structure
 
-**Strategic Narratives:** 5. **Brand Story** - Values, mission, and unique positioning 6. **Pitch Narrative** - Persuasive problem-to-solution structure 7. **Vision Narrative** - Future-focused aspirational story 8. **Origin Story** - Foundational narrative of how it began
+**Strategic Narratives:**
 
-**Specialized Narratives:** 9. **Data Storytelling** - Transform insights into compelling narrative 10. **Emotional Hooks** - Craft powerful opening and touchpoints
+5. **Brand Story** - Values, mission, and unique positioning
+6. **Pitch Narrative** - Persuasive problem-to-solution structure
+7. **Vision Narrative** - Future-focused aspirational story
+8. **Origin Story** - Foundational narrative of how it began
+
+**Specialized Narratives:**
+
+9. **Data Storytelling** - Transform insights into compelling narrative
+10. **Emotional Hooks** - Craft powerful opening and touchpoints
 
 Which framework best fits your purpose? (Enter 1-10, or ask for my recommendation)
 </ask>

package/tools/bmad-npx-wrapper.js

@@ -3,7 +3,6 @@
 /**
  * BMad Method CLI - Direct execution wrapper for npx
  * This file ensures proper execution when run via npx from GitHub or npm registry
- * Supports version selection between stable (v4) and beta (v6)
  */
 
 const { execSync } = require('node:child_process');
@@ -13,114 +12,27 @@ const fs = require('node:fs');
 // Check if we're running in an npx temporary directory
 const isNpxExecution = __dirname.includes('_npx') || __dirname.includes('.npm');
 
-async function promptVersionSelection() {
-  const inquirer = require('inquirer');
-  const chalk = require('chalk');
-
-  console.log(
-    chalk.cyan(`
-    ██████╗ ███╗   ███╗ █████╗ ██████╗ ™
-    ██╔══██╗████╗ ████║██╔══██╗██╔══██╗
-    ██████╔╝██╔████╔██║███████║██║  ██║
-    ██╔══██╗██║╚██╔╝██║██╔══██║██║  ██║
-    ██████╔╝██║ ╚═╝ ██║██║  ██║██████╔╝
-    ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝
-  `),
-  );
-
-  console.log(chalk.dim('    Build More, Architect Dreams\n'));
-
-  const answers = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'version',
-      message: 'Which version would you like to install?',
-      choices: [
-        {
-          name: chalk.green('Stable (v4.x) - Production Ready'),
-          value: 'stable',
-          short: 'Stable v4.x',
-        },
-        {
-          name: chalk.yellow('Beta (v6.0.0-beta) - Latest Features (Early Access)'),
-          value: 'beta',
-          short: 'Beta v6.0.0-beta',
-        },
-      ],
-      default: 'stable',
-    },
-  ]);
-
-  return answers.version;
-}
-
-async function installStableVersion(args) {
-  const chalk = require('chalk');
-
-  console.log(chalk.cyan('\n📦 Installing BMad Method v4 (Stable)...\n'));
-
-  // Use npx to install the stable version from npm registry
-  // The @4 tag will fetch the latest v4.x.x version
-  const npxCommand = `npx bmad-method@4 ${args.join(' ')}`;
-
-  try {
-    execSync(npxCommand, {
-      stdio: 'inherit',
-      cwd: process.cwd(),
-    });
-  } catch (error) {
-    console.error(chalk.red('Failed to install stable version'));
-    process.exit(error.status || 1);
-  }
-}
-
-async function installBetaVersion(args) {
-  const chalk = require('chalk');
-
-  console.log(chalk.yellow('\n📦 Installing BMad Method v6 Beta (Early Access)...\n'));
-
-  // Use the v6 installer from the current installation
+if (isNpxExecution) {
+  // Running via npx - spawn child process to preserve user's working directory
+  const args = process.argv.slice(2);
   const bmadCliPath = path.join(__dirname, 'cli', 'bmad-cli.js');
 
   if (!fs.existsSync(bmadCliPath)) {
-    console.error(chalk.red('Error: Could not find bmad-cli.js at'), bmadCliPath);
-    console.error(chalk.dim('Current directory:'), __dirname);
+    console.error('Error: Could not find bmad-cli.js at', bmadCliPath);
+    console.error('Current directory:', __dirname);
     process.exit(1);
   }
 
   try {
+    // Execute CLI from user's working directory (process.cwd()), not npm cache
     execSync(`node "${bmadCliPath}" ${args.join(' ')}`, {
       stdio: 'inherit',
-      cwd: path.dirname(__dirname),
+      cwd: process.cwd(), // This preserves the user's working directory
     });
   } catch (error) {
     process.exit(error.status || 1);
   }
+} else {
+  // Local execution - use require
+  require('./cli/bmad-cli.js');
 }
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  // Check if user wants to skip version prompt
-  const skipPrompt = args.includes('--skip-version-prompt');
-  const filteredArgs = args.filter((arg) => arg !== '--skip-version-prompt');
-
-  if (isNpxExecution && !skipPrompt) {
-    // Running via npx - prompt for version selection unless skipped
-    const selectedVersion = await promptVersionSelection();
-
-    if (selectedVersion === 'stable') {
-      await installStableVersion(filteredArgs);
-    } else {
-      await installBetaVersion(filteredArgs);
-    }
-  } else {
-    // Local execution or skipped prompt - use the v6 installer directly
-    require('./cli/bmad-cli.js');
-  }
-}
-
-main().catch((error) => {
-  console.error('Unexpected error:', error);
-  process.exit(1);
-});

package/tools/cli/installers/lib/core/manifest-generator.js

@@ -4,6 +4,9 @@ const yaml = require('js-yaml');
 const crypto = require('node:crypto');
 const { getSourcePath, getModulePath } = require('../../../lib/project-root');
 
+// Load package.json for version info
+const packageJson = require('../../../../../package.json');
+
 /**
  * Generates manifest files for installed workflows, agents, and tasks
  */
@@ -451,7 +454,7 @@ class ManifestGenerator {
 
     const manifest = {
       installation: {
-        version: '6.0.0-alpha.0',
+        version: packageJson.version,
         installDate: new Date().toISOString(),
         lastUpdated: new Date().toISOString(),
       },

package/src/modules/bmm/workflows/workflow-status/workflow-status-template.md

@@ -1,30 +0,0 @@
-# BMM Workflow Status
-
-## Project Configuration
-
-PROJECT_NAME: {{project_name}}
-PROJECT_TYPE: {{project_type}}
-PROJECT_LEVEL: {{project_level}}
-FIELD_TYPE: {{field_type}}
-START_DATE: {{start_date}}
-WORKFLOW_PATH: {{workflow_path_file}}
-
-## Current State
-
-CURRENT_PHASE: {{current_phase}}
-CURRENT_WORKFLOW: {{current_workflow}}
-CURRENT_AGENT: {{current_agent}}
-PHASE_1_COMPLETE: {{phase_1_complete}}
-PHASE_2_COMPLETE: {{phase_2_complete}}
-PHASE_3_COMPLETE: {{phase_3_complete}}
-PHASE_4_COMPLETE: {{phase_4_complete}}
-
-## Next Action
-
-NEXT_ACTION: {{next_action}}
-NEXT_COMMAND: {{next_command}}
-NEXT_AGENT: {{next_agent}}
-
----
-
-_Last Updated: {{last_updated}}_

package/src/modules/cis/readme.md

@@ -1,86 +0,0 @@
----
-last-redoc-date: 2025-09-28
----
-
-<!-- Powered by BMAD-CORE™ -->
-
-# Creative Intelligence System (CIS)
-
-**Purpose:** Transform creative and strategic thinking through AI-powered facilitation across five specialized domains. The CIS module provides expert coaching for brainstorming, design thinking, problem-solving, innovation strategy, and storytelling.
-
-**Overview:** The Creative Intelligence System equips teams and individuals with structured creative methodologies delivered through distinctive agent personas. Each agent facilitates interactive workflows that guide users through proven techniques while adapting to context, energy levels, and goals. Unlike traditional creative tools, CIS agents act as master facilitators who ask questions to draw out insights rather than generating solutions directly.
-
-## Workflows
-
-[View all workflows →](./workflows/README.md)
-
-The module includes **5 interactive workflows** with over 150 creative techniques and frameworks:
-
-- **Brainstorming** - 36 creative techniques across 7 categories for ideation
-- **Design Thinking** - Complete 5-phase human-centered design process
-- **Problem Solving** - Systematic root cause analysis and solution generation
-- **Innovation Strategy** - Business model innovation and disruption analysis
-- **Storytelling** - 25 story frameworks for compelling narratives
-
-## Agents
-
-[View all agents →](./agents/README.md)
-
-Five specialized agents with unique personas and communication styles:
-
-- **Carson** - Elite Brainstorming Specialist (energetic facilitator)
-- **Maya** - Design Thinking Maestro (jazz-like improviser)
-- **Dr. Quinn** - Master Problem Solver (detective-scientist hybrid)
-- **Victor** - Disruptive Innovation Oracle (bold strategic precision)
-- **Sophia** - Master Storyteller (flowery, whimsical narrator)
-
-## Configuration
-
-The module uses `/bmad/cis/config.yaml` for:
-
-- `output_folder` - Where workflow results are saved
-- `user_name` - Session participant identification
-- `communication_language` - Facilitation language preference
-
-## Usage
-
-```bash
-# Direct workflow invocation
-workflow brainstorming
-workflow design-thinking --data /path/to/context.md
-
-# Agent-facilitated sessions
-agent cis/brainstorming-coach
-> *brainstorm
-```
-
-## Key Differentiators
-
-- **Facilitation Over Generation:** Agents guide users to discover their own insights through strategic questioning
-- **Energy-Aware Sessions:** Built-in checkpoints monitor and adapt to user engagement levels
-- **Context Integration:** All workflows accept optional context documents for domain-specific guidance
-- **Persona-Driven Experience:** Each agent embodies a unique communication style matching their expertise
-- **Rich Method Libraries:** 150+ proven techniques and frameworks across creative disciplines
-
-## Installation
-
-The CIS module installer (`_module-installer/`) configures the complete creative intelligence suite including all agents, workflows, and technique libraries.
-
-## Module Architecture
-
-```
-cis/
-├── agents/          # 5 specialized creative agents
-├── workflows/       # 5 interactive workflows
-│   ├── brainstorming/
-│   ├── design-thinking/
-│   ├── innovation-strategy/
-│   ├── problem-solving/
-│   └── storytelling/
-├── tasks/           # Supporting task operations
-└── teams/           # Agent team configurations
-```
-
----
-
-_Part of the BMAD Method v6.0 - Transform your creative potential with expert AI facilitation_