Skip to content
🤖 Consolidated, AI-optimized GOMAD docs: llms-full.txt. Fetch this plain text file for complete context.
🚀 Build your own GoMad modules and share them with the community! Get started or submit to the marketplace.
GoMad

GoMad

GoMad is an agentic workflow framework for AI-driven agile development. It ships eight opinionated agent personas, a library of composable skills, and an installer that lays them into your AI IDE so you can drive a structured Analysis → Planning → Solutioning → Implementation cycle without hand-rolling prompts.

What is GoMad?

Section titled “What is GoMad?”

GoMad is a lean, properly-credited hard fork of BMAD Method that we own end-to-end. It distills the four-phase agile workflow into a small, predictable surface: each phase has a small set of gm-* skills, agents invoke those skills, and the installer copies them into the directories your IDE already reads.

Eight gm-agent-* personas cover the recurring roles in software delivery — analyst, tech-writer, pm, ux-designer, architect, scrum-master, dev, and solo-dev. They are invoked from your IDE as /gm:agent-* slash commands and load their persona body from your install root at runtime.

GoMad is published on npm as @xgent-ai/gomad and adds zero new runtime dependencies on top of BMAD’s original stack. The installer is copy-only with manifest-driven upgrade cleanup, --dry-run previews, and timestamped backup snapshots.

Get started

Section titled “Get started”

The fastest path is the install tutorial, which walks through running the interactive installer and pointing it at your project.

  • Install GoMad — End-to-end installation walkthrough.
  • Quick start — Run your first GoMad workflow once GoMad is installed.

Browse the docs

Section titled “Browse the docs”

The docs follow the Diataxis structure. Pick the section that matches what you are trying to do.

  • Agents reference — Catalog of the eight gm-agent-* personas and how to invoke them.
  • Skills reference — Catalog of the gm-* skills each agent can invoke.
  • Architecture — How agents, skills, and the installer fit together.
  • Contributing — Sending changes back to the GoMad repo.

Project status

Section titled “Project status”

GoMad is on the v1.3 milestone (docs site, story-context skill, agent-directory relocation). Earlier v1.1 and v1.2 milestones are shipped on npm.

Credits

Section titled “Credits”

GoMad is a hard fork of BMAD Method, MIT-licensed by Brian (BMad) Madison. The full attribution and the canonical non-affiliation disclaimer live in the repository LICENSE and README.