Files

Mithun Gowda B 116e9fc5f9 fix: fill implementation gaps across core modules (#544 )

* fix: fill implementation gaps across core modules

- Replace ConfidenceChecker placeholder methods with real implementations
  that search the codebase for duplicates, verify architecture docs exist,
  check research references, and validate root cause specificity
- Fix intelligent_execute() error capture: collect actual errors from
  failed tasks instead of hardcoded None, format tracebacks as strings,
  and fix variable shadowing bug where loop var overwrote task parameter
- Implement ReflexionPattern mindbase integration via HTTP API with
  graceful fallback when service is unavailable
- Fix .gitignore: remove duplicate entries, add explicit !-rules for
  .claude/settings.json and .claude/skills/, remove Tests/ ignore
- Remove unnecessary sys.path hack in cli/main.py
- Fix FailureEntry.from_dict to not mutate input dict
- Add comprehensive execution module tests: 62 new tests covering
  ParallelExecutor, ReflectionEngine, SelfCorrectionEngine, and the
  intelligent_execute orchestrator (136 total, all passing)

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

* chore: include test-generated reflexion artifacts

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

* fix: address 5 open GitHub issues (#536, #537, #531, #517, #534)

Security fixes:
- #536: Remove shell=True and user-controlled $SHELL from _run_command()
  to prevent arbitrary code execution. Use direct list-based subprocess.run
  without passing full os.environ to child processes.
- #537: Add SHA-256 integrity verification for downloaded docker-compose
  and mcp-config files. Downloads are deleted on hash mismatch. Gateway
  config supports pinned hashes via docker_compose_sha256/mcp_config_sha256.

Bug fixes:
- #531: Add agent file installation to `superclaude install` and `update`
  commands. 20 agent markdown files are now copied to ~/.claude/agents/
  alongside command installation.
- #517: Fix MCP env var flag from --env to -e for API key passthrough,
  matching the Claude CLI's expected format.

Usability:
- #534: Replace Japanese trigger phrases and report labels in pm-agent.md
  and pm.md (both src/ and plugins/) with English equivalents for
  international accessibility.

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

* docs: align documentation with Claude Code and fix version/count gaps

- Update CLAUDE.md project structure to include agents/ (20 agents),
  modes/ (7 modes), commands/ (30 commands), skills/, hooks/, mcp/,
  and core/ directories. Add Claude Code integration points section.
- Fix version references: 4.1.5 -> 4.2.0 in installation.md,
  quick-start.md, and package.json (was 4.1.7)
- Fix feature counts across all docs:
  - Commands: 21 -> 30
  - Agents: 14/16 -> 20
  - Modes: 6 -> 7
  - MCP Servers: 6 -> 8
- Update README.md agent count from 16 to 20
- Add docs/user-guide/claude-code-integration.md explaining how
  SuperClaude maps to Claude Code's native features (commands,
  agents, hooks, skills, settings, MCP servers, pytest plugin)

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

* chore: update test-generated reflexion log

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

* docs: comprehensive Claude Code gap analysis and integration guide

- Rewrite docs/user-guide/claude-code-integration.md with full feature
  mapping: all 28 hook events, skills system with YAML frontmatter,
  5 settings scopes, permission rules, plan mode, extended thinking,
  agent teams, voice, desktop features, and session management.
  Includes detailed gap table showing where SuperClaude under-uses
  Claude Code capabilities (skills migration, hooks integration,
  plan mode, settings profiles).
- Add Claude Code native features section to CLAUDE.md with extension
  points we use vs should use more (hooks, skills, plan mode, settings)
- Add Claude Code integration gap analysis to KNOWLEDGE.md with
  prioritized action items for skills migration, hooks leverage,
  plan mode integration, and settings profiles

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

* chore: update test-generated reflexion log

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

* chore: bump version to 4.3.0

Bump version across all 15 files:
- VERSION, pyproject.toml, package.json
- src/superclaude/__init__.py, src/superclaude/__version__.py
- CLAUDE.md, PLANNING.md, TASK.md, CHANGELOG.md
- README.md, README-zh.md, README-ja.md, README-kr.md
- docs/getting-started/installation.md, quick-start.md
- docs/Development/pm-agent-integration.md

Also fixes __version__.py which was out of sync at 0.4.0.
Adds comprehensive CHANGELOG entry for v4.3.0.

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

* i18n: replace all Japanese/Chinese text with English in source files

Replace CJK text with English across all non-translation files:

- src/superclaude/commands/pm.md: 38 Japanese strings in PDCA cycle,
  error handling patterns, anti-patterns, document templates
- src/superclaude/agents/pm-agent.md: 20 Japanese strings in PDCA
  phases, self-evaluation, documentation sections
- plugins/superclaude/: synced from src/ copies
- .github/workflows/readme-quality-check.yml: all Chinese comments,
  table headers, report strings, and PR comment text
- .github/workflows/pull-sync-framework.yml: Japanese comment
- .github/PULL_REQUEST_TEMPLATE.md: complete rewrite from Japanese

Translation files (README-ja.md, docs/user-guide-jp/, etc.) are
intentionally kept in their respective languages.

https://claude.ai/code/session_01AnGJMAA6Qp2j9WKKHHZfB9

---------

Co-authored-by: Claude <noreply@anthropic.com>

2026-03-22 22:57:15 +05:30

20 KiB

Raw Permalink Blame History

🚀 SuperClaudeフレームワーク

Claude Codeを構造化開発プラットフォームに変換

クイックスタート • 支援 • 新機能 • ドキュメント • 貢献

📊 フレームワーク統計

コマンド	エージェント	モード	MCPサーバー
30	16	7	8
スラッシュコマンド	専門AI	動作モード	統合サービス

ブレインストーミングからデプロイまでの完全な開発ライフサイクルをカバーする30のスラッシュコマンド。

🎯 概要

SuperClaudeはメタプログラミング設定フレームワークで、動作指示の注入とコンポーネント統制を通じて、Claude Codeを構造化開発プラットフォームに変換します。強力なツールとインテリジェントエージェントを備えたシステム化されたワークフロー自動化を提供します。

免責事項

このプロジェクトはAnthropicと関連または承認されていません。 Claude CodeはAnthropicによって構築および維持されている製品です。

📖 開発者および貢献者向け

SuperClaudeフレームワークを使用するための重要なドキュメント：

ドキュメント	目的	いつ読むか
PLANNING.md	アーキテクチャ、設計原則、絶対的なルール	セッション開始時、実装前
TASK.md	現在のタスク、優先順位、バックログ	毎日、作業開始前
KNOWLEDGE.md	蓄積された知見、ベストプラクティス、トラブルシューティング	問題に遭遇したとき、パターンを学習するとき
CONTRIBUTING.md	貢献ガイドライン、ワークフロー	PRを提出する前

💡 プロのヒント：Claude Codeはセッション開始時にこれらのファイルを読み取り、プロジェクト標準に沿った一貫性のある高品質な開発を保証します。

⚡ クイックインストール

重要：古いドキュメントで説明されているTypeScriptプラグインシステムはまだ利用できません（v5.0で予定）。v4.xの現在のインストール手順については、以下の手順に従ってください。

現在の安定バージョン (v4.3.0)

SuperClaudeは現在スラッシュコマンドを使用しています。

オプション1：pipx（推奨）

# PyPIからインストール
pipx install superclaude

# コマンドをインストール（/research、/index-repo、/agent、/recommendをインストール）
superclaude install

# インストールを確認
superclaude install --list
superclaude doctor

インストール後、Claude Codeを再起動してコマンドを使用します：

/sc:research - 並列検索による深いウェブ研究
/sc:index-repo - コンテキスト最適化のためのリポジトリインデックス作成
/sc:agent - 専門AIエージェント
/sc:recommend - コマンド推奨
/sc - 利用可能なすべてのSuperClaudeコマンドを表示

オプション2：Gitから直接インストール

# リポジトリをクローン
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework

# インストールスクリプトを実行
./install.sh

v5.0で提供予定（開発中）

新しいTypeScriptプラグインシステムを積極的に開発中です（詳細は#419を参照）。リリース後、インストールは次のように簡略化されます：

# この機能はまだ利用できません
/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
/plugin install superclaude

ステータス：開発中。ETAは未定です。

パフォーマンス向上（オプションのMCP）

2〜3倍高速な実行と**30〜50%**少ないトークンのために、オプションでMCPサーバーをインストールできます：

# パフォーマンス向上のためのオプションのMCPサーバー（airis-mcp-gateway経由）：
# - Serena: コード理解（2〜3倍高速）
# - Sequential: トークン効率的な推論（30〜50%少ないトークン）
# - Tavily: 深い研究のためのウェブ検索
# - Context7: 公式ドキュメント検索
# - Mindbase: すべての会話にわたるセマンティック検索（オプションの拡張）

# 注：エラー学習は組み込みのReflexionMemoryを介して利用可能（インストール不要）
# Mindbaseはセマンティック検索の拡張を提供（「recommended」プロファイルが必要）
# MCPサーバーのインストール：https://github.com/agiletec-inc/airis-mcp-gateway
# 詳細はdocs/mcp/mcp-integration-policy.mdを参照

パフォーマンス比較：

MCPなし：完全に機能、標準パフォーマンス ✅
MCPあり：2〜3倍高速、30〜50%少ないトークン ⚡

💖 プロジェクトを支援

正直に言うと、SuperClaudeの維持には時間とリソースが必要です。

Claude Maxサブスクリプションだけでもテスト用に月100ドルかかり、それに加えてドキュメント、バグ修正、機能開発に費やす時間があります。 日常の作業でSuperClaudeの価値を感じていただけるなら、プロジェクトの支援をご検討ください。 数ドルでも基本コストをカバーし、開発を継続することができます。

コード、フィードバック、または支援を通じて、すべての貢献者が重要です。このコミュニティの一員でいてくれてありがとう！🙏

☕ Ko-fi

一回限りの貢献

🎯 Patreon

月額支援

💜 GitHub

柔軟な階層

あなたの支援により可能になること：

項目	コスト/影響
🔬 Claude Maxテスト	検証とテスト用に月100ドル
⚡ 機能開発	新機能と改善
📚 ドキュメンテーション	包括的なガイドと例
🤝 コミュニティサポート	迅速な問題対応とヘルプ
🔧 MCP統合	新しいサーバー接続のテスト
🌐 インフラストラクチャ	ホスティングとデプロイメントのコスト

注意： ただし、プレッシャーはありません。フレームワークはいずれにしてもオープンソースのままです。人々がそれを使用し、評価していることを知るだけでもモチベーションになります。コード、ドキュメント、または情報の拡散による貢献も助けになります！🙏

🎉 V4.1の新機能

バージョン4.1は、スラッシュコマンドアーキテクチャの安定化、エージェント機能の強化、ドキュメントの改善に焦点を当てています。

🤖 よりスマートなエージェントシステム

ドメイン専門知識を持つ16の専門エージェント：

PM Agentは体系的なドキュメントを通じて継続的な学習を保証
自律的なウェブ研究のための深い研究エージェント
セキュリティエンジニアが実際の脆弱性をキャッチ
フロントエンドアーキテクトがUIパターンを理解
コンテキストに基づく自動調整
オンデマンドでドメイン固有の専門知識

⚡ 最適化されたパフォーマンス

より小さなフレームワーク、より大きなプロジェクト：

フレームワークフットプリントの削減
コードのためのより多くのコンテキスト
より長い会話が可能
複雑な操作の有効化

🔧 MCPサーバー統合

8つの強力なサーバー（airis-mcp-gateway経由）：

Tavily → プライマリウェブ検索（深い研究）
Serena → セッション持続性とメモリ
Mindbase → セッション横断学習（ゼロフットプリント）
Sequential → トークン効率的な推論
Context7 → 公式ドキュメント検索
Playwright → JavaScript重量コンテンツ抽出
Magic → UIコンポーネント生成
Chrome DevTools → パフォーマンス分析

🎯 動作モード

異なるコンテキストのための7つの適応モード：

ブレインストーミング → 適切な質問をする
ビジネスパネル → 多専門家戦略分析
深い研究 → 自律的なウェブ研究
オーケストレーション → 効率的なツール調整
トークン効率 → 30-50%のコンテキスト節約
タスク管理 → システム化された組織
内省 → メタ認知分析

📚 ドキュメントの全面見直し

開発者のための完全な書き直し：

実際の例とユースケース
一般的な落とし穴の文書化
実用的なワークフローを含む
より良いナビゲーション構造

🧪 安定性の強化

信頼性に焦点：

コアコマンドのバグ修正
テストカバレッジの改善
より堅牢なエラー処理
CI/CDパイプラインの改善

🔬 深い研究機能

DRエージェントアーキテクチャに準拠した自律的ウェブ研究

SuperClaude v4.2は、自律的、適応的、インテリジェントなウェブ研究を可能にする包括的な深い研究機能を導入します。

🎯 適応的計画

3つのインテリジェント戦略：

計画のみ：明確なクエリに対する直接実行
意図計画：曖昧なリクエストの明確化
統一：協調的な計画の洗練（デフォルト）

🔄 マルチホップ推論

最大5回の反復検索：

エンティティ拡張（論文 → 著者 → 作品）
概念深化（トピック → 詳細 → 例）
時間的進行（現在 → 歴史）
因果連鎖（効果 → 原因 → 予防）

📊 品質スコアリング

信頼度ベースの検証：

ソースの信頼性評価（0.0-1.0）
カバレッジの完全性追跡
統合の一貫性評価
最小しきい値：0.6、目標：0.8

🧠 ケースベース学習

セッション横断インテリジェンス：

パターン認識と再利用
時間経過による戦略最適化
成功したクエリ式の保存
パフォーマンス改善追跡

研究コマンドの使用

# 自動深度での基本研究
/research "2024年の最新AI開発"

# 制御された研究深度（TypeScriptのオプション経由）
/research "量子コンピューティングのブレークスルー"  # depth: exhaustive

# 特定の戦略選択
/research "市場分析"  # strategy: planning-only

# ドメインフィルタリング研究（Tavily MCP統合）
/research "Reactパターン"  # domains: reactjs.org,github.com

研究深度レベル

深度	ソース	ホップ	時間	最適な用途
クイック	5-10	1	~2分	簡単な事実、単純なクエリ
標準	10-20	3	~5分	一般的な研究（デフォルト）
深い	20-40	4	~8分	包括的な分析
徹底的	40+	5	~10分	学術レベルの研究

統合ツールオーケストレーション

深い研究システムは複数のツールをインテリジェントに調整します：

Tavily MCP：プライマリウェブ検索と発見
Playwright MCP：複雑なコンテンツ抽出
Sequential MCP：マルチステップ推論と統合
Serena MCP：メモリと学習の持続性
Context7 MCP：技術ドキュメント検索

📚 ドキュメント

🇯🇵 SuperClaude完全日本語ガイド

🚀 はじめに	📖 ユーザーガイド	🛠️ 開発者リソース	📋 リファレンス
📝 クイックスタートガイドすぐに開始 💾 インストールガイド詳細なセットアップ手順	🎯 スラッシュコマンド完全な `/sc` コマンドリスト 🤖 エージェントガイド 16の専門エージェント 🎨 動作モード 7つの適応モード 🚩 フラグガイド動作制御パラメータ 🔧 MCPサーバー 8つのサーバー統合 💼 セッション管理状態の保存と復元	🏗️ 技術アーキテクチャシステム設計の詳細 💻 コード貢献開発ワークフロー 🧪 テスト＆デバッグ品質保証	📓 サンプル集実際の使用例 🔍 トラブルシューティング一般的な問題と修正

🤝 貢献

SuperClaudeコミュニティに参加

あらゆる種類の貢献を歓迎します！お手伝いできる方法は以下のとおりです：

優先度	領域	説明
📝 高	ドキュメント	ガイドの改善、例の追加、タイプミス修正
🔧 高	MCP統合	サーバー設定の追加、統合テスト
🎯 中	ワークフロー	コマンドパターンとレシピの作成
🧪 中	テスト	テストの追加、機能の検証
🌐 低	国際化	ドキュメントの他言語への翻訳

⚖️ ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細はLICENSEファイルを参照してください。

⭐ Star履歴

🚀 SuperClaudeコミュニティによって情熱をもって構築

_{境界を押し広げる開発者のために❤️で作られました}

トップに戻る ↑

---

📋 全30コマンド

完全なコマンドリストを展開

🧠 計画と設計 (4)

/brainstorm - 構造化ブレインストーミング
/design - システムアーキテクチャ
/estimate - 時間/工数見積もり
/spec-panel - 仕様分析

💻 開発 (5)

/implement - コード実装
/build - ビルドワークフロー
/improve - コード改善
/cleanup - リファクタリング
/explain - コード説明

🧪 テストと品質 (4)

/test - テスト生成
/analyze - コード分析
/troubleshoot - デバッグ
/reflect - 振り返り

📚 ドキュメント (2)

/document - ドキュメント生成
/help - コマンドヘルプ

🔧 バージョン管理 (1)

/git - Git操作

📊 プロジェクト管理 (3)

/pm - プロジェクト管理
/task - タスク追跡
/workflow - ワークフロー自動化

🔍 研究と分析 (2)

/research - 深いウェブ研究
/business-panel - ビジネス分析

🎯 ユーティリティ (9)

/agent - AIエージェント
/index-repo - リポジトリインデックス
/index - インデックスエイリアス
/recommend - コマンド推奨
/select-tool - ツール選択
/spawn - 並列タスク
/load - セッション読み込み
/save - セッション保存
/sc - 全コマンド表示

📖 詳細なコマンドリファレンスを表示 →

20 KiB Raw Permalink Blame History Unescape Escape