BMAD-METHOD/src/modules/cis/workflows
Brian Madison 6f7e9f0653 refactor: Major v6 epic creation improvements and documentation overhaul
## Key Changes

### 1. Epic Creation Workflow Enhancements
- Added user-value focused epic structure principles (NO technical layer breakdown)
- Implemented multi-mode detection: CONTINUE, REPLACE, or UPDATE existing epics
- Added comprehensive anti-pattern examples showing wrong vs right epic breakdown
- Epics now created AFTER architecture for technically-informed story breakdown
- Added checkpoint protocol for interactive workflow progression

### 2. Removed Deprecated Solutioning Gate Check
- Deleted entire solutioning-gate-check workflow (682 lines)
- Replaced by new implementation-readiness workflow
- Cleaner separation of concerns in solutioning phase

### 3. PRD Template Simplification
- Removed hardcoded "Implementation Planning", "References", and "Next Steps" sections
- PRD now focuses purely on requirements, not workflow orchestration
- Epics/stories created as separate step after architecture

### 4. Documentation Overhaul (15+ docs updated)
- Updated quick-start guide with v6 workflow sequence
- Clarified that epics are created AFTER architecture, not during PRD
- Updated solutioning docs to reflect implementation-readiness pattern
- Improved agents-guide, brownfield-guide, enterprise docs
- Enhanced glossary, FAQ, and workflow reference documentation

### 5. Workflow Path Adjustments
- All 4 paths updated (enterprise/method × brownfield/greenfield)
- Version bumps across BMGD, BMM, and CIS workflow YAMLs
- Minor instruction file updates for consistency

### Files Changed
- 65 files total: 468 insertions, 978 deletions (net reduction of 510 lines)
- 4 files deleted (entire solutioning-gate-check workflow)
- 1 new directory added (implementation-readiness placeholder)
2025-11-16 00:23:47 -06:00
..
design-thinking refactor: Major v6 epic creation improvements and documentation overhaul 2025-11-16 00:23:47 -06:00
innovation-strategy refactor: Major v6 epic creation improvements and documentation overhaul 2025-11-16 00:23:47 -06:00
problem-solving refactor: Major v6 epic creation improvements and documentation overhaul 2025-11-16 00:23:47 -06:00
storytelling refactor: Major v6 epic creation improvements and documentation overhaul 2025-11-16 00:23:47 -06:00
README.md The install directory is now configurable, with a few minute issues 2025-11-08 13:58:43 -06:00

README.md

CIS Workflows

Five interactive workflows facilitating creative and strategic processes through curated technique libraries and structured facilitation.

Table of Contents

Workflow Overview

Brainstorming

Purpose: Interactive ideation using 36 techniques across 7 categories

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

Purpose: Human-centered design through five phases

Process: Empathize → Define → Ideate → Prototype → Test

Focus: Divergent thinking before convergent action

Output: User empathy insights and rapid prototypes

Innovation Strategy

Purpose: Identify disruption opportunities and business model innovation

Frameworks: Jobs-to-be-Done, Blue Ocean Strategy, Value Chain Analysis

Focus: Sustainable competitive advantage over features

Output: Strategic innovation roadmap

Problem Solving

Purpose: Systematic challenge resolution

Methods: TRIZ, Theory of Constraints, Systems Thinking, Root Cause Analysis

Approach: Detective-style puzzle solving

Output: Root cause identification and solution strategies

Storytelling

Purpose: Craft compelling narratives

Frameworks: Hero's Journey, Three-Act Structure, Story Brand (25 total)

Customization: Platform and audience-specific adaptation

Style: Whimsical master storyteller facilitation

Common Features

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

workflow brainstorming
workflow design-thinking
workflow innovation-strategy
workflow problem-solving
workflow storytelling

With Context

workflow [workflow-name] --data /path/to/context.md

Via Agent

agent cis/brainstorming-coach
> *brainstorm

Configuration

Edit /{bmad_folder}/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

For detailed workflow instructions, see individual workflow directories.