Edit Agent Workflow

Interactive workflow for editing existing BMAD Core agents while maintaining best practices and conventions.

Purpose

This workflow helps you refine and improve existing agents by:

Analyzing agents against BMAD Core best practices
Identifying issues and improvement opportunities
Providing guided editing for specific aspects
Validating changes against agent standards
Ensuring consistency with agent architecture

When to Use

Use this workflow when you need to:

Fix issues in existing agents
Add new menu items or workflows
Improve agent persona or communication style
Update configuration handling
Convert between agent types (full/hybrid/standalone)
Optimize agent structure and clarity

What You'll Need

Path to the agent file you want to edit (.yaml or .md)
Understanding of what changes you want to make
Access to the agent documentation (loaded automatically)

Workflow Steps

Load and analyze target agent - Provide path to agent file
Analyze against best practices - Automatic audit of agent structure
Select editing focus - Choose what aspect to edit
Load relevant documentation - Auto-loads guides based on your choice
Perform edits - Review and approve changes iteratively
Validate all changes - Comprehensive validation checklist
Generate change summary - Summary of improvements made

Editing Options

The workflow provides 12 focused editing options:

Fix critical issues - Address broken references, syntax errors
Add/fix standard config - Ensure config loading and variable usage
Refine persona - Improve role, communication style, principles
Update activation - Modify activation steps and greeting
Manage menu items - Add, remove, or reorganize commands
Update workflow references - Fix paths, add new workflows
Enhance menu handlers - Improve handler logic
Improve command triggers - Refine asterisk commands
Optimize agent type - Convert between full/hybrid/standalone
Add new capabilities - Add menu items, workflows, features
Remove bloat - Delete unused commands, redundant instructions
Full review and update - Comprehensive improvements

Agent Documentation Loaded

This workflow automatically loads:

Agent Types Guide - Understanding full, hybrid, and standalone agents
Agent Architecture - Structure, activation, and menu patterns
Command Patterns - Menu handlers and command triggers
Communication Styles - Persona and communication guidance
Workflow Execution Engine - How agents execute workflows

Output

The workflow modifies your agent file in place, maintaining the original format (YAML or markdown). Changes are reviewed and approved by you before being applied.

Best Practices

Start with analysis - Let the workflow audit your agent first
Focus your edits - Choose specific aspects to improve
Review each change - Approve or modify proposed changes
Validate thoroughly - Use the validation step to catch issues
Test after editing - Invoke the edited agent to verify it works

Tips

If you're unsure what needs improvement, choose option 12 (Full review)
For quick fixes, choose the specific option (like option 6 for workflow paths)
The workflow loads documentation automatically - you don't need to read it first
You can make multiple rounds of edits in one session
Use the validation step to ensure you didn't miss anything

create-agent - Create new agents from scratch
edit-workflow - Edit workflows referenced by agents
audit-workflow - Audit workflows for compliance

Example Usage

User: I want to add a new workflow to the PM agent
Workflow: Analyzes agent → Loads it → You choose option 5 (manage menu items)
          → Adds new menu item with workflow reference → Validates → Done

Activation

Invoke via BMad Builder agent:

/bmad:bmb:agents:bmad-builder
Then select: *edit-agent

Or directly via workflow.xml with this workflow config.

4.1 KiB Raw Blame History