I built an AI methodology framework that gives n8n teams 15 agent personas — from PRD to production in 5 commands

Built with n8n
1

Hey everyone :waving_hand:

I’ve been building n8n workflows professionally for a while now, and one thing that kept bugging me was the lack of structured methodology around how we develop workflows. We have amazing tools for building them, but the process of going from “I need an automation” to “here’s a production-ready, well-documented workflow” was always messy — scattered docs, inconsistent naming, no architecture decisions recorded, error handling bolted on as an afterthought.

So I built n8n-BMAD — an AI-powered methodology framework that brings 15 specialized agent personas to your n8n development process. Think of it as having a full agile team (product owner, architect, developer, QA, devops, etc.) that actually understands n8n’s expression syntax, node ecosystem, and workflow patterns.

What it does

The core idea is simple — 5 commands take you from idea to production:

/n8n:pm *create-prd          → Product Manager creates your requirements
/n8n:arch *create-architecture → Architect designs the solution
/n8n:po *create-story         → Product Owner breaks it into stories
/n8n:dev *dev-story            → Developer implements the workflow
/n8n:qa *code-review           → QA reviews before shipping

But there’s a lot more under the hood:

  • 15 AI agent personas — each with deep n8n domain knowledge (PM, Architect, Developer, QA, DevOps, Security, Integration Specialist, Data Analyst, Prompt Engineer, and more)

  • Scale-adaptive intelligence — auto-adjusts ceremony based on your project’s complexity. Building a quick webhook? It stays lightweight. Enterprise integration? Full ceremony kicks in.

  • 37 document templates — PRDs, ADRs, runbooks, test plans, workflow specs, all tailored for n8n projects

  • Ready-to-use workflow patterns — error handling (retry with backoff, circuit breaker, DLQ), integration patterns (API orchestration, webhook receiver), data transformation (batch processing, pagination)

  • Party Mode — bring multiple agents into one session for complex decisions

  • Quick Flow — lightweight solo-developer mode when you just want to ship fast

Claude Code + MCP Integration

This part I’m especially excited about. When you run n8n-bmad init, it automatically generates:

  • Claude Code slash commands — /n8n-dev, /n8n-architect, /n8n-qa, etc. directly in your IDE

  • MCP configuration — connects your AI assistant directly to your n8n instance’s API so agents can discover your installed nodes, inspect workflows, and understand your setup

So you can literally open Claude Code, type /n8n-dev, and have an AI developer that knows n8n inside and out helping you implement your workflow.

Getting started

bash

npm install -g n8n-bmad
n8n-bmad init

It walks you through setup interactively — asks for your n8n instance URL and API key, creates the project structure, and generates the Claude Code commands.

ScreenRecording2026-02-07at3.09.08PM-ezgif.com-video-to-gif-converter

What I’d love feedback on

This is early days and I’d really appreciate input from the community:

  • Which workflow patterns would be most useful to add? I’ve started with error handling, integration, data transformation, and scheduling — but I’m sure there are common patterns I’m missing.

  • Which agent personas resonate most? Curious which roles people would actually use vs. which feel like overkill.

  • Solo dev vs. team use — are you mostly building workflows alone or in a team? That’ll help me prioritize Quick Flow vs. the full agile ceremony.

GitHub: https://github.com/crystalmyth/n8n-bmad npm: https://www.npmjs.com/package/n8n-bmad

Happy to answer any questions! And if you try it out, I’d love to hear how it goes.

1 Like
2

That sounds pretty amazing! I’m not sure if I’m skilled enough to try this out, but I’ll try!

1 Like