Further docs cleanup: cut more redundancy, reorganize reference

- Delete what-to-build.md (duplicate of agent-or-module-decision)
- Delete crafting-agent-principles.md (niche content)
- Move workflow-patterns.md from explanation to reference (it's tables)
- Delete custom-content-types.md and customize-workflows.md (redundant)
- Delete communication-styles.md and workflow-schema.md from reference
- Update all indexes to reflect changes

Author: bmadcode

docs/explanation/crafting-agent-principles.md

@@ -3,14 +3,14 @@ title: "Facilitation Over Generation"
 description: A facilitation-first approach to AI workflows
 ---
 
-BMad workflows facilitate discovery rather than generating solutions directly.
+BMad workflows are at their most powerful when they facilitate discovery rather than generating solutions directly. A prime example is the brainstorming workflow. If you have not tried it, it is work experiencing to see what true agent facilitation can feel like - putting the user in control and feeling like they are a partner with the LLM working together.
 
 ## Key Principles
 
 | Principle | Description |
 |-----------|-------------|
 | **Questions Over Answers** | Ask strategic questions, don't provide direct answers |
-| **Multi-Turn Conversation** | Ask 1-2 questions at a time, not laundry lists |
+| **Multi-Turn Conversation** | Ask 1-2 questions at a time, not laundry lists, its a conversation |
 | **Intent-Based Guidance** | Specify goals, not exact scripts |
 | **YOU Are the Expert** | You bring domain knowledge, workflow brings process |
 
@@ -29,10 +29,6 @@ BMad workflows facilitate discovery rather than generating solutions directly.
 > "I need a UX design" → [Immediately generates complete specification]
 
 **BMad Workflow:**
-> "I need a UX design" → "What documents do you have? What are the primary user goals? What makes your situation unique?"
+> "I need a UX design" → "What documents do you have? First lets understand what are the primary user goals? What makes your situation unique?" → user response → "Why is that X. Did you ever consider that Y and Z might?"
 
-## Benefits
 
-- **Deeper insights** connected to your actual knowledge
-- **Full ownership** of decisions
-- **More memorable** because you understand the "why"

docs/explanation/custom-content-types.md

@@ -9,34 +9,26 @@ Create custom agents, workflows, and modules for BMad.
 
 | Resource | Description |
 |----------|-------------|
-| **[Create a Custom Agent](/tutorials/create-custom-agent.md)** | Build your first AI agent |
-| **[Create Your First Workflow](/tutorials/create-your-first-workflow.md)** | Design structured workflows |
-| **[Create Your First Module](/tutorials/create-your-first-module.md)** | Package and publish modules |
+| **[Create a Custom Agent](/how-to/create-custom-agent.md)** | Build your first AI agent |
+| **[Create Your First Workflow](/how-to/create-your-first-workflow.md)** | Design structured workflows |
+| **[Bundle Your Creations](/how-to/bundle-your-creations.md)** | Package and install modules |
 
 ## Core Concepts
 
 | Topic | Description |
 |-------|-------------|
-| **[What to Build](/explanation/what-to-build.md)** | Decide whether to build an agent, workflow, or module |
+| **[Agent or Module?](/how-to/agent-or-module-decision.md)** | Decide what to build first |
 | **[What Are Agents](/explanation/what-are-bmad-agents.md)** | AI personas with specialized capabilities |
 | **[What Are Workflows](/explanation/what-are-workflows.md)** | Structured step-by-step processes |
 | **[What Are Modules](/explanation/what-are-modules.md)** | Bundles of agents and workflows |
-| **[Custom Content Types](/explanation/custom-content-types.md)** | Content categories in BMad |
 
 ## Workflow Design
 
 | Topic | Description |
 |-------|-------------|
-| **[Workflow Patterns](/explanation/workflow-patterns.md)** | Structure types, intent spectrum, and execution patterns |
-| **[Workflow Customization](/explanation/customize-workflows.md)** | Tri-modal structure and cross-mode integration |
+| **[Workflow Patterns](/reference/workflow-patterns.md)** | Structure types, intent spectrum, and execution patterns |
 | **[Plan for Iteration](/explanation/plan-for-workflows-skills-to-evolve.md)** | Iteration strategy for workflows |
 
-## Agent Deep Dives
-
-| Topic | Description |
-|-------|-------------|
-| **[Crafting Agent Principles](/explanation/crafting-agent-principles.md)** | Write effective principles that activate expert knowledge |
-
 ## Architecture & Process
 
 | Topic | Description |

docs/explanation/customize-workflows.md

@@ -48,12 +48,4 @@ your-module/
 | Agents | `bmad-bmb-create-agent` |
 | Workflows | `bmad-bmb-create-workflow` |
 
-**What gets created:** Full agent files, detailed workflow steps, actual functionality
-
-## Common Confusions
-
-| Confusion | Reality |
-|-----------|----------|
-| Module builder creates agents | Creates agent specs — you build actual agents |
-| Write prompts in the brief | Brief defines WHAT, prompts come later |
-| Module is done after scaffolding | Scaffolding creates structure, not content |
+**What gets created:** Full agent files, detailed workflow steps, actual functionality

docs/explanation/facilitation-over-generation.md

@@ -2,7 +2,7 @@
 title: "Modules"
 ---
 
-Modules are bundles of agents, workflows, and configuration that solve specific problems.
+Modules are bundles of agents, workflows, and configuration that solve specific problems or serve a cohesive purpose. What makes modules unique from say generic skill plugin packs is that they integrate together with other modules and cohesively meld into the bmad help and recommendation engine and workflow sequencing!
 
 ## What Is a Module?
 

docs/explanation/index.md

@@ -17,3 +17,7 @@ Configuration values defined in Core that all modules inherit.
 ## Inheritance
 
 Modules can accept defaults, override values, or extend them using `{output_folder}`.
+
+## Your New Module Config
+
+You define new variables. So when your module is used, you have access to all core module values, and your own. If you also extend a module using the `extends-module` config in the module config, then you will additionally have access to those also from your custom workflow that is part of the module.