bmad-init

Detect project stacks and initialize BMAD pipeline state files.

3|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/ForgePlan/marketplace --skill bmad-init-forgeplan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-init
Source: https://github.com/ForgePlan/marketplace/tree/main/plugins/agents-bmad/skills/bmad-init
Command: npx skills add https://github.com/ForgePlan/marketplace --skill bmad-init-forgeplan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the one-time setup for the BMAD pipeline, detecting and configuring the project's stack and initializing the per-branch state file, ensuring the BMAD gate can enforce coding standards.

Core Features & Use Cases

  • Stack Detection: Automatically detects the project's stack based on language-specific markers.
  • Stack Configuration: Optionally reconciles with a stack-ADR for user-defined overrides.
  • State Initialization: Initializes the per-branch state file for the BMAD pipeline.
  • Use Case: Run this Skill before the first BMAD cycle to set up the necessary configuration files for code enforcement.

Quick Start

Execute the command /bmad init to detect and configure the BMAD stack for your project.

Frequently Asked Questions about bmad-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate project configuration and stack detection for a new coding pipeline?

Automating project configuration and stack detection is handled by identifying language-specific markers like pyproject.toml or package.json to configure your stack and initialize the pipeline state file. This ensures coding standards are enforced automatically.

What is a BMAD pipeline and when do I need to initialize it?

A BMAD pipeline is a code enforcement mechanism that enforces coding standards through a gate. You need to initialize it before your first development cycle to set up the necessary per-branch state files and stack configuration.

How do I set up coding standards enforcement using language-specific markers?

Setting up coding standards enforcement involves detecting your project's language markers, such as go.mod or Cargo.toml, to automatically configure the stack and enable the BMAD gate to enforce your defined coding standards.

Can I override automatic stack detection with a custom configuration?

You can override automatic stack detection by providing a stack-ADR file. The pipeline reconciles the detected stack from language markers with your user-defined overrides in the ADR to finalize the project configuration.

Does the BMAD pipeline setup work with my existing Java or Ruby project?

BMAD pipeline setup works with Java and Ruby projects if they contain the required language-specific markers, specifically pom.xml for Java or Gemfile for Ruby, allowing proper stack detection and configuration.

Why does my BMAD pipeline initialization fail to detect the project stack?

BMAD pipeline initialization fails to detect the project stack when the required language-specific markers, such as composer.json or pyproject.toml, are missing from your project directory.