Files
SuperClaude/Makefile
kazuki fbc74e4670 fix: correct installation method to project-local plugin
**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>
2025-10-21 14:45:15 +09:00

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'"