External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

Claude/fix readme plugin docs 011 cv2 lk n gko6wzm tfn dmnrm (#478)

Browse Source 
* Fix(docs): READMEをプロジェクトの現状に合わせて修正

README.mdに、未実装のTypeScriptプラグインシステム（v2.0+）に関するドキュメントが含まれていました。これにより、インストールを試みるユーザーに深刻な混乱を招き、時間と第一印象を損なう原因となっていました。

このコミットは、README.mdをプロジェクトの現状（v4.2.0）を正確に反映するように修正します。

- 存在しないTypeScriptプラグインに関する誤解を招く指示や機能説明をすべて削除しました。
- インストールセクションの冒頭に、プラグインシステムが将来のv5.0で計画されている機能であることを明確にするための警告文を追加しました。
- 現在の安定バージョンに対して、`pipx`またはgitクローンを使用する明確で検証済みのインストール手順を提供しました。
- 未実装の機能に基づいていた古いセクション（「V1.xからのアップグレード」やプラグインに関する「トラブルシューティング」など）を削除しました。
- 「What's New」セクションを、現在のv4.2リリースに関連するものに更新しました。

この変更により、ユーザーから報告された問題が解決され、ドキュメントが新規および既存のコントリビューターにとって信頼できるリソースであることが保証されます。

ユーザーのフィードバックに対応し、根本原因を解決することで間接的に課題#466をクローズします。
関連課題: #419 (プラグインシステムの提案)

* docs: Fix misleading plugin system documentation

Fixes multiple issues reported in GitHub where users wasted hours
following installation instructions for non-existent features.

Changes:
- README.md: Correct version from 4.2.0 to 4.1.6 (matches VERSION file)
- README.md: Already had warning about v5.0 plugin system (no change needed)
- CLAUDE.md: Add prominent warnings that TypeScript plugin system does NOT exist
- CLAUDE.md: Clarify .claude-plugin/ directory is planned for v5.0, not v4.1.6
- CLAUDE.md: Document actual v4.1.6 installation method (pipx/install.sh)
- CLAUDE.md: List features that DON'T work yet (plugin commands, marketplace, etc.)

Background:
- Issue #419: Plugin system is a PROPOSAL, not implemented
- .claude-plugin/ directory does not exist in any branch
- Current v4.1.6 uses slash commands via `superclaude install`
- TypeScript plugin system planned for v5.0 (no ETA)

This prevents users from wasting 3-4 hours trying to use features
that don't exist, as reported by multiple users.

Refs: #419

* docs: Fix version numbers in i18n README files

Update version badges in localized README files to match actual version.

Changes:
- README-ja.md: 4.1.5 → 4.1.6
- README-zh.md: 4.1.5 → 4.1.6
- README-kr.md: 4.1.5 → 4.1.6

All localized READMEs now correctly reflect the current version from
the VERSION file (4.1.6).

Note: These files did not contain misleading plugin system documentation,
only the version number needed correction.

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Utakata
2025-11-12 01:30:49 +09:00
committed by GitHub
parent 0ef8ea8139
commit bec0b0c3e3
5 changed files with 124 additions and 164 deletions
Download Patch File Download Diff File Expand all files Collapse all files

150
README.md
View File

@@ -14,7 +14,7 @@
<a href="https://github.com/SuperClaude-Org/SuperQwen_Framework" target="_blank">
<img src="https://img.shields.io/badge/Try-SuperQwen_Framework-orange" alt="Try SuperQwen Framework"/>
</a>
<img src="https://img.shields.io/badge/version-4.2.0-blue" alt="Version">
<img src="https://img.shields.io/badge/version-4.1.6-blue" alt="Version">
<img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
</p>
@@ -100,26 +100,44 @@ Claude Code is a product built and maintained by [Anthropic](https://www.anthrop
## ⚡ **Quick Installation**
### **Project-Local Plugin (Recommended)**
> **IMPORTANT**: The TypeScript plugin system described in older documentation is
> not yet available (planned for v5.0). For current installation
> instructions, please follow the steps below for v4.x.
SuperClaude v2.0+ uses **TypeScript plugins** with project-local auto-detection:
### **Current Stable Version (v4.1.6)**
SuperClaude currently uses slash commands.
**Option 1: pipx (Recommended)**
```bash
# Clone repository
# Install from PyPI
pipx install superclaude
# Install commands and components
superclaude install
```
**Option 2: Direct Installation from Git**
```bash
# Clone the repository
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
# Start Claude Code in this directory
claude
# Run the installation script
./install.sh
```
**That's it!** `.claude-plugin/` is auto-detected and PM Agent activates on session start.
### **Coming in v5.0 (In Development)**
**Key Features**:
- ✅ **Zero Install**: No copying, no configuration
- ✅ **Hot Reload**: Edit TypeScript → Save → Instant reflection
- ✅ **Auto-Activation**: PM Agent starts automatically (SessionStart hook)
- ✅ **Safe Development**: Separate sandbox from global Claude Code
We are actively working on a new TypeScript plugin system (see issue [#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419) for details). When released, installation will be simplified to:
```bash
# This feature is not yet available
/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
/plugin install superclaude
```
**Status**: In development. No ETA has been set.
### **Enhanced Performance (Optional MCPs)**
@@ -145,69 +163,6 @@ For **2-3x faster** execution and **30-50% fewer tokens**, optionally install MC
</div>
<details>
<summary><b>⚠️ IMPORTANT: Upgrading from SuperClaude V1.x (Slash Commands)</b></summary>
**V2.0 introduces breaking changes - migration from slash commands to TypeScript plugins:**
```bash
# 1. Remove old slash commands (if installed)
rm -rf ~/.claude/commands/sc/
# 2. Use new plugin (project-local)
cd SuperClaude_Framework
claude # .claude-plugin/ auto-detected
```
**What's New in V2.0:**
- ✅ TypeScript plugins (hot reload support)
- ✅ Project-local detection (zero install)
- ✅ Auto-activation via SessionStart hook
- ✅ 3 core plugins: PM Agent, Research, Index
- ✅ Confidence-driven workflow (≥90% threshold, Precision/Recall 1.0)
**Migration Notes:**
- Old: `/sc:pm`, `/sc:research`, `/sc:index-repo` (27 commands)
- New: `/pm`, `/research`, `/index-repo` (3 plugin commands)
- Installation: Global `~/.claude/commands/` → Project-local `.claude-plugin/`
- Just `cd` to project directory and run `claude`
</details>
<details>
<summary><b>💡 Troubleshooting</b></summary>
**Plugin not loading?**
```bash
# Verify you're in the project directory
pwd # Should show: /path/to/SuperClaude_Framework
# Check .claude-plugin/ exists
ls .claude-plugin/plugin.json
# Restart Claude Code in this directory
claude
```
**Commands not working (/pm, /research, /index-repo)?**
- Ensure you started `claude` from the SuperClaude_Framework directory
- Check for errors in Claude Code output
- Verify `.claude-plugin/plugin.json` has correct structure
**Hot reload not working?**
- Edit `.claude-plugin/pm/index.ts`
- Save file
- Changes should reflect immediately (no restart needed)
**Development mode (for contributors):**
```bash
# Install Python package for testing
make install
make verify
uv run pytest
```
</details>
---
<div align="center">
@@ -270,9 +225,9 @@ uv run pytest
<div align="center">
## 🎉 **What's New in V2.0**
## 🎉 **What's New in v4.1**
> *Version 2.0 brings architectural transformation: migration from 27 slash commands to 3 TypeScript plugins with hot reload and auto-activation.*
> *Version 4.1 focuses on stabilizing the slash command architecture, enhancing agent capabilities, and improving documentation.*
<table>
<tr>
@@ -290,13 +245,12 @@ uv run pytest
</td>
<td width="50%">
### 🔥 **TypeScript Plugins**
**3 core plugins** with hot reload:
- **PM Agent**: Confidence-driven orchestration (≥90% threshold)
- **Research**: Deep web search with adaptive planning
- **Index**: 94% token reduction (58K → 3K)
- Auto-activation via SessionStart hook
- Edit → Save → Instant reflection (no restart)
### ⚡ **Optimized Performance**
**Smaller framework, bigger projects:**
- Reduced framework footprint
- More context for your code
- Longer conversations possible
- Complex operations enabled
</td>
</tr>
@@ -332,16 +286,6 @@ uv run pytest
<tr>
<td width="50%">
### ⚡ **Optimized Performance**
**Smaller framework, bigger projects:**
- Reduced framework footprint
- More context for your code
- Longer conversations possible
- Complex operations enabled
</td>
<td width="50%">
### 📚 **Documentation Overhaul**
**Complete rewrite** for developers:
- Real examples & use cases
@@ -349,6 +293,16 @@ uv run pytest
- Practical workflows included
- Better navigation structure
</td>
<td width="50%">
### 🧪 **Enhanced Stability**
**Focus on reliability:**
- Bug fixes for core commands
- Improved test coverage
- More robust error handling
- CI/CD pipeline improvements
</td>
</tr>
</table>
@@ -474,11 +428,11 @@ The Deep Research system intelligently coordinates multiple tools:
</td>
<td valign="top">
- 🎯 [**Plugin Commands**](docs/user-guide/commands.md)
*3 core plugin commands*
- 🎯 [**Slash Commands**](docs/user-guide/commands.md)
*Full list of `/sc` commands*
- 🤖 [**Agents Guide**](docs/user-guide/agents.md)
*15 specialized agents*
*16 specialized agents*
- 🎨 [**Behavioral Modes**](docs/user-guide/modes.md)
*7 adaptive modes*
@@ -487,7 +441,7 @@ The Deep Research system intelligently coordinates multiple tools:
*Control behaviors*
- 🔧 [**MCP Servers**](docs/user-guide/mcp-servers.md)
*7 server integrations*
*8 server integrations*
- 💼 [**Session Management**](docs/user-guide/session-management.md)
*Save & restore state*