SuperClaude/README-ja.md
kazuki nakai 00706f0ea9
feat: comprehensive framework improvements (#447)
* refactor(docs): move core docs into framework/business/research (move-only)

- framework/: principles, rules, flags (思想・行動規範)
- business/: symbols, examples (ビジネス領域)
- research/: config (調査設定)
- All files renamed to lowercase for consistency

* docs: update references to new directory structure

- Update ~/.claude/CLAUDE.md with new paths
- Add migration notice in core/MOVED.md
- Remove pm.md.backup
- All @superclaude/ references now point to framework/business/research/

* fix(setup): update framework_docs to use new directory structure

- Add validate_prerequisites() override for multi-directory validation
- Add _get_source_dirs() for framework/business/research directories
- Override _discover_component_files() for multi-directory discovery
- Override get_files_to_install() for relative path handling
- Fix get_size_estimate() to use get_files_to_install()
- Fix uninstall/update/validate to use install_component_subdir

Fixes installation validation errors for new directory structure.

Tested: make dev installs successfully with new structure
  - framework/: flags.md, principles.md, rules.md
  - business/: examples.md, symbols.md
  - research/: config.md

* refactor(modes): update component references for docs restructure

* chore: remove redundant docs after PLANNING.md migration

Cleanup after Self-Improvement Loop implementation:

**Deleted (21 files, ~210KB)**:
- docs/Development/ - All content migrated to PLANNING.md & TASK.md
  * ARCHITECTURE.md (15KB) → PLANNING.md
  * TASKS.md (3.7KB) → TASK.md
  * ROADMAP.md (11KB) → TASK.md
  * PROJECT_STATUS.md (4.2KB) → outdated
  * 13 PM Agent research files → archived in KNOWLEDGE.md
- docs/PM_AGENT.md - Old implementation status
- docs/pm-agent-implementation-status.md - Duplicate
- docs/templates/ - Empty directory

**Retained (valuable documentation)**:
- docs/memory/ - Active session metrics & context
- docs/patterns/ - Reusable patterns
- docs/research/ - Research reports
- docs/user-guide*/ - User documentation (4 languages)
- docs/reference/ - Reference materials
- docs/getting-started/ - Quick start guides
- docs/agents/ - Agent-specific guides
- docs/testing/ - Test procedures

**Result**:
- Eliminated redundancy after Root Documents consolidation
- Preserved all valuable content in PLANNING.md, TASK.md, KNOWLEDGE.md
- Maintained user-facing documentation structure

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: relocate PM modules to commands/modules

- Move modules to superclaude/commands/modules/
- Organize command-specific modules under commands/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: add self-improvement loop with 4 root documents

Implements Self-Improvement Loop based on Cursor's proven patterns:

**New Root Documents**:
- PLANNING.md: Architecture, design principles, 10 absolute rules
- TASK.md: Current tasks with priority (🔴🟡🟢)
- KNOWLEDGE.md: Accumulated insights, best practices, failures
- README.md: Updated with developer documentation links

**Key Features**:
- Session Start Protocol: Read docs → Git status → Token budget → Ready
- Evidence-Based Development: No guessing, always verify
- Parallel Execution Default: Wave → Checkpoint → Wave pattern
- Mac Environment Protection: Docker-first, no host pollution
- Failure Pattern Learning: Past mistakes become prevention rules

**Cleanup**:
- Removed: docs/memory/checkpoint.json, current_plan.json (migrated to TASK.md)
- Enhanced: setup/components/commands.py (module discovery)

**Benefits**:
- LLM reads rules at session start → consistent quality
- Past failures documented → no repeats
- Progressive knowledge accumulation → continuous improvement
- 3.5x faster execution with parallel patterns

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* test: validate Self-Improvement Loop workflow

Tested complete cycle: Read docs → Extract rules → Execute task → Update docs

Test Results:
- Session Start Protocol:  All 6 steps successful
- Rule Extraction:  10/10 absolute rules identified from PLANNING.md
- Task Identification:  Next tasks identified from TASK.md
- Knowledge Application:  Failure patterns accessed from KNOWLEDGE.md
- Documentation Update:  TASK.md and KNOWLEDGE.md updated with completed work
- Confidence Score: 95% (exceeds 70% threshold)

Proved Self-Improvement Loop closes: Execute → Learn → Update → Improve

* refactor: responsibility-driven component architecture

Rename components to reflect their responsibilities:
- framework_docs.py → knowledge_base.py (KnowledgeBaseComponent)
- modes.py → behavior_modes.py (BehaviorModesComponent)
- agents.py → agent_personas.py (AgentPersonasComponent)
- commands.py → slash_commands.py (SlashCommandsComponent)
- mcp.py → mcp_integration.py (MCPIntegrationComponent)

Each component now clearly documents its responsibility:
- knowledge_base: Framework knowledge initialization
- behavior_modes: Execution mode definitions
- agent_personas: AI agent personality definitions
- slash_commands: CLI command registration
- mcp_integration: External tool integration

Benefits:
- Self-documenting architecture
- Clear responsibility boundaries
- Easy to navigate and extend
- Scalable for future hierarchical organization

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* docs: add project-specific CLAUDE.md with UV rules

- Document UV as required Python package manager
- Add common operations and integration examples
- Document project structure and component architecture
- Provide development workflow guidelines

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: resolve installation failures after framework_docs rename

## Problems Fixed
1. **Syntax errors**: Duplicate docstrings in all component files (line 1)
2. **Dependency mismatch**: Stale framework_docs references after rename to knowledge_base

## Changes
- Fix docstring format in all component files (behavior_modes, agent_personas, slash_commands, mcp_integration)
- Update all dependency references: framework_docs → knowledge_base
- Update component registration calls in knowledge_base.py (5 locations)
- Update install.py files in both setup/ and superclaude/ (5 locations total)
- Fix documentation links in README-ja.md and README-zh.md

## Verification
 All components load successfully without syntax errors
 Dependency resolution works correctly
 Installation completes in 0.5s with all validations passing
 make dev succeeds

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: add automated README translation workflow

## New Features
- **Auto-translation workflow** using GPT-Translate
- Automatically translates README.md to Chinese (ZH) and Japanese (JA)
- Triggers on README.md changes to master/main branches
- Cost-effective: ~¥90/month for typical usage

## Implementation Details
- Uses OpenAI GPT-4 for high-quality translations
- GitHub Actions integration with gpt-translate@v1.1.11
- Secure API key management via GitHub Secrets
- Automatic commit and PR creation on translation updates

## Files Added
- `.github/workflows/translation-sync.yml` - Auto-translation workflow
- `docs/Development/translation-workflow.md` - Setup guide and documentation

## Setup Required
Add `OPENAI_API_KEY` to GitHub repository secrets to enable auto-translation.

## Benefits
- 🤖 Automated translation on every README update
- 💰 Low cost (~$0.06 per translation)
- 🛡️ Secure API key storage
- 🔄 Consistent translation quality across languages

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(mcp): update airis-mcp-gateway URL to correct organization

Fixes #440

## Problem
Code referenced non-existent `oraios/airis-mcp-gateway` repository,
causing MCP installation to fail completely.

## Root Cause
- Repository was moved to organization: `agiletec-inc/airis-mcp-gateway`
- Old reference `oraios/airis-mcp-gateway` no longer exists
- Users reported "not a python/uv module" error

## Changes
- Update install_command URL: oraios → agiletec-inc
- Update run_command URL: oraios → agiletec-inc
- Location: setup/components/mcp_integration.py lines 37-38

## Verification
 Correct URL now references active repository
 MCP installation will succeed with proper organization
 No other code references oraios/airis-mcp-gateway

## Related Issues
- Fixes #440 (Airis-mcp-gateway url has changed)
- Related to #442 (MCP update issues)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: replace cloud translation with local Neural CLI

## Changes

### Removed (OpenAI-dependent)
-  `.github/workflows/translation-sync.yml` - GPT-Translate workflow
-  `docs/Development/translation-workflow.md` - OpenAI setup docs

### Added (Local Ollama-based)
-  `Makefile`: New `make translate` target using Neural CLI
-  `docs/Development/translation-guide.md` - Neural CLI guide

## Benefits

**Before (GPT-Translate)**:
- 💰 Monthly cost: ~¥90 (OpenAI API)
- 🔑 Requires API key setup
- 🌐 Data sent to external API
- ⏱️ Network latency

**After (Neural CLI)**:
-  **$0 cost** - Fully local execution
-  **No API keys** - Zero setup friction
-  **Privacy** - No external data transfer
-  **Fast** - ~1-2 min per README
-  **Offline capable** - Works without internet

## Technical Details

**Neural CLI**:
- Built in Rust with Tauri
- Uses Ollama + qwen2.5:3b model
- Binary size: 4.0MB
- Auto-installs to ~/.local/bin/

**Usage**:
```bash
make translate  # Translates README.md → README-zh.md, README-ja.md
```

## Requirements

- Ollama installed: `curl -fsSL https://ollama.com/install.sh | sh`
- Model downloaded: `ollama pull qwen2.5:3b`
- Neural CLI built: `cd ~/github/neural/src-tauri && cargo build --bin neural-cli --release`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local>
Co-authored-by: Claude <noreply@anthropic.com>
2025-10-18 20:28:10 +05:30

440 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div align="center">
# 🚀 SuperClaudeフレームワーク
### **Claude Codeを構造化開発プラットフォームに変換**
<p align="center">
<img src="https://img.shields.io/badge/version-4.1.5-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>
<p align="center">
<a href="https://superclaude.netlify.app/">
<img src="https://img.shields.io/badge/🌐_ウェブサイトを訪問-blue" alt="Website">
</a>
<a href="https://pypi.org/project/superclaude/">
<img src="https://img.shields.io/pypi/v/SuperClaude.svg?" alt="PyPI">
</a>
<a href="https://www.npmjs.com/package/@bifrost_inc/superclaude">
<img src="https://img.shields.io/npm/v/@bifrost_inc/superclaude.svg" alt="npm">
</a>
</p>
<!-- Language Selector -->
<p align="center">
<a href="README.md">
<img src="https://img.shields.io/badge/🇺🇸_English-blue" alt="English">
</a>
<a href="README-zh.md">
<img src="https://img.shields.io/badge/🇨🇳_中文-red" alt="中文">
</a>
<a href="README-ja.md">
<img src="https://img.shields.io/badge/🇯🇵_日本語-green" alt="日本語">
</a>
</p>
<p align="center">
<a href="#-クイックインストール">クイックスタート</a>
<a href="#-プロジェクトを支援">支援</a>
<a href="#-v4の新機能">新機能</a>
<a href="#-ドキュメント">ドキュメント</a>
<a href="#-貢献">貢献</a>
</p>
</div>
---
<div align="center">
## 📊 **フレームワーク統計**
| **コマンド数** | **エージェント** | **モード** | **MCPサーバー** |
|:------------:|:----------:|:---------:|:---------------:|
| **21** | **14** | **5** | **6** |
| スラッシュコマンド | 専門AI | 動作モード | 統合サービス |
</div>
---
<div align="center">
## 🎯 **概要**
SuperClaudeは**メタプログラミング設定フレームワーク**で、動作指示の注入とコンポーネント統制を通じて、Claude Codeを構造化開発プラットフォームに変換します。強力なツールとインテリジェントエージェントを備えたシステム化されたワークフロー自動化を提供します。
## ⚡ **クイックインストール**
### **インストール方法を選択**
| 方法 | コマンド | 最適な用途 |
|:------:|---------|----------|
| **🐍 pipx** | `pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install` | **✅ 推奨** - Linux/macOS |
| **📦 pip** | `pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install` | 従来のPython環境 |
| **🌐 npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | クロスプラットフォーム、Node.jsユーザー |
</div>
<details>
<summary><b>⚠️ 重要SuperClaude V3からのアップグレード</b></summary>
**SuperClaude V3がインストールされている場合は、V4をインストールする前にアンインストールする必要があります**
```bash
# V3を最初にアンインストール
関連するファイルとディレクトリをすべて削除:
*.md *.json および commands/
# その後V4をインストール
pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install
```
**✅ アップグレード時に保持される内容:**
- ✓ カスタムスラッシュコマンド(`commands/sc/`外のもの)
-`CLAUDE.md`内のカスタム内容
- ✓ Claude Codeの`.claude.json``.credentials.json``settings.json``settings.local.json`
- ✓ 追加したカスタムエージェントとファイル
**⚠️ 注意:** V3の他のSuperClaude関連`.json`ファイルは競合を引き起こす可能性があるため削除してください。
</details>
<details>
<summary><b>💡 PEP 668エラーのトラブルシューティング</b></summary>
```bash
# オプション1pipxを使用推奨
pipx install SuperClaude
# オプション2ユーザーインストール
pip install --user SuperClaude
# オプション3強制インストール注意して使用
pip install --break-system-packages SuperClaude
```
</details>
---
<div align="center">
## 💖 **プロジェクトを支援**
> 正直に言うと、SuperClaudeの維持には時間とリソースが必要です。
>
> *Claude Maxサブスクリプションだけでもテスト用に月100ドルかかり、それに加えてドキュメント、バグ修正、機能開発に費やす時間があります。*
> *日常の作業でSuperClaudeの価値を感じていただけるなら、プロジェクトの支援をご検討ください。*
> *数ドルでも基本コストをカバーし、開発を継続することができます。*
>
> コード、フィードバック、または支援を通じて、すべての貢献者が重要です。このコミュニティの一員でいてくれてありがとう!🙏
<table>
<tr>
<td align="center" width="33%">
### ☕ **Ko-fi**
[![Ko-fi](https://img.shields.io/badge/Support_on-Ko--fi-ff5e5b?logo=ko-fi)](https://ko-fi.com/superclaude)
*一回限りの貢献*
</td>
<td align="center" width="33%">
### 🎯 **Patreon**
[![Patreon](https://img.shields.io/badge/Become_a-Patron-f96854?logo=patreon)](https://patreon.com/superclaude)
*月額支援*
</td>
<td align="center" width="33%">
### 💜 **GitHub**
[![GitHub Sponsors](https://img.shields.io/badge/GitHub-Sponsor-30363D?logo=github-sponsors)](https://github.com/sponsors/SuperClaude-Org)
*柔軟な階層*
</td>
</tr>
</table>
### **あなたの支援により可能になること:**
| 項目 | コスト/影響 |
|------|-------------|
| 🔬 **Claude Maxテスト** | 検証とテスト用に月100ドル |
| ⚡ **機能開発** | 新機能と改善 |
| 📚 **ドキュメンテーション** | 包括的なガイドと例 |
| 🤝 **コミュニティサポート** | 迅速な問題対応とヘルプ |
| 🔧 **MCP統合** | 新しいサーバー接続のテスト |
| 🌐 **インフラストラクチャ** | ホスティングとデプロイメントのコスト |
> **注意:** ただし、プレッシャーはありません。フレームワークはいずれにしてもオープンソースのままです。人々がそれを使用し、評価していることを知るだけでもモチベーションになります。コード、ドキュメント、または情報の拡散による貢献も助けになります!🙏
</div>
---
<div align="center">
## 🎉 **V4の新機能**
> *バージョン4は、コミュニティフィードバックと実際の使用パターンに基づいて重要な改善をもたらします。*
<table>
<tr>
<td width="50%">
### 🤖 **よりスマートなエージェントシステム**
**14の専門エージェント**がドメイン専門知識を持ちます:
- セキュリティエンジニアが実際の脆弱性をキャッチ
- フロントエンドアーキテクトがUIパターンを理解
- コンテキストに基づく自動調整
- オンデマンドでドメイン固有の専門知識
</td>
<td width="50%">
### 📝 **改良された名前空間**
すべてのコマンドに**`/sc:`プレフィックス**
- カスタムコマンドとの競合なし
- 完全なライフサイクルをカバーする21のコマンド
- ブレインストーミングからデプロイメントまで
- 整理されたコマンド構造
</td>
</tr>
<tr>
<td width="50%">
### 🔧 **MCPサーバー統合**
**6つの強力なサーバー**が連携:
- **Context7** → 最新ドキュメント
- **Sequential** → 複雑な分析
- **Magic** → UIコンポーネント生成
- **Playwright** → ブラウザテスト
- **Morphllm** → 一括変換
- **Serena** → セッション持続
</td>
<td width="50%">
### 🎯 **動作モード**
異なるコンテキストのための**5つの適応モード**
- **ブレインストーミング** → 適切な質問をする
- **オーケストレーション** → 効率的なツール調整
- **トークン効率** → 30-50%のコンテキスト節約
- **タスク管理** → システム化された組織
- **内省** → メタ認知分析
</td>
</tr>
<tr>
<td width="50%">
### ⚡ **最適化されたパフォーマンス**
**より小さなフレームワーク、より大きなプロジェクト:**
- フレームワークフットプリントの削減
- コードのためのより多くのコンテキスト
- より長い会話が可能
- 複雑な操作の有効化
</td>
<td width="50%">
### 📚 **ドキュメントの全面見直し**
**開発者のための完全な書き直し:**
- 実際の例とユースケース
- 一般的な落とし穴の文書化
- 実用的なワークフローを含む
- より良いナビゲーション構造
</td>
</tr>
</table>
</div>
---
<div align="center">
## 🔬 **深層リサーチ機能**
SuperClaude v4.2は、自律的、適応的、知的なWeb調査を可能にする包括的な深層リサーチ機能を導入しました。
### 🎯 **適応型計画**
3つのインテリジェント戦略**計画優先**(明確なクエリの直接実行)、**意図計画**(曖昧なリクエストの明確化)、**統合**(協調的な計画改善、デフォルト)
### 🔄 **マルチホップ推論**
最大5回の反復検索エンティティ拡張、概念深化、時系列進行、因果チェーン
### 📊 **品質スコアリング**
信頼性ベースの検証:情報源の信頼性評価(0.0-1.0)、カバレッジ完全性追跡、統合一貫性評価
### 🧠 **ケースベース学習**
クロスセッション・インテリジェンス:パターン認識と再利用、戦略最適化、成功したクエリ保存
### **リサーチコマンド使用法**
```bash
/sc:research "AI最新動向 2024"
/sc:research "量子コンピューティング" --depth exhaustive
```
### **統合ツール・オーケストレーション**
複数ツールのインテリジェント調整:**Tavily MCP**Web検索、**Playwright MCP**(コンテンツ抽出)、**Sequential MCP**(推論合成)、**Serena MCP**(メモリ永続化)、**Context7 MCP**(技術ドキュメント)
</div>
---
<div align="center">
## 📚 **ドキュメント**
### **🇯🇵 SuperClaude完全日本語ガイド**
<table>
<tr>
<th align="center">🚀 はじめに</th>
<th align="center">📖 ユーザーガイド</th>
<th align="center">🛠️ 開発者リソース</th>
<th align="center">📋 リファレンス</th>
</tr>
<tr>
<td valign="top">
- 📝 [**クイックスタートガイド**](docs/getting-started/quick-start.md)
*すぐに開始*
- 💾 [**インストールガイド**](docs/getting-started/installation.md)
*詳細なセットアップ手順*
</td>
<td valign="top">
- 🎯 [**コマンドリファレンス**](docs/user-guide-jp/commands.md)
*全21のスラッシュコマンド*
- 🤖 [**エージェントガイド**](docs/user-guide-jp/agents.md)
*14の専門エージェント*
- 🎨 [**動作モード**](docs/user-guide-jp/modes.md)
*5つの適応モード*
- 🚩 [**フラグガイド**](docs/user-guide-jp/flags.md)
*動作制御パラメータ*
- 🔧 [**MCPサーバー**](docs/user-guide-jp/mcp-servers.md)
*6つのサーバー統合*
- 💼 [**セッション管理**](docs/user-guide-jp/session-management.md)
*状態の保存と復元*
</td>
<td valign="top">
- 🏗️ [**技術アーキテクチャ**](docs/developer-guide/technical-architecture.md)
*システム設計の詳細*
- 💻 [**コード貢献**](docs/developer-guide/contributing-code.md)
*開発ワークフロー*
- 🧪 [**テスト&デバッグ**](docs/developer-guide/testing-debugging.md)
*品質保証*
</td>
<td valign="top">
- ✨ [**ベストプラクティス**](docs/getting-started/quick-start.md)
*プロのコツとパターン*
- 📓 [**サンプル集**](docs/reference/examples-cookbook.md)
*実際の使用例*
- 🔍 [**トラブルシューティング**](docs/reference/troubleshooting.md)
*一般的な問題と修正*
</td>
</tr>
</table>
</div>
---
<div align="center">
## 🤝 **貢献**
### **SuperClaudeコミュニティに参加**
あらゆる種類の貢献を歓迎します!お手伝いできる方法は以下のとおりです:
| 優先度 | 領域 | 説明 |
|:--------:|------|-------------|
| 📝 **高** | ドキュメント | ガイドの改善、例の追加、タイプミス修正 |
| 🔧 **高** | MCP統合 | サーバー設定の追加、統合テスト |
| 🎯 **中** | ワークフロー | コマンドパターンとレシピの作成 |
| 🧪 **中** | テスト | テストの追加、機能の検証 |
| 🌐 **低** | 国際化 | ドキュメントの他言語への翻訳 |
<p align="center">
<a href="CONTRIBUTING.md">
<img src="https://img.shields.io/badge/📖_読む-貢献ガイド-blue" alt="Contributing Guide">
</a>
<a href="https://github.com/SuperClaude-Org/SuperClaude_Framework/graphs/contributors">
<img src="https://img.shields.io/badge/👥_表示-すべての貢献者-green" alt="Contributors">
</a>
</p>
</div>
---
<div align="center">
## ⚖️ **ライセンス**
このプロジェクトは**MITライセンス**の下でライセンスされています - 詳細は[LICENSE](LICENSE)ファイルを参照してください。
<p align="center">
<img src="https://img.shields.io/badge/License-MIT-yellow.svg?" alt="MIT License">
</p>
</div>
---
<div align="center">
## ⭐ **Star履歴**
<a href="https://www.star-history.com/#SuperClaude-Org/SuperClaude_Framework&Timeline">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline" />
</picture>
</a>
</div>
---
<div align="center">
### **🚀 SuperClaudeコミュニティによって情熱をもって構築**
<p align="center">
<sub>境界を押し広げる開発者のために❤️で作られました</sub>
</p>
<p align="center">
<a href="#-superclaudeフレームワーク">トップに戻る ↑</a>
</p>
</div>