mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
**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>
112 lines
3.9 KiB
Makefile
112 lines
3.9 KiB
Makefile
.PHONY: dev install test test-plugin doctor verify clean lint format help
|
|
|
|
# Development installation (local source, editable) - RECOMMENDED
|
|
dev:
|
|
@echo "🔧 Installing SuperClaude Framework (development mode)..."
|
|
uv pip install -e ".[dev]"
|
|
@echo ""
|
|
@echo "✅ Installation complete!"
|
|
@echo " Run 'make verify' to check installation"
|
|
|
|
# Alias for backward compatibility
|
|
install: dev
|
|
|
|
# Run tests
|
|
test:
|
|
@echo "Running tests..."
|
|
uv run pytest
|
|
|
|
# Test pytest plugin loading
|
|
test-plugin:
|
|
@echo "Testing pytest plugin auto-discovery..."
|
|
@uv run python -m pytest --trace-config 2>&1 | grep -A2 "registered third-party plugins:" | grep superclaude && echo "✅ Plugin loaded successfully" || echo "❌ Plugin not loaded"
|
|
|
|
# Run doctor command
|
|
doctor:
|
|
@echo "Running SuperClaude health check..."
|
|
@uv run superclaude doctor
|
|
|
|
# Verify Phase 1 installation
|
|
verify:
|
|
@echo "🔍 Phase 1 Installation Verification"
|
|
@echo "======================================"
|
|
@echo ""
|
|
@echo "1. Package location:"
|
|
@uv run python -c "import superclaude; print(f' {superclaude.__file__}')"
|
|
@echo ""
|
|
@echo "2. Package version:"
|
|
@uv run superclaude --version | sed 's/^/ /'
|
|
@echo ""
|
|
@echo "3. Pytest plugin:"
|
|
@uv run python -m pytest --trace-config 2>&1 | grep "registered third-party plugins:" -A2 | grep superclaude | sed 's/^/ /' && echo " ✅ Plugin loaded" || echo " ❌ Plugin not loaded"
|
|
@echo ""
|
|
@echo "4. Health check:"
|
|
@uv run superclaude doctor | grep "SuperClaude is healthy" > /dev/null && echo " ✅ All checks passed" || echo " ❌ Some checks failed"
|
|
@echo ""
|
|
@echo "======================================"
|
|
@echo "✅ Phase 1 verification complete"
|
|
|
|
# Linting
|
|
lint:
|
|
@echo "Running linter..."
|
|
uv run ruff check .
|
|
|
|
# Format code
|
|
format:
|
|
@echo "Formatting code..."
|
|
uv run ruff format .
|
|
|
|
# Clean build artifacts
|
|
clean:
|
|
@echo "Cleaning build artifacts..."
|
|
rm -rf build/ dist/ *.egg-info
|
|
find . -type d -name __pycache__ -exec rm -rf {} +
|
|
find . -type d -name .pytest_cache -exec rm -rf {} +
|
|
find . -type d -name .ruff_cache -exec rm -rf {} +
|
|
|
|
# Translate README to multiple languages using Neural CLI
|
|
translate:
|
|
@echo "🌐 Translating README using Neural CLI (Ollama + qwen2.5:3b)..."
|
|
@if [ ! -f ~/.local/bin/neural-cli ]; then \
|
|
echo "📦 Installing neural-cli..."; \
|
|
mkdir -p ~/.local/bin; \
|
|
ln -sf ~/github/neural/src-tauri/target/release/neural-cli ~/.local/bin/neural-cli; \
|
|
echo "✅ neural-cli installed to ~/.local/bin/"; \
|
|
fi
|
|
@echo ""
|
|
@echo "🇨🇳 Translating to Simplified Chinese..."
|
|
@~/.local/bin/neural-cli translate README.md --from English --to "Simplified Chinese" --output README-zh.md
|
|
@echo ""
|
|
@echo "🇯🇵 Translating to Japanese..."
|
|
@~/.local/bin/neural-cli translate README.md --from English --to Japanese --output README-ja.md
|
|
@echo ""
|
|
@echo "✅ Translation complete!"
|
|
@echo "📝 Files updated: README-zh.md, README-ja.md"
|
|
|
|
# Show help
|
|
help:
|
|
@echo "SuperClaude Framework - Available commands:"
|
|
@echo ""
|
|
@echo "🚀 Quick Start:"
|
|
@echo " make dev - Install in development mode (RECOMMENDED)"
|
|
@echo " make verify - Verify installation is working"
|
|
@echo ""
|
|
@echo "🔧 Development:"
|
|
@echo " make test - Run test suite"
|
|
@echo " make test-plugin - Test pytest plugin auto-discovery"
|
|
@echo " make doctor - Run health check"
|
|
@echo " make lint - Run linter (ruff check)"
|
|
@echo " make format - Format code (ruff format)"
|
|
@echo " make clean - Clean build artifacts"
|
|
@echo ""
|
|
@echo "📚 Documentation:"
|
|
@echo " make translate - Translate README to Chinese and Japanese"
|
|
@echo " make help - Show this help message"
|
|
@echo ""
|
|
@echo "💡 Plugin Usage:"
|
|
@echo " cd /path/to/SuperClaude_Framework && claude"
|
|
@echo " → .claude-plugin/ auto-detected (project-local plugin)"
|
|
@echo ""
|
|
@echo "💡 Legacy (backward compatibility):"
|
|
@echo " make install - Alias for 'make dev'"
|