ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/docs/how-to/monorepo-setup.md

1.6 KiB
Raw Blame History

title description sidebar
Monorepo / Multi-Project Setup Run multiple independent projects within a single BMAD installation
order
8

Monorepo / Multi-Project Setup

BMAD supports running multiple independent projects within a single installation. This is useful for monorepos, multi-app repositories, or any workspace where you want isolated artifact directories per project.

How It Works

A .current_project file in your _bmad/ directory stores the active project name. When set, all artifact output paths are redirected to project-specific subdirectories.

Quick Start

  1. List existing projects by invoking skill:bmad-project-list
  2. Create a new project by invoking skill:bmad-project-new with a project name
  3. Switch to an existing project by invoking skill:bmad-project-switch with a project name
  4. Clear project context by invoking skill:bmad-project-switch and entering CLEAR

Directory Structure

When a project context is active, for example my-app:

  • _bmad-output/my-app/planning-artifacts/ for PRDs, briefs, UX designs
  • _bmad-output/my-app/implementation-artifacts/ for sprint plans and stories
  • _bmad-output/my-app/knowledge/ for long-term project knowledge

Inline Overrides

Temporarily target a different project without changing the global context:

  • #project:my-app
  • #p:my-app

Precedence:

  1. Inline override (#p:NAME) — highest priority
  2. Global context file (.current_project)
  3. Default config paths

Security

  • Path traversal (..) is rejected
  • Absolute paths are rejected
  • Only alphanumeric characters, dots, dashes, underscores, and forward slashes are allowed