262 lines
6.1 KiB
Markdown
262 lines
6.1 KiB
Markdown
# 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 ✅
|
|
|
|
- [x] Retrieve PR #745 details from GitHub
|
|
- [x] Get the marketplace.json file content
|
|
- [x] Understand structure and requirements
|
|
- [x] 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
|
|
|
|
- PR #745: https://github.com/bmad-code-org/BMAD-METHOD/pull/745
|
|
- Claude Code Marketplace: https://marketplace.claude.ai/
|
|
- Plugin Format: Claude Code plugin specification
|
|
|
|
---
|
|
|
|
## 🔍 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
|