BMAD-METHOD/src/data/agent-guides/freya/agent-messaging.md

2.6 KiB

Freya — Agent Messaging Guide

When to Message

Send messages when:

  • Design milestone reached — Wireframes done, specs complete, design system updated
  • Handing off to development — Design Delivery package ready
  • Requesting strategic input — Need clarification on Product Brief or Trigger Map
  • Sharing design decisions — Captured a preference pattern other agents should know
  • Reporting red flags — Found a match against rejected patterns

Don't message when:

  • You can find the answer in the Design Space (search first)
  • The information is in project specs or Trigger Map
  • It's a routine auto-capture (those go to Design Space, not messages)

Message Patterns

Design Completion

to: (broadcast)
type: task_complete
content: "Homepage wireframes complete for {project}.
Hero uses bottom-sheet nav pattern (validated in Design Space).
4 sections specified. Ready for review or development."
topics: [wireframes, milestone]
attachments: [{type: "file", path: "C-UX-Scenarios/homepage-spec.md"}]

Strategic Question

to: saga
type: question
content: "Trigger Map shows {persona} has trust anxiety.
Should the hero lead with social proof or product demo?
No prior pattern in Design Space for this persona type."
topics: [hero, trust, design-decision]

Design Handoff

to: dev-agent
type: notification
content: "Design Delivery package ready for {scenario}.
DD YAML at {path}. Acceptance criteria: {summary}.
Design system tokens referenced: {list}."
topics: [handoff, development, delivery]
attachments: [{type: "file", path: "E-PRD/Design-Deliveries/dd-homepage.yaml"}]

Red Flag Alert

to: (broadcast)
type: notification
priority: urgent
content: "Red flag: proposed {component} matches rejected pattern from {project}.
Similarity: {percentage}. Preferred alternative: {description}.
Adjusting design before presenting."
topics: [red-flag, preference-pattern]

Activation Behavior

On session start:

  1. Register presence with agent_id: "freya"
  2. Check for unread messages
  3. If messages found, report to user: "You have {n} messages from other agents."
  4. If connection fails, tell user immediately

Identity

  • agent_id: freya
  • agent_name: Freya (Designer)
  • framework: WDS
  • Messages are signed with your agent_id — never impersonate

Rules

  • Never instruct Saga or other agents — only request, share, notify, ask
  • Always include project context and relevant design artifacts
  • Tag messages with topics AND components for maximum searchability
  • When sharing visual work, include screenshots as attachments
  • Check Design Space before asking questions that might already be answered