docs: update cursor, windsurf, crush, and github-copilot docs for flat file structure

docs/ide-info/crush.md

@@ -2,29 +2,27 @@
 
 ## Activating Agents
 
-BMAD agents are installed as commands in `.crush/commands/bmad/`.
+BMAD agents are installed as commands in `.crush/commands/` with flattened
+`bmad-*.md` naming.
 
 ### How to Use
 
 1. **Open Command Palette**: Use Crush command interface
-2. **Navigate**: Browse to `_bmad/{module}/agents/`
+2. **Type Command**: Start with `/bmad-` to filter BMAD commands
-3. **Select Agent**: Choose the agent command
+3. **Select Command**: Choose from the available options
 4. **Execute**: Run to activate agent persona
 
-### Command Structure
+### Examples
 
 ```
-.crush/commands/bmad/
+/bmad-bmm-agents-pm - Activate PM agent
-├── agents/          # All agents
+/bmad-bmm-agents-architect - Activate architect agent
-├── tasks/           # All tasks
+/bmad-bmm-workflows-create-prd - Execute create-prd workflow
-├── core/            # Core module
+/bmad-core-tasks-workflow - Execute workflow task
-│   ├── agents/
-│   └── tasks/
-└── {module}/        # Other modules
 ```
 
 ### Notes
 
-- Commands organized by module
+- All BMAD commands start with `bmad-`
-- Can browse hierarchically
+- Commands include agents, tasks, tools, and workflows
 - Agent activates for session

docs/ide-info/cursor.md

@@ -2,24 +2,27 @@
 
 ## Activating Agents
 
-BMAD agents are installed in `.cursor/rules/bmad/` as MDC rules.
+BMAD agents are installed as MDC rules in `.cursor/rules/` with flattened
+`bmad-*.mdc` naming.
 
 ### How to Use
 
-1. **Reference in Chat**: Use `@_bmad/{module}/agents/{agent-name}`
+1. **Reference in Chat**: Use `@bmad-{module}-{type}-{name}`
-2. **Include Entire Module**: Use `@_bmad/{module}`
+2. **Browse Available**: Type `@bmad-` to see autocomplete options
-3. **Reference Index**: Use `@_bmad/index` for all available agents
+3. **Reference Index**: Use `@bmad-index` for installation summary
 
 ### Examples
 
 ```
-@_bmad/core/agents/dev - Activate dev agent
+@bmad-bmm-agents-dev - Activate development agent
-@_bmad/bmm/agents/architect - Activate architect agent
+@bmad-bmm-agents-architect - Activate architect agent
-@_bmad/core - Include all core agents/tasks
+@bmad-bmm-workflows-create-prd - Execute create-prd workflow
+@bmad-core-tasks-workflow - Reference workflow task
 ```
 
 ### Notes
 
-- Rules are Manual type - only loaded when explicitly referenced
+- Rules are Manual type (alwaysApply: false) - only loaded when explicitly referenced
 - No automatic context pollution
-- Can combine multiple agents: `@_bmad/core/agents/dev @_bmad/core/agents/test`
+- All BMAD items start with `bmad-`
+- Can combine multiple references: `@bmad-bmm-agents-dev @bmad-bmm-agents-architect`

docs/ide-info/github-copilot.md

@@ -2,25 +2,34 @@
 
 ## Activating Agents
 
-BMAD agents are installed as chat modes in `.github/chatmodes/`.
+BMAD agents are installed in `.github/agents/` with flattened
+`bmad-*.agent.md` naming.
 
 ### How to Use
 
 1. **Open Chat View**: Click Copilot icon in VS Code sidebar
-2. **Select Mode**: Click mode selector (top of chat)
+2. **Select Agent**: Use `@bmad-{module}-agents-{name}` to reference an agent
-3. **Choose Agent**: Select the BMAD agent from dropdown
+3. **Chat**: Agent persona is now active for this conversation
-4. **Chat**: Agent is now active for this session
+
+### Examples
+
+```
+@bmad-bmm-agents-pm - Activate PM agent
+@bmad-bmm-agents-architect - Activate architect agent
+@bmad-bmm-agents-dev - Activate development agent
+```
 
 ### VS Code Settings
 
 Configured in `.vscode/settings.json`:
 
-- Max requests per session
+- `chat.agent.enabled` - Enable agent mode
-- Auto-fix enabled
+- `chat.agent.maxRequests` - Max requests per session
-- MCP discovery enabled
+- `github.copilot.chat.agent.autoFix` - Auto-fix enabled
+- `chat.mcp.discovery.enabled` - MCP discovery enabled
 
 ### Notes
 
-- Modes persist for the chat session
+- All BMAD agents start with `bmad-`
-- Switch modes anytime via dropdown
+- Agents have access to VS Code tools (edit, search, terminal, etc.)
-- Multiple agents available in mode selector
+- Agent persona persists for the chat session

docs/ide-info/windsurf.md

@@ -2,21 +2,32 @@
 
 ## Activating Agents
 
-BMAD agents are installed as workflows in `.windsurf/workflows/`.
+BMAD agents are installed as workflows in `.windsurf/workflows/` with flattened
+`bmad-*.md` naming.
 
 ### How to Use
 
-1. **Open Workflows**: Access via Windsurf menu or command palette
+1. **Type Slash Command**: Start with `/` to see available commands
-2. **Select Workflow**: Choose the agent/task workflow
+2. **Select Workflow**: Choose from `bmad-` prefixed workflows
-3. **Execute**: Run to activate that agent persona
+3. **Execute**: Press Enter to activate that agent persona
 
-### Workflow Types
+### Examples
 
-- **Agent workflows**: `{module}-{agent}.md` (auto_execution_mode: 3)
+```
-- **Task workflows**: `task-{module}-{task}.md` (auto_execution_mode: 2)
+/bmad-bmm-agents-pm - Activate PM agent
+/bmad-bmm-agents-architect - Activate architect agent
+/bmad-bmm-workflows-create-prd - Execute create-prd workflow
+/bmad-core-tasks-workflow - Execute workflow task
+```
+
+### Execution Modes
+
+- **Agent workflows**: `auto_execution_mode: 3` (higher autonomy)
+- **Task workflows**: `auto_execution_mode: 2` (guided execution)
+- **Workflow commands**: `auto_execution_mode: 1` (step-by-step)
 
 ### Notes
 
-- Agents run with higher autonomy (mode 3)
+- Commands are autocompleted when you type `/`
-- Tasks run with guided execution (mode 2)
+- All BMAD items start with `bmad-`
 - Workflows persist for the session