4.2 KiB

Raw Blame History

BMad Method - Zed Integration

This document explains how to use BMad Method agents within Zed, the fast and modern code editor.

Installation

Install BMad Method in your project:
```
npx bmad-method install
```
Select Zed as your IDE when prompted during installation.
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)

Usage

Activating Agents

Open Zed AI Assistant Panel:
- Mac: Cmd+I
- Windows/Linux: Ctrl+I
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:

Check the BMad documentation: bmad-core/user-guide.md
Review the installation logs for any errors
Ensure you're using a compatible version of Zed
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.

4.2 KiB Raw Blame History