Restructure plugin to follow Claude Code official documentation:
- Move TypeScript files from .claude-plugin/* to project root
- Create Markdown command files in commands/
- Update plugin.json to reference ./commands/*.md
- Add comprehensive plugin installation guide
Changes:
- Commands: pm.md, research.md, index-repo.md (new Markdown format)
- TypeScript: pm/, research/, index/ moved to root
- Hooks: hooks/hooks.json moved to root
- Documentation: PLUGIN_INSTALL.md, updated CLAUDE.md, Makefile
Note: This commit represents transition state. Original TypeScript-based
execution system was replaced with Markdown commands. Further redesign
needed to properly integrate Skills and Hooks per official docs.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
**Problem:**
- Previous commit (a302ca7) added `make install-plugin` that copied to ~/.claude/plugins/
- This breaks path references - plugins are designed to be project-local
- Wasted effort with install/uninstall commands
**Root Cause:**
- Misunderstood Claude Code plugin architecture
- Plugins use project-local `.claude-plugin/` directory
- Claude Code auto-detects when started in project directory
- No copying or installation needed
**Solution:**
- Remove `make install-plugin`, `uninstall-plugin`, `reinstall-plugin`
- Update README.md: Just `cd SuperClaude_Framework && claude`
- Remove ~/.claude/plugins/pm-agent/ (incorrect location)
- Simplify to zero-install approach
**Correct Usage:**
```bash
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
claude # .claude-plugin/ auto-detected
```
**Benefits:**
- Zero install: No file copying
- Hot reload: Edit TypeScript → Save → Instant reflection
- Safe development: Separate from global Claude Code
- Auto-activation: SessionStart hook runs /pm automatically
**Changes:**
- Makefile: Remove install-plugin, uninstall-plugin, reinstall-plugin targets
- README.md: Replace `make install-plugin` with `cd + claude`
- Cleanup: Remove ~/.claude/plugins/pm-agent/ directory
**Acknowledgment:**
Thanks to user for explaining Local Installer architecture:
- ~/.claude/local = separate sandbox from npm global version
- Project-local plugins = safe experimentation
- Hot reload more stable in local environment
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
## Changes
### Unified Metadata Location
- All components now use `~/.claude/.superclaude-metadata.json`
- Previously split between root and superclaude subdirectory
- Automatic migration from old location on first load
- Eliminates confusion from duplicate metadata files
### Improved Installation Messages
- Changed WARNING to INFO for existing installations
- Message now clearly states "will be updated" instead of implying problem
- Reduces user confusion during reinstalls/updates
### Updated Makefile
- `make install`: Development mode (uv, local source, editable)
- `make install-release`: Production mode (pipx, from PyPI)
- `make dev`: Alias for install
- Improved help output with categorized commands
## Technical Details
**Metadata Unification** (setup/services/settings.py):
- SettingsService now always uses `~/.claude/.superclaude-metadata.json`
- Added `_migrate_old_metadata()` for automatic migration
- Deep merge strategy preserves existing data
- Old file backed up as `.superclaude-metadata.json.migrated`
**User File Protection**:
- Verified: User-created files preserved during updates
- Only SuperClaude-managed files (tracked in metadata) are updated
- Obsolete framework files automatically removed
## Migration Path
Existing installations automatically migrate on next `make install`:
1. Old metadata detected at `~/.claude/superclaude/.superclaude-metadata.json`
2. Merged into `~/.claude/.superclaude-metadata.json`
3. Old file backed up
4. No user action required
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
