Files

Max e9e6fadb1d fix: ChatBubble crash and DeepSeek API compatibility

- Fix ChatBubble to handle non-string content with String() wrapper
- Fix API route to use generateText for non-streaming requests
- Add @ai-sdk/openai-compatible for non-OpenAI providers (DeepSeek, etc.)
- Use Chat Completions API instead of Responses API for compatible providers
- Update ChatBubble tests and fix component exports to kebab-case
- Remove stale PascalCase ChatBubble.tsx file

2026-01-26 16:55:05 +07:00

5.6 KiB

Raw Blame History

Agent Metadata Properties

Core identification and classification properties for all agents.

Property Reference

Property	Purpose	Format
`id`	Compiled output path	`_bmad/agents/{agent-name}/{agent-name}.md`
`name`	Persona's name	"First Last" or "Name Title"
`title`	Professional role	"Code Review Specialist"
`icon`	Visual identifier	Single emoji only
`module`	Team/ecosystem membership	`stand-alone`, `bmm`, `cis`, `bmgd`, or custom
`hasSidecar`	Sidecar folder exists	`true` or `false` (Expert = true)

id Property

The compiled output path after build.

Format: _bmad/agents/{agent-name}/{agent-name}.md

Examples:

id: _bmad/agents/commit-poet/commit-poet.md
id: _bmad/agents/journal-keeper/journal-keeper.md
id: _bmad/agents/security-engineer/security-engineer.md

Note: The id is a unique identifier for potential future lookup if many compiled agents are merged into a single file. Conventionally matches the agent's filename pattern.

name Property

The persona's identity - what the agent is called.

Format: Human name or descriptive name

# ✅ CORRECT
name: 'Inkwell Von Comitizen' # peron name of commit-author title agent
name: 'Dr. Demento'  # person name for a joke writer agent
name: 'Clarity' # person name for a guided thought coach agent

# ❌ WRONG
name: 'commit-poet'  # That's the filename
name: 'Code Review Specialist'  # That's the title

title Property

Professional role identifier.

Format: Professional title or role name

Important: The title determines the agent's filename:

title: 'Commit Message Artisan' → commit-message-artisan.agent.yaml
title: 'Strategic Business Analyst' → strategic-business-analyst.agent.yaml
title: 'Code Review Specialist' → code-review-specialist.agent.yaml

The id and filename are derived from the title (kebab-cased).

Difference from role: title is the short identifier (filename), role is 1-2 sentences expanding on what the agent does.

# ✅ CORRECT
title: 'Commit Message Artisan'
title: 'Strategic Business Analyst'
title: 'Code Review Specialist'

# ❌ WRONG
title: 'Inkwell Von Comitizen'  # That's the name
title: 'Writes git commits'  # Full sentence - not an identifying functional title

icon Property

Single emoji representing the agent's personality/function.

Format: Exactly one emoji

# ✅ CORRECT
icon: '🔧'
icon: '🧙‍♂️'
icon: '📜'

# ❌ WRONG
icon: '🔧📜'  # Multiple emojis
icon: 'wrench'  # Text, not emoji
icon: ''  # Empty

module Property

Which module or ecosystem this agent belongs to.

Valid Values:

Value	Meaning
`stand-alone`	Independent agent, not part of a module
`bmm`	Business Management Module
`cis`	Continuous Innovation System
`bmgd`	BMAD Game Development
`{custom}`	Any custom module code

# ✅ CORRECT
module: stand-alone
module: bmm
module: cis

# ❌ WRONG
module: standalone  # Missing hyphen
module: 'BMM'  # Uppercase

hasSidecar Property

Whether this agent has a sidecar folder with additional files.

Format: Boolean (true or false)

Agent Type	hasSidecar
Simple	`false`
Expert	`true`
Module	depends on structure

# Simple Agent
hasSidecar: false

# Expert Agent
hasSidecar: true

Note: If hasSidecar: true, the compiler expects a {agent-name}-sidecar/ folder.

Name Confusion Checklist

Use this to avoid mixing up the "name" properties:

Question	Answer
What's the file called?	Derived from `title`: `"Commit Message Artisan"` → `commit-message-artisan.agent.yaml`
What's the persona called?	`name` - "Inkwell Von Comitizen" (who the agent is)
What's their job title?	`title` - "Commit Message Artisan" (determines filename)
What do they do?	`role` - 1-2 sentences expanding on the title
What's the unique key?	`id` - `_bmad/agents/commit-message-artisan/commit-message-artisan.md` (future lookup)

Common Issues

Issue: name = title

Wrong:

name: 'Commit Message Artisan'
title: 'Commit Message Artisan'

Fix:

name: 'Inkwell Von Comitizen'
title: 'Commit Message Artisan'

Issue: id path mismatch

Wrong: Agent file is my-agent.agent.yaml but:

id: _bmad/agents/different-agent/different-agent.md

Fix: The id must match the filename:

id: _bmad/agents/my-agent/my-agent.md

Issue: Wrong module format