mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
7eb52520fa
- Installation path is now fully configurable, allowing users to specify custom installation directories during setup
- Default installation location changed to .bmad (hidden directory) for cleaner project root organization
Web Bundle Improvements:
- All web bundles (single agent and team) now include party mode support for multi-agent collaboration!
- Advanced elicitation capabilities integrated into standalone agents
- All bundles enhanced with party mode agent manifests
- Added default-party.csv files to bmm, bmgd, and cis module teams
- The default party file is what will be used with single agent bundles. teams can customize for different party configurations before web bundling through a setting in the team yaml file
- New web bundle outputs for all agents (analyst, architect, dev, pm, sm, tea, tech-writer, ux-designer, game-*, creative-squad)
Phase 4 Workflow Updates (In Progress):
- Initiated shift to separate phase 4 implementation artifacts from documentation
- Phase 4 implementation artifacts (stories, code review, sprint plan, context files) will move to dedicated location outside docs folder
- Installer questions and configuration added for artifact path selection
- Updated workflow.yaml files for code-review, sprint-planning, story-context, epic-tech-context, and retrospective workflows to support this, but still might require some udpates
Additional Changes:
- New agent and action command header models for standardization
- Enhanced web-bundle-activation-steps fragment
- Updated web-bundler.js to support new structure
- VS Code settings updated for new .bmad directory
- Party mode instructions and workflow enhanced for better orchestration
IDE Installer Updates:
- Show version number of installer in cli
- improved Installer UX
- Gemini TOML Improved to have clear loading instructions with @ commands
- All tools agent launcher mds improved to use a central file template critical indication isntead of hardcoding in 2 different locations.
113 lines
4.1 KiB
Markdown
113 lines
4.1 KiB
Markdown
# 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
|
|
|
|
1. **Load and analyze target agent** - Provide path to agent file
|
|
2. **Analyze against best practices** - Automatic audit of agent structure
|
|
3. **Select editing focus** - Choose what aspect to edit
|
|
4. **Load relevant documentation** - Auto-loads guides based on your choice
|
|
5. **Perform edits** - Review and approve changes iteratively
|
|
6. **Validate all changes** - Comprehensive validation checklist
|
|
7. **Generate change summary** - Summary of improvements made
|
|
|
|
## Editing Options
|
|
|
|
The workflow provides 12 focused editing options:
|
|
|
|
1. **Fix critical issues** - Address broken references, syntax errors
|
|
2. **Add/fix standard config** - Ensure config loading and variable usage
|
|
3. **Refine persona** - Improve role, communication style, principles
|
|
4. **Update activation** - Modify activation steps and greeting
|
|
5. **Manage menu items** - Add, remove, or reorganize commands
|
|
6. **Update workflow references** - Fix paths, add new workflows
|
|
7. **Enhance menu handlers** - Improve handler logic
|
|
8. **Improve command triggers** - Refine asterisk commands
|
|
9. **Optimize agent type** - Convert between full/hybrid/standalone
|
|
10. **Add new capabilities** - Add menu items, workflows, features
|
|
11. **Remove bloat** - Delete unused commands, redundant instructions
|
|
12. **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
|
|
|
|
## Related Workflows
|
|
|
|
- **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.
|