From 66eaad87a93cc9ae4b873448d4bfb52bf16fdba2 Mon Sep 17 00:00:00 2001
From: rahulrocksn <70889306+rahulrocksn@users.noreply.github.com>
Date: Wed, 23 Jul 2025 15:12:38 -0700
Subject: [PATCH] chore: update Zed IDE readme

---
 tools/installer/config/zed-readme.md | 129 ++-------------------------
 1 file changed, 7 insertions(+), 122 deletions(-)

diff --git a/tools/installer/config/zed-readme.md b/tools/installer/config/zed-readme.md
index ec101ffe..af5b7bd3 100644
--- a/tools/installer/config/zed-readme.md
+++ b/tools/installer/config/zed-readme.md
@@ -1,132 +1,17 @@
 # BMad Method - Zed Integration
 
-This document explains how to use BMad Method agents within Zed, the fast and modern code editor.
+Use BMad Method agents directly in Zed, the fast and modern code editor.
 
 ## Installation
 
-1. **Install BMad Method in your project:**
-   ```bash
-   npx bmad-method install
-   ```
+```bash
+npx bmad-method install
+```
 
-2. **Select Zed as your IDE** when prompted during installation.
-
-3. **The installer will create:**
-   - `.zed/assistants/` - Directory containing all BMad agent assistants
-   - `.zed/bmad-config.json` - Configuration file for Zed integration
-   - Numbered assistant files (e.g., `01-bmad-master.md`, `02-pm.md`)
+Select Zed as your IDE when prompted.
 
 ## Usage
 
-### Activating Agents
+Open the Zed AI Assistant panel (`Cmd+I` on Mac, `Ctrl+I` on Windows/Linux) and activate agents using `@agent-name`.
 
-1. **Open Zed AI Assistant Panel:**
-   - **Mac:** `Cmd+I`
-   - **Windows/Linux:** `Ctrl+I`
-
-2. **Activate an agent by typing:**
-   ```
-   @agent-name
-   ```
-
-### Available Agents
-
-| Agent | Command | Description |
-|-------|---------|-------------|
-| BMad Master | `@bmad-master` | Master agent that can perform any task |
-| Product Manager | `@pm` | Product requirements and planning |
-| Analyst | `@analyst` | Market research and analysis |
-| Architect | `@architect` | System architecture and design |
-| Product Owner | `@po` | Story management and prioritization |
-| Scrum Master | `@sm` | Process management and story creation |
-| Developer | `@dev` | Code implementation and development |
-| QA Engineer | `@qa` | Testing and quality assurance |
-| UX Expert | `@ux-expert` | User experience and interface design |
-
-### Example Interactions
-
-```
-@dev Create a React component for user authentication
-@pm Review the current sprint progress
-@architect Design the database schema for the user system
-@qa Review the authentication component and suggest tests
-```
-
-## Features
-
-### Project Context Awareness
-- Agents understand your project structure
-- Access to `.bmad-core/` documentation and templates
-- Knowledge of project conventions and standards
-
-### File System Integration
-- Full access to read and modify project files
-- Can create new files and update existing ones
-- Follows project file organization patterns
-
-### Template System
-- Access to BMad document templates
-- Can generate PRDs, architecture docs, user stories
-- Maintains consistency with BMad methodology
-
-### Task Execution
-- Can execute specific BMad tasks
-- Access to quality assurance checklists
-- Follows BMad workflows and processes
-
-## Configuration
-
-The integration creates several configuration files:
-
-### `.zed/assistants/`
-Contains individual assistant files for each BMad agent, numbered for ordering.
-
-### `.zed/bmad-config.json`
-Configuration file that describes the BMad integration and available features.
-
-## Troubleshooting
-
-### Agents Not Appearing
-- Ensure you ran `npx bmad-method install` and selected Zed
-- Check that `.zed/assistants/` directory exists
-- Restart Zed after installation
-
-### Agent Not Responding
-- Verify you're using the correct `@agent-name` syntax
-- Check that the agent file exists in `.zed/assistants/`
-- Try refreshing the AI assistant panel
-
-### File Access Issues
-- Ensure Zed has permission to access your project directory
-- Check that the agent has the necessary file permissions
-- Verify project structure matches BMad expectations
-
-## Advanced Usage
-
-### Custom Agent Ordering
-You can modify the agent ordering by editing the configuration in:
-- `tools/installer/config/ide-agent-config.yaml` (before installation)
-- `.zed/assistants/` file numbering (after installation)
-
-### Expansion Packs
-If you have BMad expansion packs installed, their agents will also be available:
-- Game development agents (if game dev expansion is installed)
-- Infrastructure agents (if infrastructure expansion is installed)
-- Other domain-specific agents
-
-### Project-Specific Customization
-- Agents automatically load project-specific documentation
-- They adapt to your project's coding standards and conventions
-- Can reference project-specific templates and checklists
-
-## Support
-
-For issues with Zed integration:
-1. Check the BMad documentation: `bmad-core/user-guide.md`
-2. Review the installation logs for any errors
-3. Ensure you're using a compatible version of Zed
-4. Join the BMad community for help and support
-
----
-
-**Note:** This integration is designed to work with Zed's AI assistant system. Make sure you have the latest version of Zed installed for the best experience. 
\ No newline at end of file
+For more details, see the main user guide: `bmad-core/user-guide.md` 
\ No newline at end of file