BMAD-METHOD/bmad/cis
Brian Madison cfedecbd53 docs: massive documentation overhaul + introduce Paige (Documentation Guide agent)
## 📚 Complete Documentation Restructure

**BMM Documentation Hub Created:**
- New centralized documentation system at `src/modules/bmm/docs/`
- 18 comprehensive guides organized by topic (7000+ lines total)
- Clear learning paths for greenfield, brownfield, and quick spec flows
- Professional technical writing standards throughout

**New Documentation:**
- `README.md` - Complete documentation hub with navigation
- `quick-start.md` - 15-minute getting started guide
- `agents-guide.md` - Comprehensive 12-agent reference (45 min read)
- `party-mode.md` - Multi-agent collaboration guide (20 min read)
- `scale-adaptive-system.md` - Deep dive on Levels 0-4 (42 min read)
- `brownfield-guide.md` - Existing codebase development (53 min read)
- `quick-spec-flow.md` - Rapid Level 0-1 development (26 min read)
- `workflows-analysis.md` - Phase 1 workflows (12 min read)
- `workflows-planning.md` - Phase 2 workflows (19 min read)
- `workflows-solutioning.md` - Phase 3 workflows (13 min read)
- `workflows-implementation.md` - Phase 4 workflows (33 min read)
- `workflows-testing.md` - Testing & QA workflows (29 min read)
- `workflow-architecture-reference.md` - Architecture workflow deep-dive
- `workflow-document-project-reference.md` - Document-project workflow reference
- `enterprise-agentic-development.md` - Team collaboration patterns
- `faq.md` - Comprehensive Q&A covering all topics
- `glossary.md` - Complete terminology reference
- `troubleshooting.md` - Common issues and solutions

**Documentation Improvements:**
- Removed all version/date footers (git handles versioning)
- Agent customization docs now include full rebuild process
- Cross-referenced links between all guides
- Reading time estimates for all major docs
- Consistent professional formatting and structure

**Consolidated & Streamlined:**
- Module README (`src/modules/bmm/README.md`) streamlined to lean signpost
- Root README polished with better hierarchy and clear CTAs
- Moved docs from root `docs/` to module-specific locations
- Better separation of user docs vs. developer reference

## 🤖 New Agent: Paige (Documentation Guide)

**Role:** Technical documentation specialist and information architect

**Expertise:**
- Professional technical writing standards
- Documentation structure and organization
- Information architecture and navigation
- User-focused content design
- Style guide enforcement

**Status:** Work in progress - Paige will evolve as documentation needs grow

**Integration:**
- Listed in agents-guide.md, glossary.md, FAQ
- Available for all phases (documentation is continuous)
- Can be customized like all BMM agents

## 🔧 Additional Changes

- Updated agent manifest with Paige
- Updated workflow manifest with new documentation workflows
- Fixed workflow-to-agent mappings across all guides
- Improved root README with clearer Quick Start section
- Better module structure explanations
- Enhanced community links with Discord channel names

**Total Impact:**
- 18 new/restructured documentation files
- 7000+ lines of professional technical documentation
- Complete navigation system with cross-references
- Clear learning paths for all user types
- Foundation for knowledge base (coming in beta)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-02 21:18:33 -06:00
..
agents docs: massive documentation overhaul + introduce Paige (Documentation Guide agent) 2025-11-02 21:18:33 -06:00
teams docs: massive documentation overhaul + introduce Paige (Documentation Guide agent) 2025-11-02 21:18:33 -06:00
workflows docs: massive documentation overhaul + introduce Paige (Documentation Guide agent) 2025-11-02 21:18:33 -06:00
README.md docs: massive documentation overhaul + introduce Paige (Documentation Guide agent) 2025-11-02 21:18:33 -06:00
config.yaml docs: massive documentation overhaul + introduce Paige (Documentation Guide agent) 2025-11-02 21:18:33 -06:00

README.md

CIS - Creative Intelligence Suite

AI-powered creative facilitation transforming strategic thinking through expert coaching across five specialized domains.

Table of Contents

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 →

  • 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 →

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

# Start interactive session
workflow brainstorming

# With context document
workflow design-thinking --data /path/to/context.md

Agent-Facilitated

# 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:

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

Part of BMad Method v6.0 - Transform creative potential through expert AI facilitation.