Setting Up Windsurf

[dogank85]

Dear Mr. Bmad,

Thank you for sharing your valuable knowledge with us.

I’ve been trying to set up the BMAD project on Windsurf, but I couldn’t quite figure out the steps. If anyone in the community could guide me—preferably with some images or a visual walkthrough—I’d greatly appreciate it.

Please note: I’m completely new to coding, so I apologize in advance for any misunderstandings or basic questions.

Best regards,
Dogan

[Habdel-Edenfield]

Up

[zisisp]

Hello I'm on the same boat. it looks like windsurf as of right now (don't know for the future) doesn't support custom agents.
So you can't add the bmad agents in the ai. you are stuck with the provided ones.
btw I have tried the free and gpt 4.1 and they are not that good. I only got some progress with the claude 3.7 (1.25) agent.
the others were not able to resolve the issues

OK I'll and provide an alternative to creating an agent for windsurf. I guess you can start a new dialogue and provide the agent file and the epic file and tell it to do it....
If there is enough interest I can post it here

[mr-smith]

You can try using a workflow. These seem to be per project customizations so you'll have to have a project open. In the top right corner of Cascade, there's an icon that looks like an open book which opens the customization window. Create a new workflow by giving it a name (like "dev"). This should open a markdown file inside ".windsurf\workflows". Add a description and paste the prompt in the content portion. To use a workflow you just type /{name} in the cascade prompt.

[zisisp]

1. In the top right corner of Cascade, there's an icon that looks like an open book which opens the customization window
   

2. Create a new workflow by giving it a name (like "dev"
   

3.This should open a markdown file inside ".windsurf\workflows". Add a description and paste the prompt in the content portio

4. To use a workflow you just type /{name} in the cascade prompt.
   

[bmadcode]

I think for now workflow is the way, or just use the tasks for creating the story, and then rules to drive the dev. The whole bmad method one way or another I was doing with rules and saved prompts before custom modes in cursor.

…

On Fri, May 30, 2025, 2:14 PM mr-smith ***@***.***> wrote: You can try using a workflow. These seem to be per project customizations so you'll have to have a project open. In the top right corner of Cascade, there's an icon that looks like an open book which opens the customization window. Create a new workflow by giving it a name (like "dev"). This should open a markdown file inside ".windsurf\workflows". Add a description and paste the prompt in the content portion. To use a workflow you just type /{name} in the cascade prompt. — Reply to this email directly, view it on GitHub <#123 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BOTVGQLDPMAWI2QJRK7H7F33BCU2PAVCNFSM6AAAAAB6FVKVNWVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGMZSGQ3DQNQ> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.*** com>

[dogank85]

Thank you so much to all. Mr Bmad do u have a paypall account. I would like
to buy you a beer.

[rogerfiske]

WOW!
I really think an MCP would be the way to go. I am really struggling trying to get the BMAD stuff into Windsurf.

[fabb]

You could try this experimental project: https://github.com/fuchsst/bmap_mcp

[Whirlywack]

@bmadcode mcp sounds like a level up! Would love to plug it into claude code too!

[bmadcode]

I'm down for adding an MCP server with the updates that are rolling out soon, will release an official one soon. Find it odd that ppl are creating separate MCP projects instead of proposing a PR to add one based on nodeJS - if no one does ill eventually get to it. but some higher priority QoL improvements and standardizations I am trying to get in first this weekend.

[fabb]

I’ve created a discussion about a BMAD MCP server: #179