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.