Provides context for working on this repository:
- Repository structure overview
- Skill development guidelines
- Anthropic specification requirements
- Common development commands
- Key files reference
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Configure header_pages to limit navbar to essential items
- Add custom CSS for better navbar styling with hover effects
- Shorten page titles for cleaner navigation display
- Add mobile menu improvements with dropdown styling
- Match navbar accent color to hero section gradient
Add custom SCSS styling to enhance the hero section appearance:
- Add purple gradient background to hero section with centered white text
- Apply proper styling to attribution box with blue accent border
- Convert documentation grid to use CSS classes for consistent card styling
- Add styled CTA button at page bottom
- Improve table styling and hover effects
Replace inline styles with CSS classes for better maintainability.
Jekyll's kramdown parser doesn't process markdown inside HTML block
elements by default. This caused bold text, links, and headings inside
<div> tags to render as literal escaped characters instead of formatted
content.
Added markdown="1" attribute to all div elements containing markdown
content in the documentation files.
Add complete documentation for BMAD Method for Claude Code:
- Jekyll configuration with SEO optimization
- Main landing page with BMAD-Method attribution
- Getting started guide with installation examples
- Skills reference with detailed examples for all 9 skills
- Commands reference with usage examples for all 15 commands
- Real-world workflow examples (E-commerce API, CLI tool, etc.)
- Configuration guide for global and project settings
- Troubleshooting guide with common issues and solutions
Documentation includes in-depth examples showing how to:
- Initialize and configure BMAD projects
- Use each skill (Analyst, PM, Architect, Developer, etc.)
- Run workflow commands through all 4 phases
- Create custom agents and workflows
- Conduct brainstorming and research sessions
Credits BMAD-Method original creators and clarifies this is a
Claude Code native conversion.
Fixed "Write-Success is not recognized" error occurring in WSL PowerShell
environments by making all functions globally scoped.
Changes:
- Added 'global:' scope to all 18 functions in install-v6.ps1
- Updated version from 6.0.2 to 6.0.3
- Updated documentation with fix details
- Ensures compatibility with PowerShell in WSL environments
The scoping issue prevented helper functions (Write-Success, Write-Info,
Write-ErrorMsg, Write-Header) from being accessible when called from
within other functions in WSL PowerShell contexts.
The Bash installer (install-v6.sh) had the same issue as the PowerShell
installer - it was not installing the 15 workflow slash commands.
## Problem
- Commands directory (bmad-v6/commands/) contains 15 .md files
- Bash installer was only installing skills, config, templates, and utils
- Commands were never copied to ~/.claude/commands/bmad/
- Linux/macOS/WSL users couldn't use /workflow-init, /prd, etc.
## Solution
Added install_commands() function and integrated it into the Bash installer,
matching the PowerShell installer functionality.
## Changes
**install-v6.sh:**
- Added BMAD_COMMANDS_DIR variable
- Added install_commands() function
- Updated create_directories() to create commands directory
- Updated verify_installation() to check for commands
- Updated print_next_steps() to list all 15 commands
- Updated version to 6.0.2
- Added verification command examples
## Commands Installed
All 15 workflow commands now installed to ~/.claude/commands/bmad/:
- /workflow-init, /workflow-status
- /product-brief, /prd, /tech-spec
- /architecture, /solutioning-gate-check
- /sprint-planning, /create-story, /dev-story
- /brainstorm, /research
- /create-agent, /create-workflow, /create-ux-design
## Consistency
Bash installer now matches PowerShell installer:
- Both install to same directories
- Both install same 15 commands
- Both verify commands installed
- Both show same success message
Version: 6.0.2
Platform: Linux/macOS/WSL
PowerShell 5.1 on Windows has encoding issues with UTF-8 files
containing Unicode characters, causing function definitions to fail.
Replaced all Unicode characters with ASCII equivalents:
- ℹ → [INFO]
- ✓ → [OK]
- ✗ → [X]
- ═ → =
- 📦📋📚1️⃣2️⃣3️⃣4️⃣ → Text/numbers
This resolves the "Write-Success is not recognized" error on
Windows PowerShell 5.1 while maintaining full functionality.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Applied Context7 PowerShell best practices for professional UX:
- [CmdletBinding()] for advanced script features
- Comment-based help with .SYNOPSIS, .DESCRIPTION, .EXAMPLE
- Write-Progress indicators at each installation step (0-100%)
- Write-Verbose statements throughout for diagnostics
- Try-catch blocks in all functions for proper error handling
- Professional error messages with recovery suggestions
Users can now run:
- `.\install-v6.ps1` for standard installation
- `.\install-v6.ps1 -Verbose` for detailed diagnostics
- `Get-Help .\install-v6.ps1` for documentation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Removed internal planning/development documents:
- BMAD-V6-COMPLETE.md (internal phases 1-5 working doc)
- PERSONA-REFACTOR-COMPLETE.md (internal refactor notes)
- PHASES-6-8-COMPLETE.md (internal phases 6-8 working doc)
These are internal working documents, not public documentation.
They remain locally for reference but are now gitignored.
Public documentation (maintained):
- README.md - Complete user-facing documentation
- CONTRIBUTING.md - Standard GitHub contributing guide
This keeps the public repo clean and professional.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Added development/working documents to .gitignore:
- BMAD-V6-CLAUDE-CODE-TRANSITION-PLAN.md (internal planning)
- PHASE-*-COMPLETE.md (phase-by-phase working docs)
- reference/ (reference materials)
These are internal working documents created during development.
Official documentation (committed and maintained):
- README.md - Main documentation
- BMAD-V6-COMPLETE.md - Phases 1-5 complete documentation
- PHASES-6-8-COMPLETE.md - Phases 6-8 complete documentation
- PERSONA-REFACTOR-COMPLETE.md - Token optimization details
This keeps the repository clean while allowing local reference files.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Problem:
- Windows 10/11 ship with PowerShell 5.1 by default
- PowerShell 5.1 only accepts 2 arguments to Join-Path
- PowerShell 6+ added support for multiple path segments
- Script was using PowerShell 6+ syntax, breaking on PowerShell 5.1
Solution:
- Added PowerShell version detection ($PSVersionTable.PSVersion.Major)
- Created Join-PathCompat helper function:
- PowerShell 5.1: chains Join-Path calls sequentially
- PowerShell 6+: uses native multiple-argument support
- Updated path construction to use Join-PathCompat
- Added version detection output (shows "compatibility mode" for PS 5.1)
Changes:
- Lines 28-36: Version detection and user feedback
- Lines 42-71: Join-PathCompat compatibility helper
- Lines 87-88: Use Join-PathCompat for multi-segment paths
Tested Compatibility:
- PowerShell 5.1 (Windows default): ✅ Now supported
- PowerShell 7+ (Core): ✅ Still supported
- Cross-platform: ✅ Works on Windows, Linux, macOS
Fixes: "Join-Path : A positional parameter cannot be found that accepts
argument 'bmad'" error on Windows PowerShell 5.1
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Add comprehensive support for Windows PowerShell, macOS, Linux, and WSL environments:
- Create install.ps1 PowerShell installation script for Windows users
- Update README.md with platform-specific installation instructions
- Add platform detection guide for LLMs to auto-detect user environment
- Include troubleshooting sections for each platform
- Document platform-specific paths and commands
This enables BMAD Skills installation on all major platforms where Claude Code runs.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Removed files that were session notes, not part of the product:
- BMAD-SYSTEM-DEPLOYMENT-GUIDE.md (session summary)
- COMPLETE-SYSTEM-SUMMARY.md (session summary)
- GITHUB-SETUP.md (publishing instructions)
- PUBLISHED.md (publishing notes)
Repository now contains only the BMAD skills system itself.
- Add comprehensive GITHUB-SETUP.md with step-by-step instructions
- Enhance .gitignore for public repository
- Cover OS, editor, build artifacts, test files
- Ready for public publication
BMAD Skills for Claude Code - v1.0.0
This repository provides a comprehensive implementation of the BMAD Method
for Claude Code using native Claude Code features.
Features:
- 7 comprehensive skills (BMAD, security, Python, JS/TS, DevOps, testing, Git)
- 5 slash commands (/bmad-init, /bmad-prd, /bmad-arch, /bmad-story, /bmad-assess)
- Memory integration for context preservation
- Auto-detection and intelligent suggestions
- Todo tracking for stories
- Hooks for project-level automation
- One-command installation
Credits:
- BMAD Method™ by BMAD Code Organization
- Implementation for Claude Code by contributors
All BMAD methodology credit belongs to the BMAD Code Organization.
See: https://github.com/bmad-code-org/BMAD-METHOD
Alex Ant