bmad-commands

Execute BMAD file I/O and test commands with JSON I/O and telemetry.

2|2|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill bmad-commands
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-commands
Source: https://github.com/adolfoaranaes12/BMAD-ENHANCED/tree/main/.claude/skills/bmad-commands
Command: npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill bmad-commands

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Atomic command primitives for BMAD operations. Provides type-safe wrappers around file operations and test execution with structured JSON I/O and built-in telemetry.

Core Features & Use Cases

  • Atomic commands like read_file, run_tests, generate_architecture_diagram, analyze_tech_stack, extract_adrs, validate_patterns
  • Telemetry and deterministic behavior for reproducible workflows
  • Extensible adapters and framework registry to support additional frameworks

Quick Start

Example: python .claude/skills/bmad-commands/scripts/read_file.py --path workspace/tasks/task-001.md --output json

Frequently Asked Questions about bmad-commands

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

FAQPage Schema
How do I run deterministic tests with structured JSON output and telemetry?

bmad-commands provides atomic test execution primitives that wrap framework-agnostic test runners with built-in telemetry and deterministic JSON I/O. Use the run_tests command with pluggable adapters to execute tests reproducibly across different frameworks while capturing structured results and performance data.

Can I automate file operations and test execution in BMAD workflows?

Yes. bmad-commands exposes atomic commands like read_file and run_tests that handle file I/O and test automation with strict type-safe inputs and outputs. These commands integrate into BMAD workflows for architecture analysis, ADR extraction, and diagram generation with framework-agnostic adapter support.

What's the best way to extract architecture diagrams and analyze tech stacks deterministically?

Use bmad-commands' generate_architecture_diagram and analyze_tech_stack primitives. These commands apply pluggable adapters across BMAD workflows to produce deterministic, reproducible outputs with built-in telemetry and structured error reporting for architecture analysis and ADR extraction.

How do I validate patterns and configure adapters for different frameworks?

bmad-commands includes validate_patterns and a config-driven adapter registry. Configure adapters in YAML to support multiple frameworks, then invoke commands via CLI with JSON parameters. This satisfies requirements for deterministic outputs, typed inputs/outputs, and extensible framework support.

Does bmad-commands work with multiple test frameworks and file formats?

Yes. The framework registry and pluggable adapters support multiple test frameworks and file operations. Define adapters in YAML configuration to extend support for additional frameworks while maintaining deterministic behavior, strict JSON I/O, and telemetry across all operations.

What dependencies do I need to run bmad-commands?

bmad-commands requires PyYAML for configuration management. This dependency enables the config-driven adapter registry and YAML-based framework configuration. Install via standard package managers before using command primitives for file operations, test execution, and architecture analysis.