f14014f0c7
## Key Changes ### 1. Time Estimate Prohibition (All Modules) - Added critical warnings against providing ANY time estimates (hours/days/weeks/months) - Acknowledges AI has fundamentally changed development speed - Applied to 33 workflow instruction files across BMB, BMGD, BMM, and CIS modules - Updated workflow creation guide with prohibition guidelines ### 2. Enhanced Epic Creation Workflow - Added intelligent UPDATE vs CREATE mode detection - Detects available context (UX, Architecture, Domain brief, Product brief) - Progressive enhancement: creates basic epics, then enriches with UX/Architecture - Living document approach with continuous updates - Added 305 lines of sophisticated workflow logic ### 3. Workflow Status Initialization Refactoring - Simplified from 893 to 318 lines (65% reduction) - Streamlined state detection: CLEAN, PLANNING, ACTIVE, LEGACY, UNCLEAR - Cleaner path selection and initialization logic - Removed redundant complexity while maintaining functionality ### 4. Workflow Path Updates - Updated all 4 workflow paths (enterprise/method × brownfield/greenfield) - Added multiple optional epic creation steps at different phases: - After PRD (basic structure) - After UX Design (with interaction context) - After Architecture (final with full context) - Changed PRD output description from "with epics and stories" to "with FRs and NFRs" ### 5. Architecture & Innovation Updates - Made epics input optional in architecture workflow (falls back to PRD FRs) - Updated innovation strategy phases to remove time-based language - Phases now: Immediate Impact → Foundation Building → Scale & Optimization ### Files Changed - 33 instruction files updated with time estimate prohibition - 2 workflow.yaml files updated (create-epics-and-stories, architecture) - 4 workflow path YAML files updated - 1 workflow creation guide enhanced This refactor significantly improves workflow intelligence, removes harmful time-based planning assumptions, and creates more adaptive, context-aware workflows that better leverage AI capabilities. |
||
|---|---|---|
| .. | ||
| README.md | ||
| agent-architecture.md | ||
| agent-command-patterns.md | ||
| agent-types.md | ||
| brainstorm-context.md | ||
| checklist.md | ||
| communication-styles.md | ||
| instructions.md | ||
| workflow.yaml | ||
README.md
Create Agent Workflow
Interactive agent builder creating BMad Core compliant agents as YAML source files that compile to .md during installation.
Table of Contents
Quick Start
# Direct workflow
workflow create-agent
# Via BMad Builder
*create-agent
Agent Types
Simple Agent
- Self-contained functionality
- Basic command structure
- No external resources
Expert Agent
- Sidecar resources for domain knowledge
- Extended capabilities
- Knowledge base integration
Module Agent
- Full-featured with workflows
- Module-specific commands
- Integrated with module structure
Workflow Phases
Phase 0: Optional Brainstorming
- Creative ideation session
- Explore concepts and personalities
- Generate command ideas
- Output feeds into persona development
Phase 1: Agent Setup
- Choose agent type (Simple/Expert/Module)
- Define identity (name, title, icon, filename)
- Assign to module (if Module agent)
Phase 2: Persona Development
- Define role and responsibilities
- Craft unique identity/backstory
- Select communication style
- Establish guiding principles
- Add critical actions (optional)
Phase 3: Command Building
- Add required commands (*help, *exit)
- Define workflow commands
- Add task commands
- Create action commands
- Configure attributes
Phase 4: Finalization
- Generate .agent.yaml file
- Create customize file (optional)
- Setup sidecar resources (Expert agents)
- Validate and compile
- Provide usage instructions
Output Structure
Generated Files
Standalone Agents:
- Source:
{bmad_folder}/agents/{filename}.agent.yaml - Compiled:
{bmad_folder}/agents/{filename}.md
Module Agents:
- Source:
src/modules/{module}/agents/{filename}.agent.yaml - Compiled:
{bmad_folder}/{module}/agents/{filename}.md
YAML Structure
agent:
metadata:
id: {bmad_folder}/{module}/agents/{filename}.md
name: Agent Name
title: Agent Title
icon: 🤖
module: module-name
persona:
role: '...'
identity: '...'
communication_style: '...'
principles: ['...', '...']
menu:
- trigger: command-name
workflow: path/to/workflow.yaml
description: Command description
Optional Customize File
Location: {bmad_folder}/_cfg/agents/{module}-{filename}.customize.yaml
Allows persona and menu overrides that persist through updates.
Installation
Compilation Methods
Quick Rebuild:
bmad compile-agents
During Module Install: Automatic compilation when installing modules
Manual Compilation:
node tools/cli/bmad-cli.js compile-agents
Examples
Creating a Code Review Agent
User: I need a code review agent
Builder: Let's brainstorm first...
[Brainstorming generates ideas for strict vs friendly reviewer]
Builder: Now let's build your agent:
- Type: Simple
- Name: Code Reviewer
- Role: Senior developer conducting thorough reviews
- Style: Professional but approachable
- Commands:
- *review-pr: Review pull request
- *review-file: Review single file
- *review-standards: Check coding standards
Creating a Domain Expert
Type: Expert
Name: Legal Advisor
Sidecar: legal-knowledge/
Commands:
- *contract-review
- *compliance-check
- *risk-assessment
Workflow Files
create-agent/
├── workflow.yaml # Configuration
├── instructions.md # Step guide
├── checklist.md # Validation
├── README.md # This file
├── agent-types.md # Type details
├── agent-architecture.md # Patterns
├── agent-command-patterns.md # Commands
└── communication-styles.md # Styles
Best Practices
- Use brainstorming for complex agents
- Start simple - Add commands incrementally
- Test commands before finalizing
- Document thoroughly in descriptions
- Follow naming conventions consistently