ldy26098
/
BMAD-METHOD
mirror of https://github.com/bmad-code-org/BMAD-METHOD.git
1
0
Fork 0
Code Packages Projects Releases Wiki Activity
BMAD-METHOD/.patch/745/IMPLEMENTATION-PLAN.md

6.1 KiB
Raw Blame History

PR #745 Implementation Plan

PR: Feat/claude code marketplace plugin Issue: N/A (Feature request) Status: Planning phase Branch: feature/claude-code-marketplace-plugin-745 Author: amdmax

📋 Issue Summary

Feature Request

Add BMAD as a Claude Code marketplace plugin to enable users to install BMAD directly from Claude Code's marketplace. This allows easier access to BMAD agents and workflows for Claude Code users.

Key Requirements

  • Claude Code marketplace plugin configuration
  • Support for BMAD core framework
  • Support for all 5 expansion packs:
    • Godot Game Dev
    • 2D Phaser Game Dev
    • 2D Unity Game Dev
    • Creative Writing
    • Infrastructure DevOps
  • Proper metadata and categorization
  • Agent and operation (task) definitions

🎯 Solution Overview

File to Create

  1. .claude-plugin/marketplace.json (307 lines)
    • Claude Code marketplace plugin manifest
    • Contains plugin metadata, owner info, agents, operations for each plugin
    • Includes BMAD core + 5 expansion packs

File Structure

The marketplace.json file contains:

Top-level Structure:

  • name: "bmad-method"
  • metadata: Plugin description
  • owner: Organization info
  • plugins: Array of 6 plugins (core + 5 expansions)

Each Plugin Contains:

  • name: Plugin identifier
  • source: Path to plugin files
  • description: User-friendly description
  • version: Plugin version
  • author: Creator info
  • homepage, repository, license: Reference URLs
  • agents: Array of agent file paths
  • operations: Array of operation/task file paths
  • keywords: Search keywords
  • category: Plugin category
  • tags: Classification tags
  • requires: Dependency list (for expansion packs)

📊 Plugins Included

1. bmad-core

Path: ./bmad-core Version: 4.44.0 Agents (10):

  • analyst.md
  • architect.md
  • bmad-master.md
  • bmad-orchestrator.md
  • dev.md
  • pm.md
  • po.md
  • qa.md
  • sm.md
  • ux-expert.md

Operations (21 tasks):

  • advanced-elicitation.md
  • apply-qa-fixes.md
  • brownfield-create-epic.md
  • brownfield-create-story.md
  • correct-course.md
  • create-brownfield-story.md
  • create-deep-research-prompt.md
  • create-next-story.md
  • document-project.md
  • facilitate-brainstorming-session.md
  • generate-ai-frontend-prompt.md
  • index-docs.md
  • kb-mode-interaction.md
  • nfr-assess.md
  • qa-gate.md
  • review-story.md
  • risk-profile.md
  • shard-doc.md
  • test-design.md
  • trace-requirements.md
  • validate-next-story.md

2. bmad-godot-game-dev

Path: ./expansion-packs/bmad-godot-game-dev Version: 1.0.0 Requires: bmad-core Agents (10 game development specialists) Operations (21 game-specific tasks)

3. bmad-2d-phaser-game-dev

Path: ./expansion-packs/bmad-2d-phaser-game-dev Version: 1.0.0 Requires: bmad-core Agents (3: game-designer, game-developer, game-sm) Operations (3 tasks)

4. bmad-2d-unity-game-dev

Path: ./expansion-packs/bmad-2d-unity-game-dev Version: 1.0.0 Requires: bmad-core Agents (4: game-architect, game-designer, game-developer, game-sm) Operations (5 tasks)

5. bmad-creative-writing

Path: ./expansion-packs/bmad-creative-writing Version: 1.1.1 Requires: bmad-core Agents (10 writing specialists) Operations (25 writing workflow tasks)

6. bmad-infrastructure-devops

Path: ./expansion-packs/bmad-infrastructure-devops Version: 1.12.0 Requires: bmad-core Agents (1: infra-devops-platform.md) Operations (2: review-infrastructure, validate-infrastructure)

📝 Implementation Phases

Phase 1: Code Analysis ✅

  • Retrieve PR #745 details from GitHub
  • Get the marketplace.json file content
  • Understand structure and requirements
  • Identify all plugins and their definitions

Phase 2: File Creation 🔄

  • Create .claude-plugin/ directory
  • Create marketplace.json file with complete content
  • Verify JSON syntax is valid
  • Verify all paths are correct

Phase 3: Validation

  • Run npm validate
  • Validate JSON structure
  • Check file paths exist
  • Verify no syntax errors

Phase 4: Testing

  • Run npm lint
  • Check for linting errors
  • Verify backward compatibility
  • No regressions

Phase 5: Documentation

  • Create TEST-RESULTS.md
  • Create patch files
  • Create comprehensive documentation
  • Final status report

Phase 6: Commit & GitHub

  • Commit with proper message
  • Post GitHub comment with results

✅ Validation Checklist

Pre-Commit Validation

  • .claude-plugin/marketplace.json created
  • JSON is valid and parseable
  • 307 lines total
  • All 6 plugins defined
  • All agent paths correct
  • All operation/task paths correct
  • npm validate: Pass
  • npm lint: No errors
  • No new warnings

Functionality Validation

  • BMAD core plugin properly defined
  • All 5 expansion packs included
  • Plugin dependencies correct
  • Agent file references valid
  • Operation/task file references valid
  • Metadata complete
  • Keywords and tags present

Post-Commit Validation

  • Commits with proper message
  • Branch ready for merge
  • Documentation comprehensive
  • All tests passing

🎓 Key Points

  1. File Type: JSON configuration file
  2. Purpose: Claude Code marketplace plugin manifest
  3. Scope: Single file, 307 lines
  4. Complexity: Low (configuration file, not code)
  5. Impact: Enables marketplace distribution
  6. Backward Compatible: Yes - only additions
  7. Risk Level: Very low - configuration only

📚 Reference Files

🔍 Related Information from Previous PRs

From .patch folders:

  • PR #714 (Kiro IDE): IDE integration pattern
  • PR #667 (Status terminology): Minor fixes pattern
  • PR #648 (Cursor rules): Configuration pattern

Next Steps: Create .claude-plugin/marketplace.json file and validate