{
  "markdown": "# BMAD Skills: Your AI Product Team\n\n[![Tests](https://github.com/bacoco/bmad-skills/workflows/Tests/badge.svg)](https://github.com/bacoco/bmad-skills/actions/workflows/test.yml)\n[![Release](https://github.com/bacoco/bmad-skills/workflows/Release/badge.svg)](https://github.com/bacoco/bmad-skills/actions/workflows/release.yml)\n[![Coverage](https://img.shields.io/badge/coverage-62%25-yellow.svg)](htmlcov/index.html)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n**Transform ideas into shipped products through natural conversation with Claude.**\n\nFrom \"I have an idea...\" to production-ready code, BMAD guides you through research, planning, design, architecture, testing, and implementation—automatically.\n\n---\n\n## 💡 What is BMAD?\n\nImagine having a complete product team that activates instantly when you need them:\n\n```\nYou: \"I have an idea for a budget tracking app\"\n\nClaude (analyst): \"Great! Let's explore this together. What problems are your users facing\n                  with current budgeting tools?\"\n\n[30 minutes of brainstorming later...]\n\nYou: \"Create a PRD for this\"\n\nClaude (PM): \"I'll create a comprehensive PRD. Based on our discussion, here are the\n              core features...\"\n              📄 Generates: product-requirements-document.md\n\nYou: \"What should the UI look like?\"\n\nClaude (UX): \"Let me design the user flows and wireframes...\"\n             🎨 Generates: user-flows.md, wireframes.md\n\nYou: \"How should we build this?\"\n\nClaude (architect): \"Here's the technical architecture...\"\n                    🏗️ Generates: architecture-decisions.md\n\nYou: \"Break this into stories\"\n\nClaude (stories): \"I've created 12 developer-ready stories with acceptance criteria...\"\n                  📋 Generates: 12 story files\n\nYou: \"Implement story 1\"\n\nClaude (dev): \"Implementing authentication system with tests...\"\n              💻 Generates: working code + tests\n```\n\n**All through natural conversation. No commands. No manual switching. Just talk.**\n\n---\n\n## 🎯 Why BMAD?\n\n### The Problem\n\nBuilding products is complex:\n- ❌ Jumping between research, planning, design, and coding fragments your thinking\n- ❌ Missing steps leads to rework and technical debt\n- ❌ Context loss when switching between tasks\n- ❌ Documentation falls behind implementation\n- ❌ No consistent workflow across projects\n\n### The Solution\n\nBMAD is a complete workflow ecosystem that:\n- ✅ **Guides you through the right process** automatically based on your needs\n- ✅ **Maintains context** across all phases of development\n- ✅ **Generates documentation** as you go, not after the fact\n- ✅ **Adapts to project complexity** - lightweight for bugs, comprehensive for features\n- ✅ **Works through conversation** - no commands, no configuration\n\n---\n\n## 🚀 Real-World Examples\n\n### Example 1: Building a New Feature\n\n**Scenario:** You want to add social login to your app\n\n```\nYou: \"I want to add Google and GitHub login to my app\"\n\nClaude (orchestrator): \"This is a Level 2 feature. Let me activate the right skills...\"\n\nClaude (analyst): \"Let's research OAuth best practices and security requirements...\"\n                  [Researches, documents findings]\n\nClaude (architecture): \"Here's how we'll integrate OAuth securely...\"\n                       [Designs auth flow, token management, security]\n\nClaude (tea): \"Here's the test strategy for authentication...\"\n              [Defines test scenarios, security tests, edge cases]\n\nClaude (stories): \"I've broken this into 4 stories:\n                   1. OAuth provider setup\n                   2. Login flow implementation\n                   3. Token management\n                   4. Security hardening\"\n\nYou: \"Implement story 1\"\n\nClaude (dev): \"Setting up OAuth providers...\"\n              [Writes code, tests, documentation]\n```\n\n**Result:** Production-ready feature with architecture docs, test coverage, and security best practices baked in.\n\n### Example 2: Quick Bug Fix\n\n**Scenario:** Login timeout is too short\n\n```\nYou: \"Fix the login timeout - users are getting logged out too quickly\"\n\nClaude (openspec-change-proposal): \"I'll create a lightweight proposal for this Level 0 change...\"\n                           📄 proposal.md: Increase session timeout from 15min to 60min\n                           ✅ tasks.md: Update config, test, document\n\nYou: \"Implement it\"\n\nClaude (openspec-change-implementation): \"Updating session timeout configuration...\"\n                             [Makes change, tests, logs execution]\n\nYou: \"Archive this\"\n\nClaude (openspec-change-closure): \"Documented and archived. Session timeout fix is complete.\"\n```\n\n**Result:** Quick fix with full traceability - no ceremony, just results.\n\n### Example 3: Exploring a New Idea\n\n**Scenario:** You have a vague idea for an app\n\n```\nYou: \"I'm thinking about an app for freelancers to manage their time and invoicing\"\n\nClaude (analyst): \"Interesting! Let's explore this together:\n                   - Who are your target users?\n                   - What pain points are they facing?\n                   - What's different from existing tools like Harvest or Toggl?\"\n\n[Conversation continues - Claude asks smart questions, researches competitors,\n identifies opportunities, documents insights]\n\nClaude: \"I've documented our findings in discovery-notes.md.\n         Key insight: Freelancers want integrated time tracking + invoicing +\n         project management. Current tools require 3 separate subscriptions.\n\n         Ready to create a PRD?\"\n\nYou: \"Yes\"\n\nClaude (pm): \"Creating comprehensive PRD...\"\n```\n\n**Result:** Clear product direction validated through research before writing a single line of code.\n\n---\n\n## ✨ Key Features\n\n### 🎭 16 Specialized Skills, One Seamless Experience\n\n**BMAD Workflow (11 skills):**\n- 💡 **Analyst** - Brainstorming, research, competitive analysis\n- 📋 **PM** - PRD creation, feature planning, roadmapping\n- 🎨 **UX** - User flows, wireframes, design systems\n- 🏗️ **Architecture** - Technical design, decision documentation\n- 🧪 **TEA** - Test strategy, ATDD scenarios, quality gates\n- 🚀 **Performance** - Bottleneck analysis, load planning, optimization roadmaps\n- 📈 **Observability** - Instrumentation strategy, metrics/alert design, telemetry governance\n- 🔐 **Security** - Threat modeling, remediation planning, compliance alignment\n- 📝 **Stories** - Developer-ready story breakdown\n- 💻 **Dev** - Implementation with tests and documentation\n- 🎯 **Orchestrator** - Workflow coordination and guidance\n\n**OpenSpec (3 skills):**\n- 📄 **Propose** - Lightweight change proposals\n- ⚡ **Implement** - Quick implementations\n- 📦 **Archive** - Change documentation and closing\n\n**Operations:**\n- ⚙️ **TaskMaster MCP Bootstrap** - Provision and align the TaskMaster MCP server with BMAD hooks\n\n**Skill Creator:**\n- 🛠️ **Create Skills** - Build custom skills for your workflow\n\n### 🛡️ Operational Excellence Additions\n\nPerformance, observability, and security are first-class phases in BMAD. The new skills activate immediately after test strategy so delivery teams close critical gaps before story planning:\n\n- **bmad-performance-optimization** — synthesizes telemetry, builds benchmark plans, and prioritizes optimizations.\n- **bmad-observability-readiness** — designs metrics, logging, tracing, dashboards, and alerting to eliminate blind spots.\n- **bmad-security-review** — runs threat modeling, gap assessments, and remediation planning tied to compliance standards.\n\n### 🧠 Intelligent Workflow Routing\n\nBMAD automatically chooses the right approach based on complexity:\n\n| Complexity | Example | Workflow | Skills Used |\n|-----------|---------|----------|-------------|\n| **Level 0** | Config change | OpenSpec | 3 skills |\n| **Level 1** | Small feature | OpenSpec | 3 skills |\n| **Level 2** | Medium feature | BMAD | 5-7 skills |\n| **Level 3** | New product area | BMAD | All 8 skills |\n| **Level 4** | Novel innovation | BMAD | All 8 skills + research |\n\n### 💬 Conversational Activation\n\nNo commands to remember. Just talk naturally:\n\n| You Say | Skill Activated | What Happens |\n|---------|----------------|--------------|\n| \"I have an idea...\" | Analyst | Brainstorming session |\n| \"Create a PRD\" | PM | Requirement document |\n| \"Design the UX\" | UX | User flows + wireframes |\n| \"How should we build this?\" | Architecture | Technical design |\n| \"How should we test this?\" | TEA | Test strategy |\n| \"Break into stories\" | Stories | Developer tasks |\n| \"Implement story X\" | Dev | Code + tests |\n| \"Fix this bug\" | OpenSpec | Quick fix workflow |\n| \"What's next?\" | Orchestrator | Status + guidance |\n\n### 📊 Full Traceability\n\nEvery decision, every change, fully documented:\n\n```\nproject/\n├── docs/\n│   ├── discovery/              # Research & brainstorming\n│   ├── requirements/           # PRD & feature specs\n│   ├── design/                 # UX flows & wireframes\n│   ├── architecture/           # Technical decisions\n│   ├── testing/                # Test strategy\n│   └── stories/                # Implementation stories\n├── .claude/skills/_runtime/\n│   └── workspace/\n│       ├── changes/            # OpenSpec proposals\n│       └── specs/              # Living specifications\n└── [your code]\n```\n\n---\n\n## 🎬 How It Works\n\n### 1. Natural Conversation\n\nYou talk to Claude naturally about what you want to build or fix. No special syntax, no commands.\n\n### 2. Automatic Skill Activation\n\nClaude detects your intent and activates the right skill:\n- **Idea exploration** → Analyst\n- **Planning** → PM\n- **Design** → UX\n- **Technical questions** → Architecture\n- **Implementation** → Dev\n\n### 3. Context-Aware Guidance\n\nEach skill knows:\n- What came before (maintains full context)\n- What needs to happen next (guides your workflow)\n- What artifacts to create (generates documentation)\n- When to hand off (seamless transitions)\n\n### 4. Progressive Complexity\n\nStart simple, scale as needed:\n- Quick fixes use OpenSpec (3 skills, 5 minutes)\n- Features use BMAD (8 skills, guided process)\n- New products use full workflow (end-to-end)\n\n---\n\n## 🏆 Benefits\n\n### For Solo Developers\n- ✅ Get the structure and discipline of a full team\n- ✅ Don't skip important steps (architecture, testing, documentation)\n- ✅ Ship higher quality features faster\n- ✅ Build a portfolio of well-documented projects\n\n### For Teams\n- ✅ Consistent workflow across all developers\n- ✅ Better handoffs with complete documentation\n- ✅ Faster onboarding (workflow is built-in)\n- ✅ Scalable process from bugs to features\n\n### For Founders\n- ✅ Validate ideas before coding (analyst + PM)\n- ✅ Make better technical decisions (architecture)\n- ✅ Ship with confidence (test strategy)\n- ✅ Move fast without breaking things (quality gates)\n\n---\n\n## 📦 What's Included\n\n**Complete self-contained bundle:**\n- 16 specialized AI skills that work together\n- Shared glossary, constraints, and quality standards\n- Runtime workspace for proposals and specs\n- Comprehensive guides and troubleshooting docs\n- Activation metrics and monitoring tools\n\n**Everything works out of the box.** No configuration needed.\n\n---\n\n## 🚀 Get Started\n\n### Install (2 minutes)\n\n**Option 1: NPM/npx (Recommended)**\n\n```bash\n# Install globally\nnpx bmad-skills --global\n\n# Or install to current project\nnpx bmad-skills\n\n# Or install to custom path\nnpx bmad-skills --path /your/custom/path\n```\n\n**Option 2: Direct script**\n\n```bash\n# Install globally\ncurl -fsSL https://raw.githubusercontent.com/bacoco/bmad-skills/main/scripts/install-to-home.sh | bash\n\n# Or manually\ngit clone https://github.com/bacoco/bmad-skills.git\ncd bmad-skills\nbash scripts/install.sh\n```\n\n### Start Building\n\n```bash\n# Open Claude Code and just start talking:\n\"I have an idea for a meditation timer app\"\n```\n\nThat's it. BMAD takes it from there.\n\n---\n\n## 📚 Learn More\n\n- 🚀 **[Quickstart Guide](.claude/skills/_docs/guides/quickstart-conversational.md)** - Get started in 5 minutes\n- 📖 **[Conversational Flow Examples](.claude/skills/_docs/guides/conversational-flow.md)** - 6 complete scenarios\n- 🔧 **[Skills Reference](.claude/skills/_docs/reference/skills.md)** - Detailed skill documentation\n- ❓ **[FAQ](.claude/skills/_docs/activation/activation-faq.md)** - Common questions answered\n\n---\n\n## 🤝 Contributing\n\nBMAD is open source and welcomes contributions:\n\n1. Follow the [Style Guide](.claude/skills/_config/STYLE-GUIDE.md)\n2. Run tests: `bash scripts/verify.sh`\n3. Submit PRs with clear descriptions\n\nSee [Contributing Guidelines](.claude/skills/_docs/guides/contributing.md) for details.\n\n### 🛠️ Development Setup\n\nTo contribute to BMAD, set up your local development environment:\n\n```bash\n# Clone the repository\ngit clone https://github.com/bacoco/bmad-skills.git\ncd bmad-skills\n\n# Install all dependencies (Python + Node)\nmake install\n\n# Or install manually:\npip3 install -r requirements.txt\nnpm install\n```\n\n**Available Commands:**\n\n```bash\n# Testing\nmake test              # Run unit and integration tests\nmake test-unit         # Run unit tests only\n\n# Quality\nmake lint              # Lint skill contracts\nmake validate          # Validate all skills\n\n# Utilities\nmake clean             # Remove temporary files and caches\nmake help              # Show all available commands\n```\n\n**Requirements:**\n- Python 3.9+\n- Node.js 14+\n\n**Running Tests:**\n\n```bash\n# Quick validation (recommended for development)\nmake test\n\n# Full integration suite\npytest tests/integration/ -v\n\n# Run specific test file\npytest tests/integration/test_cli_install.py -v\n\n# Validate CLI installation manually\nnode bin/cli.js --path /tmp/test-install\n\n# Conversational regression (manual)\nFollow tests/WHY_NO_E2E_TESTS.md for the documented checklist\n```\n\n**Test Structure:**\n- `tests/unit/` - Unit tests for Python modules\n- `tests/integration/` - CLI and workflow integration tests\n- `tests/test_*.py` - Static validation tests (metadata, templates)\n- Manual conversational QA flow described in `tests/WHY_NO_E2E_TESTS.md`\n\n---\n\n## 📄 License\n\nMIT License - See [LICENSE](.claude/skills/_config/LICENSE.md)\n\n---\n\n## 🆘 Support\n\n- 📖 [Documentation](.claude/skills/_docs/)\n- 🐛 [Report Issues](https://github.com/bacoco/bmad-skills/issues)\n- 💬 [Discussions](https://github.com/bacoco/bmad-skills/discussions)\n- 🌟 [Star on GitHub](https://github.com/bacoco/bmad-skills)\n\n---\n\n<div align=\"center\">\n\n**Stop context-switching. Start shipping.**\n\n[Get Started →](#-get-started) | [See Examples →](#-real-world-examples) | [Learn More →](#-learn-more)\n\n</div>\n",
  "bytes": 14446,
  "sha": "643074af2c470a822eacb6ac9048d6ff5fdb39fd4172e20dd0934c26e3fdda67",
  "repo_slug": "bacoco/bmad-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_bacoco_bmad_skills_claude_skills_bmad_di_2f61aa1c/readme"
}