Fixes (#379)

* Fix: Install only selected MCP servers and ensure valid empty backups

This commit addresses two separate issues:

1.  **MCP Installation:** The `install` command was installing all MCP servers instead of only the ones selected by the user. The `_install` method in `setup/components/mcp.py` was iterating through all available servers, not the user's selection. This has been fixed to respect the `selected_mcp_servers` configuration. A new test has been added to verify this fix.

2.  **Backup Creation:** The `create_backup` method in `setup/core/installer.py` created an invalid `.tar.gz` file when the backup source was empty. This has been fixed to ensure that a valid, empty tar archive is always created. A test was added for this as well.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* Fix: Correct installer validation for MCP and MCP Docs components

This commit fixes a validation issue in the installer where it would incorrectly fail after a partial installation of MCP servers.

The `MCPComponent` validation logic was checking for all "required" servers, regardless of whether they were selected by the user. This has been corrected to only validate the servers that were actually installed, by checking against the list of installed servers stored in the metadata. The metadata storage has also been fixed to only record the installed servers.

The `MCPDocsComponent` was failing validation because it was not being registered in the metadata if no documentation files were installed. This has been fixed by ensuring the post-installation hook runs even when no files are copied.

New tests have been added for both components to verify the corrected logic.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* Fix: Allow re-installation of components and correct validation logic

This commit fixes a bug that prevented new MCP servers from being installed on subsequent runs of the installer. It also fixes the validation logic that was causing failures after a partial installation.

The key changes are:
1.  A new `is_reinstallable` method has been added to the base `Component` class. This allows certain components (like the `mcp` component) to be re-run even if they are already marked as installed.
2.  The installer logic has been updated to respect this new method.
3.  The `MCPComponent` now correctly stores only the installed servers in the metadata.
4.  The validation logic for `MCPComponent` and `MCPDocsComponent` has been corrected to prevent incorrect failures.

New tests have been added to verify all aspects of the new logic.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Display authors in UI header and update author info

This commit implements the user's request to display author names and emails in the UI header of the installer.

The key changes are:
1.  The `__email__` field in `SuperClaude/__init__.py` has been updated to include both authors' emails.
2.  The `display_header` function in `setup/utils/ui.py` has been modified to read the author and email information and display it.
3.  A new test has been added to `tests/test_ui.py` to verify the new UI output.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Version bump to 4.1.0 and various fixes

This commit prepares the project for the v4.1.0 release. It includes a version bump across all relevant files and incorporates several bug fixes and feature enhancements from recent tasks.

Key changes in this release:

- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 in all configuration files, documentation, and source code.

- **Installer Fixes**:
  - Components can now be marked as `reinstallable`, allowing them to be re-run on subsequent installations. This fixes a bug where new MCP servers could not be added.
  - The validation logic for `mcp` and `mcp_docs` components has been corrected to avoid incorrect failures.
  - A bug in the backup creation process that created invalid empty archives has been fixed.

- **UI Enhancements**:
  - Author names and emails are now displayed in the installer UI header.

- **Metadata Updates**:
  - Mithun Gowda B has been added as an author.

- **New Tests**:
  - Comprehensive tests have been added for the installer logic, MCP components, and UI changes to ensure correctness and prevent regressions.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* fix: Resolve dependencies for partial installs and other fixes

This commit addresses several issues, the main one being a dependency resolution failure during partial installations.

Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree when a user requests to install a subset of components. This fixes the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run on subsequent installs, enabling the addition of new servers.
- **Validation Logic**: The validation for `mcp` and `mcp_docs` has been corrected to avoid spurious failures.
- **UI and Metadata**: Author information has been added to the UI header and source files.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Tests**: New tests have been added to cover all the above changes.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* fix: Installer fixes and version bump to 4.1.0

This commit includes a collection of fixes for the installer logic, UI enhancements, and a version bump to 4.1.0.

Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree for partial installations, fixing the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run to add new servers.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts the user to select servers.
- **Validation Logic**: The post-installation validation logic has been corrected to only validate components from the current session and to use the correct list of installed servers.
- **UI & Metadata**: Author information has been added to the UI and source files.
- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 across all files.
- **Tests**: New tests have been added to cover all the bug fixes.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Add --authors flag and multiple installer fixes

This commit introduces the `--authors` flag to display author information and includes a collection of fixes for the installer logic.

Key changes:
- **New Feature**: Added an `--authors` flag that displays the names, emails, and GitHub usernames of the project authors.
- **Dependency Resolution**: Fixed a critical bug where partial installations would fail due to unresolved dependencies.
- **Component Re-installation**: Added a mechanism to allow components to be "reinstallable", fixing an issue that prevented adding new MCP servers on subsequent runs.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts for server selection.
- **Validation Logic**: Corrected the post-installation validation to prevent spurious errors.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Metadata**: Author and GitHub information has been added to the source files.
- **UI**: The installer header now displays author information.
- **Tests**: Added new tests for all new features and bug fixes.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* Add Docker support and framework enhancements

- Add serena-docker.json MCP configuration
- Update MCP configs and installer components
- Enhance CLI commands with new functionality
- Add symbols utility for framework operations
- Improve UI and logging components

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Bump version from 4.1.1 to 4.1.2

- Update version across all package files
- Update documentation and README files
- Update Python module version strings
- Update feature configuration files

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>

* Bump version from 4.1.2 to 4.1.3

- Update version across all package files
- Update documentation and README files
- Update Python module version strings
- Update feature configuration files

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>

* Fix home directory detection for immutable distros

- Add get_home_directory() function to handle /var/home/$USER paths
- Support Fedora Silverblue, Universal Blue, and other immutable distros
- Replace all Path.home() calls throughout the setup system
- Add fallback methods for edge cases and compatibility
- Create test script for immutable distro validation

Fixes:
- Incorrect home path detection on immutable Linux distributions
- Installation failures on Fedora Silverblue/Universal Blue
- Issues with Claude Code configuration paths

Technical changes:
- New get_home_directory() in utils/environment.py
- Updated all CLI commands, validators, and core components
- Maintains backward compatibility with standard systems
- Robust fallback chain for edge cases

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>

* Fix circular import and complete immutable distro support

- Move get_home_directory() to separate paths.py module
- Resolve circular import between environment.py and logger.py
- Update all import statements across the setup system
- Verify functionality with comprehensive testing

Technical changes:
- Created setup/utils/paths.py for path utilities
- Updated imports in all affected modules
- Maintains full backward compatibility
- Fixes installation on immutable distros

Testing completed:
- ✅ Basic home directory detection works
- ✅ Installation system integration works
- ✅ Environment utilities integration works
- ✅ Immutable distro logic validated

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>

* Fix mcp_docs installation bugs

- Fix mcp_docs component incorrectly marking as installed when no MCP servers selected
- Add MCP server selection prompt when mcp_docs component is explicitly requested
- Return False instead of calling _post_install() when no servers selected or files found
- Add user-friendly warning when mcp_docs requested without server selection
- Remove mcp_docs from installation when no servers are available

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix MCP server name mapping for documentation files

- Add mapping for sequential-thinking -> MCP_Sequential.md
- Add mapping for morphllm-fast-apply -> MCP_Morphllm.md
- Ensures mcp_docs installation works with all MCP server naming conventions

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Enable mcp_docs component reinstallation

- Add is_reinstallable() method returning True to allow repeat installations
- Fixes issue where mcp_docs was skipped on subsequent installation attempts
- Enables users to change MCP server selections and update documentation

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix repeat installation issues for mcp_docs

- Ensure mcp component is auto-added when mcp_docs is selected with servers
- Fix component_files tracking to only include successfully copied files
- Ensures CLAUDE.md gets properly updated with MCP documentation imports
- Fixes issue where MCP servers weren't installed on repeat attempts

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix MCP component metadata tracking and debug logging

- Fix servers_count to track actually installed servers instead of total available
- Add installed_servers list to metadata for better tracking
- Add debug logging to trace component auto-addition
- Ensures MCP component appears properly in metadata when servers are installed

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix pyproject.toml license format and add missing classifier

- Fix license format from string to {text = "MIT"} format
- Add missing "License :: OSI Approved :: MIT License" classifier
- Fix indentation consistency in classifiers section
- Resolves setup.py installation errors and PEP 621 compliance

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix MCP incremental installation and auto-detection system

PROBLEM FIXED:
- MCP component only registered servers selected during current session
- mcp_docs component only installed docs for newly selected servers
- Users had to reinstall everything when adding new MCP servers
- Installation failed if no servers selected but servers existed

SOLUTION IMPLEMENTED:
- Add auto-detection of existing MCP servers from config files (.claude.json, claude_desktop_config.json)
- Add CLI detection via 'claude mcp list' output parsing
- Add smart server merging (existing + selected + previously installed)
- Add server name normalization for common variations
- Fix CLI logic to allow mcp_docs installation without server selection
- Add graceful error handling for corrupted configs

KEY FEATURES:
✅ Auto-detects existing MCP servers from multiple config locations
✅ Supports incremental installation (add new servers without breaking existing)
✅ Works with or without --install-dir argument
✅ Handles server name variations (sequential vs sequential-thinking, etc.)
✅ Maintains metadata persistence across installation sessions
✅ Graceful fallback when config files are corrupted
✅ Compatible with both interactive and non-interactive modes

TESTED SCENARIOS:
- Fresh installation with no MCP servers ✅
- Auto-detection with existing servers ✅
- Incremental server additions ✅
- Mixed mode (new + existing servers) ✅
- Error handling with corrupted configs ✅
- Default vs custom installation directories ✅
- Interactive vs command-line modes ✅

Files changed:
- setup/cli/commands/install.py: Allow mcp_docs auto-detection mode
- setup/components/mcp.py: Add comprehensive auto-detection logic
- setup/components/mcp_docs.py: Add auto-detection for documentation

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Integrate SuperClaude framework flags into help command

ENHANCEMENT:
- Add comprehensive flag documentation to /sc:help command
- Include all 25 SuperClaude framework flags with descriptions
- Organize flags into logical categories (Mode, MCP, Analysis, Execution, Output)
- Add practical usage examples showing flag combinations
- Include flag priority rules and precedence hierarchy

NEW SECTIONS ADDED:
✅ Mode Activation Flags (5 flags): --brainstorm, --introspect, --task-manage, --orchestrate, --token-efficient
✅ MCP Server Flags (8 flags): --c7, --seq, --magic, --morph, --serena, --play, --all-mcp, --no-mcp
✅ Analysis Depth Flags (3 flags): --think, --think-hard, --ultrathink
✅ Execution Control Flags (6 flags): --delegate, --concurrency, --loop, --iterations, --validate, --safe-mode
✅ Output Optimization Flags (3 flags): --uc, --scope, --focus
✅ Flag Priority Rules: Clear hierarchy and precedence guidelines
✅ Usage Examples: 4 practical examples showing real-world flag combinations

IMPACT:
- Users can now discover all SuperClaude capabilities from /sc:help
- Single source of truth for commands AND flags
- Improved discoverability of advanced features
- Clear guidance on flag usage and combinations
- Help content nearly doubled (68 → 148 lines) with valuable reference information

Files changed:
- SuperClaude/Commands/help.md: Integrate FLAGS.md content with structured tables and examples

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Remove non-existent commands from modes.md documentation

PROBLEM FIXED:
- Documentation contained references to fake/non-existent commands
- Commands like sc:fix, sc:simple-pix, sc:update, sc:develop, sc:modernize, sc:simple-fix don't exist in CLI
- Confusing users who try to use these commands and get errors
- Inconsistency between documentation and actual SuperClaude command availability

COMMANDS REMOVED/REPLACED:
❌ /sc:simple-fix → ✅ /sc:troubleshoot (real command)
❌ /sc:develop → ✅ /sc:implement (real command)
❌ /sc:modernize → ✅ /sc:improve (real command)

AFFECTED FILES:
- Docs/User-Guide/modes.md: Fixed all non-existent command references
- Docs/User-Guide-jp/modes.md: Fixed Japanese translation with same issues
- Docs/User-Guide-zh/modes.md: Fixed Chinese translation with same issues

VERIFICATION:
✅ All remaining /sc: commands verified to exist in SuperClaude/Commands/
✅ No more references to fake commands in any language version
✅ Examples now use only real, working SuperClaude commands
✅ User experience improved - no more confusion from non-working commands

REAL COMMANDS REFERENCED:
- /sc:analyze, /sc:brainstorm, /sc:help, /sc:implement
- /sc:improve, /sc:reflect, /sc:troubleshoot
- All verified to exist in CLI implementation

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Version bump to 4.1.4

CHANGELOG:
✅ Added comprehensive flag documentation to /sc:help command
✅ Fixed MCP incremental installation and auto-detection system
✅ Cleaned up documentation by removing non-existent commands
✅ Enhanced user experience with complete capability reference

VERSION UPDATES:
- Updated VERSION file: 4.1.3 → 4.1.4
- Updated pyproject.toml: 4.1.3 → 4.1.4
- Updated package.json: 4.1.3 → 4.1.4
- Updated all Python __init__.py fallback versions
- Updated all documentation references across all languages
- Updated setup/data/features.json component versions
- Updated CHANGELOG.md with comprehensive 4.1.4 release notes

SCOPE OF CHANGES:
📦 Core files: VERSION, pyproject.toml, package.json, __init__.py files
📚 Documentation: All .md files across English, Japanese, Chinese
🔧 Setup files: features.json, base.py version references
📝 Project files: README files, CHANGELOG, SECURITY, CONTRIBUTING

VERIFICATION:
✅ No remaining 4.1.3 references found
✅ 29 files now properly reference 4.1.4
✅ All language versions consistently updated
✅ Package metadata properly versioned for distribution

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix Serena MCP installation to use uvx instead of uv run

- Update serena.json config template to use uvx with git+https://github.com/oraios/serena
- Fix documentation across all language versions (EN, JP, ZH) to show correct uvx syntax
- Update mcp-server-guide.md troubleshooting section with proper Serena reinstallation commands
- Remove obsolete npm-based installation references

This resolves GitHub Codespace installation failures where 'uv run serena' failed
because serena wasn't locally installed. The uvx approach correctly fetches from
the official GitHub repository as documented by Serena maintainers.

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* some fixes

* Update pyproject.toml

Version

* Update VERSION

Fix

---------

Signed-off-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Happy <yesreply@happy.engineering>

.claude/settings.json

@@ -1 +0,0 @@
-{}

.claude/skills/confidence-check/SKILL.md

@@ -1,125 +0,0 @@
----
-name: Confidence Check
-description: Pre-implementation confidence assessment (≥90% required). Use before starting any implementation to verify readiness with duplicate check, architecture compliance, official docs verification, OSS references, and root cause identification.
-allowed-tools: Read, Grep, Glob, WebFetch, WebSearch
----
-
-# Confidence Check Skill
-
-## Purpose
-
-Prevents wrong-direction execution by assessing confidence **BEFORE** starting implementation.
-
-**Requirement**: ≥90% confidence to proceed with implementation.
-
-**Test Results** (2025-10-21):
-- Precision: 1.000 (no false positives)
-- Recall: 1.000 (no false negatives)
-- 8/8 test cases passed
-
-## When to Use
-
-Use this skill BEFORE implementing any task to ensure:
-- No duplicate implementations exist
-- Architecture compliance verified
-- Official documentation reviewed
-- Working OSS implementations found
-- Root cause properly identified
-
-## Confidence Assessment Criteria
-
-Calculate confidence score (0.0 - 1.0) based on 5 checks:
-
-### 1. No Duplicate Implementations? (25%)
-
-**Check**: Search codebase for existing functionality
-
-```bash
-# Use Grep to search for similar functions
-# Use Glob to find related modules
-```
-
-✅ Pass if no duplicates found
-❌ Fail if similar implementation exists
-
-### 2. Architecture Compliance? (25%)
-
-**Check**: Verify tech stack alignment
-
-- Read `CLAUDE.md`, `PLANNING.md`
-- Confirm existing patterns used
-- Avoid reinventing existing solutions
-
-✅ Pass if uses existing tech stack (e.g., Supabase, UV, pytest)
-❌ Fail if introduces new dependencies unnecessarily
-
-### 3. Official Documentation Verified? (20%)
-
-**Check**: Review official docs before implementation
-
-- Use Context7 MCP for official docs
-- Use WebFetch for documentation URLs
-- Verify API compatibility
-
-✅ Pass if official docs reviewed
-❌ Fail if relying on assumptions
-
-### 4. Working OSS Implementations Referenced? (15%)
-
-**Check**: Find proven implementations
-
-- Use Tavily MCP or WebSearch
-- Search GitHub for examples
-- Verify working code samples
-
-✅ Pass if OSS reference found
-❌ Fail if no working examples
-
-### 5. Root Cause Identified? (15%)
-
-**Check**: Understand the actual problem
-
-- Analyze error messages
-- Check logs and stack traces
-- Identify underlying issue
-
-✅ Pass if root cause clear
-❌ Fail if symptoms unclear
-
-## Confidence Score Calculation
-
-```
-Total = Check1 (25%) + Check2 (25%) + Check3 (20%) + Check4 (15%) + Check5 (15%)
-
-If Total >= 0.90:  ✅ Proceed with implementation
-If Total >= 0.70:  ⚠️  Present alternatives, ask questions
-If Total < 0.70:   ❌ STOP - Request more context
-```
-
-## Output Format
-
-```
-📋 Confidence Checks:
-   ✅ No duplicate implementations found
-   ✅ Uses existing tech stack
-   ✅ Official documentation verified
-   ✅ Working OSS implementation found
-   ✅ Root cause identified
-
-📊 Confidence: 1.00 (100%)
-✅ High confidence - Proceeding to implementation
-```
-
-## Implementation Details
-
-The TypeScript implementation is available in `confidence.ts` for reference, containing:
-
-- `confidenceCheck(context)` - Main assessment function
-- Detailed check implementations
-- Context interface definitions
-
-## ROI
-
-**Token Savings**: Spend 100-200 tokens on confidence check to save 5,000-50,000 tokens on wrong-direction work.
-
-**Success Rate**: 100% precision and recall in production testing.

.claude/skills/confidence-check/confidence.ts

@@ -1,171 +0,0 @@
-/**
- * Confidence Check - Pre-implementation confidence assessment
- *
- * Prevents wrong-direction execution by assessing confidence BEFORE starting.
- * Requires ≥90% confidence to proceed with implementation.
- *
- * Test Results (2025-10-21):
- * - Precision: 1.000 (no false positives)
- * - Recall: 1.000 (no false negatives)
- * - 8/8 test cases passed
- */
-
-export interface Context {
-  task?: string;
-  duplicate_check_complete?: boolean;
-  architecture_check_complete?: boolean;
-  official_docs_verified?: boolean;
-  oss_reference_complete?: boolean;
-  root_cause_identified?: boolean;
-  confidence_checks?: string[];
-  [key: string]: any;
-}
-
-/**
- * Assess confidence level (0.0 - 1.0)
- *
- * Investigation Phase Checks:
- * 1. No duplicate implementations? (25%)
- * 2. Architecture compliance? (25%)
- * 3. Official documentation verified? (20%)
- * 4. Working OSS implementations referenced? (15%)
- * 5. Root cause identified? (15%)
- *
- * @param context - Task context with investigation flags
- * @returns Confidence score (0.0 = no confidence, 1.0 = absolute certainty)
- */
-export async function confidenceCheck(context: Context): Promise<number> {
-  let score = 0.0;
-  const checks: string[] = [];
-
-  // Check 1: No duplicate implementations (25%)
-  if (noDuplicates(context)) {
-    score += 0.25;
-    checks.push("✅ No duplicate implementations found");
-  } else {
-    checks.push("❌ Check for existing implementations first");
-  }
-
-  // Check 2: Architecture compliance (25%)
-  if (architectureCompliant(context)) {
-    score += 0.25;
-    checks.push("✅ Uses existing tech stack (e.g., Supabase)");
-  } else {
-    checks.push("❌ Verify architecture compliance (avoid reinventing)");
-  }
-
-  // Check 3: Official documentation verified (20%)
-  if (hasOfficialDocs(context)) {
-    score += 0.2;
-    checks.push("✅ Official documentation verified");
-  } else {
-    checks.push("❌ Read official docs first");
-  }
-
-  // Check 4: Working OSS implementations referenced (15%)
-  if (hasOssReference(context)) {
-    score += 0.15;
-    checks.push("✅ Working OSS implementation found");
-  } else {
-    checks.push("❌ Search for OSS implementations");
-  }
-
-  // Check 5: Root cause identified (15%)
-  if (rootCauseIdentified(context)) {
-    score += 0.15;
-    checks.push("✅ Root cause identified");
-  } else {
-    checks.push("❌ Continue investigation to identify root cause");
-  }
-
-  // Store check results
-  context.confidence_checks = checks;
-
-  // Display checks
-  console.log("📋 Confidence Checks:");
-  checks.forEach(check => console.log(`   ${check}`));
-  console.log("");
-
-  return score;
-}
-
-/**
- * Check for duplicate implementations
- *
- * Before implementing, verify:
- * - No existing similar functions/modules (Glob/Grep)
- * - No helper functions that solve the same problem
- * - No libraries that provide this functionality
- */
-function noDuplicates(context: Context): boolean {
-  return context.duplicate_check_complete ?? false;
-}
-
-/**
- * Check architecture compliance
- *
- * Verify solution uses existing tech stack:
- * - Supabase project → Use Supabase APIs (not custom API)
- * - Next.js project → Use Next.js patterns (not custom routing)
- * - Turborepo → Use workspace patterns (not manual scripts)
- */
-function architectureCompliant(context: Context): boolean {
-  return context.architecture_check_complete ?? false;
-}
-
-/**
- * Check if official documentation verified
- *
- * For testing: uses context flag 'official_docs_verified'
- * For production: checks for README.md, CLAUDE.md, docs/ directory
- */
-function hasOfficialDocs(context: Context): boolean {
-  // Check context flag (for testing and runtime)
-  if ('official_docs_verified' in context) {
-    return context.official_docs_verified ?? false;
-  }
-
-  // Fallback: check for documentation files (production)
-  // This would require filesystem access in Node.js
-  return false;
-}
-
-/**
- * Check if working OSS implementations referenced
- *
- * Search for:
- * - Similar open-source solutions
- * - Reference implementations in popular projects
- * - Community best practices
- */
-function hasOssReference(context: Context): boolean {
-  return context.oss_reference_complete ?? false;
-}
-
-/**
- * Check if root cause is identified with high certainty
- *
- * Verify:
- * - Problem source pinpointed (not guessing)
- * - Solution addresses root cause (not symptoms)
- * - Fix verified against official docs/OSS patterns
- */
-function rootCauseIdentified(context: Context): boolean {
-  return context.root_cause_identified ?? false;
-}
-
-/**
- * Get recommended action based on confidence level
- *
- * @param confidence - Confidence score (0.0 - 1.0)
- * @returns Recommended action
- */
-export function getRecommendation(confidence: number): string {
-  if (confidence >= 0.9) {
-    return "✅ High confidence (≥90%) - Proceed with implementation";
-  } else if (confidence >= 0.7) {
-    return "⚠️ Medium confidence (70-89%) - Continue investigation, DO NOT implement yet";
-  } else {
-    return "❌ Low confidence (<70%) - STOP and continue investigation loop";
-  }
-}

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,52 +0,0 @@
-# Pull Request
-
-## Summary
-
-<!-- Briefly describe the purpose of this PR -->
-
-## Changes
-
-<!-- List the main changes -->
--
-
-## Related Issue
-
-<!-- Reference related issue numbers if applicable -->
-Closes #
-
-## Checklist
-
-### Git Workflow
-- [ ] External contributors: Followed Fork → topic branch → upstream PR flow
-- [ ] Collaborators: Used topic branch (no direct commits to main)
-- [ ] Rebased on upstream/main (`git rebase upstream/main`, no conflicts)
-- [ ] Commit messages follow Conventional Commits (`feat:`, `fix:`, `docs:`, etc.)
-
-### Code Quality
-- [ ] Changes are limited to a single purpose (not a mega-PR; aim for ~200 lines diff)
-- [ ] Follows existing code conventions and patterns
-- [ ] Added appropriate tests for new features/fixes
-- [ ] Lint/Format/Typecheck all pass
-- [ ] CI/CD pipeline succeeds (green status)
-
-### Security
-- [ ] No secrets or credentials committed
-- [ ] Necessary files excluded via `.gitignore`
-- [ ] No breaking changes, or if so: `!` commit + MIGRATION.md documented
-
-### Documentation
-- [ ] Updated documentation as needed (README, CLAUDE.md, docs/, etc.)
-- [ ] Added comments for complex logic
-- [ ] API changes are properly documented
-
-## How to Test
-
-<!-- Describe how to verify this PR works -->
-
-## Screenshots (if applicable)
-
-<!-- Attach screenshots for UI changes -->
-
-## Notes
-
-<!-- Anything you want reviewers to know, technical decisions, etc. -->

.github/workflows/README.md

@@ -1,158 +0,0 @@
-# GitHub Actions Workflows
-
-This directory contains CI/CD workflows for SuperClaude Framework.
-
-## Workflows
-
-### 1. **test.yml** - Comprehensive Test Suite
-**Triggers**: Push/PR to `master` or `integration`, manual dispatch
-**Jobs**:
-- **test**: Run tests on Python 3.10, 3.11, 3.12
-  - Install UV and dependencies
-  - Run full test suite
-  - Generate coverage report (Python 3.10 only)
-  - Upload to Codecov
-- **lint**: Run ruff linter and format checker
-- **plugin-check**: Verify pytest plugin loads correctly
-- **doctor-check**: Run `superclaude doctor` health check
-- **test-summary**: Aggregate results from all jobs
-
-**Status Badge**:
-```markdown
-[![Tests](https://github.com/SuperClaude-Org/SuperClaude_Framework/actions/workflows/test.yml/badge.svg)](https://github.com/SuperClaude-Org/SuperClaude_Framework/actions/workflows/test.yml)
-```
-
-### 2. **quick-check.yml** - Fast PR Feedback
-**Triggers**: Pull requests to `master` or `integration`
-**Jobs**:
-- **quick-test**: Fast check on Python 3.10 only
-  - Run unit tests only (faster)
-  - Run linter
-  - Check formatting
-  - Verify plugin loads
-  - 10 minute timeout
-
-**Purpose**: Provide rapid feedback on PRs before running full test matrix.
-
-### 3. **publish-pypi.yml** (Existing)
-**Triggers**: Manual or release tags
-**Purpose**: Publish package to PyPI
-
-### 4. **readme-quality-check.yml** (Existing)
-**Triggers**: Push/PR affecting README files
-**Purpose**: Validate README quality and consistency
-
-## Local Testing
-
-Before pushing, run these commands locally:
-
-```bash
-# Run full test suite
-uv run pytest -v
-
-# Run with coverage
-uv run pytest --cov=superclaude --cov-report=term
-
-# Run linter
-uv run ruff check src/ tests/
-
-# Check formatting
-uv run ruff format --check src/ tests/
-
-# Auto-fix formatting
-uv run ruff format src/ tests/
-
-# Verify plugin loads
-uv run pytest --trace-config | grep superclaude
-
-# Run doctor check
-uv run superclaude doctor --verbose
-```
-
-## CI/CD Pipeline
-
-```
-┌─────────────────────┐
-│   Push/PR Created   │
-└──────────┬──────────┘
-           │
-           ├─────────────────────────┐
-           │                         │
-    ┌──────▼──────┐         ┌───────▼────────┐
-    │ Quick Check │         │  Full Test     │
-    │  (PR only)  │         │   Matrix       │
-    │             │         │                │
-    │ • Unit tests│         │ • Python 3.10  │
-    │ • Lint      │         │ • Python 3.11  │
-    │ • Format    │         │ • Python 3.12  │
-    │             │         │ • Coverage     │
-    │ ~2-3 min    │         │ • Lint         │
-    └─────────────┘         │ • Plugin check │
-                            │ • Doctor check │
-                            │                │
-                            │ ~5-8 min       │
-                            └────────────────┘
-```
-
-## Coverage Reporting
-
-Coverage reports are generated for Python 3.10 and uploaded to Codecov.
-
-To view coverage locally:
-```bash
-uv run pytest --cov=superclaude --cov-report=html
-open htmlcov/index.html
-```
-
-## Troubleshooting
-
-### Workflow fails with "UV not found"
-- UV is installed in each job via `curl -LsSf https://astral.sh/uv/install.sh | sh`
-- If installation fails, check UV's status page
-
-### Tests fail locally but pass in CI (or vice versa)
-- Check Python version: `python --version`
-- Reinstall dependencies: `uv pip install -e ".[dev]"`
-- Clear caches: `rm -rf .pytest_cache .venv`
-
-### Plugin not loading in CI
-- Verify entry point in `pyproject.toml`: `[project.entry-points.pytest11]`
-- Check plugin is installed: `uv run pytest --trace-config`
-
-### Coverage upload fails
-- This is non-blocking (fail_ci_if_error: false)
-- Check Codecov token in repository secrets
-
-## Maintenance
-
-### Adding a New Workflow
-1. Create new `.yml` file in this directory
-2. Follow existing structure (checkout, setup-python, install UV)
-3. Add status badge to README.md if needed
-4. Document in this file
-
-### Updating Python Versions
-1. Edit `matrix.python-version` in `test.yml`
-2. Update `pyproject.toml` classifiers
-3. Test locally with new version first
-
-### Modifying Test Strategy
-- **quick-check.yml**: For fast PR feedback (unit tests only)
-- **test.yml**: For comprehensive validation (full matrix)
-
-## Best Practices
-
-1. **Keep workflows fast**: Use caching, parallel jobs
-2. **Fail fast**: Use `-x` flag in pytest for quick-check
-3. **Clear names**: Job and step names should be descriptive
-4. **Version pinning**: Pin action versions (@v4, @v5)
-5. **Matrix testing**: Test on multiple Python versions
-6. **Non-blocking coverage**: Don't fail on coverage upload errors
-7. **Manual triggers**: Add `workflow_dispatch` for debugging
-
-## Resources
-
-- [GitHub Actions Documentation](https://docs.github.com/en/actions)
-- [UV Documentation](https://github.com/astral-sh/uv)
-- [Pytest Documentation](https://docs.pytest.org/)
-- [SuperClaude Testing Guide](../../docs/developer-guide/testing-debugging.md)

.github/workflows/publish-pypi.yml

@@ -52,28 +52,28 @@ jobs:
         echo "📦 Checking package structure..."
         ls -la
         echo "🔍 Checking SuperClaude package..."
-        ls -la src/superclaude/
-        echo "🔍 Verifying src directory..."
-        ls -la src/
+        ls -la SuperClaude/
+        echo "🔍 Checking setup package..."
+        ls -la setup/
         
         # Verify version consistency
         echo "📋 Checking version consistency..."
         python -c "
         import toml
         import sys
-        sys.path.insert(0, 'src')
-
+        sys.path.insert(0, '.')
+        
         # Load pyproject.toml version
         with open('pyproject.toml', 'r') as f:
             pyproject = toml.load(f)
         pyproject_version = pyproject['project']['version']
-
+        
         # Load package version
-        from superclaude import __version__
-
+        from SuperClaude import __version__
+        
         print(f'pyproject.toml version: {pyproject_version}')
         print(f'Package version: {__version__}')
-
+        
         if pyproject_version != __version__:
             print('❌ Version mismatch!')
             sys.exit(1)
@@ -122,7 +122,7 @@ jobs:
         echo "|----------|-------|" >> $GITHUB_STEP_SUMMARY
         echo "| Target | ${{ github.event_name == 'release' && 'PyPI (Production)' || github.event.inputs.target || 'TestPyPI' }} |" >> $GITHUB_STEP_SUMMARY
         echo "| Trigger | ${{ github.event_name }} |" >> $GITHUB_STEP_SUMMARY
-        echo "| Version | $(python -c 'import sys; sys.path.insert(0, \"src\"); from superclaude import __version__; print(__version__)') |" >> $GITHUB_STEP_SUMMARY
+        echo "| Version | $(python -c 'from SuperClaude import __version__; print(__version__)') |" >> $GITHUB_STEP_SUMMARY
         echo "| Commit | ${{ github.sha }} |" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
         
@@ -160,13 +160,13 @@ jobs:
         
         # Test basic import
         python -c "
-        import superclaude
-        print(f'✅ Successfully imported SuperClaude v{superclaude.__version__}')
-
+        import SuperClaude
+        print(f'✅ Successfully imported SuperClaude v{SuperClaude.__version__}')
+        
         # Test CLI entry point
         import subprocess
         result = subprocess.run(['SuperClaude', '--version'], capture_output=True, text=True)
         print(f'✅ CLI version: {result.stdout.strip()}')
         "
         
-        echo "✅ Installation test completed successfully!"
+        echo "✅ Installation test completed successfully!"

.github/workflows/pull-sync-framework.yml

@@ -1,140 +0,0 @@
-name: Pull Sync from Framework
-
-on:
-  schedule:
-    - cron: '0 */6 * * *'
-  workflow_dispatch:
-
-jobs:
-  sync-and-isolate:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
-    steps:
-      - name: Checkout Plugin Repository (Target)
-        uses: actions/checkout@v4
-        with:
-          path: plugin-repo
-
-      - name: Check for Framework updates
-        id: check-updates
-        run: |
-          FRAMEWORK_HEAD=$(git ls-remote https://github.com/SuperClaude-Org/SuperClaude_Framework HEAD | cut -f1)
-          echo "Current framework HEAD: $FRAMEWORK_HEAD"
-          echo "framework-head=$FRAMEWORK_HEAD" >> $GITHUB_OUTPUT
-
-          LAST_SYNCED=""
-          if [ -f "plugin-repo/docs/.framework-sync-commit" ]; then
-            LAST_SYNCED=$(cat plugin-repo/docs/.framework-sync-commit)
-            echo "Last synced commit: $LAST_SYNCED"
-          else
-            echo "No previous sync state - will run sync"
-          fi
-
-          if [ "$FRAMEWORK_HEAD" = "$LAST_SYNCED" ] && [ "${{ github.event_name }}" != "workflow_dispatch" ]; then
-            echo "✅ Framework is up to date - skipping sync"
-            echo "has-updates=false" >> $GITHUB_OUTPUT
-          else
-            echo "🔄 Framework has updates - proceeding with sync"
-            echo "has-updates=true" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Checkout Framework Repository (Source)
-        if: steps.check-updates.outputs.has-updates == 'true'
-        uses: actions/checkout@v4
-        with:
-          repository: SuperClaude-Org/SuperClaude_Framework
-          path: framework-src
-
-      - name: Set up Python
-        if: steps.check-updates.outputs.has-updates == 'true'
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.10'
-
-      - name: Run Transformation & Sync Logic
-        if: steps.check-updates.outputs.has-updates == 'true'
-        run: |
-          cd plugin-repo
-          python3 scripts/sync_from_framework.py
-
-      - name: Verify protected files are unchanged
-        if: steps.check-updates.outputs.has-updates == 'true'
-        working-directory: plugin-repo
-        run: |
-          # Note: plugin.json removed from list as it is updated by the MCP merge script
-          PROTECTED=(
-            "README.md" "README-ja.md" "README-zh.md"
-            "BACKUP_GUIDE.md" "MIGRATION_GUIDE.md" "SECURITY.md"
-            "CLAUDE.md" "LICENSE" ".gitignore"
-            ".claude-plugin/marketplace.json"
-            "core/" "modes/"
-          )
-          VIOLATIONS=()
-          for path in "${PROTECTED[@]}"; do
-            if git diff --name-only HEAD -- "$path" | grep -q .; then
-              VIOLATIONS+=("$path")
-            fi
-          done
-          if [ ${#VIOLATIONS[@]} -gt 0 ]; then
-            echo "🚨 PROTECTION VIOLATION: sync modified Plugin-owned files:"
-            for v in "${VIOLATIONS[@]}"; do echo "  • $v"; done
-            echo ""
-            echo "Fix: check SYNC_MAPPINGS in scripts/sync_from_framework.py"
-            exit 1
-          fi
-          echo "🔒 Protection check passed — no Plugin-owned files were modified"
-
-      - name: Save framework sync state
-        if: steps.check-updates.outputs.has-updates == 'true'
-        run: |
-          echo "${{ steps.check-updates.outputs.framework-head }}" > plugin-repo/docs/.framework-sync-commit
-          echo "✅ Saved framework commit: ${{ steps.check-updates.outputs.framework-head }}"
-
-      - name: Commit Changes to Sync Branch
-        if: steps.check-updates.outputs.has-updates == 'true'
-        id: commit-changes
-        working-directory: plugin-repo
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-          SYNC_BRANCH="framework-sync/$(date +'%Y-%m-%d-%H%M')"
-          git checkout -b "$SYNC_BRANCH"
-
-          git add commands/ agents/ .claude-plugin/plugin.json plugin.json
-
-          if [ -f "docs/.framework-sync-commit" ]; then
-            git add -f docs/.framework-sync-commit
-          fi
-
-          if ! git diff --cached --quiet; then
-            git commit -m "chore: automated sync from framework [${{ steps.check-updates.outputs.framework-head }}]"
-            git push origin "$SYNC_BRANCH"
-            echo "has-changes=true" >> $GITHUB_OUTPUT
-            echo "sync-branch=$SYNC_BRANCH" >> $GITHUB_OUTPUT
-          else
-            echo "No changes detected."
-            echo "has-changes=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Create Pull Request for Review
-        if: steps.commit-changes.outputs.has-changes == 'true'
-        working-directory: plugin-repo
-        env:
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          gh pr create \
-            --title "chore: framework sync ${{ steps.check-updates.outputs.framework-head }}" \
-            --body "## Automated Framework Sync
-
-          Synced from upstream framework commit: \`${{ steps.check-updates.outputs.framework-head }}\`
-
-          **Review required before merge.** This PR was created automatically by the framework sync workflow. Please review the changes to ensure no unexpected modifications were introduced.
-
-          ---
-          *Auto-generated by pull-sync-framework workflow*" \
-            --base main \
-            --head "${{ steps.commit-changes.outputs.sync-branch }}"

.github/workflows/quick-check.yml

@@ -1,54 +0,0 @@
-name: Quick Check
-
-on:
-  pull_request:
-    branches: [master, integration]
-
-jobs:
-  quick-test:
-    name: Quick Test (Python 3.10)
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-
-      - name: Install UV
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-
-      - name: Install dependencies
-        run: |
-          uv pip install --system -e ".[dev]"
-
-      - name: Run unit tests only
-        run: |
-          pytest tests/unit/ -v --tb=short -x
-
-      - name: Run linter
-        run: |
-          ruff check src/ tests/
-
-      - name: Check formatting
-        run: |
-          ruff format --check src/ tests/
-
-      - name: Verify pytest plugin
-        run: |
-          pytest --trace-config 2>&1 | grep -q "superclaude"
-
-      - name: Summary
-        if: success()
-        run: |
-          echo "✅ Quick checks passed!"
-          echo "  - Unit tests: PASSED"
-          echo "  - Linting: PASSED"
-          echo "  - Formatting: PASSED"
-          echo "  - Plugin: LOADED"

.github/workflows/readme-quality-check.yml

@@ -39,8 +39,8 @@ jobs:
         #!/usr/bin/env python3
         # -*- coding: utf-8 -*-
         """
-        SuperClaude Multi-language README Quality Checker
-        Checks version sync, link validity, and structural consistency
+        SuperClaude多语言README质量检查器
+        检查版本同步、链接有效性、结构一致性
         """
         
         import os
@@ -52,7 +52,7 @@ jobs:
         
         class READMEQualityChecker:
             def __init__(self):
-                self.readme_files = ['README.md', 'README-zh.md', 'README-ja.md', 'README-kr.md']
+                self.readme_files = ['README.md', 'README-zh.md', 'README-ja.md']
                 self.results = {
                     'structure_consistency': [],
                     'link_validation': [],
@@ -61,19 +61,19 @@ jobs:
                 }
                 
             def check_structure_consistency(self):
-                """Check structural consistency"""
-                print("🔍 Checking structural consistency...")
+                """检查结构一致性"""
+                print("🔍 检查结构一致性...")
                 
                 structures = {}
                 for file in self.readme_files:
                     if os.path.exists(file):
                         with open(file, 'r', encoding='utf-8') as f:
                             content = f.read()
-                            # Extract heading structure
+                            # 提取标题结构
                             headers = re.findall(r'^#{1,6}\s+(.+)$', content, re.MULTILINE)
                             structures[file] = len(headers)
                             
-                # Compare structural differences
+                # 比较结构差异
                 line_counts = [structures.get(f, 0) for f in self.readme_files if f in structures]
                 if line_counts:
                     max_diff = max(line_counts) - min(line_counts)
@@ -85,13 +85,13 @@ jobs:
                         'status': 'PASS' if consistency_score >= 90 else 'WARN'
                     }
                     
-                    print(f"✅ Structural consistency: {consistency_score}/100")
+                    print(f"✅ 结构一致性: {consistency_score}/100")
                     for file, count in structures.items():
                         print(f"   {file}: {count} headers")
                         
             def check_link_validation(self):
-                """Check link validity"""
-                print("🔗 Checking link validity...")
+                """检查链接有效性"""
+                print("🔗 检查链接有效性...")
                 
                 all_links = {}
                 broken_links = []
@@ -101,14 +101,14 @@ jobs:
                         with open(file, 'r', encoding='utf-8') as f:
                             content = f.read()
                             
-                        # Extract all links
+                        # 提取所有链接
                         links = re.findall(r'\[([^\]]+)\]\(([^)]+)\)', content)
                         all_links[file] = []
                         
                         for text, url in links:
                             link_info = {'text': text, 'url': url, 'status': 'unknown'}
                             
-                            # Check local file links
+                            # 检查本地文件链接
                             if not url.startswith(('http://', 'https://', '#')):
                                 if os.path.exists(url):
                                     link_info['status'] = 'valid'
@@ -116,10 +116,10 @@ jobs:
                                     link_info['status'] = 'broken'
                                     broken_links.append(f"{file}: {url}")
                             
-                            # HTTP link check (simplified)
+                            # HTTP链接检查（简化版）
                             elif url.startswith(('http://', 'https://')):
                                 try:
-                                    # Only check key links to avoid excessive requests
+                                    # 只检查几个关键链接，避免过多请求
                                     if any(domain in url for domain in ['github.com', 'pypi.org', 'npmjs.com']):
                                         response = requests.head(url, timeout=10, allow_redirects=True)
                                         link_info['status'] = 'valid' if response.status_code < 400 else 'broken'
@@ -132,7 +132,7 @@ jobs:
                                 
                             all_links[file].append(link_info)
                 
-                # Calculate link health score
+                # 计算链接健康度
                 total_links = sum(len(links) for links in all_links.values())
                 broken_count = len(broken_links)
                 link_score = max(0, 100 - (broken_count * 10)) if total_links > 0 else 100
@@ -141,37 +141,37 @@ jobs:
                     'score': link_score,
                     'total_links': total_links,
                     'broken_links': broken_count,
-                    'broken_list': broken_links[:10],  # Show max 10
+                    'broken_list': broken_links[:10],  # 最多显示10个
                     'status': 'PASS' if link_score >= 80 else 'FAIL'
                 }
                 
-                print(f"✅ Link validity: {link_score}/100")
-                print(f"   Total links: {total_links}")
-                print(f"   Broken links: {broken_count}")
+                print(f"✅ 链接有效性: {link_score}/100")
+                print(f"   总链接数: {total_links}")
+                print(f"   损坏链接: {broken_count}")
                 
             def check_translation_sync(self):
-                """Check translation sync"""
-                print("🌍 Checking translation sync...")
+                """检查翻译同步性"""
+                print("🌍 检查翻译同步性...")
                 
                 if not all(os.path.exists(f) for f in self.readme_files):
-                    print("⚠️  Some README files are missing")
+                    print("⚠️  缺少某些README文件")
                     self.results['translation_sync'] = {
                         'score': 60,
                         'status': 'WARN',
-                        'message': 'Some README files are missing'
+                        'message': '缺少某些README文件'
                     }
                     return
                 
-                # Check file modification times
+                # 检查文件修改时间
                 mod_times = {}
                 for file in self.readme_files:
                     mod_times[file] = os.path.getmtime(file)
                     
-                # Calculate time difference (seconds)
+                # 计算时间差异（秒）
                 times = list(mod_times.values())
                 time_diff = max(times) - min(times)
                 
-                # Score based on time diff (within 7 days = synced)
+                # 根据时间差评分（7天内修改认为是同步的）
                 sync_score = max(0, 100 - (time_diff / (7 * 24 * 3600) * 20))
                 
                 self.results['translation_sync'] = {
@@ -181,14 +181,14 @@ jobs:
                     'mod_times': {f: f"{os.path.getmtime(f):.0f}" for f in self.readme_files}
                 }
                 
-                print(f"✅ Translation sync: {int(sync_score)}/100")
-                print(f"   Max time difference: {round(time_diff / (24 * 3600), 1)} days")
+                print(f"✅ 翻译同步性: {int(sync_score)}/100")
+                print(f"   最大时间差: {round(time_diff / (24 * 3600), 1)} 天")
                 
             def generate_report(self):
-                """Generate quality report"""
-                print("\n📊 Generating quality report...")
+                """生成质量报告"""
+                print("\n📊 生成质量报告...")
                 
-                # Calculate overall score
+                # 计算总分
                 scores = [
                     self.results['structure_consistency'].get('score', 0),
                     self.results['link_validation'].get('score', 0),
@@ -197,18 +197,18 @@ jobs:
                 overall_score = sum(scores) // len(scores)
                 self.results['overall_score'] = overall_score
                 
-                # Generate GitHub Actions summary
+                # 生成GitHub Actions摘要
                 pipe = "|"
-                table_header = f"{pipe} Check {pipe} Score {pipe} Status {pipe} Details {pipe}"
+                table_header = f"{pipe} 检查项目 {pipe} 分数 {pipe} 状态 {pipe} 详情 {pipe}"
                 table_separator = f"{pipe}----------|------|------|------|"
-                table_row1 = f"{pipe} 📐 Structure {pipe} {self.results['structure_consistency'].get('score', 0)}/100 {pipe} {self.results['structure_consistency'].get('status', 'N/A')} {pipe} {len(self.results['structure_consistency'].get('details', {}))} files {pipe}"
-                table_row2 = f"{pipe} 🔗 Links {pipe} {self.results['link_validation'].get('score', 0)}/100 {pipe} {self.results['link_validation'].get('status', 'N/A')} {pipe} {self.results['link_validation'].get('broken_links', 0)} broken {pipe}"
-                table_row3 = f"{pipe} 🌍 Translation {pipe} {self.results['translation_sync'].get('score', 0)}/100 {pipe} {self.results['translation_sync'].get('status', 'N/A')} {pipe} {self.results['translation_sync'].get('time_diff_days', 0)} days diff {pipe}"
-
+                table_row1 = f"{pipe} 📐 结构一致性 {pipe} {self.results['structure_consistency'].get('score', 0)}/100 {pipe} {self.results['structure_consistency'].get('status', 'N/A')} {pipe} {len(self.results['structure_consistency'].get('details', {}))} 个文件 {pipe}"
+                table_row2 = f"{pipe} 🔗 链接有效性 {pipe} {self.results['link_validation'].get('score', 0)}/100 {pipe} {self.results['link_validation'].get('status', 'N/A')} {pipe} {self.results['link_validation'].get('broken_links', 0)} 个损坏链接 {pipe}"
+                table_row3 = f"{pipe} 🌍 翻译同步性 {pipe} {self.results['translation_sync'].get('score', 0)}/100 {pipe} {self.results['translation_sync'].get('status', 'N/A')} {pipe} {self.results['translation_sync'].get('time_diff_days', 0)} 天差异 {pipe}"
+                
                 summary_parts = [
-                    "## 📊 README Quality Check Report",
+                    "## 📊 README质量检查报告",
                     "",
-                    f"### 🏆 Overall Score: {overall_score}/100",
+                    f"### 🏆 总体评分: {overall_score}/100",
                     "",
                     table_header,
                     table_separator,
@@ -216,47 +216,47 @@ jobs:
                     table_row2,
                     table_row3,
                     "",
-                    "### 📋 Details",
+                    "### 📋 详细信息",
                     "",
-                    "**Structural consistency details:**"
+                    "**结构一致性详情:**"
                 ]
                 summary = "\n".join(summary_parts)
-
+                
                 for file, count in self.results['structure_consistency'].get('details', {}).items():
-                    summary += f"\n- `{file}`: {count} headings"
-
+                    summary += f"\n- `{file}`: {count} 个标题"
+                
                 if self.results['link_validation'].get('broken_links'):
-                    summary += f"\n\n**Broken links:**\n"
+                    summary += f"\n\n**损坏链接列表:**\n"
                     for link in self.results['link_validation']['broken_list']:
                         summary += f"\n- ❌ {link}"
-
-                summary += f"\n\n### 🎯 Recommendations\n"
-
+                
+                summary += f"\n\n### 🎯 建议\n"
+                
                 if overall_score >= 90:
-                    summary += "✅ Excellent quality! Keep it up."
+                    summary += "✅ 质量优秀！继续保持。"
                 elif overall_score >= 70:
-                    summary += "⚠️ Good quality with room for improvement."
+                    summary += "⚠️ 质量良好，有改进空间。"
                 else:
-                    summary += "🚨 Needs improvement! Please review the issues above."
-
-                # Write GitHub Actions summary
+                    summary += "🚨 需要改进！请检查上述问题。"
+                
+                # 写入GitHub Actions摘要
                 github_step_summary = os.environ.get('GITHUB_STEP_SUMMARY')
                 if github_step_summary:
                     with open(github_step_summary, 'w', encoding='utf-8') as f:
                         f.write(summary)
                 
-                # Save detailed results
+                # 保存详细结果
                 with open('readme-quality-report.json', 'w', encoding='utf-8') as f:
                     json.dump(self.results, f, indent=2, ensure_ascii=False)
                 
-                print("✅ Report generated")
-
-                # Determine exit code based on score
+                print("✅ 报告已生成")
+                
+                # 根据分数决定退出码
                 return 0 if overall_score >= 70 else 1
                 
             def run_all_checks(self):
-                """Run all checks"""
-                print("🚀 Starting README quality check...\n")
+                """运行所有检查"""
+                print("🚀 开始README质量检查...\n")
                 
                 self.check_structure_consistency()
                 self.check_link_validation() 
@@ -264,7 +264,7 @@ jobs:
                 
                 exit_code = self.generate_report()
                 
-                print(f"\n🎯 Check complete! Score: {self.results['overall_score']}/100")
+                print(f"\n🎯 检查完成！总分: {self.results['overall_score']}/100")
                 return exit_code
 
         if __name__ == "__main__":
@@ -297,11 +297,11 @@ jobs:
             const score = report.overall_score;
             const emoji = score >= 90 ? '🏆' : score >= 70 ? '✅' : '⚠️';
             
-            const comment = `${emoji} **README Quality Check: ${score}/100**\n\n` +
-              `📐 Structural consistency: ${report.structure_consistency?.score || 0}/100\n` +
-              `🔗 Link validity: ${report.link_validation?.score || 0}/100\n` +
-              `🌍 Translation sync: ${report.translation_sync?.score || 0}/100\n\n` +
-              `See the Actions tab for the detailed report.`;
+            const comment = `${emoji} **README质量检查结果: ${score}/100**\n\n` +
+              `📐 结构一致性: ${report.structure_consistency?.score || 0}/100\n` +
+              `🔗 链接有效性: ${report.link_validation?.score || 0}/100\n` +
+              `🌍 翻译同步性: ${report.translation_sync?.score || 0}/100\n\n` +
+              `查看详细报告请点击 Actions 标签页。`;
             
             github.rest.issues.createComment({
               issue_number: context.issue.number,

.github/workflows/test.yml

@@ -1,175 +0,0 @@
-name: Tests
-
-on:
-  push:
-    branches: [master, integration]
-  pull_request:
-    branches: [master, integration]
-  workflow_dispatch:
-
-jobs:
-  test:
-    name: Test on Python ${{ matrix.python-version }}
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.10", "3.11", "3.12"]
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install UV
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-
-      - name: Verify UV installation
-        run: uv --version
-
-      - name: Install dependencies
-        run: |
-          uv pip install --system -e ".[dev]"
-          uv pip list --system
-
-      - name: Verify package installation
-        run: |
-          python -c "import superclaude; print(f'SuperClaude {superclaude.__version__} installed')"
-          python -c "import pytest_cov; print('pytest-cov is installed')"
-
-      - name: Run tests
-        run: |
-          pytest -v --tb=short --color=yes
-
-      - name: Run tests with coverage
-        if: matrix.python-version == '3.10'
-        run: |
-          pytest --cov=superclaude --cov-report=xml --cov-report=term
-
-      - name: Upload coverage to Codecov
-        if: matrix.python-version == '3.10'
-        uses: codecov/codecov-action@v4
-        with:
-          file: ./coverage.xml
-          flags: unittests
-          name: codecov-umbrella
-          fail_ci_if_error: false
-
-  lint:
-    name: Lint and Format Check
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-
-      - name: Install UV
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-
-      - name: Install dependencies
-        run: |
-          uv pip install --system -e ".[dev]"
-
-      - name: Run ruff linter
-        run: |
-          ruff check src/ tests/
-
-      - name: Check ruff formatting
-        run: |
-          ruff format --check src/ tests/
-
-  plugin-check:
-    name: Pytest Plugin Check
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-
-      - name: Install UV
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-
-      - name: Install dependencies
-        run: |
-          uv pip install --system -e ".[dev]"
-
-      - name: Verify pytest plugin loaded
-        run: |
-          pytest --trace-config 2>&1 | grep -q "superclaude" && echo "✅ Plugin loaded successfully" || (echo "❌ Plugin not loaded" && exit 1)
-
-      - name: Check available fixtures
-        run: |
-          pytest --fixtures | grep -E "(confidence_checker|self_check_protocol|reflexion_pattern|token_budget|pm_context)"
-
-  doctor-check:
-    name: SuperClaude Doctor Check
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-
-      - name: Install UV
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-
-      - name: Install dependencies
-        run: |
-          uv pip install --system -e ".[dev]"
-
-      - name: Run doctor command
-        run: |
-          superclaude doctor --verbose
-
-  test-summary:
-    name: Test Summary
-    runs-on: ubuntu-latest
-    needs: [test, lint, plugin-check, doctor-check]
-    if: always()
-
-    steps:
-      - name: Check test results
-        run: |
-          if [ "${{ needs.test.result }}" != "success" ]; then
-            echo "❌ Tests failed"
-            exit 1
-          fi
-          if [ "${{ needs.lint.result }}" != "success" ]; then
-            echo "❌ Linting failed"
-            exit 1
-          fi
-          if [ "${{ needs.plugin-check.result }}" != "success" ]; then
-            echo "❌ Plugin check failed"
-            exit 1
-          fi
-          if [ "${{ needs.doctor-check.result }}" != "success" ]; then
-            echo "❌ Doctor check failed"
-            exit 1
-          fi
-          echo "✅ All checks passed!"

.gitignore

@@ -98,12 +98,9 @@ Pipfile.lock
 # Poetry
 poetry.lock
 
-# Claude Code - only ignore user-specific files, keep settings.json and skills/
-.claude/history/
-.claude/cache/
-.claude/*.lock
-!.claude/settings.json
-!.claude/skills/
+# Claude Code
+.claude/
+CLAUDE.md
 
 # SuperClaude specific
 .serena/
@@ -112,6 +109,8 @@ poetry.lock
 *.bak
 
 # Project specific
+Tests/
+ClaudeDocs/
 temp/
 tmp/
 .cache/
@@ -167,8 +166,30 @@ release-notes/
 changelog-temp/
 
 # Build artifacts (additional)
+*.deb
+*.rpm
+*.dmg
+*.pkg
 *.msi
 *.exe
+
+# IDE & Editor specific
+.vscode/settings.json
+.vscode/launch.json
+.idea/workspace.xml
+.idea/tasks.xml
+*.sublime-project
+*.sublime-workspace
+
+# System & OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+Desktop.ini
 $RECYCLE.BIN/
 
 # Personal files
@@ -177,4 +198,4 @@ TODO.txt
 
 # Development artifacts (should not be in repo)
 package-lock.json
-uv.lock
+uv.lock

.pre-commit-config.yaml

@@ -1,93 +0,0 @@
-# SuperClaude Framework - Pre-commit Hooks
-# See https://pre-commit.com for more information
-
-repos:
-  # Basic file checks
-  - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
-    hooks:
-      - id: trailing-whitespace
-        exclude: '\.md$'
-      - id: end-of-file-fixer
-      - id: check-yaml
-        args: ['--unsafe']  # Allow custom YAML tags
-      - id: check-json
-      - id: check-toml
-      - id: check-added-large-files
-        args: ['--maxkb=1000']
-      - id: check-merge-conflict
-      - id: check-case-conflict
-      - id: mixed-line-ending
-        args: ['--fix=lf']
-
-  # Secret detection (critical for security)
-  - repo: https://github.com/Yelp/detect-secrets
-    rev: v1.4.0
-    hooks:
-      - id: detect-secrets
-        args:
-          - '--baseline'
-          - '.secrets.baseline'
-        exclude: |
-          (?x)^(
-            .*\.lock$|
-            .*package-lock\.json$|
-            .*pnpm-lock\.yaml$|
-            .*\.min\.js$|
-            .*\.min\.css$
-          )$
-
-  # Additional secret patterns (from CLAUDE.md)
-  - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
-    hooks:
-      - id: detect-private-key
-      - id: check-yaml
-        name: Check for hardcoded secrets
-        entry: |
-          bash -c '
-          if grep -rE "(sk_live_[a-zA-Z0-9]{24,}|pk_live_[a-zA-Z0-9]{24,}|sk_test_[a-zA-Z0-9]{24,}|pk_test_[a-zA-Z0-9]{24,}|SUPABASE_SERVICE_ROLE_KEY\s*=\s*['\''\"']eyJ|SUPABASE_ANON_KEY\s*=\s*['\''\"']eyJ|NEXT_PUBLIC_SUPABASE_ANON_KEY\s*=\s*['\''\"']eyJ|OPENAI_API_KEY\s*=\s*['\''\"']sk-|TWILIO_AUTH_TOKEN\s*=\s*['\''\"'][a-f0-9]{32}|INFISICAL_TOKEN\s*=\s*['\''\"']st\.|DATABASE_URL\s*=\s*['\''\"']postgres.*@.*:.*/.*(password|passwd))" "$@" 2>/dev/null; then
-            echo "🚨 BLOCKED: Hardcoded secrets detected!"
-            echo "Replace with placeholders: your_token_here, \${VAR_NAME}, etc."
-            exit 1
-          fi
-          '
-
-  # Conventional Commits validation
-  - repo: https://github.com/compilerla/conventional-pre-commit
-    rev: v3.0.0
-    hooks:
-      - id: conventional-pre-commit
-        stages: [commit-msg]
-        args: []
-
-  # Markdown linting
-  - repo: https://github.com/igorshubovych/markdownlint-cli
-    rev: v0.38.0
-    hooks:
-      - id: markdownlint
-        args: ['--fix']
-        exclude: |
-          (?x)^(
-            CHANGELOG\.md|
-            .*node_modules.*|
-            .*\.min\.md$
-          )$
-
-  # YAML linting
-  - repo: https://github.com/adrienverge/yamllint
-    rev: v1.33.0
-    hooks:
-      - id: yamllint
-        args: ['-d', '{extends: default, rules: {line-length: {max: 120}, document-start: disable}}']
-
-  # Shell script linting
-  - repo: https://github.com/shellcheck-py/shellcheck-py
-    rev: v0.9.0.6
-    hooks:
-      - id: shellcheck
-        args: ['--severity=warning']
-
-# Global settings
-default_stages: [commit]
-fail_fast: false

AGENTS.md

@@ -1,38 +0,0 @@
-# Repository Guidelines
-
-## Project Structure & Module Organization
-- `src/superclaude/` holds the Python package and pytest plugin entrypoints.
-- `tests/` contains Python integration/unit suites; markers map to features in `pyproject.toml`.
-- `pm/`, `research/`, and `index/` house TypeScript agents with standalone `package.json`.
-- `skills/` holds runtime skills (e.g., `confidence-check`); `commands/` documents scripted Claude commands.
-- `docs/` provides reference packs; start with `docs/developer-guide` for workflow expectations.
-
-## Build, Test, and Development Commands
-- `make install` installs the framework editable via `uv pip install -e ".[dev]"`.
-- `make test` runs `uv run pytest` across `tests/`.
-- `make doctor` or `make verify` check CLI wiring and plugin health.
-- `make lint` and `make format` delegate to Ruff; run after significant edits.
-- TypeScript agents: inside `pm/`, run `npm install` once, then `npm test` or `npm run build`; repeat for `research/` and `index/`.
-
-## Coding Style & Naming Conventions
-- Python: 4-space indentation, Black line length 88, Ruff `E,F,I,N,W`; prefer snake_case for modules/functions and PascalCase for classes.
-- Keep pytest markers explicit (`@pytest.mark.unit`, etc.) and match file names `test_*.py`.
-- TypeScript: rely on project `tsconfig.json`; keep filenames kebab-case and exported classes PascalCase; align with existing PM agent modules.
-- Reserve docstrings or inline comments for non-obvious orchestration; let clear naming do the heavy lifting.
-
-## Testing Guidelines
-- Default to `make test`; add `uv run pytest -m unit` to scope runs during development.
-- When changes touch CLI or plugin startup, extend integration coverage in `tests/test_pytest_plugin.py`.
-- Respect coverage focus on `src/superclaude` (`tool.coverage.run`); adjust configuration instead of skipping logic.
-- For TypeScript agents, add Jest specs under `__tests__/*.test.ts` and keep coverage thresholds satisfied via `npm run test:coverage`.
-
-## Commit & Pull Request Guidelines
-- Follow Conventional Commits (`feat:`, `fix:`, `refactor:`) as seen in `git log`; keep present-tense summaries under ~72 chars.
-- Group related file updates per commit to simplify bisects and release notes.
-- Before opening a PR, run `make lint`, `make format`, and `make test`; include summaries of verification steps in the PR description.
-- Reference linked issues (`Closes #123`) and, for agent workflow changes, add brief reproduction notes; screenshots only when docs change.
-- Tag reviewers listed in `CODEOWNERS` when touching owned directories.
-
-## Plugin Deployment Tips
-- Use `make install-plugin` to mirror the development plugin into `~/.claude/plugins/pm-agent`; prefer `make reinstall-plugin` after local iterations.
-- Validate plugin detection with `make test-plugin` before sharing artifact links or release notes.

CHANGELOG.md

@@ -7,69 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [4.3.0] - 2026-03-22
-### Added
-- **Agent installation** - `superclaude install` now deploys 20 agent files to `~/.claude/agents/` (#531)
-- **SHA-256 integrity verification** - Downloaded docker-compose and mcp-config files are verified against expected hashes (#537)
-- **Comprehensive execution tests** - 62 new tests for ParallelExecutor, ReflectionEngine, SelfCorrectionEngine, and orchestrator (136 total)
-- **Claude Code integration guide** - New `docs/user-guide/claude-code-integration.md` mapping all SuperClaude features to Claude Code's native extension points with gap analysis
-- **Claude Code gap analysis** - Documented in KNOWLEDGE.md: skills migration (critical), hooks integration (high), plan mode (medium), settings profiles (medium)
-
-### Fixed
-- **SECURITY: shell=True removal** - Replaced `shell=True` with user-controlled `$SHELL` in `_run_command()` with direct list-based `subprocess.run` (#536)
-- **ConfidenceChecker placeholders** - Replaced 4 stub methods with real implementations: codebase search, architecture doc checks, research reference validation, root cause specificity checks
-- **intelligent_execute() error capture** - Collect actual errors from failed tasks instead of hardcoded None; fixed critical variable shadowing bug where loop var overwrote task parameter
-- **MCP env var flag** - Fixed `--env` to `-e` matching Claude CLI's expected format (#517)
-- **ReflexionPattern mindbase** - Implemented HTTP API integration with graceful fallback when service unavailable
-- **.gitignore contradictions** - Removed duplicate entries, added explicit rules for `.claude/settings.json` and `.claude/skills/`
-- **FailureEntry.from_dict** - Fixed input dict mutation via shallow copy
-- **sys.path hack** - Removed unnecessary `sys.path.insert` from cli/main.py
-- **__version__.py mismatch** - Synced from 0.4.0 to match package version
-
-### Changed
-- **Japanese triggers → English** - Replaced Japanese trigger phrases and labels in pm-agent.md and pm.md with English equivalents (#534)
-- **Version consistency** - All version references across 15 files now synchronized
-- **Feature counts** - Corrected across all docs: Commands 21→30, Agents 14/16→20, Modes 6→7, MCP 6→8
-- **CLAUDE.md** - Complete project structure with agents, modes, commands, skills, hooks, MCP directories
-- **PLANNING.md, TASK.md, KNOWLEDGE.md** - Updated to reflect current architecture and Claude Code integration gaps
-
-## [4.2.0] - 2026-01-18
-### Added
-- **AIRIS MCP Gateway** - Optional unified MCP solution with 60+ tools (#509)
-  - Single SSE endpoint at `localhost:9400`
-  - 98% token reduction through HOT/COLD tool management
-  - Requires Docker (optional - individual servers still supported)
-- **Airis Agent and MindBase MCP servers** - New individual server options (#497)
-- **Explicit command boundaries and handoff instructions** - All 30 commands now have clear scope definitions (#513)
-- **Complete command reference documentation** - Comprehensive docs for all slash commands (#512)
-
-### Fixed
-- UTF-8 encoding handling for MCP command output on all platforms (#507)
-
-### Changed
-- MCP installer now offers AIRIS Gateway as recommended option (with Docker)
-- Individual MCP servers remain fully supported for users without Docker
-- Command documentation improved with boundaries, triggers, and next-step guidance
-
-## [4.1.9] - 2026-01-15
-### Added
-- **Framework Restoration** - Complete SuperClaude framework restored from commit d4a17fc
-- **30 Slash Commands** - All slash commands restored with comprehensive documentation
-- **install.sh Script** - Missing installation script added (#483)
-- **MCP Command** - New `superclaude mcp` command for MCP server management
-- **Tavily MCP Server** - Web search integration for deep research capabilities
-- **Chrome DevTools MCP** - Browser debugging and performance analysis
-
-### Fixed
-- Package distribution now includes all plugin resources
-- Commands path resolution prioritizes package location
-- Commands and skills properly included in MANIFEST.in
-
-### Changed
-- Synchronized translated READMEs with main README structure
-- Added `__init__.py` to all packages for proper module resolution
-
-## [4.1.5] - 2025-09-26
+## [4.1.4] - 2025-09-20
 ### Added
 - Comprehensive flag documentation integrated into `/sc:help` command
 - All 25 SuperClaude framework flags now discoverable from help system
@@ -81,6 +19,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Smart server merging (existing + selected + previously installed)
 - Documentation cleanup: removed non-existent commands (sc:fix, sc:simple-pix, sc:update, sc:develop, sc:modernize, sc:simple-fix)
 - CLI logic to allow mcp_docs installation without server selection
+
 ### Changed
 - MCP component now supports true incremental installation
 - mcp_docs component auto-detects and installs documentation for all detected servers
@@ -129,7 +68,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Technical
 - Added `setup/utils/updater.py` for PyPI update checking logic
 - Added `bin/checkUpdate.js` for NPM update checking logic
-- Integrated update checks into main entry points (superclaude/__main__.py and bin/cli.js)
+- Integrated update checks into main entry points (SuperClaude/__main__.py and bin/cli.js)
 - Non-blocking update checks with 2-second timeout to avoid delays
 
 ### Changed
@@ -138,7 +77,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Commands are now installed in `~/.claude/commands/sc/` subdirectory
 - All 21 commands updated: `/analyze` → `/sc:analyze`, `/build` → `/sc:build`, etc.
 - Automatic migration from old command locations to new `sc/` subdirectory
-- **BREAKING**: Documentation reorganization - docs/ directory renamed to Guides/
+- **BREAKING**: Documentation reorganization - Docs/ directory renamed to Guides/
 
 ### Added
 - **NEW AGENTS**: 14 specialized domain agents with enhanced capabilities
@@ -171,7 +110,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Migration preserves existing functionality while preventing naming conflicts
 - Installation process detects and migrates existing commands automatically
 - Tab completion support for `/sc:` prefix to discover all SuperClaude commands
-- Guides/ directory replaces docs/ for improved organization
+- Guides/ directory replaces Docs/ for improved organization
 
 ## [4.0.6] - 2025-08-23
 

CLAUDE.md

@@ -1,341 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## 🐍 Python Environment Rules
-
-**CRITICAL**: This project uses **UV** for all Python operations. Never use `python -m`, `pip install`, or `python script.py` directly.
-
-### Required Commands
-
-```bash
-# All Python operations must use UV
-uv run pytest                    # Run tests
-uv run pytest tests/pm_agent/   # Run specific tests
-uv pip install package           # Install dependencies
-uv run python script.py          # Execute scripts
-```
-
-## 📂 Project Structure
-
-**Current v4.3.0 Architecture**: Python package with 30 commands, 20 agents, 7 modes
-
-```
-# Claude Code Configuration (v4.3.0)
-# Installed via `superclaude install` to user's home directory
-~/.claude/
-├── settings.json
-├── commands/sc/         # 30 slash commands (/sc:research, /sc:implement, etc.)
-│   ├── pm.md
-│   ├── research.md
-│   ├── implement.md
-│   └── ... (30 total)
-├── agents/              # 20 domain-specialist agents (@pm-agent, @system-architect, etc.)
-│   ├── pm-agent.md
-│   ├── system-architect.md
-│   └── ... (20 total)
-└── skills/              # Skills (confidence-check, etc.)
-
-# Python Package
-src/superclaude/
-├── __init__.py          # Public API: ConfidenceChecker, SelfCheckProtocol, ReflexionPattern
-├── pytest_plugin.py     # Auto-loaded pytest integration (5 fixtures, 9 markers)
-├── pm_agent/            # confidence.py, self_check.py, reflexion.py, token_budget.py
-├── execution/           # parallel.py, reflection.py, self_correction.py
-├── cli/                 # main.py, doctor.py, install_commands.py, install_mcp.py, install_skill.py
-├── commands/            # 30 slash command definitions (.md files)
-├── agents/              # 20 agent definitions (.md files)
-├── modes/               # 7 behavioral modes (.md files)
-├── skills/              # Installable skills (confidence-check, etc.)
-├── hooks/               # Claude Code hook definitions
-├── mcp/                 # MCP server configurations (10 servers)
-└── core/                # Core utilities
-
-# Project Files
-tests/                   # Python test suite (136 tests)
-├── unit/                # Unit tests (auto-marked @pytest.mark.unit)
-└── integration/         # Integration tests (auto-marked @pytest.mark.integration)
-docs/                    # Documentation
-scripts/                 # Analysis tools (workflow metrics, A/B testing)
-plugins/                 # Exported plugin artefacts for distribution
-PLANNING.md              # Architecture, absolute rules
-TASK.md                  # Current tasks
-KNOWLEDGE.md             # Accumulated insights
-```
-
-### Claude Code Integration Points
-
-SuperClaude integrates with Claude Code through these mechanisms:
-- **Slash Commands**: 30 commands installed to `~/.claude/commands/sc/` (e.g., `/sc:pm`, `/sc:research`)
-- **Agents**: 20 agents installed to `~/.claude/agents/` (e.g., `@pm-agent`, `@system-architect`)
-- **Skills**: Installed to `~/.claude/skills/` (e.g., confidence-check)
-- **Hooks**: Session lifecycle hooks in `src/superclaude/hooks/`
-- **Settings**: Project settings in `.claude/settings.json`
-- **Pytest Plugin**: Auto-loaded via entry point, provides fixtures and markers
-- **MCP Servers**: 8+ servers configurable via `superclaude mcp`
-
-## 🔧 Development Workflow
-
-### Essential Commands
-
-```bash
-# Setup
-make dev              # Install in editable mode with dev dependencies
-make verify           # Verify installation (package, plugin, health)
-
-# Testing
-make test             # Run full test suite
-uv run pytest tests/pm_agent/ -v              # Run specific directory
-uv run pytest tests/test_file.py -v           # Run specific file
-uv run pytest -m confidence_check             # Run by marker
-uv run pytest --cov=superclaude               # With coverage
-
-# Code Quality
-make lint             # Run ruff linter
-make format           # Format code with ruff
-make doctor           # Health check diagnostics
-
-# MCP Servers
-superclaude mcp                              # Interactive install (gateway default)
-superclaude mcp --list                       # List available servers
-superclaude mcp --servers airis-mcp-gateway  # Install AIRIS Gateway (recommended)
-superclaude mcp --servers tavily context7    # Install individual servers
-
-# Plugin Packaging
-make build-plugin            # Build plugin artefacts into dist/
-make sync-plugin-repo        # Sync artefacts into ../SuperClaude_Plugin
-
-# Maintenance
-make clean            # Remove build artifacts
-```
-
-## 📦 Core Architecture
-
-### Pytest Plugin (Auto-loaded)
-
-Registered via `pyproject.toml` entry point, automatically available after installation.
-
-**Fixtures**: `confidence_checker`, `self_check_protocol`, `reflexion_pattern`, `token_budget`, `pm_context`
-
-**Auto-markers**:
-- Tests in `/unit/` → `@pytest.mark.unit`
-- Tests in `/integration/` → `@pytest.mark.integration`
-
-**Custom markers**: `@pytest.mark.confidence_check`, `@pytest.mark.self_check`, `@pytest.mark.reflexion`
-
-### PM Agent - Three Core Patterns
-
-**1. ConfidenceChecker** (src/superclaude/pm_agent/confidence.py)
-- Pre-execution confidence assessment: ≥90% required, 70-89% present alternatives, <70% ask questions
-- Prevents wrong-direction work, ROI: 25-250x token savings
-
-**2. SelfCheckProtocol** (src/superclaude/pm_agent/self_check.py)
-- Post-implementation evidence-based validation
-- No speculation - verify with tests/docs
-
-**3. ReflexionPattern** (src/superclaude/pm_agent/reflexion.py)
-- Error learning and prevention
-- Cross-session pattern matching
-
-### Parallel Execution
-
-**Wave → Checkpoint → Wave pattern** (src/superclaude/execution/parallel.py):
-- 3.5x faster than sequential execution
-- Automatic dependency analysis
-- Example: [Read files in parallel] → Analyze → [Edit files in parallel]
-
-### Slash Commands, Agents & Modes (v4.3.0)
-
-- Install via: `pipx install superclaude && superclaude install`
-- **30 Commands** installed to `~/.claude/commands/sc/` (e.g., `/sc:pm`, `/sc:research`, `/sc:implement`)
-- **20 Agents** installed to `~/.claude/agents/` (e.g., `@pm-agent`, `@system-architect`, `@deep-research`)
-- **7 Behavioral Modes**: Brainstorming, Business Panel, Deep Research, Introspection, Orchestration, Task Management, Token Efficiency
-- **Skills**: Installable to `~/.claude/skills/` (e.g., confidence-check)
-
-> **Note**: TypeScript plugin system planned for v5.0 ([#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419))
-
-## 🧪 Testing with PM Agent
-
-### Example Test with Markers
-
-```python
-@pytest.mark.confidence_check
-def test_feature(confidence_checker):
-    """Pre-execution confidence check - skips if < 70%"""
-    context = {"test_name": "test_feature", "has_official_docs": True}
-    assert confidence_checker.assess(context) >= 0.7
-
-@pytest.mark.self_check
-def test_implementation(self_check_protocol):
-    """Post-implementation validation with evidence"""
-    implementation = {"code": "...", "tests": [...]}
-    passed, issues = self_check_protocol.validate(implementation)
-    assert passed, f"Validation failed: {issues}"
-
-@pytest.mark.reflexion
-def test_error_learning(reflexion_pattern):
-    """If test fails, reflexion records for future prevention"""
-    pass
-
-@pytest.mark.complexity("medium")  # simple: 200, medium: 1000, complex: 2500
-def test_with_budget(token_budget):
-    """Token budget allocation"""
-    assert token_budget.limit == 1000
-```
-
-## 🌿 Git Workflow
-
-**Branch structure**: `master` (production) ← `integration` (testing) ← `feature/*`, `fix/*`, `docs/*`
-
-**Standard workflow**:
-1. Create branch from `integration`: `git checkout -b feature/your-feature`
-2. Develop with tests: `uv run pytest`
-3. Commit: `git commit -m "feat: description"` (conventional commits)
-4. Merge to `integration` → validate → merge to `master`
-
-**Current branch**: See git status in session start output
-
-### Parallel Development with Git Worktrees
-
-**CRITICAL**: When running multiple Claude Code sessions in parallel, use `git worktree` to avoid conflicts.
-
-```bash
-# Create worktree for integration branch
-cd ~/github/SuperClaude_Framework
-git worktree add ../SuperClaude_Framework-integration integration
-
-# Create worktree for feature branch
-git worktree add ../SuperClaude_Framework-feature feature/pm-agent
-```
-
-**Benefits**:
-- Run Claude Code sessions on different branches simultaneously
-- No branch switching conflicts
-- Independent working directories
-- Parallel development without state corruption
-
-**Usage**:
-- Session A: Open `~/github/SuperClaude_Framework/` (current branch)
-- Session B: Open `~/github/SuperClaude_Framework-integration/` (integration)
-- Session C: Open `~/github/SuperClaude_Framework-feature/` (feature branch)
-
-**Cleanup**:
-```bash
-git worktree remove ../SuperClaude_Framework-integration
-```
-
-## 📝 Key Documentation Files
-
-**PLANNING.md** - Architecture, design principles, absolute rules
-**TASK.md** - Current tasks and priorities
-**KNOWLEDGE.md** - Accumulated insights and troubleshooting
-
-Additional docs in `docs/user-guide/`, `docs/developer-guide/`, `docs/reference/`
-
-## 💡 Core Development Principles
-
-### 1. Evidence-Based Development
-**Never guess** - verify with official docs (Context7 MCP, WebFetch, WebSearch) before implementation.
-
-### 2. Confidence-First Implementation
-Check confidence BEFORE starting: ≥90% proceed, 70-89% present alternatives, <70% ask questions.
-
-### 3. Parallel-First Execution
-Use **Wave → Checkpoint → Wave** pattern (3.5x faster). Example: `[Read files in parallel]` → Analyze → `[Edit files in parallel]`
-
-### 4. Token Efficiency
-- Simple (typo): 200 tokens
-- Medium (bug fix): 1,000 tokens
-- Complex (feature): 2,500 tokens
-- Confidence check ROI: spend 100-200 to save 5,000-50,000
-
-## 🔧 MCP Server Integration
-
-**Recommended**: Use **airis-mcp-gateway** for unified MCP management.
-
-```bash
-superclaude mcp  # Interactive install, gateway is default (requires Docker)
-```
-
-**Gateway Benefits**: 60+ tools, 98% token reduction, single SSE endpoint, Web UI
-
-**High Priority Servers** (included in gateway):
-- **Tavily**: Web search (Deep Research)
-- **Context7**: Official documentation (prevent hallucination)
-- **Sequential**: Token-efficient reasoning (30-50% reduction)
-- **Serena**: Session persistence
-- **Mindbase**: Cross-session learning
-
-**Optional**: Playwright (browser automation), Magic (UI components), Chrome DevTools (performance)
-
-**Usage**: TypeScript plugins and Python pytest plugin can call MCP servers. Always prefer MCP tools over speculation for documentation/research.
-
-## 🚀 Development & Installation
-
-### Current Installation Method (v4.3.0)
-
-**Standard Installation**:
-```bash
-# Option 1: pipx (recommended)
-pipx install superclaude
-superclaude install
-
-# Option 2: Direct from repo
-git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
-cd SuperClaude_Framework
-./install.sh
-```
-
-**Development Mode**:
-```bash
-# Install in editable mode
-make dev
-
-# Run tests
-make test
-
-# Verify installation
-make verify
-```
-
-### Plugin System (v5.0 - Not Yet Available)
-
-The TypeScript plugin system (`.claude-plugin/`, marketplace) is planned for v5.0.
-See `docs/plugin-reorg.md` for details.
-
-## 📊 Package Information
-
-**Package name**: `superclaude`
-**Version**: 4.3.0
-**Python**: >=3.10
-**Build system**: hatchling (PEP 517)
-
-**Entry points**:
-- CLI: `superclaude` command
-- Pytest plugin: Auto-loaded as `superclaude`
-
-**Dependencies**:
-- pytest>=7.0.0
-- click>=8.0.0
-- rich>=13.0.0
-
-## 🔌 Claude Code Native Features (for developers)
-
-SuperClaude extends Claude Code through its native extension points. When developing SuperClaude features, use these Claude Code capabilities:
-
-### Extension Points We Use
-- **Custom Commands** (`~/.claude/commands/sc/*.md`): 30 `/sc:*` commands
-- **Custom Agents** (`~/.claude/agents/*.md`): 20 domain-specialist agents
-- **Skills** (`~/.claude/skills/`): confidence-check skill
-- **Settings** (`.claude/settings.json`): Permission rules, hooks
-- **MCP Servers**: 8 pre-configured + AIRIS gateway
-- **Pytest Plugin**: Auto-loaded via entry point
-
-### Extension Points We Should Use More
-- **Hooks** (28 events): `SessionStart`, `Stop`, `PostToolUse`, `TaskCompleted` — ideal for PM Agent auto-restore, self-check validation, and reflexion triggers
-- **Skills System**: Commands should migrate to proper skills with YAML frontmatter for auto-triggering, tool restrictions, and effort overrides
-- **Plan Mode**: Could integrate with confidence checks (block implementation when < 70%)
-- **Settings Profiles**: Could provide recommended permission/hook configs per workflow
-- **Native Session Persistence**: `--continue`/`--resume` instead of custom memory files
-
-See `docs/user-guide/claude-code-integration.md` for the full gap analysis.

CODE_OF_CONDUCT.md

@@ -518,7 +518,7 @@ This code of conduct draws inspiration from several established community standa
 
 **Last Updated**: December 2024 (SuperClaude Framework v4.0)
 **Next Review**: June 2025 (Semi-annual review cycle)
-**Version**: 4.1.5 (Updated for v4 community structure and governance)
+**Version**: 4.1.4 (Updated for v4 community structure and governance)
 
 **Review Schedule:**
 - **Semi-Annual Reviews**: Policy effectiveness assessment and community feedback integration

CONTRIBUTING.md

@@ -12,7 +12,7 @@ SuperClaude Framework transforms Claude Code into a structured development platf
 **Before Reporting:**
 - Search existing issues to avoid duplicates
 - Test with latest SuperClaude version
-- Verify issue isn't covered in [Troubleshooting Guide](docs/Reference/troubleshooting.md)
+- Verify issue isn't covered in [Troubleshooting Guide](Docs/Reference/troubleshooting.md)
 
 **Required Information:**
 - SuperClaude version: `SuperClaude --version`
@@ -27,7 +27,7 @@ SuperClaude Framework transforms Claude Code into a structured development platf
 **Good Bug Report Example:**
 ```
 **Environment:**
-- SuperClaude: 4.1.5
+- SuperClaude: 4.1.4
 - OS: Ubuntu 22.04
 - Claude Code: 1.5.2
 - Python: 3.9.7
@@ -188,8 +188,8 @@ Reference/          # Best practices and troubleshooting
 - Security best practices for external integrations
 
 **Development Workflow:**
-1. Review [Technical Architecture](docs/Developer-Guide/technical-architecture.md)
-2. Study [Contributing Code Guide](docs/Developer-Guide/contributing-code.md)
+1. Review [Technical Architecture](Docs/Developer-Guide/technical-architecture.md)
+2. Study [Contributing Code Guide](Docs/Developer-Guide/contributing-code.md)
 3. Set up development environment
 4. Create feature branch from `master`
 5. Implement changes with tests
@@ -203,7 +203,7 @@ Reference/          # Best practices and troubleshooting
 - Documentation completeness and clarity
 - Test coverage and quality
 
-For detailed development guidelines, see [Contributing Code Guide](docs/Developer-Guide/contributing-code.md).
+For detailed development guidelines, see [Contributing Code Guide](Docs/Developer-Guide/contributing-code.md).
 
 ## 🤝 Community Guidelines
 
@@ -315,14 +315,14 @@ SuperClaude Framework enhances Claude Code for systematic software development w
 - Design discussions for major features
 
 **Documentation Resources**
-- [Troubleshooting Guide](docs/Reference/troubleshooting.md) - Common issues and solutions
-- [Examples Cookbook](docs/Reference/examples-cookbook.md) - Practical usage patterns
-- [Quick Start Practices](docs/Reference/quick-start-practices.md) - Optimization strategies
-- [Technical Architecture](docs/Developer-Guide/technical-architecture.md) - Framework design
+- [Troubleshooting Guide](Docs/Reference/troubleshooting.md) - Common issues and solutions
+- [Examples Cookbook](Docs/Reference/examples-cookbook.md) - Practical usage patterns
+- [Quick Start Practices](Docs/Reference/quick-start-practices.md) - Optimization strategies
+- [Technical Architecture](Docs/Developer-Guide/technical-architecture.md) - Framework design
 
 **Development Support**
-- [Contributing Code Guide](docs/Developer-Guide/contributing-code.md) - Development setup
-- [Testing & Debugging](docs/Developer-Guide/testing-debugging.md) - Quality procedures
+- [Contributing Code Guide](Docs/Developer-Guide/contributing-code.md) - Development setup
+- [Testing & Debugging](Docs/Developer-Guide/testing-debugging.md) - Quality procedures
 - Code review process through pull requests
 - Maintainer guidance on complex contributions
 
@@ -344,7 +344,7 @@ Before seeking support, please:
 **Development Environment Issues:**
 
 **Q: "SuperClaude install fails with permission errors"**
-A: Use `pip install --user SuperClaude` or create virtual environment. See [Installation Guide](docs/Getting-Started/installation.md) for details.
+A: Use `pip install --user SuperClaude` or create virtual environment. See [Installation Guide](Docs/Getting-Started/installation.md) for details.
 
 **Q: "Commands not recognized after installation"**
 A: Restart Claude Code session. Verify installation with `SuperClaude install --list-components`. Check ~/.claude directory exists.
@@ -358,7 +358,7 @@ A: Check Node.js installation for MCP servers. Verify ~/.claude/.claude.json con
 A: Follow agent patterns in setup/components/agents.py. Include trigger keywords, capabilities description, and integration tests.
 
 **Q: "Testing framework setup?"**
-A: See [Testing & Debugging Guide](docs/Developer-Guide/testing-debugging.md). Use pytest for Python tests, include component validation.
+A: See [Testing & Debugging Guide](Docs/Developer-Guide/testing-debugging.md). Use pytest for Python tests, include component validation.
 
 **Q: "Documentation structure?"**
 A: Follow existing patterns: Getting-Started → User-Guide → Developer-Guide → Reference. Include examples and progressive complexity.

DELETION_RATIONALE.md

@@ -1,400 +0,0 @@
-# Deletion Rationale (Evidence-Based)
-
-**PR Target Branch**: `next`
-**Base Branch**: `master`
-**Date**: 2025-10-24
-
----
-
-## 📊 Deletion Summary
-
-| Category | Deleted Files | Deleted Lines | Reason Category |
-|---------|--------------|---------------|-----------------|
-| setup/ directory | 40 | 12,289 | Architecture renovation |
-| superclaude/ (old structure) | 86 | ~8,000 | PEP 517 migration |
-| TypeScript implementation | 14 | 2,633 | Preserved in branch |
-| Plugin files | 9 | 494 | Repository separation |
-| bin/ + scripts/ | 8 | ~800 | CLI modernization |
-| **Total** | **~157** | **~22,507** | - |
-
----
-
-## 1. setup/ Directory Deletion (12,289 lines)
-
-### What Was Deleted
-```
-setup/
-├── cli/          # Old CLI commands (backup, install, uninstall, update)
-├── components/   # Installers for agents, modes, commands
-├── core/         # Installer, registry, validator
-├── services/     # claude_md, config, files, settings
-└── utils/        # logger, paths, security, symbols, ui, updater
-```
-
-### Deletion Rationale (Evidence)
-
-**Evidence 1: Commit Message**
-```
-commit eb37591
-refactor: remove legacy setup/ system and dependent tests
-
-Remove old installation system (setup/) that caused heavy token consumption
-```
-
-**Evidence 2: PHASE_2_COMPLETE.md**
-```markdown
-New architecture (src/superclaude/) is self-contained and doesn't need setup/.
-```
-
-**Evidence 3: Architecture Migration Rationale**
-- Old system: Copied files to `~/.claude/superclaude/` → **Polluted user environment**
-- New system: Installed to `site-packages/` → **Standard Python package**
-
-**Evidence 4: Token Efficiency**
-- Old setup/: Complex installation logic, backup functionality, security checks
-- New system: Complete with `uv pip install -e ".[dev]"`
-
-**Logical Conclusion**:
-- ✅ Migrated to PEP 517 compliant build system (hatchling)
-- ✅ Uses standard Python package management (UV)
-- ✅ Zero `~/.claude/` pollution
-- ✅ Significantly reduced maintenance burden
-
----
-
-## 2. superclaude/ Directory Deletion (Old Structure)
-
-### What Was Deleted
-```
-superclaude/
-├── agents/          # 20 agent definitions
-├── commands/        # 27 slash commands
-├── modes/           # 7 behavior modes
-├── framework/       # PRINCIPLES, RULES, FLAGS
-├── business/        # Business panel
-└── cli/             # Old CLI tools
-```
-
-### Deletion Rationale (Evidence)
-
-**Evidence 1: Python Package Directory Layout Research**
-```markdown
-File: docs/research/python_src_layout_research_20251021.md
-
-## Recommendation
-Use src/ layout for SuperClaude:
-- Clear separation between package code and tests
-- Prevents accidental imports from development directory
-- Modern Python best practice
-```
-
-**Evidence 2: Migration Completion Proof**
-```bash
-# Old structure
-superclaude/pm_agent/confidence.py
-
-# New structure (PEP 517 compliant)
-src/superclaude/pm_agent/confidence.py
-```
-
-**Evidence 3: pytest plugin auto-discovery**
-```bash
-$ uv run python -m pytest --trace-config 2>&1 | grep "registered third-party plugins:"
-registered third-party plugins:
-  superclaude-0.4.0 at /Users/kazuki/github/superclaude/src/superclaude/pytest_plugin.py
-```
-
-**Logical Conclusion**:
-- ✅ src/ layout is official Python recommendation
-- ✅ Clear separation between package and tests
-- ✅ Prevents accidental imports from development directory
-- ✅ Entry point auto-discovery verified working
-
----
-
-## 3. 27 Slash Commands Deletion
-
-### What Was Deleted
-```
-~/.claude/commands/sc/ (27 commands):
-- analyze, brainstorm, build, business-panel, cleanup
-- design, document, estimate, explain, git, help
-- implement, improve, index, load, pm, reflect
-- research, save, select-tool, spawn, spec-panel
-- task, test, troubleshoot, workflow
-```
-
-### Deletion Rationale (Evidence)
-
-**Evidence 1: Commit Message**
-```
-commit 06e7c00
-feat: migrate research and index-repo to plugin, delete all slash commands
-
-## Architecture Change
-Strategy: Minimal start with PM Agent orchestration
-- PM Agent = orchestrator (command coordinator)
-- Task tool (general-purpose, Explore) = execution
-- Plugin commands = specialized tasks when needed
-- Avoid reinventing the wheel (use official tools first)
-
-## Benefits
-✅ Minimal footprint (3 commands vs 27)
-✅ Plugin-based distribution
-✅ Version control
-✅ Easy to extend when needed
-```
-
-**Evidence 2: Claude Code Official Tools Priority Policy**
-- Task tool: General-purpose task execution
-- Explore agent: Codebase exploration
-- These are **Claude Code built-in tools** - no need to reimplement
-
-**Evidence 3: PM Agent Orchestration Strategy**
-```markdown
-File: commands/agent.md (SuperClaude_Plugin)
-
-## Task Protocol
-1. Clarify scope
-2. Plan investigation
-   - @confidence-check skill (pre-implementation score ≥0.90 required)
-   - @deep-research agent (web/MCP research)
-   - @repo-index agent (repository structure + file shortlist)
-   - @self-review agent (post-implementation validation)
-3. Iterate until confident
-4. Implementation wave
-5. Self-review and reflexion
-```
-
-**Evidence 4: Performance Data**
-- 27 commands → 3 commands (pm, research, index-repo)
-- Footprint reduction: **89% reduction**
-- Can be extended as needed (plugin architecture)
-
-**Logical Conclusion**:
-- ✅ Eliminated overlap with Claude Code built-in tools
-- ✅ PM Agent functions as orchestrator
-- ✅ Started with minimal essential command set
-- ✅ Designed for extensibility via plugins
-
----
-
-## 4. TypeScript Implementation Deletion (2,633 lines)
-
-### What Was Deleted
-```
-pm/
-├── index.ts
-├── confidence.ts
-├── self-check.ts
-├── reflexion.ts
-└── __tests__/
-
-research/
-└── index.ts
-
-index/
-└── index.ts
-```
-
-### Deletion Rationale (Evidence)
-
-**Evidence 1: Commit Message**
-```
-commit f511e04
-chore: remove TypeScript implementation (saved in typescript-impl branch)
-
-- TypeScript implementation preserved in typescript-impl branch for future reference
-```
-
-**Evidence 2: Branch Preservation Confirmation**
-```bash
-$ git branch --all | grep typescript-impl
-  typescript-impl
-```
-
-**Evidence 3: Avoiding Dual Implementation**
-- TypeScript version: Hot reload plugin implementation (experimental)
-- Python version: Production use (pytest plugin)
-
-**Evidence 4: Markdown-based Command Superiority**
-```markdown
-File: commands/agent.md
-
-# SC Agent Activation
-🚀 **SC Agent online** — this plugin launches `/sc:agent` automatically at session start.
-```
-- Markdown is readable
-- Natively supported by Claude Code
-- TypeScript implementation was over-engineering
-
-**Logical Conclusion**:
-- ✅ TypeScript implementation saved in `typescript-impl` branch
-- ✅ Maintained for future reference
-- ✅ Current Markdown-based + Python implementation is sufficient
-- ✅ Prioritized simplicity
-
----
-
-## 5. Plugin Files Deletion (494 lines)
-
-### What Was Deleted
-```
-.claude-plugin/
-├── plugin.json
-└── marketplace.json
-
-agents/
-├── deep-research.md
-├── repo-index.md
-└── self-review.md
-
-commands/
-├── pm.md
-├── research.md
-└── index-repo.md
-
-hooks/
-└── hooks.json
-```
-
-### Deletion Rationale (Evidence)
-
-**Evidence 1: Commit Message**
-```
-commit 87c80d0
-refactor: move plugin files to SuperClaude_Plugin repository
-
-Plugin files now maintained in SuperClaude_Plugin repository.
-This repository focuses on Python package implementation.
-```
-
-**Evidence 2: Repository Separation Rationale**
-
-**SuperClaude_Framework (this repository)**:
-- Python package implementation
-- pytest plugin
-- CLI tools (`superclaude` command)
-- Documentation
-
-**SuperClaude_Plugin (separate repository)**:
-- Claude Code plugin
-- Slash command definitions
-- Agent definitions
-- Hooks configuration
-
-**Evidence 3: Clear Responsibility Separation**
-```
-SuperClaude_Framework:
-  Purpose: Distributed as Python library
-  Install: `uv pip install superclaude`
-  Target: pytest + CLI users
-
-SuperClaude_Plugin:
-  Purpose: Distributed as Claude Code plugin
-  Install: `/plugin install sc@SuperClaude-Org`
-  Target: Claude Code users
-```
-
-**Logical Conclusion**:
-- ✅ Separation of concerns (Python package vs Claude Code plugin)
-- ✅ Independent version control
-- ✅ Optimized distribution methods
-- ✅ Distributed maintenance burden
-
----
-
-## 6. bin/ + scripts/ Deletion (~800 lines)
-
-### What Was Deleted
-```
-bin/
-├── cli.js
-├── check_env.js
-├── check_update.js
-├── install.js
-└── update.js
-
-scripts/
-├── build_and_upload.py
-├── validate_pypi_ready.py
-└── verify_research_integration.sh
-```
-
-### Deletion Rationale (Evidence)
-
-**Evidence 1: CLI Modernization Commit**
-```
-commit b23c9ce
-feat: migrate CLI to typer + rich for modern UX
-```
-
-**Evidence 2: Old CLI vs New CLI**
-
-**Old CLI (bin/cli.js)**:
-- Node.js implementation
-- Complex dependency checking
-- Auto-update functionality
-
-**New CLI (src/superclaude/cli/main.py)**:
-```python
-# Modern Python CLI with typer + rich
-@app.command()
-def doctor(verbose: bool = False):
-    """Run health checks"""
-    # Simple, readable, maintainable
-```
-
-**Evidence 3: Obsolete Scripts**
-- `build_and_upload.py` → Replaced by `uv build` + `uv publish`
-- `validate_pypi_ready.py` → Replaced by `uv build --check`
-- `verify_research_integration.sh` → Replaced by `uv run pytest`
-
-**Logical Conclusion**:
-- ✅ Eliminated Node.js dependency
-- ✅ Modern Python CLI (typer + rich)
-- ✅ Leveraged UV standard commands
-- ✅ Simpler and more maintainable code
-
----
-
-## 📈 Overall Impact
-
-### Before (master)
-- **Total lines**: ~45,000 lines
-- **Directories**: setup/, superclaude/, bin/, scripts/, .claude-plugin/
-- **Installation**: Complex `setup/` system
-- **Distribution**: npm + PyPI
-- **Dependencies**: Node.js + Python
-
-### After (next)
-- **Total lines**: ~22,500 lines (**50% reduction**)
-- **Directories**: src/superclaude/, docs/, tests/
-- **Installation**: `uv pip install -e ".[dev]"`
-- **Distribution**: PyPI (plugin in separate repo)
-- **Dependencies**: Python only
-
-### Reduction Effects
-- ✅ Code size: 50% reduction
-- ✅ Dependencies: Node.js removed
-- ✅ Maintenance: Significantly reduced with setup/ removal
-- ✅ User environment pollution: Zero
-- ✅ Installation time: Seconds
-
----
-
-## ✅ Conclusion
-
-All deletions were performed based on the following principles:
-
-1. **Evidence-Based**: Backed by documentation, test results, commit history
-2. **Logical**: Compliant with architecture principles, Python standards, Claude Code official recommendations
-3. **Preserved**: TypeScript saved in branch, plugin moved to separate repository
-4. **Verified**: All 97 tests passing, installation verified working
-
-**Review Focus**:
-- [ ] Architecture migration validity
-- [ ] Sufficiency of deletion rationale
-- [ ] Clarity of alternative solutions
-- [ ] Test coverage maintenance
-- [ ] Documentation consistency

Docs/Developer-Guide/contributing-code.md

@@ -57,14 +57,14 @@ SuperClaude is a **Context-Oriented Configuration Framework** - not executing so
 
 ```
 SuperClaude_Framework/
-├── superclaude/           # Framework components (the source of truth)
+├── SuperClaude/           # Framework components (the source of truth)
 │   ├── Core/             # PRINCIPLES.md, RULES.md, FLAGS.md
 │   ├── Agents/           # 15 specialized domain experts
 │   ├── Commands/         # 21 context trigger patterns (/sc: behavioral instructions)
 │   ├── Modes/            # 6 behavioral modification patterns
 │   └── MCP/              # 6 MCP server configurations
 ├── setup/                # Python installation system
-├── docs/                 # Documentation (what you're reading)
+├── Docs/                 # Documentation (what you're reading)
 └── tests/                # File validation scripts
 ```
 
@@ -82,7 +82,7 @@ User Input → Claude Code → Reads SuperClaude Context → Modified Behavior
 ```
 
 1. User types `/sc:implement "auth system"` **in Claude Code conversation** (not terminal)
-2. Claude Code reads `superclaude/Commands/implement.md`
+2. Claude Code reads `SuperClaude/Commands/implement.md`
 3. Command activates security-engineer agent context
 4. Context7 MCP provides authentication patterns
 5. Claude generates complete, secure implementation
@@ -208,7 +208,7 @@ Brief description of context file changes
 
 **Agent Development Process:**
 1. Identify domain expertise gap
-2. Create agent file in `superclaude/Agents/`
+2. Create agent file in `SuperClaude/Agents/`
 3. Define triggers, behaviors, and boundaries
 4. Test with various Claude Code scenarios
 5. Document usage patterns and examples

Docs/Developer-Guide/documentation-index.md

@@ -1,4 +1,4 @@
-# SuperClaude Framework developer-guide Index
+# SuperClaude Framework Developer-Guide Index
 
 ## Document Navigation Guide
 

Docs/Developer-Guide/technical-architecture.md

@@ -34,19 +34,14 @@ This guide documents how SuperClaude's Context-Oriented Configuration Framework
 ├── MCP_Playwright.md               # Playwright MCP integration
 ├── MCP_Sequential.md               # Sequential MCP integration
 ├── MCP_Serena.md                   # Serena MCP integration
-├── MCP_Tavily.md                   # Tavily MCP integration
 ├── MCP_Zig.md                      # Zig MCP integration
 ├── MODE_Brainstorming.md           # Collaborative discovery mode
-├── MODE_Business_Panel.md          # Business expert panel mode
-├── MODE_DeepResearch.md            # Deep research mode
 ├── MODE_Introspection.md           # Transparent reasoning mode
 ├── MODE_Orchestration.md           # Tool coordination mode
 ├── MODE_Task_Management.md         # Task orchestration mode
 ├── MODE_Token_Efficiency.md        # Compressed communication mode
-├── agents/                         # Domain specialist contexts (19 total)
+├── agents/                         # Domain specialist contexts (14 total)
 │   ├── backend-architect.md        # Backend expertise
-│   ├── business-panel-experts.md   # Business strategy panel
-│   ├── deep-research-agent.md      # Deep research expertise
 │   ├── devops-architect.md         # DevOps expertise
 │   ├── frontend-architect.md       # Frontend expertise
 │   ├── learning-guide.md           # Educational expertise
@@ -58,34 +53,27 @@ This guide documents how SuperClaude's Context-Oriented Configuration Framework
 │   ├── root-cause-analyst.md       # Problem diagnosis expertise
 │   ├── security-engineer.md        # Security expertise
 │   ├── socratic-mentor.md          # Educational expertise
-│   ├── spec-panel-experts.md       # Specification review panel
 │   ├── system-architect.md         # System design expertise
-│   ├── technical-writer.md         # Documentation expertise
-│   ├── test-runner.md              # Test execution expertise
-│   └── wave-orchestrator.md        # Wave orchestration patterns
+│   └── technical-writer.md         # Documentation expertise
 └── commands/                       # Workflow pattern contexts
-    └── sc/                         # SuperClaude command namespace (25 total)
+    └── sc/                         # SuperClaude command namespace (21 total)
         ├── analyze.md              # Analysis patterns
         ├── brainstorm.md           # Discovery patterns
         ├── build.md                # Build patterns
-        ├── business-panel.md       # Business expert panel patterns
         ├── cleanup.md              # Cleanup patterns
         ├── design.md               # Design patterns
         ├── document.md             # Documentation patterns
         ├── estimate.md             # Estimation patterns
         ├── explain.md              # Explanation patterns
         ├── git.md                  # Git workflow patterns
-        ├── help.md                 # Help and command listing
         ├── implement.md            # Implementation patterns
         ├── improve.md              # Improvement patterns
         ├── index.md                # Index patterns
         ├── load.md                 # Context loading patterns
         ├── reflect.md              # Reflection patterns
-        ├── research.md             # Deep research patterns
         ├── save.md                 # Session persistence patterns
         ├── select-tool.md          # Tool selection patterns
         ├── spawn.md                # Multi-agent patterns
-        ├── spec-panel.md           # Specification review panel
         ├── task.md                 # Task management patterns
         ├── test.md                 # Testing patterns
         ├── troubleshoot.md         # Troubleshooting patterns
@@ -124,12 +112,9 @@ The main `CLAUDE.md` file uses an import system to load multiple context files:
 @MCP_Playwright.md         # Playwright MCP integration
 @MCP_Sequential.md         # Sequential MCP integration
 @MCP_Serena.md             # Serena MCP integration
-@MCP_Tavily.md             # Tavily MCP integration
 @MCP_Zig.md                # Zig MCP integration
 *CRITICAL*
 @MODE_Brainstorming.md     # Collaborative discovery mode
-@MODE_Business_Panel.md    # Business expert panel mode
-@MODE_DeepResearch.md      # Deep research mode
 @MODE_Introspection.md     # Transparent reasoning mode
 @MODE_Task_Management.md   # Task orchestration mode
 @MODE_Orchestration.md     # Tool coordination mode

Docs/Getting-Started/installation.md

@@ -2,10 +2,10 @@
 
 # 📦 SuperClaude Installation Guide
 
-### **Transform Claude Code with 30 Commands, 20 Agents, 7 Modes & 8 MCP Servers**
+### **Transform Claude Code with 21 Commands, 14 Agents & 6 MCP Servers**
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-4.3.0-blue?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/version-4.1.4-blue?style=for-the-badge" alt="Version">
   <img src="https://img.shields.io/badge/Python-3.8+-green?style=for-the-badge" alt="Python">
   <img src="https://img.shields.io/badge/Platform-Linux%20|%20macOS%20|%20Windows-orange?style=for-the-badge" alt="Platform">
 </p>
@@ -33,7 +33,7 @@
 | **🐍 pipx** | `pipx install SuperClaude && SuperClaude install` | Linux/macOS | **✅ Recommended** - Isolated environment |
 | **📦 pip** | `pip install SuperClaude && SuperClaude install` | All | Traditional Python setups |
 | **🌐 npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | All | Node.js developers |
-| **🔧 Dev** | `git clone ... && uv pip install -e ".[dev]"` | All | Contributors & developers |
+| **🔧 Dev** | `git clone ... && pip install -e ".[dev]"` | All | Contributors & developers |
 
 </div>
 
@@ -209,11 +209,8 @@ superclaude install
 git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
 cd SuperClaude_Framework
 
-# Install uv if not present
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
 # Install in development mode
-uv pip install -e ".[dev]"
+pip install -e ".[dev]"
 
 # Test installation
 SuperClaude install --dry-run
@@ -226,7 +223,6 @@ SuperClaude install --dry-run
 - Latest features
 - Contribute to project
 - Full source access
-- Fast installation (uv)
 
 **📍 Best for:**
 - Contributors
@@ -270,7 +266,7 @@ SuperClaude install --dry-run
 ```bash
 # Verify SuperClaude version
 python3 -m SuperClaude --version
-# Expected: SuperClaude 4.3.0
+# Expected: SuperClaude 4.1.4
 
 # List installed components
 SuperClaude install --list-components
@@ -470,24 +466,24 @@ brew install python3
 
 **First Week:**
 - [Quick Start Guide](quick-start.md)
-- [Commands Reference](../user-guide/commands.md)
+- [Commands Reference](../User-Guide/commands.md)
 - Try `/sc:brainstorm`
 
 </td>
 <td valign="top">
 
 **Week 2-3:**
-- [Behavioral Modes](../user-guide/modes.md)
-- [Agents Guide](../user-guide/agents.md)
-- [Examples Cookbook](../reference/examples-cookbook.md)
+- [Behavioral Modes](../User-Guide/modes.md)
+- [Agents Guide](../User-Guide/agents.md)
+- [Examples Cookbook](../Reference/examples-cookbook.md)
 
 </td>
 <td valign="top">
 
 **Advanced:**
-- [MCP Servers](../user-guide/mcp-servers.md)
-- [Technical Architecture](../developer-guide/technical-architecture.md)
-- [Contributing Code](../developer-guide/contributing-code.md)
+- [MCP Servers](../User-Guide/mcp-servers.md)
+- [Technical Architecture](../Developer-Guide/technical-architecture.md)
+- [Contributing Code](../Developer-Guide/contributing-code.md)
 
 </td>
 </tr>
@@ -504,7 +500,7 @@ brew install python3
 You now have access to:
 
 <p align="center">
-  <b>30 Commands</b> • <b>20 AI Agents</b> • <b>7 Behavioral Modes</b> • <b>8 MCP Servers</b>
+  <b>21 Commands</b> • <b>14 AI Agents</b> • <b>6 Behavioral Modes</b> • <b>6 MCP Servers</b>
 </p>
 
 **Ready to start?** Try `/sc:brainstorm` in Claude Code for your first SuperClaude experience!

Docs/Getting-Started/quick-start.md

@@ -6,7 +6,7 @@
 
 <p align="center">
   <img src="https://img.shields.io/badge/Framework-Context_Engineering-purple?style=for-the-badge" alt="Framework">
-  <img src="https://img.shields.io/badge/Version-4.3.0-blue?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/Version-4.1.4-blue?style=for-the-badge" alt="Version">
   <img src="https://img.shields.io/badge/Time_to_Start-5_Minutes-green?style=for-the-badge" alt="Quick Start">
 </p>
 
@@ -30,7 +30,7 @@
 
 | **Commands** | **AI Agents** | **Behavioral Modes** | **MCP Servers** |
 |:------------:|:-------------:|:-------------------:|:---------------:|
-| **30** | **20** | **7** | **8** |
+| **21** | **14** | **6** | **6** |
 | `/sc:` triggers | Domain specialists | Context adaptation | Tool integration |
 
 </div>
@@ -435,8 +435,8 @@ Start simple with basic commands. Complexity emerges naturally as needed.
 
 **First Week:**
 - [Installation Guide](installation.md)
-- [Commands Reference](../user-guide/commands.md)
-- [Examples Cookbook](../reference/examples-cookbook.md)
+- [Commands Reference](../User-Guide/commands.md)
+- [Examples Cookbook](../Reference/examples-cookbook.md)
 
 Start with `/sc:brainstorm`
 
@@ -444,9 +444,9 @@ Start with `/sc:brainstorm`
 <td valign="top">
 
 **Growing Skills:**
-- [Behavioral Modes](../user-guide/modes.md)
-- [Agents Guide](../user-guide/agents.md)
-- [Session Management](../user-guide/session-management.md)
+- [Behavioral Modes](../User-Guide/modes.md)
+- [Agents Guide](../User-Guide/agents.md)
+- [Session Management](../User-Guide/session-management.md)
 
 Explore mode combinations
 
@@ -454,9 +454,9 @@ Explore mode combinations
 <td valign="top">
 
 **Expert Usage:**
-- [MCP Servers](../user-guide/mcp-servers.md)
-- [Technical Architecture](../developer-guide/technical-architecture.md)
-- [Contributing](../developer-guide/contributing-code.md)
+- [MCP Servers](../User-Guide/mcp-servers.md)
+- [Technical Architecture](../Developer-Guide/technical-architecture.md)
+- [Contributing](../Developer-Guide/contributing-code.md)
 
 Create custom workflows
 
@@ -465,10 +465,10 @@ Create custom workflows
 </table>
 
 <p align="center">
-  <a href="../user-guide/commands.md">
+  <a href="../User-Guide/commands.md">
     <img src="https://img.shields.io/badge/📚_Explore-All_21_Commands-blue?style=for-the-badge" alt="Commands">
   </a>
-  <a href="../reference/examples-cookbook.md">
+  <a href="../Reference/examples-cookbook.md">
     <img src="https://img.shields.io/badge/🍳_Try-Real_Examples-green?style=for-the-badge" alt="Examples">
   </a>
 </p>
@@ -486,7 +486,7 @@ Create custom workflows
 </p>
 
 <p align="center">
-  <sub>SuperClaude v4.3.0 - Context Engineering for Claude Code</sub>
+  <sub>SuperClaude v4.1.4 - Context Engineering for Claude Code</sub>
 </p>
 
 </div>

Docs/Reference/README.md

@@ -40,7 +40,7 @@ This documentation is organized for **progressive learning** with multiple entry
 **Goal**: Establish confident SuperClaude usage with essential workflows
 
 ```
-Day 1-2: ../getting-started/quick-start.md
+Day 1-2: ../Getting-Started/quick-start.md
    ↓ Foundation building and first commands
 Day 3-4: basic-examples.md  
    ↓ Practical application and pattern recognition
@@ -159,7 +159,7 @@ Advanced Analysis: diagnostic-reference.md
 
 ### Immediate Issues
 - **Command not working**: Check [common-issues.md](./common-issues.md) → Common SuperClaude Problems
-- **Session lost**: Use `/sc:load` → See [Session Management](../user-guide/session-management.md)
+- **Session lost**: Use `/sc:load` → See [Session Management](../User-Guide/session-management.md)
 - **Flag confusion**: Check [basic-examples.md](./basic-examples.md) → Flag Usage Examples
 
 ### Development Blockers
@@ -242,7 +242,7 @@ Found outdated information or broken examples?
 
 ---
 
-**Start Your Journey**: New to SuperClaude? Begin with [Quick Start Guide](../getting-started/quick-start.md) for immediate productivity gains.
+**Start Your Journey**: New to SuperClaude? Begin with [Quick Start Guide](../Getting-Started/quick-start.md) for immediate productivity gains.
 
 **Need Answers Now**: Jump to [basic-examples.md](./basic-examples.md) for copy-paste solutions.
 

Docs/Reference/common-issues.md

@@ -13,7 +13,7 @@ Test: /sc:brainstorm "test" should ask questions
 
 ### 2. Installation Verification
 ```bash
-python3 -m SuperClaude --version    # Should show 4.1.5
+python3 -m SuperClaude --version    # Should show 4.1.4
 
 # If not working:
 # For pipx users
@@ -71,7 +71,7 @@ pip3 install SuperClaude
 ```
 
 ## Verification Checklist
-- [ ] `python3 -m SuperClaude --version` returns 4.1.5
+- [ ] `python3 -m SuperClaude --version` returns 4.1.4
 - [ ] `/sc:brainstorm "test"` works in Claude Code
 - [ ] `SuperClaude install --list-components` shows components
 

Docs/Reference/examples-cookbook.md

@@ -95,7 +95,7 @@
 ## Learning Progression Roadmap
 
 ### Phase 1: Foundation (Week 1-2)
-1. **Setup**: Complete [Installation Guide](../getting-started/installation.md)
+1. **Setup**: Complete [Installation Guide](../Getting-Started/installation.md)
 2. **Basics**: Practice [Basic Examples](./basic-examples.md#essential-one-liner-commands)
 3. **Patterns**: Learn [Basic Usage Patterns](./basic-examples.md#basic-usage-patterns)
 4. **Success**: Can execute common development tasks independently
@@ -151,9 +151,9 @@
 ## Support Resources
 
 **Documentation**:
-- [Commands Reference](../user-guide/commands.md) - Complete command documentation
-- [Agents Guide](../user-guide/agents.md) - Multi-agent coordination
-- [MCP Servers](../user-guide/mcp-servers.md) - Enhanced capabilities
+- [Commands Reference](../User-Guide/commands.md) - Complete command documentation
+- [Agents Guide](../User-Guide/agents.md) - Multi-agent coordination
+- [MCP Servers](../User-Guide/mcp-servers.md) - Enhanced capabilities
 - [Advanced Workflows](./advanced-workflows.md) - Complex coordination patterns
 
 **Community**:
@@ -162,7 +162,7 @@
 - [Contributing Guide](../CONTRIBUTING.md) - Framework contribution
 
 **Advanced**:
-- [Technical Architecture](../developer-guide/technical-architecture.md) - Deep system understanding
+- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Deep system understanding
 - [Troubleshooting Guide](./troubleshooting.md) - Common issues and solutions
 
 ---

Docs/Reference/mcp-server-guide.md

@@ -732,7 +732,7 @@ echo "Test MCP servers in Claude Code after restart"
 ## Related Resources
 
 ### MCP-Specific Documentation
-- **Core SuperClaude Guide**: [../user-guide/mcp-servers.md](../user-guide/mcp-servers.md) - MCP server overview and usage
+- **Core SuperClaude Guide**: [../User-Guide/mcp-servers.md](../User-Guide/mcp-servers.md) - MCP server overview and usage
 - **Common Issues**: [common-issues.md](./common-issues.md) - General troubleshooting procedures
 - **Diagnostic Reference**: [diagnostic-reference.md](./diagnostic-reference.md) - Advanced diagnostic procedures
 

Docs/Reference/troubleshooting.md

@@ -6,7 +6,7 @@ Quick fixes to advanced diagnostics for SuperClaude Framework issues.
 
 **Installation Verification:**
 ```bash
-python3 -m SuperClaude --version    # Should show 4.1.5
+python3 -m SuperClaude --version    # Should show 4.1.4
 SuperClaude install --list-components
 ```
 
@@ -19,7 +19,7 @@ SuperClaude install --list-components
 ```
 
 **Resolution Checklist:**
-- [ ] Version commands work and show 4.1.5
+- [ ] Version commands work and show 4.1.4
 - [ ] `/sc:` commands respond in Claude Code  
 - [ ] MCP servers listed: `SuperClaude install --list-components | grep mcp`
 
@@ -116,8 +116,8 @@ SuperClaude install --fresh
 ## Get Help
 
 **Documentation:**
-- [Installation Guide](../getting-started/installation.md) - Setup issues
-- [Commands Guide](../user-guide/commands.md) - Usage issues
+- [Installation Guide](../Getting-Started/installation.md) - Setup issues
+- [Commands Guide](../User-Guide/commands.md) - Usage issues
 
 **Community:**
 - [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)

Docs/User-Guide-jp/agents.md

@@ -1,12 +1,12 @@
 # SuperClaude エージェントガイド 🤖
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#superclaude-agents-guide-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#superclaude-agents-guide-)
 
 SuperClaude は、Claude Code が専門知識を得るために呼び出すことができる 14 のドメイン スペシャリスト エージェントを提供します。
 
 ## 🧪 エージェントのアクティベーションのテスト
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#-testing-agent-activation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#-testing-agent-activation)
 
 このガイドを使用する前に、エージェントの選択が機能することを確認してください。
 
@@ -37,23 +37,23 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ
 
 ## コアコンセプト
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#core-concepts)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#core-concepts)
 
 ### SuperClaude エージェントとは何ですか?
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#what-are-superclaude-agents)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#what-are-superclaude-agents)
 
-**エージェントは**、Claude Codeの行動を変更するコンテキスト指示として実装された、専門分野のAIドメインエキスパートです。各エージェントは、ドメイン固有の専門知識、行動パターン、問題解決アプローチを含む、ディレクトリ`.md`内に綿密に作成されたファイルです`superclaude/Agents/`。
+**エージェントは**、Claude Codeの行動を変更するコンテキスト指示として実装された、専門分野のAIドメインエキスパートです。各エージェントは、ドメイン固有の専門知識、行動パターン、問題解決アプローチを含む、ディレクトリ`.md`内に綿密に作成されたファイルです`SuperClaude/Agents/`。
 
 **重要**: エージェントは別個の AI モデルやソフトウェアではなく、Claude Code が読み取って特殊な動作を採用するコンテキスト構成です。
 
 ### エージェントの2つの使用方法
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#two-ways-to-use-agents)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#two-ways-to-use-agents)
 
 #### 1. @agent- プレフィックスを使用した手動呼び出し
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#1-manual-invocation-with-agent--prefix)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#1-manual-invocation-with-agent--prefix)
 
 ```shell
 # Directly invoke a specific agent
@@ -64,7 +64,7 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ
 
 #### 2. 自動アクティベーション（行動ルーティング）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#2-auto-activation-behavioral-routing)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#2-auto-activation-behavioral-routing)
 
 「自動アクティベーション」とは、Claude Codeがリクエスト内のキーワードとパターンに基づいて適切なコンテキストで動作指示を読み取り、エンゲージすることを意味します。SuperClaudeは、Claudeが最適なスペシャリストにルーティングするための動作ガイドラインを提供します。
 
@@ -83,7 +83,7 @@ SuperClaude は、Claude Code が専門知識を得るために呼び出すこ
 
 ### エージェント選択ルール
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-selection-rules)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-selection-rules)
 
 **優先順位の階層:**
 
@@ -115,11 +115,11 @@ Task Analysis →
 
 ## クイックスタートの例
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quick-start-examples)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quick-start-examples)
 
 ### 手動エージェント呼び出し
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#manual-agent-invocation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#manual-agent-invocation)
 
 ```shell
 # Explicitly call specific agents with @agent- prefix
@@ -131,7 +131,7 @@ Task Analysis →
 
 ### 自動エージェント調整
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#automatic-agent-coordination)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#automatic-agent-coordination)
 
 ```shell
 # Commands that trigger auto-activation
@@ -150,7 +150,7 @@ Task Analysis →
 
 ### 手動と自動のアプローチを組み合わせる
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#combining-manual-and-auto-approaches)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#combining-manual-and-auto-approaches)
 
 ```shell
 # Start with command (auto-activation)
@@ -165,15 +165,15 @@ Task Analysis →
 
 ## SuperClaude エージェントチーム 👥
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#the-superclaude-agent-team-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#the-superclaude-agent-team-)
 
 ### アーキテクチャとシステム設計エージェント 🏗️
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#architecture--system-design-agents-%EF%B8%8F)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#architecture--system-design-agents-%EF%B8%8F)
 
 ### システムアーキテクト 🏢
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#system-architect-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#system-architect-)
 
 **専門分野**：スケーラビリティとサービスアーキテクチャに重点を置いた大規模分散システム設計
 
@@ -199,7 +199,7 @@ Task Analysis →
 
 ### 成功基準
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#success-criteria)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#success-criteria)
 
 - [ ] 応答に表れたシステムレベルの思考
 - [ ] サービスの境界と統合パターンについて言及する
@@ -216,7 +216,7 @@ Task Analysis →
 
 ### バックエンドアーキテクト ⚙️
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#backend-architect-%EF%B8%8F)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#backend-architect-%EF%B8%8F)
 
 **専門分野**: APIの信頼性とデータの整合性を重視した堅牢なサーバーサイドシステム設計
 
@@ -246,7 +246,7 @@ Task Analysis →
 
 ### フロントエンドアーキテクト 🎨
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#frontend-architect-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#frontend-architect-)
 
 **専門分野**: アクセシビリティとユーザーエクスペリエンスを重視した最新の Web アプリケーション アーキテクチャ
 
@@ -276,7 +276,7 @@ Task Analysis →
 
 ### DevOps アーキテクト 🚀
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#devops-architect-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#devops-architect-)
 
 **専門分野**: 信頼性の高いソフトウェア配信のためのインフラストラクチャ自動化と展開パイプライン設計
 
@@ -304,11 +304,11 @@ Task Analysis →
 
 ### 品質・分析エージェント 🔍
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quality--analysis-agents-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quality--analysis-agents-)
 
 ### セキュリティエンジニア 🔒
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#security-engineer-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#security-engineer-)
 
 **専門分野**: 脅威モデリングと脆弱性防止に重点を置いたアプリケーション セキュリティ アーキテクチャ
 
@@ -338,7 +338,7 @@ Task Analysis →
 
 ### パフォーマンスエンジニア ⚡
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#performance-engineer-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#performance-engineer-)
 
 **専門分野**：スケーラビリティとリソース効率を重視したシステムパフォーマンスの最適化
 
@@ -368,7 +368,7 @@ Task Analysis →
 
 ### 根本原因分析者 🔍
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#root-cause-analyst-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#root-cause-analyst-)
 
 **専門分野**：証拠に基づく分析と仮説検定を用いた体系的な問題調査
 
@@ -398,7 +398,7 @@ Task Analysis →
 
 ### 品質エンジニア ✅
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quality-engineer-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quality-engineer-)
 
 **専門分野**:自動化とカバレッジに重点を置いた包括的なテスト戦略と品質保証
 
@@ -428,7 +428,7 @@ Task Analysis →
 
 ### リファクタリングの専門家 🔧
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#refactoring-expert-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#refactoring-expert-)
 
 **専門分野**：体系的なリファクタリングと技術的負債管理によるコード品質の改善
 
@@ -456,11 +456,11 @@ Task Analysis →
 
 ### 専門開発エージェント 🎯
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#specialized-development-agents-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#specialized-development-agents-)
 
 ### Python エキスパート 🐍
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#python-expert-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#python-expert-)
 
 **専門分野**: 最新のフレームワークとパフォーマンスを重視した、本番環境対応の Python 開発
 
@@ -490,7 +490,7 @@ Task Analysis →
 
 ### 要件アナリスト 📝
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#requirements-analyst-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#requirements-analyst-)
 
 **専門分野**：体系的なステークホルダー分析による要件発見と仕様策定
 
@@ -518,11 +518,11 @@ Task Analysis →
 
 ### コミュニケーションと学習エージェント 📚
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#communication--learning-agents-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#communication--learning-agents-)
 
 ### テクニカルライター 📚
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#technical-writer-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#technical-writer-)
 
 **専門分野**: 視聴者分析と明確さを重視した技術文書作成とコミュニケーション
 
@@ -552,7 +552,7 @@ Task Analysis →
 
 ### 学習ガイド 🎓
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#learning-guide-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#learning-guide-)
 
 **専門分野**：スキル開発とメンターシップに重点を置いた教育コンテンツの設計と漸進的学習
 
@@ -582,11 +582,11 @@ Task Analysis →
 
 ## エージェントの調整と統合 🤝
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-coordination--integration-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-coordination--integration-)
 
 ### 調整パターン
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#coordination-patterns)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#coordination-patterns)
 
 **アーキテクチャチーム**:
 
@@ -608,7 +608,7 @@ Task Analysis →
 
 ### MCP サーバー統合
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#mcp-server-integration)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#mcp-server-integration)
 
 **MCP サーバーによる拡張機能**:
 
@@ -621,20 +621,20 @@ Task Analysis →
 
 ### エージェントのアクティベーションのトラブルシューティング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#troubleshooting-agent-activation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#troubleshooting-agent-activation)
 
 ## トラブルシューティング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#troubleshooting)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#troubleshooting)
 
 トラブルシューティングのヘルプについては、以下を参照してください。
 
-- [よくある問題](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/common-issues.md)- よくある問題に対するクイック修正
-- [トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/troubleshooting.md)- 包括的な問題解決
+- [よくある問題](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/common-issues.md)- よくある問題に対するクイック修正
+- [トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/troubleshooting.md)- 包括的な問題解決
 
 ### よくある問題
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#common-issues)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#common-issues)
 
 - **エージェントのアクティベーションなし**: ドメインキーワード「セキュリティ」、「パフォーマンス」、「フロントエンド」を使用します
 - **間違ったエージェントが選択されました**: エージェントのドキュメントでトリガーキーワードを確認してください
@@ -644,7 +644,7 @@ Task Analysis →
 
 ### 即時修正
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#immediate-fixes)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#immediate-fixes)
 
 - **エージェントの強制アクティベーション**: リクエストで明示的なドメインキーワードを使用する
 - **エージェントの選択をリセット**: エージェントの状態をリセットするには、Claude Code セッションを再起動します。
@@ -653,7 +653,7 @@ Task Analysis →
 
 ### エージェント固有のトラブルシューティング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-specific-troubleshooting)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-specific-troubleshooting)
 
 **セキュリティエージェントなし:**
 
@@ -697,7 +697,7 @@ Task Analysis →
 
 ### サポートレベル
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#support-levels)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#support-levels)
 
 **クイックフィックス:**
 
@@ -707,13 +707,13 @@ Task Analysis →
 
 **詳細なヘルプ:**
 
-- エージェントのインストールに関する問題については、[一般的な問題ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/common-issues.md)を参照してください。
+- エージェントのインストールに関する問題については、[一般的な問題ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/common-issues.md)を参照してください。
 - 対象エージェントのトリガーキーワードを確認する
 
 **専門家によるサポート:**
 
 - 使用`SuperClaude install --diagnose`
-- 協調分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/diagnostic-reference.md)を参照してください
+- 協調分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/diagnostic-reference.md)を参照してください
 
 **コミュニティサポート:**
 
@@ -722,7 +722,7 @@ Task Analysis →
 
 ### 成功の検証
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#success-validation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#success-validation)
 
 エージェントの修正を適用した後、次のようにテストします。
 
@@ -734,7 +734,7 @@ Task Analysis →
 
 ## クイックトラブルシューティング（レガシー）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quick-troubleshooting-legacy)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quick-troubleshooting-legacy)
 
 - **エージェントが有効化されていない場合**→ ドメインキーワード「セキュリティ」、「パフォーマンス」、「フロントエンド」を使用します
 - **エージェントが間違っている**→ エージェントのドキュメントでトリガーキーワードを確認してください
@@ -762,11 +762,11 @@ Task Analysis →
 
 ## クイックリファレンス 📋
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quick-reference-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quick-reference-)
 
 ### エージェントトリガー検索
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-trigger-lookup)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-trigger-lookup)
 
 |トリガータイプ|キーワード/パターン|活性化エージェント|
 |---|---|---|
@@ -786,7 +786,7 @@ Task Analysis →
 
 ### コマンドエージェントマッピング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#command-agent-mapping)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#command-agent-mapping)
 
 |指示|主な薬剤|サポートエージェント|
 |---|---|---|
@@ -801,7 +801,7 @@ Task Analysis →
 
 ### 効果的な薬剤の組み合わせ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#effective-agent-combinations)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#effective-agent-combinations)
 
 **開発ワークフロー**:
 
@@ -822,11 +822,11 @@ Task Analysis →
 
 ## ベストプラクティス💡
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#best-practices-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#best-practices-)
 
 ### はじめに（シンプルなアプローチ）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#getting-started-simple-approach)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#getting-started-simple-approach)
 
 **自然言語ファースト:**
 
@@ -837,7 +837,7 @@ Task Analysis →
 
 ### エージェントの選択の最適化
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#optimizing-agent-selection)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#optimizing-agent-selection)
 
 **効果的なキーワードの使用法:**
 
@@ -859,7 +859,7 @@ Task Analysis →
 
 ### 一般的な使用パターン
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#common-usage-patterns)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#common-usage-patterns)
 
 **開発ワークフロー:**
 
@@ -895,7 +895,7 @@ Task Analysis →
 
 ### 高度なエージェント調整
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#advanced-agent-coordination)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#advanced-agent-coordination)
 
 **マルチドメインプロジェクト:**
 
@@ -923,7 +923,7 @@ Task Analysis →
 
 ### 品質重視の開発
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#quality-driven-development)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quality-driven-development)
 
 **セキュリティ第一のアプローチ:** 開発リクエストには常にセキュリティに関する考慮事項を含め、ドメインスペシャリストとともにセキュリティエンジニアを自動的に関与させます。
 
@@ -937,11 +937,11 @@ Task Analysis →
 
 ## エージェントインテリジェンスを理解する🧠
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#understanding-agent-intelligence-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#understanding-agent-intelligence-)
 
 ### エージェントを効果的にする要素
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#what-makes-agents-effective)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#what-makes-agents-effective)
 
 **ドメイン専門知識**: 各エージェントは、それぞれのドメインに特有の専門的な知識パターン、行動アプローチ、問題解決方法論を備えています。
 
@@ -953,7 +953,7 @@ Task Analysis →
 
 ### エージェント vs. 従来のAI
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#agent-vs-traditional-ai)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-vs-traditional-ai)
 
 **従来のアプローチ**: 単一のAIが、さまざまなレベルの専門知識を持つすべてのドメインを処理します。 **エージェントアプローチ**: 専門のエキスパートが、深いドメイン知識と集中的な問題解決で協力します。
 
@@ -966,7 +966,7 @@ Task Analysis →
 
 ### システムを信頼し、パターンを理解する
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#trust-the-system-understand-the-patterns)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#trust-the-system-understand-the-patterns)
 
 **期待すること**:
 
@@ -986,36 +986,36 @@ Task Analysis →
 
 ## 関連リソース 📚
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#related-resources-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#related-resources-)
 
 ### 必須ドキュメント
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#essential-documentation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#essential-documentation)
 
-- **[コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md)**- 最適なエージェント調整をトリガーするSuperClaudeコマンドをマスターする
-- **[MCP サーバー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md)**- 専用ツールの統合によるエージェント機能の強化
-- **[セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)**- 永続的なエージェントコンテキストによる長期ワークフロー
+- **[コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)**- 最適なエージェント調整をトリガーするSuperClaudeコマンドをマスターする
+- **[MCP サーバー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md)**- 専用ツールの統合によるエージェント機能の強化
+- **[セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)**- 永続的なエージェントコンテキストによる長期ワークフロー
 
 ### 高度な使用法
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#advanced-usage)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#advanced-usage)
 
-- **[行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md)**- エージェントの調整を強化するためのコンテキスト最適化
-- **[はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/quick-start.md)**- エージェントの最適化のための専門家のテクニック
-- **[例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)**- 現実世界のエージェントの調整パターン
+- **[行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md)**- エージェントの調整を強化するためのコンテキスト最適化
+- **[はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/quick-start.md)**- エージェントの最適化のための専門家のテクニック
+- **[例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md)**- 現実世界のエージェントの調整パターン
 
 ### 開発リソース
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#development-resources)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#development-resources)
 
-- **[技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/technical-architecture.md)**- SuperClaude のエージェント システム設計を理解する
-- **[貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/contributing-code.md)**- エージェントの機能と調整パターンの拡張
+- **[技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/technical-architecture.md)**- SuperClaude のエージェント システム設計を理解する
+- **[貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/contributing-code.md)**- エージェントの機能と調整パターンの拡張
 
 ---
 
 ## エージェントとしての道のり 🚀
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md#your-agent-journey-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#your-agent-journey-)
 
 **第1週：自然な使用法** 自然な言語による説明から始めましょう。どのエージェントが、そしてなぜアクティブになるのかに注目しましょう。プロセスを考えすぎずに、キーワードのパターンに対する直感を養います。
 

Docs/User-Guide-jp/commands.md

@@ -1,12 +1,12 @@
 # SuperClaude コマンドガイド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#superclaude-commands-guide)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#superclaude-commands-guide)
 
 `/sc:*`SuperClaude は、ワークフロー用コマンドと`@agent-*`スペシャリスト用コマンドの 21 個の Claude Code コマンドを提供します。
 
 ## コマンドの種類
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#command-types)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#command-types)
 
 |タイプ|使用場所|形式|例|
 |---|---|---|---|
@@ -16,7 +16,7 @@
 
 ## クイックテスト
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#quick-test)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#quick-test)
 
 ```shell
 # Terminal: Verify installation
@@ -32,11 +32,11 @@ python3 -m SuperClaude --version
 
 ## 🎯 SuperClaude コマンドの理解
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#-understanding-superclaude-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#-understanding-superclaude-commands)
 
 ## SuperClaudeの仕組み
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#how-superclaude-works)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#how-superclaude-works)
 
 SuperClaude は、Claude Code が特殊な動作を実行するために読み込む動作コンテキストファイルを提供します。 と入力すると`/sc:implement`、Claude Code は`implement.md`コンテキストファイルを読み込み、その動作指示に従います。
 
@@ -44,7 +44,7 @@ SuperClaude は、Claude Code が特殊な動作を実行するために読み
 
 ### コマンドの種類:
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#command-types-1)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#command-types-1)
 
 - **スラッシュコマンド**（`/sc:*`）：ワークフローパターンと動作​​モードをトリガーする
 - **エージェントの呼び出し**（`@agent-*`）：特定のドメインスペシャリストを手動で起動する
@@ -52,10 +52,10 @@ SuperClaude は、Claude Code が特殊な動作を実行するために読み
 
 ### コンテキストメカニズム:
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#the-context-mechanism)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#the-context-mechanism)
 
 1. **ユーザー入力**: 入力する`/sc:implement "auth system"`
-2. **コンテキスト読み込み**: クロードコード読み取り`~/.claude/superclaude/Commands/implement.md`
+2. **コンテキスト読み込み**: クロードコード読み取り`~/.claude/SuperClaude/Commands/implement.md`
 3. **行動の採用**：クロードはドメインの専門知識、ツールの選択、検証パターンを適用します
 4. **強化された出力**: セキュリティ上の考慮事項とベストプラクティスを備えた構造化された実装
 
@@ -63,7 +63,7 @@ SuperClaude は、Claude Code が特殊な動作を実行するために読み
 
 ### インストールコマンドと使用コマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#installation-vs-usage-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#installation-vs-usage-commands)
 
 **🖥️ ターミナルコマンド**（実際の CLI ソフトウェア）：
 
@@ -83,16 +83,16 @@ SuperClaude は、Claude Code が特殊な動作を実行するために読み
 
 ## 🧪 セットアップのテスト
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#-testing-your-setup)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#-testing-your-setup)
 
 ### 🖥️ ターミナル検証（ターミナル/CMDで実行）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#%EF%B8%8F-terminal-verification-run-in-terminalcmd)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#%EF%B8%8F-terminal-verification-run-in-terminalcmd)
 
 ```shell
 # Verify SuperClaude is working (primary method)
 python3 -m SuperClaude --version
-# Example output: SuperClaude 4.1.5
+# Example output: SuperClaude 4.1.4
 
 # Claude Code CLI version check
 claude --version
@@ -104,7 +104,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### 💬 クロードコードテスト（クロードコードチャットに入力）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#-claude-code-testing-type-in-claude-code-chat)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#-claude-code-testing-type-in-claude-code-chat)
 
 ```
 # Test basic /sc: command
@@ -116,11 +116,11 @@ python3 -m SuperClaude install --list-components | grep mcp
 # Example behavior: List of available commands
 ```
 
-**テストが失敗した場合**:[インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/installation.md)または[トラブルシューティングを確認してください](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#troubleshooting)
+**テストが失敗した場合**:[インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/installation.md)または[トラブルシューティングを確認してください](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#troubleshooting)
 
 ### 📝 コマンドクイックリファレンス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#-command-quick-reference)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#-command-quick-reference)
 
 |コマンドタイプ|走る場所|形式|目的|例|
 |---|---|---|---|---|
@@ -134,25 +134,25 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ## 目次
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#table-of-contents)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#table-of-contents)
 
-- [必須コマンド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#essential-commands)- ここから始めましょう（8つのコアコマンド）
-- [一般的なワークフロー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#common-workflows)- 機能するコマンドの組み合わせ
-- [完全なコマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#full-command-reference)- カテゴリ別に整理された全21個のコマンド
-- [トラブルシューティング](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#troubleshooting)- よくある問題と解決策
-- [コマンドインデックス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#command-index)- カテゴリ別にコマンドを検索
+- [必須コマンド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#essential-commands)- ここから始めましょう（8つのコアコマンド）
+- [一般的なワークフロー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#common-workflows)- 機能するコマンドの組み合わせ
+- [完全なコマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#full-command-reference)- カテゴリ別に整理された全21個のコマンド
+- [トラブルシューティング](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#troubleshooting)- よくある問題と解決策
+- [コマンドインデックス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#command-index)- カテゴリ別にコマンドを検索
 
 ---
 
 ## 必須コマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#essential-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#essential-commands)
 
 **即時の生産性向上のためのコアワークフロー コマンド:**
 
 ### `/sc:brainstorm`- プロジェクト発見
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#scbrainstorm---project-discovery)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scbrainstorm---project-discovery)
 
 **目的**: 対話型の要件検出とプロジェクト計画  
 **構文**:`/sc:brainstorm "your idea"` `[--strategy systematic|creative]`
@@ -165,7 +165,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### `/sc:implement`- 機能開発
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#scimplement---feature-development)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scimplement---feature-development)
 
 **目的**: インテリジェントなスペシャリストルーティングによるフルスタック機能の実装  
 **構文**:`/sc:implement "feature description"` `[--type frontend|backend|fullstack] [--focus security|performance]`
@@ -179,7 +179,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### `/sc:analyze`- コード評価
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#scanalyze---code-assessment)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scanalyze---code-assessment)
 
 **目的**: 品質、セキュリティ、パフォーマンスにわたる包括的なコード分析  
 **構文**:`/sc:analyze [path]` `[--focus quality|security|performance|architecture]`
@@ -192,7 +192,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### `/sc:troubleshoot`- 問題診断
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#sctroubleshoot---problem-diagnosis)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#sctroubleshoot---problem-diagnosis)
 
 **目的**: 根本原因分析による体系的な問題診断  
 **構文**:`/sc:troubleshoot "issue description"` `[--type build|runtime|performance]`
@@ -205,7 +205,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### `/sc:test`- 品質保証
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#sctest---quality-assurance)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#sctest---quality-assurance)
 
 **目的**: カバレッジ分析による包括的なテスト  
 **構文**:`/sc:test` `[--type unit|integration|e2e] [--coverage] [--fix]`
@@ -218,7 +218,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### `/sc:improve`- コード強化
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#scimprove---code-enhancement)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scimprove---code-enhancement)
 
 **目的**: 体系的なコードの改善と最適化を適用する  
 **構文**:`/sc:improve [path]` `[--type performance|quality|security] [--preview]`
@@ -231,7 +231,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### `/sc:document`- ドキュメント生成
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#scdocument---documentation-generation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scdocument---documentation-generation)
 
 **目的**: コードとAPIの包括的なドキュメントを生成する  
 **構文**:`/sc:document [path]` `[--type api|user-guide|technical] [--format markdown|html]`
@@ -244,7 +244,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### `/sc:workflow`- 実装計画
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#scworkflow---implementation-planning)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scworkflow---implementation-planning)
 
 **目的**: 要件から構造化された実装計画を生成する  
 **構文**:`/sc:workflow "feature description"` `[--strategy agile|waterfall] [--format markdown]`
@@ -259,13 +259,13 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ## 一般的なワークフロー
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#common-workflows)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#common-workflows)
 
 **実証済みのコマンドの組み合わせ:**
 
 ### 新しいプロジェクトのセットアップ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#new-project-setup)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#new-project-setup)
 
 ```shell
 /sc:brainstorm "project concept"      # Define requirements
@@ -275,7 +275,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### 機能開発
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#feature-development)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#feature-development)
 
 ```shell
 /sc:implement "feature name"          # Build the feature
@@ -285,7 +285,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### コード品質の改善
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#code-quality-improvement)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#code-quality-improvement)
 
 ```shell
 /sc:analyze --focus quality           # Assess current state
@@ -295,7 +295,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### バグ調査
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#bug-investigation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#bug-investigation)
 
 ```shell
 /sc:troubleshoot "issue description"  # Diagnose the problem
@@ -305,11 +305,11 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ## 完全なコマンドリファレンス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#full-command-reference)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#full-command-reference)
 
 ### 開発コマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#development-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#development-commands)
 
 |指示|目的|最適な用途|
 |---|---|---|
@@ -320,7 +320,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### 分析コマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#analysis-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#analysis-commands)
 
 |指示|目的|最適な用途|
 |---|---|---|
@@ -330,7 +330,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### 品質コマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#quality-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#quality-commands)
 
 |指示|目的|最適な用途|
 |---|---|---|
@@ -341,7 +341,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### プロジェクト管理
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#project-management)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#project-management)
 
 |指示|目的|最適な用途|
 |---|---|---|
@@ -351,7 +351,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### ユーティリティコマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#utility-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#utility-commands)
 
 |指示|目的|最適な用途|
 |---|---|---|
@@ -360,7 +360,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ### セッションコマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#session-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#session-commands)
 
 |指示|目的|最適な用途|
 |---|---|---|
@@ -373,7 +373,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ## コマンドインデックス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#command-index)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#command-index)
 
 **機能別:**
 
@@ -392,7 +392,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 ## トラブルシューティング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#troubleshooting)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#troubleshooting)
 
 **コマンドの問題:**
 
@@ -404,12 +404,12 @@ python3 -m SuperClaude install --list-components | grep mcp
 
 - セッションをリセット:`/sc:load`再初期化する
 - ステータスを確認:`SuperClaude install --list-components`
-- ヘルプ:[トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/troubleshooting.md)
+- ヘルプ:[トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/troubleshooting.md)
 
 ## 次のステップ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#next-steps)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#next-steps)
 
-- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md)- コマンドの動作を制御する
-- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md)- スペシャリストのアクティベーション
-- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)- 実際の使用パターン
+- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)- コマンドの動作を制御する
+- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md)- スペシャリストのアクティベーション
+- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md)- 実際の使用パターン

Docs/User-Guide-jp/flags.md

@@ -1,16 +1,16 @@
 # SuperClaude フラグガイド 🏁
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#superclaude-flags-guide-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#superclaude-flags-guide-)
 
 **ほとんどのフラグは自動的にアクティブになります**。Claude Code は、リクエスト内のキーワードとパターンに基づいて適切なコンテキストを実行するための動作指示を読み取ります。
 
 ## 必須の自動アクティベーションフラグ（ユースケースの90%）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#essential-auto-activation-flags-90-of-use-cases)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#essential-auto-activation-flags-90-of-use-cases)
 
 ### コア分析フラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#core-analysis-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#core-analysis-flags)
 
 |フラグ|起動時|何をするのか|
 |---|---|---|
@@ -20,7 +20,7 @@
 
 ### MCP サーバーフラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#mcp-server-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#mcp-server-flags)
 
 |フラグ|サーバ|目的|自動トリガー|
 |---|---|---|---|
@@ -33,7 +33,7 @@
 
 ### 動作モードフラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#behavioral-mode-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#behavioral-mode-flags)
 
 |フラグ|起動時|何をするのか|
 |---|---|---|
@@ -45,7 +45,7 @@
 
 ### 実行制御フラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#execution-control-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#execution-control-flags)
 
 |フラグ|起動時|何をするのか|
 |---|---|---|
@@ -56,11 +56,11 @@
 
 ## コマンド固有のフラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#command-specific-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#command-specific-flags)
 
 ### 分析コマンドフラグ（`/sc:analyze`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#analysis-command-flags-scanalyze)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#analysis-command-flags-scanalyze)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -70,7 +70,7 @@
 
 ### ビルドコマンドフラグ（`/sc:build`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#build-command-flags-scbuild)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#build-command-flags-scbuild)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -81,7 +81,7 @@
 
 ### 設計コマンドフラグ（`/sc:design`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#design-command-flags-scdesign)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#design-command-flags-scdesign)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -90,7 +90,7 @@
 
 ### コマンドフラグの説明（`/sc:explain`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#explain-command-flags-scexplain)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#explain-command-flags-scexplain)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -100,7 +100,7 @@
 
 ### コマンドフラグの改善（`/sc:improve`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#improve-command-flags-scimprove)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#improve-command-flags-scimprove)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -111,7 +111,7 @@
 
 ### タスクコマンドフラグ（`/sc:task`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#task-command-flags-sctask)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#task-command-flags-sctask)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -121,7 +121,7 @@
 
 ### ワークフローコマンドフラグ（`/sc:workflow`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#workflow-command-flags-scworkflow)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#workflow-command-flags-scworkflow)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -131,7 +131,7 @@
 
 ### コマンドフラグのトラブルシューティング ( `/sc:troubleshoot`)
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#troubleshoot-command-flags-sctroubleshoot)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#troubleshoot-command-flags-sctroubleshoot)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -141,7 +141,7 @@
 
 ### クリーンアップコマンドフラグ（`/sc:cleanup`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#cleanup-command-flags-sccleanup)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#cleanup-command-flags-sccleanup)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -152,7 +152,7 @@
 
 ### コマンドフラグの推定（`/sc:estimate`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#estimate-command-flags-scestimate)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#estimate-command-flags-scestimate)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -162,7 +162,7 @@
 
 ### インデックスコマンドフラグ（`/sc:index`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#index-command-flags-scindex)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#index-command-flags-scindex)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -171,7 +171,7 @@
 
 ### コマンドフラグを反映する ( `/sc:reflect`)
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#reflect-command-flags-screflect)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#reflect-command-flags-screflect)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -181,7 +181,7 @@
 
 ### スポーンコマンドフラグ（`/sc:spawn`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#spawn-command-flags-scspawn)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#spawn-command-flags-scspawn)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -190,7 +190,7 @@
 
 ### Gitコマンドフラグ（`/sc:git`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#git-command-flags-scgit)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#git-command-flags-scgit)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -199,7 +199,7 @@
 
 ### 選択ツールコマンドフラグ ( `/sc:select-tool`)
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#select-tool-command-flags-scselect-tool)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#select-tool-command-flags-scselect-tool)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -208,7 +208,7 @@
 
 ### テストコマンドフラグ（`/sc:test`）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#test-command-flags-sctest)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#test-command-flags-sctest)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -218,11 +218,11 @@
 
 ## 高度な制御フラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#advanced-control-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#advanced-control-flags)
 
 ### 範囲と焦点
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#scope-and-focus)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#scope-and-focus)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -231,7 +231,7 @@
 
 ### 実行制御
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#execution-control)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#execution-control)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -242,7 +242,7 @@
 
 ### システムフラグ（SuperClaude インストール）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#system-flags-superclaude-installation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#system-flags-superclaude-installation)
 
 |フラグ|目的|価値観|
 |---|---|---|
@@ -258,11 +258,11 @@
 
 ## 一般的な使用パターン
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#common-usage-patterns)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#common-usage-patterns)
 
 ### フロントエンド開発
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#frontend-development)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#frontend-development)
 
 ```shell
 /sc:implement "responsive dashboard" --magic --c7
@@ -273,7 +273,7 @@
 
 ### バックエンド開発
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#backend-development)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#backend-development)
 
 ```shell
 /sc:analyze api/ --focus performance --seq --think
@@ -284,7 +284,7 @@
 
 ### 大規模プロジェクト
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#large-projects)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#large-projects)
 
 ```shell
 /sc:analyze . --ultrathink --all-mcp --safe-mode
@@ -295,7 +295,7 @@
 
 ### 品質とメンテナンス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#quality--maintenance)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#quality--maintenance)
 
 ```shell
 /sc:improve src/ --type quality --safe --interactive
@@ -306,11 +306,11 @@
 
 ## フラグインタラクション
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#flag-interactions)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#flag-interactions)
 
 ### 互換性のある組み合わせ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#compatible-combinations)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#compatible-combinations)
 
 - `--think`+ `--c7`: ドキュメント付き分析
 - `--magic`+ `--play`: テスト付きのUI生成
@@ -320,7 +320,7 @@
 
 ### 競合するフラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#conflicting-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#conflicting-flags)
 
 - `--all-mcp`個別のMCPフラグと比較（どちらか一方を使用）
 - `--no-mcp`任意のMCPフラグと比較（--no-mcpが優先）
@@ -329,7 +329,7 @@
 
 ### 関係の自動有効化
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#auto-enabling-relationships)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#auto-enabling-relationships)
 
 - `--safe-mode`自動的`--uc`に有効になり、`--validate`
 - `--ultrathink`すべてのMCPサーバーを自動的に有効にする
@@ -338,11 +338,11 @@
 
 ## トラブルシューティングフラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#troubleshooting-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#troubleshooting-flags)
 
 ### よくある問題
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#common-issues)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#common-issues)
 
 - **ツールが多すぎる**:`--no-mcp`ネイティブツールのみでテストする
 - **操作が遅すぎます**:`--uc`出力を圧縮するために追加します
@@ -351,7 +351,7 @@
 
 ### デバッグフラグ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#debug-flags)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#debug-flags)
 
 ```shell
 /sc:analyze . --verbose                      # Shows decision logic and flag activation
@@ -361,7 +361,7 @@
 
 ### クイックフィックス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#quick-fixes)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#quick-fixes)
 
 ```shell
 /sc:analyze . --help                         # Shows available flags for command
@@ -371,7 +371,7 @@
 
 ## フラグの優先ルール
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#flag-priority-rules)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#flag-priority-rules)
 
 1. **安全第一**: `--safe-mode`> `--validate`> 最適化フラグ
 2. **明示的なオーバーライド**: ユーザーフラグ > 自動検出
@@ -381,8 +381,8 @@
 
 ## 関連リソース
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md#related-resources)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#related-resources)
 
-- [コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md)- これらのフラグを使用するコマンド
-- [MCP サーバーガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md)- MCP フラグのアクティブ化について
-- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)- 永続セッションでのフラグの使用
+- [コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)- これらのフラグを使用するコマンド
+- [MCP サーバーガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md)- MCP フラグのアクティブ化について
+- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)- 永続セッションでのフラグの使用

Docs/User-Guide-jp/mcp-servers.md

@@ -1,16 +1,16 @@
 # SuperClaude MCP サーバーガイド 🔌
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#superclaude-mcp-servers-guide-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#superclaude-mcp-servers-guide-)
 
 ## 概要
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#overview)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#overview)
 
 MCP（モデルコンテキストプロトコル）サーバーは、専用ツールを通じてClaude Codeの機能を拡張します。SuperClaudeは6つのMCPサーバーを統合し、タスクに応じてサーバーをいつ起動するかをClaudeに指示します。
 
 ### 🔍 現実チェック
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#-reality-check)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#-reality-check)
 
 - **MCPサーバーとは**: 追加ツールを提供する外部Node.jsプロセス
 - **含まれていないもの**：SuperClaude 機能が組み込まれている
@@ -28,9 +28,9 @@ MCP（モデルコンテキストプロトコル）サーバーは、専用ツ
 
 ## クイックスタート
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#quick-start)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#quick-start)
 
-**セットアップの確認**：MCPサーバーは自動的に起動します。インストールとトラブルシューティングについては、[「インストールガイド」](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/installation.md)と[「トラブルシューティング」](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/troubleshooting.md)を参照してください。
+**セットアップの確認**：MCPサーバーは自動的に起動します。インストールとトラブルシューティングについては、[「インストールガイド」](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/installation.md)と[「トラブルシューティング」](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/troubleshooting.md)を参照してください。
 
 **自動アクティベーションロジック:**
 
@@ -45,11 +45,11 @@ MCP（モデルコンテキストプロトコル）サーバーは、専用ツ
 
 ## サーバーの詳細
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#server-details)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#server-details)
 
 ### コンテキスト7 📚
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#context7-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#context7-)
 
 **目的**: 公式ライブラリドキュメントへのアクセス **トリガー**: インポートステートメント、フレームワークキーワード、ドキュメントリクエスト **要件**: Node.js 16+、APIキーなし
 
@@ -64,7 +64,7 @@ MCP（モデルコンテキストプロトコル）サーバーは、専用ツ
 
 ### 連続思考 🧠
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#sequential-thinking-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#sequential-thinking-)
 
 **目的**: 構造化された多段階の推論と体系的な分析 **トリガー**: 複雑なデバッグ、`--think`フラグ、アーキテクチャ分析 **要件**: Node.js 16+、APIキーなし
 
@@ -79,7 +79,7 @@ MCP（モデルコンテキストプロトコル）サーバーは、専用ツ
 
 ### 魔法✨
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#magic-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#magic-)
 
 **目的**: 21st.dev パターンからのモダン UI コンポーネント生成 **トリガー**: UI リクエスト、`/ui`コマンド、コンポーネント開発 **要件**: Node.js 16+、TWENTYFIRST_API_KEY()
 
@@ -94,7 +94,7 @@ export TWENTYFIRST_API_KEY="your_key_here"
 
 ### 劇作家🎭
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#playwright-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#playwright-)
 
 **目的**: 実際のブラウザ自動化とE2Eテスト **トリガー**: ブラウザテスト、E2Eシナリオ、視覚的検証 **要件**: Node.js 16以上、APIキーなし
 
@@ -109,7 +109,7 @@ export TWENTYFIRST_API_KEY="your_key_here"
 
 ### morphllm-fast-apply 🔄
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#morphllm-fast-apply-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#morphllm-fast-apply-)
 
 **目的**: 効率的なパターンベースのコード変換 **トリガー**: 複数ファイルの編集、リファクタリング、フレームワークの移行 **要件**: Node.js 16+、MORPH_API_KEY
 
@@ -124,7 +124,7 @@ export MORPH_API_KEY="your_key_here"
 
 ### セレナ🧭
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#serena-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#serena-)
 
 **目的**: プロジェクトメモリを使用したセマンティックコード理解 **トリガー**: シンボル操作、大規模コードベース、セッション管理 **要件**: Python 3.9+、UV パッケージマネージャー、API キーなし
 
@@ -139,7 +139,7 @@ export MORPH_API_KEY="your_key_here"
 
 ## 構成
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#configuration)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#configuration)
 
 **MCP 構成ファイル ( `~/.claude.json`):**
 
@@ -178,7 +178,7 @@ export MORPH_API_KEY="your_key_here"
 
 ## 使用パターン
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#usage-patterns)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#usage-patterns)
 
 **サーバー制御:**
 
@@ -207,7 +207,7 @@ export MORPH_API_KEY="your_key_here"
 
 ## トラブルシューティング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#troubleshooting)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#troubleshooting)
 
 **よくある問題:**
 
@@ -255,7 +255,7 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
 
 ## サーバーの組み合わせ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#server-combinations)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#server-combinations)
 
 **APIキーなし（無料）** :
 
@@ -278,7 +278,7 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
 
 ## 統合
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#integration)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#integration)
 
 **SuperClaude コマンドを使用する場合:**
 
@@ -300,20 +300,20 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
 
 ## 関連リソース
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md#related-resources)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#related-resources)
 
 **必読:**
 
-- [コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md)- MCPサーバーをアクティブ化するコマンド
-- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/quick-start.md)- MCP セットアップガイド
+- [コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)- MCPサーバーをアクティブ化するコマンド
+- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/quick-start.md)- MCP セットアップガイド
 
 **高度な使用法:**
 
-- [行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md)- モード-MCP調整
-- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md)- エージェントとMCPの統合
-- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)- Serena ワークフロー
+- [行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md)- モード-MCP調整
+- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md)- エージェントとMCPの統合
+- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)- Serena ワークフロー
 
 **技術リファレンス:**
 
-- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)- MCP ワークフローパターン
-- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/technical-architecture.md)- 統合の詳細
+- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md)- MCP ワークフローパターン
+- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/technical-architecture.md)- 統合の詳細

Docs/User-Guide-jp/modes.md

@@ -1,16 +1,16 @@
 # SuperClaude 行動モードガイド 🧠
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#superclaude-behavioral-modes-guide-)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#superclaude-behavioral-modes-guide-)
 
 ## ✅ クイック検証
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-quick-verification)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-quick-verification)
 
-コマンドを使用してモードをテストします`/sc:`。モードはタスクの複雑さに基づいて自動的にアクティブになります。コマンドの完全なリファレンスについては、[コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md)をご覧ください。
+コマンドを使用してモードをテストします`/sc:`。モードはタスクの複雑さに基づいて自動的にアクティブになります。コマンドの完全なリファレンスについては、[コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)をご覧ください。
 
 ## クイックリファレンステーブル
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#quick-reference-table)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#quick-reference-table)
 
 |モード|目的|自動トリガー|重要な行動|最適な用途|
 |---|---|---|---|---|
@@ -24,7 +24,7 @@
 
 ## はじめに（2分の概要）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#getting-started-2-minute-overview)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#getting-started-2-minute-overview)
 
 **モードは動作指示を通じてアクティブ化されます**- Claude Code はコンテキスト ファイルを読み取り、タスクのパターンと複雑さに基づいてどのモード動作を採用するかを決定します。
 
@@ -47,11 +47,11 @@
 
 ## モードの詳細
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-details)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-details)
 
 ### 🧠 ブレインストーミングモード - インタラクティブな発見
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-brainstorming-mode---interactive-discovery)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-brainstorming-mode---interactive-discovery)
 
 **目的**: 共同作業による発見を通じて、漠然としたアイデアを構造化された要件に変換します。
 
@@ -85,7 +85,7 @@ Brainstorming Approach:
 
 #### 成功基準
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#success-criteria)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#success-criteria)
 
 - [ ] すぐに解決策を提示するのではなく、質問で応答する
 - [ ] 質問はユーザーのニーズ、技術的制約、ビジネス目標を探ります
@@ -106,7 +106,7 @@ Brainstorming Approach:
 
 ### 🔍 内省モード - メタ認知分析
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-introspection-mode---meta-cognitive-analysis)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-introspection-mode---meta-cognitive-analysis)
 
 **目的**: 学習の最適化と透明な意思決定のための推論プロセスを公開します。
 
@@ -149,7 +149,7 @@ Introspective Approach:
 
 ### 📋 タスク管理モード - 複雑な調整
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-task-management-mode---complex-coordination)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-task-management-mode---complex-coordination)
 
 **目的**: 複数ステップの操作のためのセッション永続性を備えた階層的なタスク構成。
 
@@ -193,7 +193,7 @@ Task Management Approach:
 
 ### 🎯 オーケストレーションモード - インテリジェントなツール選択
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-orchestration-mode---intelligent-tool-selection)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-orchestration-mode---intelligent-tool-selection)
 
 **目的**: インテリジェントなツールルーティングと並列調整を通じてタスクの実行を最適化します。
 
@@ -235,7 +235,7 @@ Orchestration Approach:
 
 ### ⚡ トークン効率モード - 圧縮通信
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-token-efficiency-mode---compressed-communication)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-token-efficiency-mode---compressed-communication)
 
 **目的**: 情報の品質を維持しながら、シンボル システムを通じて推定 30 ～ 50% のトークン削減を実現します。
 
@@ -276,7 +276,7 @@ Token Efficient Approach:
 
 ### 🎨 標準モード - バランスのとれたデフォルト
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#-standard-mode---balanced-default)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-standard-mode---balanced-default)
 
 **目的**: 簡単な開発タスクに対して明確でプロフェッショナルなコミュニケーションを提供します。
 
@@ -319,11 +319,11 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ## 高度な使用法
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#advanced-usage)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#advanced-usage)
 
 ### モードの組み合わせ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-combinations)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-combinations)
 
 **マルチモードワークフロー:**
 
@@ -341,7 +341,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ### 手動モード制御
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#manual-mode-control)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#manual-mode-control)
 
 **特定の動作を強制する:**
 
@@ -366,7 +366,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ### モードの境界と優先順位
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-boundaries-and-priority)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-boundaries-and-priority)
 
 **モードがアクティブになると:**
 
@@ -387,11 +387,11 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ## 実世界の例
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#real-world-examples)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#real-world-examples)
 
 ### 完全なワークフローの例
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#complete-workflow-examples)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#complete-workflow-examples)
 
 **新規プロジェクト開発:**
 
@@ -430,7 +430,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ### モードの組み合わせパターン
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-combination-patterns)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-combination-patterns)
 
 **非常に複雑なシナリオ:**
 
@@ -447,11 +447,11 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ## クイックリファレンス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#quick-reference)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#quick-reference)
 
 ### モード起動パターン
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-activation-patterns)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-activation-patterns)
 
 |トリガータイプ|入力例|モードが有効|主要な動作|
 |---|---|---|---|
@@ -464,7 +464,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ### 手動オーバーライドコマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#manual-override-commands)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#manual-override-commands)
 
 ```shell
 # Force specific mode behaviors
@@ -483,26 +483,26 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ## トラブルシューティング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#troubleshooting)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#troubleshooting)
 
 トラブルシューティングのヘルプについては、以下を参照してください。
 
-- [よくある問題](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/common-issues.md)- よくある問題に対するクイック修正
-- [トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/troubleshooting.md)- 包括的な問題解決
+- [よくある問題](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/common-issues.md)- よくある問題に対するクイック修正
+- [トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/troubleshooting.md)- 包括的な問題解決
 
 ### よくある問題
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#common-issues)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#common-issues)
 
 - **モードがアクティブ化されていません**: 手動フラグを使用してください: `--brainstorm`、、`--introspect``--uc`
 - **間違ったモードがアクティブです**: リクエスト内の複雑なトリガーとキーワードを確認してください
 - **予期しないモード切り替え**：タスクの進行に基づく通常の動作
 - **実行への影響**: モードはツールの使用を最適化するものであり、実行には影響しないはずです。
-- **モードの競合**:[フラグガイドでフラグの優先順位ルールを確認してください](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md)
+- **モードの競合**:[フラグガイドでフラグの優先順位ルールを確認してください](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)
 
 ### 即時修正
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#immediate-fixes)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#immediate-fixes)
 
 - **特定のモードを強制**:`--brainstorm`またはのような明示的なフラグを使用する`--task-manage`
 - **リセットモードの動作**: モード状態をリセットするには、Claude Code セッションを再起動します。
@@ -511,7 +511,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ### モード固有のトラブルシューティング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#mode-specific-troubleshooting)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-specific-troubleshooting)
 
 **ブレインストーミングモードの問題:**
 
@@ -564,7 +564,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ### エラーコードリファレンス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#error-code-reference)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#error-code-reference)
 
 |モードエラー|意味|クイックフィックス|
 |---|---|---|
@@ -579,7 +579,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 
 ### プログレッシブサポートレベル
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#progressive-support-levels)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#progressive-support-levels)
 
 **レベル 1: クイックフィックス (< 2 分)**
 
@@ -596,7 +596,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 # Review request complexity and triggers
 ```
 
-- モードのインストールに関する問題については、[一般的な問題ガイドを](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/common-issues.md)参照してください。
+- モードのインストールに関する問題については、[一般的な問題ガイドを](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/common-issues.md)参照してください。
 
 **レベル3: 専門家によるサポート（30分以上）**
 
@@ -607,7 +607,7 @@ SuperClaude install --diagnose
 # Review behavioral triggers and thresholds
 ```
 
-- 行動モード分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/diagnostic-reference.md)を参照してください
+- 行動モード分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/diagnostic-reference.md)を参照してください
 
 **レベル4: コミュニティサポート**
 
@@ -617,7 +617,7 @@ SuperClaude install --diagnose
 
 ### 成功の検証
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#success-validation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#success-validation)
 
 モード修正を適用した後、次のようにテストします。
 
@@ -629,17 +629,17 @@ SuperClaude install --diagnose
 
 ## クイックトラブルシューティング（レガシー）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#quick-troubleshooting-legacy)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#quick-troubleshooting-legacy)
 
 - **モードがアクティブ化されない**→手動フラグを使用: `--brainstorm`、、`--introspect``--uc`
 - **間違ったモードがアクティブです**→ リクエスト内の複雑なトリガーとキーワードを確認してください
 - **予期せぬモード切り替え**→ タスクの進行に基づく通常の動作
 - **実行への影響**→ モードはツールの使用を最適化するものであり、実行には影響しないはずです
-- **モードの競合→**[フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md)でフラグの優先順位ルールを確認してください[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md)
+- **モードの競合→**[フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)でフラグの優先順位ルールを確認してください[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)
 
 ## よくある質問
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#frequently-asked-questions)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#frequently-asked-questions)
 
 **Q: どのモードがアクティブになっているかはどうすればわかりますか?** A: 通信パターンで次のインジケーターを確認してください。
 
@@ -674,7 +674,7 @@ SuperClaude install --diagnose
 
 ## まとめ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#summary)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#summary)
 
 SuperClaude の 5 つの行動モードは、ユーザーのニーズに自動的に適合する**インテリジェントな適応システムを作成します。**
 
@@ -691,36 +691,36 @@ SuperClaude の 5 つの行動モードは、ユーザーのニーズに自動
 
 ## 関連ガイド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/modes.md#related-guides)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#related-guides)
 
 **学習の進捗:**
 
 **🌱 エッセンシャル（第1週）**
 
-- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/quick-start.md)- モードの有効化例
-- [コマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md)- コマンドは自動的にモードをアクティブ化します
-- [インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/installation.md)- 動作モードの設定
+- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/quick-start.md)- モードの有効化例
+- [コマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)- コマンドは自動的にモードをアクティブ化します
+- [インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/installation.md)- 動作モードの設定
 
 **🌿中級（第2～3週）**
 
-- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/agents.md)- モードとスペシャリストの連携方法
-- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/flags.md)- 手動モードの制御と最適化
-- [例文集](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md)- モードパターンの実践
+- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md)- モードとスペシャリストの連携方法
+- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)- 手動モードの制御と最適化
+- [例文集](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md)- モードパターンの実践
 
 **🌲 上級（2ヶ月目以降）**
 
-- [MCP サーバー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md)- 拡張機能を備えたモード統合
-- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)- タスク管理モードのワークフロー
-- [はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/getting-started/quick-start.md)- モードの使用パターン
+- [MCP サーバー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md)- 拡張機能を備えたモード統合
+- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)- タスク管理モードのワークフロー
+- [はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/quick-start.md)- モードの使用パターン
 
 **🔧 エキスパート**
 
-- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/technical-architecture.md)- モード実装の詳細
-- [コードの貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/developer-guide/contributing-code.md)- モードの機能を拡張する
+- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/technical-architecture.md)- モード実装の詳細
+- [コードの貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/contributing-code.md)- モードの機能を拡張する
 
 **モード固有のガイド:**
 
-- **ブレインストーミング**：[要件発見パターン](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/reference/examples-cookbook.md#requirements)
-- **タスク管理**：[セッション管理ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md)
-- **オーケストレーション**: [MCP サーバー ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/mcp-servers.md)
-- **トークン効率**：[コマンドの基礎](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/commands.md#token-efficiency)
+- **ブレインストーミング**：[要件発見パターン](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md#requirements)
+- **タスク管理**：[セッション管理ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)
+- **オーケストレーション**: [MCP サーバー ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md)
+- **トークン効率**：[コマンドの基礎](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#token-efficiency)

Docs/User-Guide-jp/session-management.md

@@ -1,16 +1,16 @@
 # セッション管理ガイド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#session-management-guide)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#session-management-guide)
 
 SuperClaude は、Serena MCP サーバーを通じて永続的なセッション管理を提供し、Claude Code の会話全体にわたる真のコンテキスト保存と長期的なプロジェクト継続性を実現します。
 
 ## 永続メモリを使用したコアセッションコマンド
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#core-session-commands-with-persistent-memory)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#core-session-commands-with-persistent-memory)
 
 ### `/sc:load`- 永続メモリによるコンテキストの読み込み
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#scload---context-loading-with-persistent-memory)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#scload---context-loading-with-persistent-memory)
 
 **目的**: 以前のセッションからのプロジェクトコンテキストと永続メモリを使用してセッションを初期化します。MCP  
 **統合**: Serena MCP をトリガーして、保存されたプロジェクトメモリを読み取ります。  
@@ -38,7 +38,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### `/sc:save`- メモリへのセッションの永続性
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#scsave---session-persistence-to-memory)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#scsave---session-persistence-to-memory)
 
 **目的**: 現在のセッション状態と決定を永続メモリ  
 **MCP に保存します。統合**: Serena MCP をトリガーしてメモリ ファイルに書き込みます。  
@@ -66,7 +66,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### `/sc:reflect`- メモリコンテキストによる進捗状況の評価
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#screflect---progress-assessment-with-memory-context)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#screflect---progress-assessment-with-memory-context)
 
 **目的**: 保存されたメモリに対して現在の進行状況を分析し、セッションの完全性を検証する  
 **MCP 統合**: Serena MCP を使用して、保存されたメモリと現在の状態を比較する  
@@ -94,11 +94,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ## 永続メモリアーキテクチャ
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#persistent-memory-architecture)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#persistent-memory-architecture)
 
 ### Serena MCP が真の永続性を実現する方法
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#how-serena-mcp-enables-true-persistence)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#how-serena-mcp-enables-true-persistence)
 
 **メモリストレージ**:
 
@@ -123,11 +123,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ## 永続性を備えたセッションライフサイクルパターン
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#session-lifecycle-patterns-with-persistence)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#session-lifecycle-patterns-with-persistence)
 
 ### 新しいプロジェクトの初期化
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#new-project-initialization)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#new-project-initialization)
 
 ```shell
 # 1. Start fresh project
@@ -145,7 +145,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### 既存の作業の再開（クロス会話）
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#resuming-existing-work-cross-conversation)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#resuming-existing-work-cross-conversation)
 
 ```shell
 # 1. Load previous context from persistent memory
@@ -163,7 +163,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### 長期プロジェクト管理
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#long-term-project-management)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#long-term-project-management)
 
 ```shell
 # Weekly checkpoint pattern with persistence
@@ -180,11 +180,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ## クロス会話の継続性
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#cross-conversation-continuity)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#cross-conversation-continuity)
 
 ### 粘り強く新しい会話を始める
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#starting-new-conversations-with-persistence)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#starting-new-conversations-with-persistence)
 
 新しい Claude Code 会話を開始すると、永続メモリ システムによって次のことが可能になります。
 
@@ -208,7 +208,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### メモリ最適化
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#memory-optimization)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#memory-optimization)
 
 **有効なメモリ使用量**:
 
@@ -233,11 +233,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ## 永続セッションのベストプラクティス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#best-practices-for-persistent-sessions)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#best-practices-for-persistent-sessions)
 
 ### セッション開始プロトコル
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#session-start-protocol)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#session-start-protocol)
 
 1. `/sc:load`既存のプロジェクトの場合は常に
 2. `/sc:reflect`記憶から現在の状態を理解するために使用する
@@ -246,7 +246,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### セッション終了プロトコル
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#session-end-protocol)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#session-end-protocol)
 
 1. `/sc:reflect`保存された目標に対する完全性を評価するために使用します
 2. 重要な決定を`/sc:save`将来のセッションのために保存する
@@ -255,7 +255,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### 記憶品質の維持
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#memory-quality-maintenance)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#memory-quality-maintenance)
 
 - 簡単に思い出せるように、分かりやすく説明的なメモリ名を使用する
 - 決定事項と代替アプローチに関する背景情報を含める
@@ -264,11 +264,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ## 他のSuperClaude機能との統合
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#integration-with-other-superclaude-features)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#integration-with-other-superclaude-features)
 
 ### MCP サーバー調整
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#mcp-server-coordination)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#mcp-server-coordination)
 
 - **Serena MCP** : 永続メモリインフラストラクチャを提供します
 - **シーケンシャルMCP** : 保存されたメモリを使用して複雑な分析を強化します
@@ -277,7 +277,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### エージェントとメモリの連携
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#agent-collaboration-with-memory)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#agent-collaboration-with-memory)
 
 - エージェントは強化されたコンテキストのために永続的なメモリにアクセスします
 - 以前の専門家の決定は保存され、参照されます
@@ -286,7 +286,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### 永続性を備えたコマンド統合
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#command-integration-with-persistence)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#command-integration-with-persistence)
 
 - すべての`/sc:`コマンドは永続的なコンテキストを参照し、そのコンテキストに基づいて構築できます。
 - 以前のコマンド出力と決定はセッション間で利用可能
@@ -295,11 +295,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ## 永続セッションのトラブルシューティング
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#troubleshooting-persistent-sessions)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#troubleshooting-persistent-sessions)
 
 ### よくある問題
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#common-issues)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#common-issues)
 
 **メモリが読み込まれません**:
 
@@ -324,7 +324,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### クイックフィックス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#quick-fixes)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#quick-fixes)
 
 **セッション状態をリセット**:
 
@@ -349,11 +349,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ## 高度な永続セッションパターン
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#advanced-persistent-session-patterns)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#advanced-persistent-session-patterns)
 
 ### 複数フェーズのプロジェクト
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#multi-phase-projects)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#multi-phase-projects)
 
 - 整理のためにフェーズ固有のメモリ命名を使用する
 - フェーズ全体でアーキテクチャ上の決定の継続性を維持する
@@ -362,7 +362,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### チームコラボレーション
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#team-collaboration)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#team-collaboration)
 
 - 共有メモリの規則と命名規則
 - チームのコンテキストにおける意思決定根拠の保存
@@ -371,7 +371,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### 長期メンテナンス
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#long-term-maintenance)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#long-term-maintenance)
 
 - 完了したプロジェクトのメモリアーカイブ戦略
 - 蓄積された記憶によるパターンライブラリの開発
@@ -380,11 +380,11 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ## 永続セッション管理の主な利点
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#key-benefits-of-persistent-session-management)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#key-benefits-of-persistent-session-management)
 
 ### プロジェクトの継続性
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#project-continuity)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#project-continuity)
 
 - 複数の会話にわたるシームレスな作業継続
 - Claude Codeセッション間でコンテキストが失われることはありません
@@ -393,7 +393,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### 生産性の向上
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#enhanced-productivity)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#enhanced-productivity)
 
 - プロジェクトのコンテキストを再度説明する必要性が減少
 - 起動時間が速く、作業を継続できる
@@ -402,7 +402,7 @@ SuperClaude は、Serena MCP サーバーを通じて永続的なセッション
 
 ### 品質の一貫性
 
-[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/docs/user-guide/session-management.md#quality-consistency)
+[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#quality-consistency)
 
 - セッション間で一貫したアーキテクチャパターン
 - コード品質の決定と標準の保持

Docs/User-Guide-zh/agents.md

@@ -35,7 +35,7 @@ SuperClaude 提供了 14 个领域专业智能体，Claude Code 可以调用它
 ## 核心概念
 
 ### 什么是 SuperClaude 智能体？
-**智能体**是专业的 AI 领域专家，以上下文指令的形式实现，用于修改 Claude Code 的行为。每个智能体都是 `superclaude/Agents/` 目录中精心制作的 `.md` 文件，包含领域特定的专业知识、行为模式和问题解决方法。
+**智能体**是专业的 AI 领域专家，以上下文指令的形式实现，用于修改 Claude Code 的行为。每个智能体都是 `SuperClaude/Agents/` 目录中精心制作的 `.md` 文件，包含领域特定的专业知识、行为模式和问题解决方法。
 
 **重要提示**：智能体不是独立的 AI 模型或软件 - 它们是 Claude Code 读取的上下文配置，用于采用专门的行为。
 
@@ -494,8 +494,8 @@ Task Analysis →
 ## 故障排除
 
 获取故障排除帮助，请参阅：
-- [常见问题](../reference/common-issues.md) - 常见问题的快速修复
-- [故障排除指南](../reference/troubleshooting.md) - 综合问题解决
+- [常见问题](../Reference/common-issues.md) - 常见问题的快速修复
+- [故障排除指南](../Reference/troubleshooting.md) - 综合问题解决
 
 ### 常见问题
 - **无智能体激活**: 使用领域关键词："security"、"performance"、"frontend"
@@ -556,12 +556,12 @@ Task Analysis →
 - 聚焦在单一领域以避免混淆
 
 **详细帮助：**
-- 查看[常见问题指南](../reference/common-issues.md)了解智能体安装问题
+- 查看[常见问题指南](../Reference/common-issues.md)了解智能体安装问题
 - 查看目标智能体的触发关键词
 
 **专家支持：**
 - 使用 `SuperClaude install --diagnose`
-- 查看[诊断参考指南](../reference/diagnostic-reference.md)进行协调分析
+- 查看[诊断参考指南](../Reference/diagnostic-reference.md)进行协调分析
 
 **社区支持：**
 - 在 [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) 报告问题
@@ -793,12 +793,12 @@ Task Analysis →
 
 ### 高级用法
 - **[行为模式](modes.md)** - 用于增强智能体协调的上下文优化
-- **[入门指南](../getting-started/quick-start.md)** - 智能体优化的专家技巧
-- **[示例食谱](../reference/examples-cookbook.md)** - 实际的智能体协调模式
+- **[入门指南](../Getting-Started/quick-start.md)** - 智能体优化的专家技巧
+- **[示例食谱](../Reference/examples-cookbook.md)** - 实际的智能体协调模式
 
 ### 开发资源
-- **[技术架构](../developer-guide/technical-architecture.md)** - 理解 SuperClaude 的智能体系统设计
-- **[贡献指南](../developer-guide/contributing-code.md)** - 扩展智能体能力和协调模式
+- **[技术架构](../Developer-Guide/technical-architecture.md)** - 理解 SuperClaude 的智能体系统设计
+- **[贡献指南](../Developer-Guide/contributing-code.md)** - 扩展智能体能力和协调模式
 
 ---
 

Docs/User-Guide-zh/commands.md

@@ -38,7 +38,7 @@ SuperClaude 提供行为上下文文件，Claude Code 通过读取这些文件
 
 ### 上下文机制：
 1. **用户输入**：您输入 `/sc:implement "auth system"`
-2. **上下文加载**：Claude Code 读取 `~/.claude/superclaude/Commands/implement.md`
+2. **上下文加载**：Claude Code 读取 `~/.claude/SuperClaude/Commands/implement.md`
 3. **行为采用**：Claude 运用专业知识进行工具选择和验证
 4. **增强输出**：带有安全考虑和最佳实践的结构化实现
 
@@ -67,7 +67,7 @@ SuperClaude 提供行为上下文文件，Claude Code 通过读取这些文件
 ```bash
 # 验证 SuperClaude 是否正常工作（主要方法）
 python3 -m SuperClaude --version
-# 示例输出：SuperClaude 4.1.5
+# 示例输出：SuperClaude 4.1.4
 
 # Claude Code CLI 版本检查
 claude --version
@@ -88,7 +88,7 @@ python3 -m SuperClaude install --list-components | grep mcp
 # 示例行为：显示可用命令列表
 ```
 
-**如果测试失败**：检查 [安装指南](../getting-started/installation.md) 或 [故障排除](#troubleshooting)
+**如果测试失败**：检查 [安装指南](../Getting-Started/installation.md) 或 [故障排除](#troubleshooting)
 
 ### 📝 Command Quick Reference
 
@@ -296,10 +296,10 @@ python3 -m SuperClaude install --list-components | grep mcp
 **快速修复：**
 - 重置会话: `/sc:load` 重新初始化
 - 检查状态: `SuperClaude install --list-components`
-- 获取帮助: [故障排除指南](../reference/troubleshooting.md)
+- 获取帮助: [故障排除指南](../Reference/troubleshooting.md)
 
 ## 下一步
 
 - [标志指南](flags.md) - 控制命令行为
 - [智能体指南](agents.md) - 专家激活
-- [示例手册](../reference/examples-cookbook.md) - 真实使用模式
+- [示例手册](../Reference/examples-cookbook.md) - 真实使用模式

Docs/User-Guide-zh/mcp-servers.md

@@ -20,7 +20,7 @@ MCP（模型上下文协议）服务器通过专业工具扩展 Claude Code 的
 
 ## 快速开始
 
-**设置验证**：MCP 服务器会自动激活。有关安装和故障排除，请参阅 [安装指南](../getting-started/installation.md) 和 [故障排除](../reference/troubleshooting.md)。
+**设置验证**：MCP 服务器会自动激活。有关安装和故障排除，请参阅 [安装指南](../Getting-Started/installation.md) 和 [故障排除](../Reference/troubleshooting.md)。
 
 **自动激活逻辑：**
 
@@ -260,7 +260,7 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
 
 **必读资料：**
 - [命令指南](commands.md) - 激活 MCP 服务器的命令
-- [快速开始指南](../getting-started/quick-start.md) - MCP 设置指南
+- [快速开始指南](../Getting-Started/quick-start.md) - MCP 设置指南
 
 **高级使用：**
 - [行为模式](modes.md) - 模式-MCP 协调
@@ -268,5 +268,5 @@ echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
 - [会话管理](session-management.md) - Serena 工作流
 
 **技术参考：**
-- [示例手册](../reference/examples-cookbook.md) - MCP 工作流模式
-- [技术架构](../developer-guide/technical-architecture.md) - 集成详情
+- [示例手册](../Reference/examples-cookbook.md) - MCP 工作流模式
+- [技术架构](../Developer-Guide/technical-architecture.md) - 集成详情

Docs/User-Guide-zh/modes.md

@@ -404,8 +404,8 @@ Standard Approach: Consistent, professional baseline for all tasks
 ## 故障排除
 
 有关故障排除帮助，请参阅：
-- [常见问题](../reference/common-issues.md) - 频繁问题的快速修复
-- [故障排除指南](../reference/troubleshooting.md) - 全面的问题解决方案
+- [常见问题](../Reference/common-issues.md) - 频繁问题的快速修复
+- [故障排除指南](../Reference/troubleshooting.md) - 全面的问题解决方案
 
 ### 常见问题
 - **模式未激活**：使用手动标志：`--brainstorm`、`--introspect`、`--uc`
@@ -493,7 +493,7 @@ Standard Approach: Consistent, professional baseline for all tasks
 /sc:reflect --type mode-status            # 检查当前模式状态
 # 检查请求复杂性和触发器
 ```
-- 有关模式安装问题，请参阅[常见问题指南](../reference/common-issues.md)
+- 有关模式安装问题，请参阅[常见问题指南](../Reference/common-issues.md)
 
 **级别 3：专家支持（30+ 分钟）**
 ```bash
@@ -502,7 +502,7 @@ SuperClaude install --diagnose
 # 检查模式激活模式
 # 检查行为触发器和阈值
 ```
-- 有关行为模式分析，请参阅[诊断参考指南](../reference/diagnostic-reference.md)
+- 有关行为模式分析，请参阅[诊断参考指南](../Reference/diagnostic-reference.md)
 
 **级别 4：社区支持**
 - 在 [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues) 报告模式问题
@@ -578,26 +578,26 @@ SuperClaude 的 5 种行为模式创建了一个**智能适应系统**，自动
 **学习进展：**
 
 **🌱 基础（第1周）**
-- [快速开始指南](../getting-started/quick-start.md) - 模式激活示例
+- [快速开始指南](../Getting-Started/quick-start.md) - 模式激活示例
 - [命令参考](commands.md) - 命令自动激活模式
-- [安装指南](../getting-started/installation.md) - 设置行为模式
+- [安装指南](../Getting-Started/installation.md) - 设置行为模式
 
 **🌿 中级（第2-3周）**
 - [智能体指南](agents.md) - 模式如何与专家协调
 - [标志指南](flags.md) - 手动模式控制和优化
-- [示例手册](../reference/examples-cookbook.md) - 实践中的模式模式
+- [示例手册](../Reference/examples-cookbook.md) - 实践中的模式模式
 
 **🌲 高级（第2+个月）**
 - [MCP 服务器](mcp-servers.md) - 模式与增强能力的集成
 - [会话管理](session-management.md) - 任务管理模式工作流
-- [入门指南](../getting-started/quick-start.md) - 模式使用模式
+- [入门指南](../Getting-Started/quick-start.md) - 模式使用模式
 
 **🔧 专家级**
-- [技术架构](../developer-guide/technical-architecture.md) - 模式实现细节
-- [代码贡献](../developer-guide/contributing-code.md) - 扩展模式能力
+- [技术架构](../Developer-Guide/technical-architecture.md) - 模式实现细节
+- [代码贡献](../Developer-Guide/contributing-code.md) - 扩展模式能力
 
 **特定模式指南：**
-- **头脑风暴**：[需求发现模式](../reference/examples-cookbook.md#requirements)
+- **头脑风暴**：[需求发现模式](../Reference/examples-cookbook.md#requirements)
 - **任务管理**：[会话管理指南](session-management.md)
 - **编排**：[MCP 服务器指南](mcp-servers.md)
 - **令牌效率**：[命令基础](commands.md#token-efficiency)

Docs/User-Guide/agents.md

@@ -1,6 +1,6 @@
 # SuperClaude Agents Guide 🤖
 
-SuperClaude provides 16 domain specialist agents that Claude Code can invoke for specialized expertise.
+SuperClaude provides 14 domain specialist agents that Claude Code can invoke for specialized expertise.
 
 
 ## 🧪 Testing Agent Activation
@@ -35,7 +35,7 @@ Before using this guide, verify agent selection works:
 ## Core Concepts
 
 ### What are SuperClaude Agents?
-**Agents** are specialized AI domain experts implemented as context instructions that modify Claude Code's behavior. Each agent is a carefully crafted `.md` file in the `superclaude/Agents/` directory containing domain-specific expertise, behavioral patterns, and problem-solving approaches.
+**Agents** are specialized AI domain experts implemented as context instructions that modify Claude Code's behavior. Each agent is a carefully crafted `.md` file in the `SuperClaude/Agents/` directory containing domain-specific expertise, behavioral patterns, and problem-solving approaches.
 
 **Important**: Agents are NOT separate AI models or software - they are context configurations that Claude Code reads to adopt specialized behaviors.
 
@@ -137,78 +137,6 @@ Task Analysis →
 
 ## The SuperClaude Agent Team 👥
 
-### Meta-Layer Agent 🎯
-
-### pm-agent 📚
-**Expertise**: Self-improvement workflow executor that documents implementations, analyzes mistakes, and maintains knowledge base continuously
-
-**Auto-Activation**:
-- **Post-Implementation**: After any task completion requiring documentation
-- **Mistake Detection**: Immediate analysis when errors or bugs occur
-- **Monthly Maintenance**: Regular documentation health reviews
-- **Knowledge Gap**: When patterns emerge requiring documentation
-- Commands: Automatically activates after `/sc:implement`, `/sc:build`, `/sc:improve` completions
-
-**Capabilities**:
-- **Implementation Documentation**: Record new patterns, architectural decisions, edge cases discovered
-- **Mistake Analysis**: Root cause analysis, prevention checklists, pattern identification
-- **Pattern Recognition**: Extract success patterns, anti-patterns, best practices
-- **Knowledge Maintenance**: Monthly reviews, noise reduction, duplication merging, freshness updates
-- **Self-Improvement Loop**: Transform every experience into reusable knowledge
-
-**How PM Agent Works** (Meta-Layer):
-1. **Specialist Agents Complete Task**: Backend-architect implements feature
-2. **PM Agent Auto-Activates**: After implementation completion
-3. **Documentation**: Records patterns, decisions, edge cases in docs/
-4. **Knowledge Update**: Updates CLAUDE.md if global pattern discovered
-5. **Evidence Collection**: Links test results, screenshots, metrics
-6. **Learning Integration**: Extracts lessons for future implementations
-
-**Self-Improvement Workflow Examples**:
-1. **Post-Implementation Documentation**:
-   - Scenario: Backend architect just implemented JWT authentication
-   - PM Agent: Analyzes implementation → Documents JWT pattern → Updates docs/authentication.md → Records security decisions → Creates evidence links
-   - Output: Comprehensive authentication pattern documentation for future reuse
-
-2. **Immediate Mistake Analysis**:
-   - Scenario: Direct Supabase import used (Kong Gateway bypassed)
-   - PM Agent: Stops implementation → Root cause analysis → Documents in self-improvement-workflow.md → Creates prevention checklist → Updates CLAUDE.md
-   - Output: Mistake recorded with prevention strategy, won't repeat error
-
-3. **Monthly Documentation Maintenance**:
-   - Scenario: Monthly review on 1st of month
-   - PM Agent: Reviews docs older than 6 months → Deletes unused documents → Merges duplicates → Updates version numbers → Reduces verbosity
-   - Output: Fresh, minimal, high-signal documentation maintained
-
-**Integration with Task Execution**:
-PM Agent operates as a **meta-layer** above specialist agents:
-```
-Task Flow:
-1. User Request → Auto-activation selects specialist agent
-2. Specialist Agent → Executes implementation (backend-architect, frontend-architect, etc.)
-3. PM Agent (Auto-triggered) → Documents learnings
-4. Knowledge Base → Updated with patterns, mistakes, improvements
-```
-
-**Works Best With**: All agents (documents their work, not replaces them)
-
-**Quality Standards**:
-- **Latest**: Last Verified dates on all documents
-- **Minimal**: Necessary information only, no verbosity
-- **Clear**: Concrete examples and copy-paste ready code
-- **Practical**: Immediately applicable to real work
-
-**Self-Improvement Loop Phases**:
-- **AFTER Phase**: Primary responsibility - document implementations, update docs/, create evidence
-- **MISTAKE RECOVERY**: Immediate stop, root cause analysis, documentation update
-- **MAINTENANCE**: Monthly pruning, merging, freshness updates, noise reduction
-
-**Verify**: Activates automatically after task completions requiring documentation
-**Test**: Should document patterns after backend-architect implements features
-**Check**: Should create prevention checklists when mistakes detected
-
----
-
 ### Architecture & System Design Agents 🏗️
 
 ### system-architect 🏢
@@ -315,48 +243,6 @@ Task Flow:
 
 **Works Best With**: system-architect (infrastructure planning), security-engineer (compliance), performance-engineer (monitoring)
 
----
-
-### deep-research-agent 🔬
-**Expertise**: Comprehensive research with adaptive strategies and multi-hop reasoning
-
-**Auto-Activation**:
-- Keywords: "research", "investigate", "discover", "explore", "find out", "search for", "latest", "current"
-- Commands: `/sc:research` automatically activates this agent
-- Context: Complex queries requiring thorough research, current information needs, fact-checking
-- Complexity: Questions spanning multiple domains or requiring iterative exploration
-
-**Capabilities**:
-- **Adaptive Planning Strategies**: Planning (direct), Intent (clarify first), Unified (collaborative)
-- **Multi-Hop Reasoning**: Up to 5 levels - entity expansion, temporal progression, conceptual deepening, causal chains
-- **Self-Reflective Mechanisms**: Progress assessment after each major step with replanning triggers
-- **Evidence Management**: Clear citations, relevance scoring, uncertainty acknowledgment
-- **Tool Orchestration**: Parallel-first execution with Tavily (search), Playwright (JavaScript content), Sequential (reasoning)
-- **Learning Integration**: Pattern recognition and strategy reuse via Serena memory
-
-**Research Depth Levels**:
-- **Quick**: Basic search, 1 hop, summary output
-- **Standard**: Extended search, 2-3 hops, structured report (default)
-- **Deep**: Comprehensive search, 3-4 hops, detailed analysis
-- **Exhaustive**: Maximum depth, 5 hops, complete investigation
-
-**Examples**:
-1. **Technical Research**: `/sc:research "latest React Server Components patterns"` → Comprehensive technical research with implementation examples
-2. **Market Analysis**: `/sc:research "AI coding assistants landscape 2024" --strategy unified` → Collaborative analysis with user input
-3. **Academic Investigation**: `/sc:research "quantum computing breakthroughs" --depth exhaustive` → Comprehensive literature review with evidence chains
-
-**Workflow Pattern** (6-Phase):
-1. **Understand** (5-10%): Assess query complexity
-2. **Plan** (10-15%): Select strategy and identify parallel opportunities  
-3. **TodoWrite** (5%): Create adaptive task hierarchy (3-15 tasks)
-4. **Execute** (50-60%): Parallel searches and extractions
-5. **Track** (Continuous): Monitor progress and confidence
-6. **Validate** (10-15%): Verify evidence chains
-
-**Output**: Reports saved to `docs/research/[topic]_[timestamp].md`
-
-**Works Best With**: system-architect (technical research), learning-guide (educational research), requirements-analyst (market research)
-
 ### Quality & Analysis Agents 🔍
 
 ### security-engineer 🔒
@@ -609,8 +495,8 @@ Task Flow:
 ## Troubleshooting
 
 For troubleshooting help, see:
-- [Common Issues](../reference/common-issues.md) - Quick fixes for frequent problems
-- [Troubleshooting Guide](../reference/troubleshooting.md) - Comprehensive problem resolution
+- [Common Issues](../Reference/common-issues.md) - Quick fixes for frequent problems
+- [Troubleshooting Guide](../Reference/troubleshooting.md) - Comprehensive problem resolution
 
 ### Common Issues
 - **No agent activation**: Use domain keywords: "security", "performance", "frontend"
@@ -671,12 +557,12 @@ For troubleshooting help, see:
 - Focus on single domain to avoid confusion
 
 **Detailed Help:**
-- See [Common Issues Guide](../reference/common-issues.md) for agent installation problems
+- See [Common Issues Guide](../Reference/common-issues.md) for agent installation problems
 - Review trigger keywords for target agents
 
 **Expert Support:**  
 - Use `SuperClaude install --diagnose`
-- See [Diagnostic Reference Guide](../reference/diagnostic-reference.md) for coordination analysis
+- See [Diagnostic Reference Guide](../Reference/diagnostic-reference.md) for coordination analysis
 
 **Community Support:**
 - Report issues at [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)
@@ -732,7 +618,6 @@ After applying agent fixes, test with:
 | **Documentation** | "documentation", "readme", "API docs" | technical-writer |
 | **Learning** | "explain", "tutorial", "beginner", "teaching" | learning-guide |
 | **Requirements** | "requirements", "PRD", "specification" | requirements-analyst |
-| **Research** | "research", "investigate", "latest", "current" | deep-research-agent |
 
 ### Command-Agent Mapping
 
@@ -746,7 +631,6 @@ After applying agent fixes, test with:
 | `/sc:design` | system-architect | Domain architects, requirements-analyst |
 | `/sc:test` | quality-engineer | security-engineer, performance-engineer |
 | `/sc:explain` | learning-guide | technical-writer, domain specialists |
-| `/sc:research` | deep-research-agent | Technical specialists, learning-guide |
 
 ### Effective Agent Combinations
 
@@ -910,12 +794,12 @@ Add "documented", "explained", or "tutorial" to requests for automatic technical
 
 ### Advanced Usage  
 - **[Behavioral Modes](modes.md)** - Context optimization for enhanced agent coordination
-- **[Getting Started](../getting-started/quick-start.md)** - Expert techniques for agent optimization
-- **[Examples Cookbook](../reference/examples-cookbook.md)** - Real-world agent coordination patterns
+- **[Getting Started](../Getting-Started/quick-start.md)** - Expert techniques for agent optimization
+- **[Examples Cookbook](../Reference/examples-cookbook.md)** - Real-world agent coordination patterns
 
 ### Development Resources
-- **[Technical Architecture](../developer-guide/technical-architecture.md)** - Understanding SuperClaude's agent system design
-- **[Contributing](../developer-guide/contributing-code.md)** - Extending agent capabilities and coordination patterns
+- **[Technical Architecture](../Developer-Guide/technical-architecture.md)** - Understanding SuperClaude's agent system design
+- **[Contributing](../Developer-Guide/contributing-code.md)** - Extending agent capabilities and coordination patterns
 
 ---
 

Docs/User-Guide/commands.md

@@ -0,0 +1,348 @@
+# SuperClaude Commands Guide
+
+SuperClaude provides 24 commands for Claude Code: `/sc:*` commands for workflows and `@agent-*` for specialists.
+
+## Command Types
+
+| Type | Where Used | Format | Example |
+|------|------------|--------|---------|
+| **Slash Commands** | Claude Code | `/sc:[command]` | `/sc:implement "feature"` |
+| **Agents** | Claude Code | `@agent-[name]` | `@agent-security "review"` |
+| **Installation** | Terminal | `SuperClaude [command]` | `SuperClaude install` |
+
+## Quick Test
+```bash
+# Terminal: Verify installation
+python3 -m SuperClaude --version
+# Claude Code CLI verification: claude --version
+
+# Claude Code: Test commands
+/sc:brainstorm "test project"    # Should ask discovery questions
+/sc:analyze README.md           # Should provide analysis
+```
+
+**Workflow**: `/sc:brainstorm "idea"` → `/sc:implement "feature"` → `/sc:test`
+
+## 🎯 Understanding SuperClaude Commands
+
+## How SuperClaude Works
+
+SuperClaude provides behavioral context files that Claude Code reads to adopt specialized behaviors. When you type `/sc:implement`, Claude Code reads the `implement.md` context file and follows its behavioral instructions.
+
+**SuperClaude commands are NOT executed by software** - they are context triggers that modify Claude Code's behavior through reading specialized instruction files from the framework.
+
+### Command Types:
+- **Slash Commands** (`/sc:*`): Trigger workflow patterns and behavioral modes
+- **Agent Invocations** (`@agent-*`): Manually activate specific domain specialists
+- **Flags** (`--think`, `--safe-mode`): Modify command behavior and depth
+
+### The Context Mechanism:
+1. **User Input**: You type `/sc:implement "auth system"`
+2. **Context Loading**: Claude Code reads `~/.claude/SuperClaude/Commands/implement.md`
+3. **Behavior Adoption**: Claude applies domain expertise, tool selection, and validation patterns
+4. **Enhanced Output**: Structured implementation with security considerations and best practices
+
+**Key Point**: This creates sophisticated development workflows through context management rather than traditional software execution.
+
+### Installation vs Usage Commands
+
+**🖥️ Terminal Commands** (Actual CLI software):
+- `SuperClaude install` - Installs the framework components
+- `SuperClaude update` - Updates existing installation  
+- `SuperClaude uninstall` - Removes framework installation
+- `python3 -m SuperClaude --version` - Check installation status
+
+**💬 Claude Code Commands** (Context triggers):
+- `/sc:brainstorm` - Activates requirements discovery context
+- `/sc:implement` - Activates feature development context
+- `@agent-security` - Activates security specialist context
+- All commands work inside Claude Code chat interface only
+
+
+> **Quick Start**: Try `/sc:brainstorm "your project idea"` → `/sc:implement "feature name"` → `/sc:test` to experience the core workflow.
+
+## 🧪 Testing Your Setup
+
+### 🖥️ Terminal Verification (Run in Terminal/CMD)
+```bash
+# Verify SuperClaude is working (primary method)
+python3 -m SuperClaude --version
+# Example output: SuperClaude 4.1.4
+
+# Claude Code CLI version check
+claude --version
+
+# Check installed components
+python3 -m SuperClaude install --list-components | grep mcp
+# Example output: Shows installed MCP components
+```
+
+### 💬 Claude Code Testing (Type in Claude Code Chat)
+```
+# Test basic /sc: command
+/sc:brainstorm "test project"
+# Example behavior: Interactive requirements discovery starts
+
+# Test command help
+/sc:help
+# Example behavior: List of available commands
+```
+
+**If tests fail**: Check [Installation Guide](../Getting-Started/installation.md) or [Troubleshooting](#troubleshooting)
+
+### 📝 Command Quick Reference
+
+| Command Type | Where to Run | Format | Purpose | Example |
+|-------------|--------------|--------|---------|----------|
+| **🖥️ Installation** | Terminal/CMD | `SuperClaude [command]` | Setup and maintenance | `SuperClaude install` |
+| **🔧 Configuration** | Terminal/CMD | `python3 -m SuperClaude [command]` | Advanced configuration | `python3 -m SuperClaude --version` |
+| **💬 Slash Commands** | Claude Code | `/sc:[command]` | Workflow automation | `/sc:implement "feature"` |
+| **🤖 Agent Invocation** | Claude Code | `@agent-[name]` | Manual specialist activation | `@agent-security "review"` |
+| **⚡ Enhanced Flags** | Claude Code | `/sc:[command] --flags` | Behavior modification | `/sc:analyze --think-hard` |
+
+> **Remember**: All `/sc:` commands and `@agent-` invocations work inside Claude Code chat, not your terminal. They trigger Claude Code to read specific context files from the SuperClaude framework.
+
+## Table of Contents
+
+- [Essential Commands](#essential-commands) - Start here (8 core commands)
+- [Common Workflows](#common-workflows) - Command combinations that work
+- [Full Command Reference](#full-command-reference) - All 23 commands organized by category
+- [Troubleshooting](#troubleshooting) - Common issues and solutions
+- [Command Index](#command-index) - Find commands by category
+
+---
+
+## Essential Commands
+
+**Core workflow commands for immediate productivity:**
+
+### `/sc:brainstorm` - Project Discovery
+**Purpose**: Interactive requirements discovery and project planning  
+**Syntax**: `/sc:brainstorm "your idea"` `[--strategy systematic|creative]`  
+
+**Use Cases**: 
+- New project planning: `/sc:brainstorm "e-commerce platform"`
+- Feature exploration: `/sc:brainstorm "user authentication system"`  
+- Problem solving: `/sc:brainstorm "slow database queries"`
+
+### `/sc:help` - Command Reference
+**Purpose**: Displays a list of all available `/sc` commands and their descriptions.
+**Syntax**: `/sc:help`
+
+**Use Cases**:
+- Discovering available commands: `/sc:help`
+- Getting a quick reminder of command names: `/sc:help`
+
+### `/sc:implement` - Feature Development  
+**Purpose**: Full-stack feature implementation with intelligent specialist routing  
+**Syntax**: `/sc:implement "feature description"` `[--type frontend|backend|fullstack] [--focus security|performance]`  
+
+**Use Cases**:
+- Authentication: `/sc:implement "JWT login system"`
+- UI components: `/sc:implement "responsive dashboard"`
+- APIs: `/sc:implement "REST user endpoints"`
+- Database: `/sc:implement "user schema with relationships"`
+
+### `/sc:analyze` - Code Assessment
+**Purpose**: Comprehensive code analysis across quality, security, and performance  
+**Syntax**: `/sc:analyze [path]` `[--focus quality|security|performance|architecture]`
+
+**Use Cases**:
+- Project health: `/sc:analyze .`
+- Security audit: `/sc:analyze --focus security`
+- Performance review: `/sc:analyze --focus performance`
+
+### `/sc:business-panel` - Strategic Business Analysis
+**Purpose**: Multi-expert business strategy analysis with 9 renowned thought leaders  
+**Syntax**: `/sc:business-panel "content"` `[--mode discussion|debate|socratic] [--experts "name1,name2"]`
+
+**Use Cases**:
+- Strategy evaluation: `/sc:business-panel "our go-to-market strategy"`
+- Competitive analysis: `/sc:business-panel @competitor_analysis.pdf --mode debate`
+- Innovation assessment: `/sc:business-panel "AI product idea" --experts "christensen,drucker"`
+- Strategic learning: `/sc:business-panel "competitive strategy" --mode socratic`
+
+**Expert Panel**: Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont
+
+### `/sc:spec-panel` - Expert Specification Review
+**Purpose**: Multi-expert specification review and improvement using renowned specification and software engineering experts  
+**Syntax**: `/sc:spec-panel [content|@file]` `[--mode discussion|critique|socratic] [--focus requirements|architecture|testing|compliance]`
+
+**Use Cases**:
+- Specification review: `/sc:spec-panel @api_spec.yml --mode critique --focus requirements,architecture`
+- Requirements workshop: `/sc:spec-panel "user story content" --mode discussion`
+- Architecture validation: `/sc:spec-panel @microservice.spec.yml --mode socratic --focus architecture`
+- Compliance review: `/sc:spec-panel @security_requirements.yml --focus compliance`
+- Iterative improvement: `/sc:spec-panel @complex_system.spec.yml --iterations 3`
+
+**Expert Panel**: Wiegers, Adzic, Cockburn, Fowler, Nygard, Newman, Hohpe, Crispin, Gregory, Hightower
+
+### `/sc:troubleshoot` - Problem Diagnosis
+**Purpose**: Systematic issue diagnosis with root cause analysis  
+**Syntax**: `/sc:troubleshoot "issue description"` `[--type build|runtime|performance]`
+
+**Use Cases**:
+- Runtime errors: `/sc:troubleshoot "500 error on login"`
+- Build failures: `/sc:troubleshoot --type build`
+- Performance problems: `/sc:troubleshoot "slow page load"`
+
+### `/sc:test` - Quality Assurance
+**Purpose**: Comprehensive testing with coverage analysis  
+**Syntax**: `/sc:test` `[--type unit|integration|e2e] [--coverage] [--fix]`
+
+**Use Cases**:
+- Full test suite: `/sc:test --coverage`
+- Unit testing: `/sc:test --type unit --watch`
+- E2E validation: `/sc:test --type e2e`
+
+### `/sc:improve` - Code Enhancement  
+**Purpose**: Apply systematic code improvements and optimizations  
+**Syntax**: `/sc:improve [path]` `[--type performance|quality|security] [--preview]`
+
+**Use Cases**:
+- General improvements: `/sc:improve src/`
+- Performance optimization: `/sc:improve --type performance`
+- Security hardening: `/sc:improve --type security`
+
+### `/sc:document` - Documentation Generation
+**Purpose**: Generate comprehensive documentation for code and APIs  
+**Syntax**: `/sc:document [path]` `[--type api|user-guide|technical] [--format markdown|html]`
+
+**Use Cases**:
+- API docs: `/sc:document --type api`
+- User guides: `/sc:document --type user-guide`
+- Technical docs: `/sc:document --type technical`
+
+### `/sc:workflow` - Implementation Planning
+**Purpose**: Generate structured implementation plans from requirements  
+**Syntax**: `/sc:workflow "feature description"` `[--strategy agile|waterfall] [--format markdown]`
+
+**Use Cases**:
+- Feature planning: `/sc:workflow "user authentication"`
+- Sprint planning: `/sc:workflow --strategy agile`
+- Architecture planning: `/sc:workflow "microservices migration"`
+
+---
+
+## Common Workflows
+
+**Proven command combinations:**
+
+### New Project Setup
+```bash
+/sc:brainstorm "project concept"      # Define requirements
+/sc:design "system architecture"      # Create technical design  
+/sc:workflow "implementation plan"    # Generate development roadmap
+```
+
+### Feature Development
+```bash
+/sc:implement "feature name"          # Build the feature
+/sc:test --coverage                   # Validate with tests
+/sc:document --type api               # Generate documentation  
+```
+
+### Code Quality Improvement
+```bash
+/sc:analyze --focus quality           # Assess current state
+/sc:improve --preview                 # Preview improvements
+/sc:test --coverage                   # Validate changes
+```
+
+### Bug Investigation
+```bash
+/sc:troubleshoot "issue description"  # Diagnose the problem
+/sc:analyze --focus problem-area      # Deep analysis
+/sc:improve --fix --safe-mode         # Apply targeted fixes
+```
+
+### Specification Development
+```bash
+/sc:spec-panel @existing_spec.yml --mode critique  # Expert review
+/sc:spec-panel @improved_spec.yml --iterations 2    # Iterative refinement
+/sc:document --type technical                        # Generate documentation
+```
+
+## Full Command Reference
+
+### Development Commands
+| Command | Purpose | Best For |
+|---------|---------|----------|
+| **workflow** | Implementation planning | Project roadmaps, sprint planning |
+| **implement** | Feature development | Full-stack features, API development |
+| **build** | Project compilation | CI/CD, production builds |
+| **design** | System architecture | API specs, database schemas |
+
+### Analysis Commands  
+| Command | Purpose | Best For |
+|---------|---------|----------|
+| **analyze** | Code assessment | Quality audits, security reviews |
+| **business-panel** | Strategic analysis | Business decisions, competitive assessment |
+| **spec-panel** | Specification review | Requirements validation, architecture analysis |
+| **troubleshoot** | Problem diagnosis | Bug investigation, performance issues |
+| **explain** | Code explanation | Learning, code reviews |
+
+### Quality Commands
+| Command | Purpose | Best For |
+|---------|---------|----------|
+| **improve** | Code enhancement | Performance optimization, refactoring |
+| **cleanup** | Technical debt | Dead code removal, organization |
+| **test** | Quality assurance | Test automation, coverage analysis |
+| **document** | Documentation | API docs, user guides |
+
+### Project Management
+| Command | Purpose | Best For |
+|---------|---------|----------|
+| **estimate** | Project estimation | Timeline planning, resource allocation |
+| **task** | Task management | Complex workflows, task tracking |
+| **spawn** | Meta-orchestration | Large-scale projects, parallel execution |
+
+### Utility Commands
+| Command | Purpose | Best For |
+|---------|---------|----------|
+| **help** | List all commands | Discovering available commands |
+| **git** | Version control | Commit management, branch strategies |
+| **index** | Command discovery | Exploring capabilities, finding commands |
+
+### Session Commands  
+| Command | Purpose | Best For |
+|---------|---------|----------|
+| **load** | Context loading | Session initialization, project onboarding |
+| **save** | Session persistence | Checkpointing, context preservation |
+| **reflect** | Task validation | Progress assessment, completion validation |
+| **select-tool** | Tool optimization | Performance optimization, tool selection |
+
+---
+
+## Command Index
+
+**By Function:**
+- **Planning**: brainstorm, design, workflow, estimate
+- **Development**: implement, build, git
+- **Analysis**: analyze, business-panel, spec-panel, troubleshoot, explain  
+- **Quality**: improve, cleanup, test, document
+- **Management**: task, spawn, load, save, reflect
+- **Utility**: help, index, select-tool
+
+**By Complexity:**
+- **Beginner**: brainstorm, implement, analyze, test, help
+- **Intermediate**: workflow, design, business-panel, spec-panel, improve, document  
+- **Advanced**: spawn, task, select-tool, reflect
+
+## Troubleshooting
+
+**Command Issues:**
+- **Command not found**: Verify installation: `python3 -m SuperClaude --version`
+- **No response**: Restart Claude Code session
+- **Processing delays**: Use `--no-mcp` to test without MCP servers
+
+**Quick Fixes:**
+- Reset session: `/sc:load` to reinitialize
+- Check status: `SuperClaude install --list-components`
+- Get help: [Troubleshooting Guide](../Reference/troubleshooting.md)
+
+## Next Steps
+
+- [Flags Guide](flags.md) - Control command behavior
+- [Agents Guide](agents.md) - Specialist activation
+- [Examples Cookbook](../Reference/examples-cookbook.md) - Real usage patterns

Docs/User-Guide/flags.md

@@ -18,8 +18,6 @@
 | `--seq` / `--sequential` | Sequential | Multi-step reasoning, debugging | Complex debugging, system design |
 | `--magic` | Magic | UI component generation | `/ui` commands, frontend keywords |
 | `--play` / `--playwright` | Playwright | Browser testing, E2E validation | Testing requests, visual validation |
-| `--chrome` / `--devtools` | Chrome DevTools | Performance analysis, debugging | Performance auditing, debugging, layout issues |
-| `--tavily` | Tavily | Web search, real-time info | Web search requests, research queries |
 | `--morph` / `--morphllm` | Morphllm | Bulk transformations, pattern edits | Bulk operations, style enforcement |
 | `--serena` | Serena | Project memory, symbol operations | Symbol operations, large codebases |
 
@@ -167,7 +165,6 @@
 | `--iterations [n]` | Improvement cycles | 1-10 |
 | `--all-mcp` | Enable all MCP servers | Boolean |
 | `--no-mcp` | Native tools only | Boolean |
-| `--frontend-verify` | UI testing, frontend debugging, layout validation | Enable Playwright + Chrome DevTools + Serena |
 
 ### System Flags (SuperClaude Installation)
 | Flag | Purpose | Values |

Docs/User-Guide/mcp-servers.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-MCP (Model Context Protocol) servers extend Claude Code's capabilities through specialized tools. SuperClaude integrates 8 MCP servers and provides Claude with instructions on when to activate them based on your tasks.
+MCP (Model Context Protocol) servers extend Claude Code's capabilities through specialized tools. SuperClaude integrates 6 MCP servers and provides Claude with instructions on when to activate them based on your tasks.
 
 ### 🔍 Reality Check
 - **What MCP servers are**: External Node.js processes that provide additional tools
@@ -17,12 +17,10 @@ MCP (Model Context Protocol) servers extend Claude Code's capabilities through s
 - **playwright**: Browser automation and E2E testing
 - **morphllm-fast-apply**: Pattern-based code transformations
 - **serena**: Semantic code understanding and project memory
-- **tavily**: Web search and real-time information retrieval
-- **chrome-devtools**: Performance analysis and debugging
 
 ## Quick Start
 
-**Setup Verification**: MCP servers activate automatically. For installation and troubleshooting, see [Installation Guide](../getting-started/installation.md) and [Troubleshooting](../reference/troubleshooting.md).
+**Setup Verification**: MCP servers activate automatically. For installation and troubleshooting, see [Installation Guide](../Getting-Started/installation.md) and [Troubleshooting](../Reference/troubleshooting.md).
 
 **Auto-Activation Logic:**
 
@@ -34,8 +32,6 @@ MCP (Model Context Protocol) servers extend Claude Code's capabilities through s
 | `test`, `e2e`, `browser` | **playwright** |
 | Multi-file edits, refactoring | **morphllm-fast-apply** |
 | Large projects, sessions | **serena** |
-| `/sc:research`, `latest`, `current` | **tavily** |
-| `performance`, `debug`, `LCP` | **chrome-devtools** |
 
 ## Server Details
 
@@ -123,90 +119,6 @@ export MORPH_API_KEY="your_key_here"
 /sc:refactor "extract UserService" --serena
 ```
 
-### tavily 🔍
-**Purpose**: Web search and real-time information retrieval for research
-**Triggers**: `/sc:research` commands, "latest" information requests, current events, fact-checking
-**Requirements**: Node.js 16+, TAVILY_API_KEY (free tier available at https://app.tavily.com)
-
-```bash
-# Automatic activation
-/sc:research "latest AI developments 2024"
-# → Performs intelligent web research
-
-# Manual activation  
-/sc:analyze "market trends" --tavily
-
-# API key setup (get free key at https://app.tavily.com)
-export TAVILY_API_KEY="tvly-your_api_key_here"
-```
-
-### chrome-devtools 📊
-**Purpose**: Performance analysis, debugging, and real-time browser inspection
-**Triggers**: Performance auditing, debugging layout issues (e.g., CLS), slow loading times (LCP), console errors, network requests
-**Requirements**: Node.js 16+, no API key
-
-```bash
-# Automatic activation
-/sc:debug "page is loading slowly"
-# → Enables performance analysis with Chrome DevTools
-
-# Manual activation
-/sc:analyze --performance "homepage"
-```
-
-**Capabilities:**
-- **Web Search**: Comprehensive searches with ranking and filtering
-- **News Search**: Time-filtered current events and updates
-- **Content Extraction**: Full-text extraction from search results  
-- **Domain Filtering**: Include/exclude specific domains
-- **Multi-Hop Research**: Iterative searches based on findings (up to 5 hops)
-
-**Research Depth Control:**
-- `--depth quick`: 5-10 sources, basic synthesis
-- `--depth standard`: 10-20 sources, structured report (default)
-- `--depth deep`: 20-40 sources, comprehensive analysis
-- `--depth exhaustive`: 40+ sources, academic-level research
-
-## Unified MCP Gateway (Alternative Setup)
-
-For users who want a simpler, unified setup that manages all MCP servers through a single endpoint, **AIRIS MCP Gateway** provides:
-
-- **50 tools** from 7 default servers (airis-agent, context7, fetch, memory, sequential-thinking, serena, tavily)
-- **Single SSE endpoint** instead of 8+ separate stdio connections
-- **Lazy loading** - servers start only when needed, auto-terminate when idle
-
-### Setup
-
-```bash
-# 1. Clone and start
-git clone https://github.com/agiletec-inc/airis-mcp-gateway.git
-cd airis-mcp-gateway
-docker compose up -d
-
-# 2. Register with Claude Code
-claude mcp add --scope user --transport sse airis-mcp-gateway http://localhost:9400/sse
-```
-
-### Verify
-
-```bash
-curl http://localhost:9400/health
-curl http://localhost:9400/api/tools/combined | jq '.tools_count'
-```
-
-### Configuration
-
-Edit `mcp-config.json` to enable/disable servers, then restart:
-```bash
-docker compose restart api
-```
-
-### More Information
-
-- **Repository**: [github.com/agiletec-inc/airis-mcp-gateway](https://github.com/agiletec-inc/airis-mcp-gateway)
-
----
-
 ## Configuration
 
 **MCP Configuration File (`~/.claude.json`):**
@@ -238,15 +150,6 @@ docker compose restart api
     "serena": {
       "command": "uvx",
       "args": ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "ide-assistant"]
-    },
-    "tavily": {
-      "command": "npx",
-      "args": ["-y", "tavily-mcp@latest"],
-      "env": {"TAVILY_API_KEY": "${TAVILY_API_KEY}"}
-    },
-    "chrome-devtools": {
-      "command": "npx",
-      "args": ["-y", "chrome-devtools-mcp@latest"]
     }
   }
 }
@@ -308,21 +211,16 @@ export TWENTYFIRST_API_KEY="your_key_here"
 # For Morphllm server (required for bulk transformations)
 export MORPH_API_KEY="your_key_here"
 
-# For Tavily server (required for web search - free tier available)
-export TAVILY_API_KEY="tvly-your_key_here"
-
 # Add to shell profile for persistence
 echo 'export TWENTYFIRST_API_KEY="your_key"' >> ~/.bashrc
 echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
-echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
 ```
 
 **Environment Variable Usage:**
 - ✅ `TWENTYFIRST_API_KEY` - Required for Magic MCP server functionality
 - ✅ `MORPH_API_KEY` - Required for Morphllm MCP server functionality  
-- ✅ `TAVILY_API_KEY` - Required for Tavily MCP server functionality (free tier available)
 - ❌ Other env vars in docs - Examples only, not used by framework
-- 📝 Magic and Morphllm are paid services, Tavily has free tier, framework works without them
+- 📝 Both are paid service API keys, framework works without them
 
 ## Server Combinations
 
@@ -340,9 +238,6 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
 - **Web Development**: magic + context7 + playwright  
 - **Enterprise Refactoring**: serena + morphllm + sequential-thinking
 - **Complex Analysis**: sequential-thinking + context7 + serena
-- **Deep Research**: tavily + sequential-thinking + serena + playwright
-- **Current Events**: tavily + context7 + sequential-thinking
-- **Performance Tuning**: chrome-devtools + sequential-thinking + playwright
 
 ## Integration
 
@@ -350,13 +245,11 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
 - Analysis commands automatically use Sequential + Serena
 - Implementation commands use Magic + Context7
 - Testing commands use Playwright + Sequential
-- Research commands use Tavily + Sequential + Playwright
 
 **With Behavioral Modes:**
 - Brainstorming Mode: Sequential for discovery
 - Task Management: Serena for persistence
 - Orchestration Mode: Optimal server selection
-- Deep Research Mode: Tavily + Sequential + Playwright coordination
 
 **Performance Control:**
 - Automatic resource management based on system load
@@ -367,7 +260,7 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
 
 **Essential Reading:**
 - [Commands Guide](commands.md) - Commands that activate MCP servers
-- [Quick Start Guide](../getting-started/quick-start.md) - MCP setup guide
+- [Quick Start Guide](../Getting-Started/quick-start.md) - MCP setup guide
 
 **Advanced Usage:**
 - [Behavioral Modes](modes.md) - Mode-MCP coordination
@@ -375,5 +268,5 @@ echo 'export TAVILY_API_KEY="your_key"' >> ~/.bashrc
 - [Session Management](session-management.md) - Serena workflows
 
 **Technical References:**
-- [Examples Cookbook](../reference/examples-cookbook.md) - MCP workflow patterns
-- [Technical Architecture](../developer-guide/technical-architecture.md) - Integration details
+- [Examples Cookbook](../Reference/examples-cookbook.md) - MCP workflow patterns
+- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Integration details

Docs/User-Guide/modes.md

@@ -9,7 +9,6 @@ Test modes by using `/sc:` commands - they activate automatically based on task
 |------|---------|---------------|---------------|---------------|
 | **🧠 Brainstorming** | Interactive discovery | "brainstorm", "maybe", vague requests | Socratic questions, requirement elicitation | New project planning, unclear requirements |
 | **🔍 Introspection** | Meta-cognitive analysis | Error recovery, "analyze reasoning" | Transparent thinking markers (🤔, 🎯, 💡) | Debugging, learning, optimization |
-| **🔬 Deep Research** | Systematic investigation mindset | `/sc:research`, investigation keywords | 6-phase workflow, evidence-based reasoning | Technical research, current events, market analysis |
 | **📋 Task Management** | Complex coordination | >3 steps, >2 directories | Phase breakdown, memory persistence | Multi-step operations, project management |
 | **🎯 Orchestration** | Intelligent tool selection | Multi-tool ops, high resource usage | Optimal tool routing, parallel execution | Complex analysis, performance optimization |
 | **⚡ Token Efficiency** | Compressed communication | High context usage, `--uc` flag | Symbol systems, estimated 30-50% token reduction | Resource constraints, large operations |
@@ -121,60 +120,6 @@ Introspective Approach:
 
 ---
 
-### 🔬 Deep Research Mode - Systematic Investigation Mindset
-
-**Purpose**: Research mindset for systematic investigation and evidence-based reasoning.
-
-**Auto-Activation Triggers:**
-- `/sc:research` command invocation
-- Research-related keywords: investigate, explore, discover, analyze
-- Questions requiring current information beyond knowledge cutoff
-- Complex research requirements
-- Manual flag: `--research`
-
-**Behavioral Modifications:**
-- **Thinking Style**: Systematic over casual, evidence over assumption, progressive depth exploration
-- **Communication**: Lead with confidence levels, provide inline citations, acknowledge uncertainties
-- **Priority Shifts**: Completeness over speed, accuracy over speculation, verification over assumption
-- **Process Adaptations**: Always create investigation plans, default to parallel operations, maintain evidence chains
-
-**6-Phase Research Workflow:**
-- 📋 **Understand** (5-10%): Assess query complexity and requirements
-- 📝 **Plan** (10-15%): Select strategy (planning/intent/unified) and identify parallelization
-- ✅ **TodoWrite** (5%): Create adaptive task hierarchy (3-15 tasks based on complexity)
-- 🔄 **Execute** (50-60%): Parallel-first searches and smart extraction routing
-- 📊 **Track** (Continuous): Monitor progress and update confidence scores
-- ✓ **Validate** (10-15%): Verify evidence chains and ensure completeness
-
-**Example Experience:**
-```
-Standard Mode: "Here are some search results about quantum computing..."
-Deep Research Mode: 
-"📊 Research Plan: Quantum computing breakthroughs
- ✓ TodoWrite: Created 8 research tasks
- 🔄 Executing parallel searches across domains
- 📈 Confidence: 0.82 across 15 verified sources
- 📝 Report saved: docs/research/research_quantum_[timestamp].md"
-```
-
-#### Quality Standards
-- [ ] Minimum 2 sources per claim with inline citations
-- [ ] Confidence scoring (0.0-1.0) for all findings
-- [ ] Parallel execution by default for independent operations
-- [ ] Reports saved to docs/research/ with proper structure
-- [ ] Clear methodology and evidence presentation
-
-**Verify:** `/sc:research "test topic"` should create TodoWrite and execute systematically
-**Test:** All research should include confidence scores and citations
-**Check:** Reports should be saved to docs/research/ automatically
-
-**Works Best With:**
-- **→ Task Management**: Research planning with TodoWrite integration
-- **→ Orchestration**: Parallel Tavily/Playwright coordination
-- **Manual Override**: Use `--depth` and `--strategy` for fine control
-
----
-
 ### 📋 Task Management Mode - Complex Coordination
 
 **Purpose**: Hierarchical task organization with session persistence for multi-step operations.
@@ -460,8 +405,8 @@ Standard Approach: Consistent, professional baseline for all tasks
 ## Troubleshooting
 
 For troubleshooting help, see:
-- [Common Issues](../reference/common-issues.md) - Quick fixes for frequent problems
-- [Troubleshooting Guide](../reference/troubleshooting.md) - Comprehensive problem resolution
+- [Common Issues](../Reference/common-issues.md) - Quick fixes for frequent problems
+- [Troubleshooting Guide](../Reference/troubleshooting.md) - Comprehensive problem resolution
 
 ### Common Issues
 - **Mode not activating**: Use manual flags: `--brainstorm`, `--introspect`, `--uc`
@@ -549,7 +494,7 @@ For troubleshooting help, see:
 /sc:reflect --type mode-status            # Check current mode state
 # Review request complexity and triggers
 ```
-- See [Common Issues Guide](../reference/common-issues.md) for mode installation problems
+- See [Common Issues Guide](../Reference/common-issues.md) for mode installation problems
 
 **Level 3: Expert Support (30+ min)**
 ```bash
@@ -558,7 +503,7 @@ SuperClaude install --diagnose
 # Check mode activation patterns
 # Review behavioral triggers and thresholds
 ```
-- See [Diagnostic Reference Guide](../reference/diagnostic-reference.md) for behavioral mode analysis
+- See [Diagnostic Reference Guide](../Reference/diagnostic-reference.md) for behavioral mode analysis
 
 **Level 4: Community Support**
 - Report mode issues at [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)
@@ -634,26 +579,26 @@ SuperClaude's 5 behavioral modes create an **intelligent adaptation system** tha
 **Learning Progression:**
 
 **🌱 Essential (Week 1)**
-- [Quick Start Guide](../getting-started/quick-start.md) - Mode activation examples
+- [Quick Start Guide](../Getting-Started/quick-start.md) - Mode activation examples
 - [Commands Reference](commands.md) - Commands automatically activate modes
-- [Installation Guide](../getting-started/installation.md) - Set up behavioral modes
+- [Installation Guide](../Getting-Started/installation.md) - Set up behavioral modes
 
 **🌿 Intermediate (Week 2-3)**  
 - [Agents Guide](agents.md) - How modes coordinate with specialists
 - [Flags Guide](flags.md) - Manual mode control and optimization
-- [Examples Cookbook](../reference/examples-cookbook.md) - Mode patterns in practice
+- [Examples Cookbook](../Reference/examples-cookbook.md) - Mode patterns in practice
 
 **🌲 Advanced (Month 2+)**
 - [MCP Servers](mcp-servers.md) - Mode integration with enhanced capabilities
 - [Session Management](session-management.md) - Task Management mode workflows  
-- [Getting Started](../getting-started/quick-start.md) - Mode usage patterns
+- [Getting Started](../Getting-Started/quick-start.md) - Mode usage patterns
 
 **🔧 Expert**
-- [Technical Architecture](../developer-guide/technical-architecture.md) - Mode implementation details
-- [Contributing Code](../developer-guide/contributing-code.md) - Extend mode capabilities
+- [Technical Architecture](../Developer-Guide/technical-architecture.md) - Mode implementation details
+- [Contributing Code](../Developer-Guide/contributing-code.md) - Extend mode capabilities
 
 **Mode-Specific Guides:**
-- **Brainstorming**: [Requirements Discovery Patterns](../reference/examples-cookbook.md#requirements)
+- **Brainstorming**: [Requirements Discovery Patterns](../Reference/examples-cookbook.md#requirements)
 - **Task Management**: [Session Management Guide](session-management.md)
 - **Orchestration**: [MCP Servers Guide](mcp-servers.md)
 - **Token Efficiency**: [Command Fundamentals](commands.md#token-efficiency)

KNOWLEDGE.md

@@ -1,644 +0,0 @@
-# KNOWLEDGE.md
-
-**Accumulated Insights, Best Practices, and Troubleshooting for SuperClaude Framework**
-
-> This document captures lessons learned, common pitfalls, and solutions discovered during development.
-> Consult this when encountering issues or learning project patterns.
-
-**Last Updated**: 2025-11-12
-
----
-
-## 🧠 **Core Insights**
-
-### **PM Agent ROI: 25-250x Token Savings**
-
-**Finding**: Pre-execution confidence checking has exceptional ROI.
-
-**Evidence**:
-- Spending 100-200 tokens on confidence check saves 5,000-50,000 tokens on wrong-direction work
-- Real example: Checking for duplicate implementations before coding (2min research) vs implementing duplicate feature (2hr work)
-
-**When it works best**:
-- Unclear requirements → Ask questions first
-- New codebase → Search for existing patterns
-- Complex features → Verify architecture compliance
-- Bug fixes → Identify root cause before coding
-
-**When to skip**:
-- Trivial changes (typo fixes)
-- Well-understood tasks with clear path
-- Emergency hotfixes (but document learnings after)
-
----
-
-### **Hallucination Detection: 94% Accuracy**
-
-**Finding**: The Four Questions catch most AI hallucinations.
-
-**The Four Questions**:
-1. Are all tests passing? → REQUIRE actual output
-2. Are all requirements met? → LIST each requirement
-3. No assumptions without verification? → SHOW documentation
-4. Is there evidence? → PROVIDE test results, code changes, validation
-
-**Red flags that indicate hallucination**:
-- "Tests pass" (without showing output) 🚩
-- "Everything works" (without evidence) 🚩
-- "Implementation complete" (with failing tests) 🚩
-- Skipping error messages 🚩
-- Ignoring warnings 🚩
-- "Probably works" language 🚩
-
-**Real example**:
-```
-❌ BAD: "The API integration is complete and working correctly."
-✅ GOOD: "The API integration is complete. Test output:
-         ✅ test_api_connection: PASSED
-         ✅ test_api_authentication: PASSED
-         ✅ test_api_data_fetch: PASSED
-         All 3 tests passed in 1.2s"
-```
-
----
-
-### **Parallel Execution: 3.5x Speedup**
-
-**Finding**: Wave → Checkpoint → Wave pattern dramatically improves performance.
-
-**Pattern**:
-```python
-# Wave 1: Independent reads (parallel)
-files = [Read(f1), Read(f2), Read(f3)]
-
-# Checkpoint: Analyze together (sequential)
-analysis = analyze_files(files)
-
-# Wave 2: Independent edits (parallel)
-edits = [Edit(f1), Edit(f2), Edit(f3)]
-```
-
-**When to use**:
-- ✅ Reading multiple independent files
-- ✅ Editing multiple unrelated files
-- ✅ Running multiple independent searches
-- ✅ Parallel test execution
-
-**When NOT to use**:
-- ❌ Operations with dependencies (file2 needs data from file1)
-- ❌ Sequential analysis (building context step-by-step)
-- ❌ Operations that modify shared state
-
-**Performance data**:
-- Sequential: 10 file reads = 10 API calls = ~30 seconds
-- Parallel: 10 file reads = 1 API call = ~3 seconds
-- Speedup: 3.5x average, up to 10x for large batches
-
----
-
-## 🛠️ **Common Pitfalls and Solutions**
-
-### **Pitfall 1: Implementing Before Checking for Duplicates**
-
-**Problem**: Spent hours implementing feature that already exists in codebase.
-
-**Solution**: ALWAYS use Glob/Grep before implementing:
-```bash
-# Search for similar functions
-uv run python -c "from pathlib import Path; print([f for f in Path('src').rglob('*.py') if 'feature_name' in f.read_text()])"
-
-# Or use grep
-grep -r "def feature_name" src/
-```
-
-**Prevention**: Run confidence check, ensure duplicate_check_complete=True
-
----
-
-### **Pitfall 2: Assuming Architecture Without Verification**
-
-**Problem**: Implemented custom API when project uses Supabase.
-
-**Solution**: READ CLAUDE.md and PLANNING.md before implementing:
-```python
-# Check project tech stack
-with open('CLAUDE.md') as f:
-    claude_md = f.read()
-
-if 'Supabase' in claude_md:
-    # Use Supabase APIs, not custom implementation
-```
-
-**Prevention**: Run confidence check, ensure architecture_check_complete=True
-
----
-
-### **Pitfall 3: Skipping Test Output**
-
-**Problem**: Claimed tests passed but they were actually failing.
-
-**Solution**: ALWAYS show actual test output:
-```bash
-# Run tests and capture output
-uv run pytest -v > test_output.txt
-
-# Show in validation
-echo "Test Results:"
-cat test_output.txt
-```
-
-**Prevention**: Use SelfCheckProtocol, require evidence
-
----
-
-### **Pitfall 4: Version Inconsistency**
-
-**Problem**: VERSION file says 4.1.9, but package.json says 4.1.5, pyproject.toml says 0.4.0.
-
-**Solution**: Understand versioning strategy:
-- **Framework version** (VERSION file): User-facing version (4.1.9)
-- **Python package** (pyproject.toml): Library semantic version (0.4.0)
-- **NPM package** (package.json): Should match framework version (4.1.9)
-
-**When updating versions**:
-1. Update VERSION file first
-2. Update package.json to match
-3. Update README badges
-4. Consider if pyproject.toml needs bump (breaking changes?)
-5. Update CHANGELOG.md
-
-**Prevention**: Create release checklist
-
----
-
-### **Pitfall 5: UV Not Installed**
-
-**Problem**: Makefile requires `uv` but users don't have it.
-
-**Solution**: Install UV:
-```bash
-# macOS/Linux
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
-# Windows
-powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
-
-# With pip
-pip install uv
-```
-
-**Alternative**: Provide fallback commands:
-```bash
-# With UV (preferred)
-uv run pytest
-
-# Without UV (fallback)
-python -m pytest
-```
-
-**Prevention**: Document UV requirement in README
-
----
-
-## 📚 **Best Practices**
-
-### **Testing Best Practices**
-
-**1. Use pytest markers for organization**:
-```python
-@pytest.mark.unit
-def test_individual_function():
-    pass
-
-@pytest.mark.integration
-def test_component_interaction():
-    pass
-
-@pytest.mark.confidence_check
-def test_with_pre_check(confidence_checker):
-    pass
-```
-
-**2. Use fixtures for shared setup**:
-```python
-# conftest.py
-@pytest.fixture
-def sample_context():
-    return {...}
-
-# test_file.py
-def test_feature(sample_context):
-    # Use sample_context
-```
-
-**3. Test both happy path and edge cases**:
-```python
-def test_feature_success():
-    # Normal operation
-
-def test_feature_with_empty_input():
-    # Edge case
-
-def test_feature_with_invalid_data():
-    # Error handling
-```
-
----
-
-### **Git Workflow Best Practices**
-
-**1. Conventional commits**:
-```bash
-git commit -m "feat: add confidence checking to PM Agent"
-git commit -m "fix: resolve version inconsistency"
-git commit -m "docs: update CLAUDE.md with plugin warnings"
-git commit -m "test: add unit tests for reflexion pattern"
-```
-
-**2. Small, focused commits**:
-- Each commit should do ONE thing
-- Commit message should explain WHY, not WHAT
-- Code changes should be reviewable in <500 lines
-
-**3. Branch naming**:
-```bash
-feature/add-confidence-check
-fix/version-inconsistency
-docs/update-readme
-refactor/simplify-cli
-test/add-unit-tests
-```
-
----
-
-### **Documentation Best Practices**
-
-**1. Code documentation**:
-```python
-def assess(self, context: Dict[str, Any]) -> float:
-    """
-    Assess confidence level (0.0 - 1.0)
-
-    Investigation Phase Checks:
-    1. No duplicate implementations? (25%)
-    2. Architecture compliance? (25%)
-    3. Official documentation verified? (20%)
-    4. Working OSS implementations referenced? (15%)
-    5. Root cause identified? (15%)
-
-    Args:
-        context: Context dict with task details
-
-    Returns:
-        float: Confidence score (0.0 = no confidence, 1.0 = absolute certainty)
-
-    Example:
-        >>> checker = ConfidenceChecker()
-        >>> confidence = checker.assess(context)
-        >>> if confidence >= 0.9:
-        ...     proceed_with_implementation()
-    """
-```
-
-**2. README structure**:
-- Start with clear value proposition
-- Quick installation instructions
-- Usage examples
-- Link to detailed docs
-- Contribution guidelines
-- License
-
-**3. Keep docs synchronized with code**:
-- Update docs in same PR as code changes
-- Review docs during code review
-- Use automated doc generation where possible
-
----
-
-## 🔧 **Troubleshooting Guide**
-
-### **Issue: Tests Not Found**
-
-**Symptoms**:
-```
-$ uv run pytest
-ERROR: file or directory not found: tests/
-```
-
-**Cause**: tests/ directory doesn't exist
-
-**Solution**:
-```bash
-# Create tests structure
-mkdir -p tests/unit tests/integration
-
-# Add __init__.py files
-touch tests/__init__.py
-touch tests/unit/__init__.py
-touch tests/integration/__init__.py
-
-# Add conftest.py
-touch tests/conftest.py
-```
-
----
-
-### **Issue: Plugin Not Loaded**
-
-**Symptoms**:
-```
-$ uv run pytest --trace-config
-# superclaude not listed in plugins
-```
-
-**Cause**: Package not installed or entry point not configured
-
-**Solution**:
-```bash
-# Reinstall in editable mode
-uv pip install -e ".[dev]"
-
-# Verify entry point in pyproject.toml
-# Should have:
-# [project.entry-points.pytest11]
-# superclaude = "superclaude.pytest_plugin"
-
-# Test plugin loaded
-uv run pytest --trace-config 2>&1 | grep superclaude
-```
-
----
-
-### **Issue: ImportError in Tests**
-
-**Symptoms**:
-```python
-ImportError: No module named 'superclaude'
-```
-
-**Cause**: Package not installed in test environment
-
-**Solution**:
-```bash
-# Install package in editable mode
-uv pip install -e .
-
-# Or use uv run (creates venv automatically)
-uv run pytest
-```
-
----
-
-### **Issue: Fixtures Not Available**
-
-**Symptoms**:
-```python
-fixture 'confidence_checker' not found
-```
-
-**Cause**: pytest plugin not loaded or fixture not defined
-
-**Solution**:
-```bash
-# Check plugin loaded
-uv run pytest --fixtures | grep confidence_checker
-
-# Verify pytest_plugin.py has fixture
-# Should have:
-# @pytest.fixture
-# def confidence_checker():
-#     return ConfidenceChecker()
-
-# Reinstall package
-uv pip install -e .
-```
-
----
-
-### **Issue: .gitignore Not Working**
-
-**Symptoms**: Files listed in .gitignore still tracked by git
-
-**Cause**: Files were tracked before adding to .gitignore
-
-**Solution**:
-```bash
-# Remove from git but keep in filesystem
-git rm --cached <file>
-
-# OR remove entire directory
-git rm -r --cached <directory>
-
-# Commit the change
-git commit -m "fix: remove tracked files from gitignore"
-```
-
----
-
-## 💡 **Advanced Techniques**
-
-### **Technique 1: Dynamic Fixture Configuration**
-
-```python
-@pytest.fixture
-def token_budget(request):
-    """Fixture that adapts based on test markers"""
-    marker = request.node.get_closest_marker("complexity")
-    complexity = marker.args[0] if marker else "medium"
-    return TokenBudgetManager(complexity=complexity)
-
-# Usage
-@pytest.mark.complexity("simple")
-def test_simple_feature(token_budget):
-    assert token_budget.limit == 200
-```
-
----
-
-### **Technique 2: Confidence-Driven Test Execution**
-
-```python
-def pytest_runtest_setup(item):
-    """Skip tests if confidence is too low"""
-    marker = item.get_closest_marker("confidence_check")
-    if marker:
-        checker = ConfidenceChecker()
-        context = build_context(item)
-        confidence = checker.assess(context)
-
-        if confidence < 0.7:
-            pytest.skip(f"Confidence too low: {confidence:.0%}")
-```
-
----
-
-### **Technique 3: Reflexion-Powered Error Learning**
-
-```python
-def pytest_runtest_makereport(item, call):
-    """Record failed tests for future learning"""
-    if call.when == "call" and call.excinfo is not None:
-        reflexion = ReflexionPattern()
-        error_info = {
-            "test_name": item.name,
-            "error_type": type(call.excinfo.value).__name__,
-            "error_message": str(call.excinfo.value),
-        }
-        reflexion.record_error(error_info)
-```
-
----
-
-## 📊 **Performance Insights**
-
-### **Token Usage Patterns**
-
-Based on real usage data:
-
-| Task Type | Typical Tokens | With PM Agent | Savings |
-|-----------|---------------|---------------|---------|
-| Typo fix | 200-500 | 200-300 | 40% |
-| Bug fix | 2,000-5,000 | 1,000-2,000 | 50% |
-| Feature | 10,000-50,000 | 5,000-15,000 | 60% |
-| Wrong direction | 50,000+ | 100-200 (prevented) | 99%+ |
-
-**Key insight**: Prevention (confidence check) saves more tokens than optimization
-
----
-
-### **Execution Time Patterns**
-
-| Operation | Sequential | Parallel | Speedup |
-|-----------|-----------|----------|---------|
-| 5 file reads | 15s | 3s | 5x |
-| 10 file reads | 30s | 3s | 10x |
-| 20 file edits | 60s | 15s | 4x |
-| Mixed ops | 45s | 12s | 3.75x |
-
-**Key insight**: Parallel execution has diminishing returns after ~10 operations per wave
-
----
-
-## 🎓 **Lessons Learned**
-
-### **Lesson 1: Documentation Drift is Real**
-
-**What happened**: README described v2.0 plugin system that didn't exist in v4.1.9
-
-**Impact**: Users spent hours trying to install non-existent features
-
-**Solution**:
-- Add warnings about planned vs implemented features
-- Review docs during every release
-- Link to tracking issues for planned features
-
-**Prevention**: Documentation review checklist in release process
-
----
-
-### **Lesson 2: Version Management is Hard**
-
-**What happened**: Three different version numbers across files
-
-**Impact**: Confusion about which version is installed
-
-**Solution**:
-- Define version sources of truth
-- Document versioning strategy
-- Automate version updates in release script
-
-**Prevention**: Single-source-of-truth for versions (maybe use bumpversion)
-
----
-
-### **Lesson 3: Tests Are Non-Negotiable**
-
-**What happened**: Framework provided testing tools but had no tests itself
-
-**Impact**: No confidence in code quality, regression bugs
-
-**Solution**:
-- Create comprehensive test suite
-- Require tests for all new code
-- Add CI/CD to run tests automatically
-
-**Prevention**: Make tests a requirement in PR template
-
----
-
-## 🔮 **Future Explorations**
-
-Ideas worth investigating:
-
-1. **Automated confidence checking** - AI analyzes context and suggests improvements
-2. **Visual reflexion patterns** - Graph view of error patterns over time
-3. **Predictive token budgeting** - ML model predicts token usage based on task
-4. **Collaborative learning** - Share reflexion patterns across projects (opt-in)
-5. **Real-time hallucination detection** - Streaming analysis during generation
-
----
-
-## 📞 **Getting Help**
-
-**When stuck**:
-1. Check this KNOWLEDGE.md for similar issues
-2. Read PLANNING.md for architecture context
-3. Check TASK.md for known issues
-4. Search GitHub issues for solutions
-5. Ask in GitHub discussions
-
-**When sharing knowledge**:
-1. Document solution in this file
-2. Update relevant section
-3. Add to troubleshooting guide if applicable
-4. Consider adding to FAQ
-
----
-
-## 🔌 **Claude Code Integration Gap Analysis** (March 2026)
-
-### Key Finding: SuperClaude Under-uses Claude Code's Extension Points
-
-Claude Code provides 60+ built-in commands, 28 hook events, a full skills system, 5 settings scopes, agent teams, plan mode, extended thinking, and 60+ MCP servers in its registry. SuperClaude currently uses only a fraction of these.
-
-### Biggest Gaps (High Impact)
-
-**1. Skills System (CRITICAL)**
-- Claude Code skills support YAML frontmatter with `model`, `effort`, `allowed-tools`, `context: fork`, auto-triggering via `description`, and argument substitution
-- SuperClaude has only 1 skill (confidence-check); 30 commands could be reimplemented as skills for better auto-triggering and tool restrictions
-- **Action**: Migrate key commands to skills format in v4.3+
-
-**2. Hooks System (HIGH)**
-- Claude Code has 28 hook events (`SessionStart`, `Stop`, `PostToolUse`, `TaskCompleted`, `SubagentStop`, `PreCompact`, etc.)
-- SuperClaude defines hooks but doesn't leverage most events
-- **Action**: Use `SessionStart` for PM Agent auto-restore, `Stop` for session persistence, `PostToolUse` for self-check, `TaskCompleted` for reflexion
-
-**3. Plan Mode Integration (MEDIUM)**
-- Claude Code's plan mode provides read-only exploration with visual markdown plans
-- SuperClaude's confidence checks could block transition from plan to implementation when confidence < 70%
-- **Action**: Connect confidence checker to plan mode exit gate
-
-**4. Settings Profiles (MEDIUM)**
-- Claude Code has 5 settings scopes with granular permission rules (`Bash(pattern)`, `Edit(path)`, `mcp__server__tool`)
-- SuperClaude could provide recommended settings profiles per workflow (strict security, autonomous dev, research)
-- **Action**: Create `.claude/settings.json` templates for common workflows
-
-### What's Working Well
-
-- **Commands** (30): Well-integrated as custom commands in `~/.claude/commands/sc/`
-- **Agents** (20): Properly installed to `~/.claude/agents/` as subagents
-- **MCP Servers** (8+): Good coverage of common tools, AIRIS gateway unifies them
-- **Pytest Plugin**: Clean auto-loading, good fixture/marker system
-- **Behavioral Modes** (7): Effective context injection even without native support
-
-### Reference
-
-See `docs/user-guide/claude-code-integration.md` for the complete feature mapping and gap analysis.
-
----
-
-*This document grows with the project. Everyone who encounters a problem and finds a solution should document it here.*
-
-**Contributors**: SuperClaude development team and community
-**Maintained by**: Project maintainers
-**Review frequency**: Quarterly or after major insights

MANIFEST.in

@@ -3,31 +3,16 @@ include README.md
 include LICENSE
 include CHANGELOG.md
 include CONTRIBUTING.md
+include ROADMAP.md
 include SECURITY.md
+include ARCHITECTURE_OVERVIEW.md
 include pyproject.toml
-recursive-include docs *.md *.json *.py
-recursive-include tests *.py
-recursive-include src/superclaude *.py *.md *.ts *.json *.sh
-recursive-include src/superclaude/commands *.md
-recursive-include src/superclaude/agents *.md
-recursive-include src/superclaude/modes *.md
-recursive-include src/superclaude/mcp *.md *.json
-recursive-include src/superclaude/core *.md
-recursive-include src/superclaude/examples *.md
-recursive-include src/superclaude/hooks *.json
-recursive-include src/superclaude/scripts *.py *.sh
-recursive-include src/superclaude/skills *.md *.ts *.json
-recursive-include plugins/superclaude *.py *.md *.ts *.json *.sh
-recursive-include plugins/superclaude/commands *.md
-recursive-include plugins/superclaude/agents *.md
-recursive-include plugins/superclaude/modes *.md
-recursive-include plugins/superclaude/mcp *.py *.md *.json
-recursive-include plugins/superclaude/mcp/configs *.json
-recursive-include plugins/superclaude/core *.md
-recursive-include plugins/superclaude/examples *.md
-recursive-include plugins/superclaude/hooks *.json
-recursive-include plugins/superclaude/scripts *.py *.sh
-recursive-include plugins/superclaude/skills *.py *.md *.ts *.json
+recursive-include SuperClaude *
+recursive-include Templates *
+recursive-include Docs *.md
+recursive-include Setup *
+recursive-include profiles *
+recursive-include config *
 global-exclude __pycache__
 global-exclude *.py[co]
 global-exclude .DS_Store

Makefile

@@ -1,138 +0,0 @@
-.PHONY: install test test-plugin doctor verify clean lint format build-plugin sync-plugin-repo uninstall-legacy help
-
-# Installation (local source, editable) - RECOMMENDED
-install:
-	@echo "🔧 Installing SuperClaude Framework (development mode)..."
-	uv pip install -e ".[dev]"
-	@echo ""
-	@echo "✅ Installation complete!"
-	@echo "   Run 'make verify' to check installation"
-
-# 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 {} +
-
-PLUGIN_DIST := dist/plugins/superclaude
-PLUGIN_REPO ?= ../SuperClaude_Plugin
-
-.PHONY: build-plugin
-build-plugin: ## Build SuperClaude plugin artefacts into dist/
-	@echo "🛠️  Building SuperClaude plugin from unified sources..."
-	@uv run python scripts/build_superclaude_plugin.py
-
-.PHONY: sync-plugin-repo
-sync-plugin-repo: build-plugin ## Sync built plugin artefacts into ../SuperClaude_Plugin
-	@if [ ! -d "$(PLUGIN_REPO)" ]; then \
-		echo "❌ Target plugin repository not found at $(PLUGIN_REPO)"; \
-		echo "   Set PLUGIN_REPO=/path/to/SuperClaude_Plugin when running make."; \
-		exit 1; \
-	fi
-	@echo "📦 Syncing artefacts to $(PLUGIN_REPO)..."
-	@rsync -a --delete $(PLUGIN_DIST)/agents/ $(PLUGIN_REPO)/agents/
-	@rsync -a --delete $(PLUGIN_DIST)/commands/ $(PLUGIN_REPO)/commands/
-	@rsync -a --delete $(PLUGIN_DIST)/hooks/ $(PLUGIN_REPO)/hooks/
-	@rsync -a --delete $(PLUGIN_DIST)/scripts/ $(PLUGIN_REPO)/scripts/
-	@rsync -a --delete $(PLUGIN_DIST)/skills/ $(PLUGIN_REPO)/skills/
-	@rsync -a --delete $(PLUGIN_DIST)/.claude-plugin/ $(PLUGIN_REPO)/.claude-plugin/
-	@echo "✅ Sync complete."
-
-# 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 install         - 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 "🔌 Plugin Packaging:"
-	@echo "  make build-plugin    - Build SuperClaude plugin artefacts into dist/"
-	@echo "  make sync-plugin-repo - Sync artefacts into ../SuperClaude_Plugin"
-	@echo ""
-	@echo "📚 Documentation:"
-	@echo "  make translate       - Translate README to Chinese and Japanese"
-	@echo ""
-	@echo "🧹 Cleanup:"
-	@echo "  make uninstall-legacy - Remove old SuperClaude files from ~/.claude"
-	@echo "  make help            - Show this help message"
-
-# Remove legacy SuperClaude files from ~/.claude directory
-uninstall-legacy:
-	@echo "🧹 Cleaning up legacy SuperClaude files..."
-	@bash scripts/uninstall_legacy.sh
-	@echo ""

PARALLEL_INDEXING_PLAN.md

@@ -1,190 +0,0 @@
-# Parallel Repository Indexing Execution Plan
-
-## Objective
-Create comprehensive repository index for: /Users/kazuki/github/SuperClaude_Framework
-
-## Execution Strategy
-
-Execute the following 5 tasks IN PARALLEL using Task tool.
-IMPORTANT: All 5 Task tool calls must be in a SINGLE message for parallel execution.
-
-## Tasks to Execute (Parallel)
-
-### Task 1: Analyze code structure
-- Agent: Explore
-- ID: code_structure
-
-**Prompt**:
-```
-Analyze the code structure of this repository: /Users/kazuki/github/SuperClaude_Framework
-
-Task: Find and analyze all source code directories (src/, lib/, superclaude/, setup/, apps/, packages/)
-
-For each directory found:
-1. List all Python/JavaScript/TypeScript files
-2. Identify the purpose/responsibility
-3. Note key files and entry points
-4. Detect any organizational issues
-
-Output format (JSON):
-{
-    "directories": [
-        {
-            "path": "relative/path",
-            "purpose": "description",
-            "file_count": 10,
-            "key_files": ["file1.py", "file2.py"],
-            "issues": ["redundant nesting", "orphaned files"]
-        }
-    ],
-    "total_files": 100
-}
-
-Use Glob and Grep tools to search efficiently.
-Be thorough: "very thorough" level.
-
-```
-
-### Task 2: Analyze documentation
-- Agent: Explore
-- ID: documentation
-
-**Prompt**:
-```
-Analyze the documentation of this repository: /Users/kazuki/github/SuperClaude_Framework
-
-Task: Find and analyze all documentation (docs/, README*, *.md files)
-
-For each documentation section:
-1. List all markdown/rst files
-2. Assess documentation coverage
-3. Identify missing documentation
-4. Detect redundant/duplicate docs
-
-Output format (JSON):
-{
-    "directories": [
-        {
-            "path": "docs/",
-            "purpose": "User/developer documentation",
-            "file_count": 50,
-            "coverage": "good|partial|poor",
-            "missing": ["API reference", "Architecture guide"],
-            "duplicates": ["README vs docs/README"]
-        }
-    ],
-    "root_docs": ["README.md", "CLAUDE.md"],
-    "total_files": 75
-}
-
-Use Glob to find all .md files.
-Check for duplicate content patterns.
-
-```
-
-### Task 3: Analyze configuration files
-- Agent: Explore
-- ID: configuration
-
-**Prompt**:
-```
-Analyze the configuration files of this repository: /Users/kazuki/github/SuperClaude_Framework
-
-Task: Find and analyze all configuration files (.toml, .yaml, .yml, .json, .ini, .cfg)
-
-For each config file:
-1. Identify purpose (build, deps, CI/CD, etc.)
-2. Note importance level
-3. Check for issues (deprecated, unused)
-
-Output format (JSON):
-{
-    "config_files": [
-        {
-            "path": "pyproject.toml",
-            "type": "python_project",
-            "importance": "critical",
-            "issues": []
-        }
-    ],
-    "total_files": 15
-}
-
-Use Glob with appropriate patterns.
-
-```
-
-### Task 4: Analyze test structure
-- Agent: Explore
-- ID: tests
-
-**Prompt**:
-```
-Analyze the test structure of this repository: /Users/kazuki/github/SuperClaude_Framework
-
-Task: Find and analyze all tests (tests/, __tests__/, *.test.*, *.spec.*)
-
-For each test directory/file:
-1. Count test files
-2. Identify test types (unit, integration, performance)
-3. Assess coverage (if pytest/coverage data available)
-
-Output format (JSON):
-{
-    "test_directories": [
-        {
-            "path": "tests/",
-            "test_count": 20,
-            "types": ["unit", "integration", "benchmark"],
-            "coverage": "unknown"
-        }
-    ],
-    "total_tests": 25
-}
-
-Use Glob to find test files.
-
-```
-
-### Task 5: Analyze scripts and utilities
-- Agent: Explore
-- ID: scripts
-
-**Prompt**:
-```
-Analyze the scripts and utilities of this repository: /Users/kazuki/github/SuperClaude_Framework
-
-Task: Find and analyze all scripts (scripts/, bin/, tools/, *.sh, *.bash)
-
-For each script:
-1. Identify purpose
-2. Note language (bash, python, etc.)
-3. Check if documented
-
-Output format (JSON):
-{
-    "script_directories": [
-        {
-            "path": "scripts/",
-            "script_count": 5,
-            "purposes": ["build", "deploy", "utility"],
-            "documented": true
-        }
-    ],
-    "total_scripts": 10
-}
-
-Use Glob to find script files.
-
-```
-
-## Expected Output
-
-Each task will return JSON with analysis results.
-After all tasks complete, merge the results into a single repository index.
-
-## Performance Expectations
-
-- Sequential execution: ~300ms
-- Parallel execution: ~60-100ms (3-5x faster)
-- No GIL limitations (API-level parallelism)

PLANNING.md

@@ -1,389 +0,0 @@
-# PLANNING.md
-
-**Architecture, Design Principles, and Absolute Rules for SuperClaude Framework**
-
-> This document is read by Claude Code at session start to ensure consistent, high-quality development aligned with project standards.
-
----
-
-## 🎯 **Project Vision**
-
-SuperClaude Framework transforms Claude Code into a structured development platform through:
-- **Behavioral instruction injection** via CLAUDE.md
-- **Component orchestration** via pytest plugin + slash commands
-- **Systematic workflow automation** via PM Agent patterns
-
-**Core Mission**: Enhance AI-assisted development with:
-- Pre-execution confidence checking (prevent wrong-direction work)
-- Post-implementation validation (prevent hallucinations)
-- Cross-session learning (reflexion pattern)
-- Token-efficient parallel execution (3.5x speedup)
-
----
-
-## 🏗️ **Architecture Overview**
-
-### **Current State (v4.3.0)**
-
-SuperClaude is a **Python package** with:
-- Pytest plugin (auto-loaded via entry points)
-- CLI tools (superclaude command)
-- PM Agent patterns (confidence, self-check, reflexion)
-- Parallel execution framework
-- Optional slash commands (installed to ~/.claude/commands/)
-
-```
-SuperClaude Framework v4.3.0
-│
-├── Core Package (src/superclaude/)
-│   ├── pytest_plugin.py          # Auto-loaded by pytest
-│   ├── pm_agent/                  # Pre/post implementation patterns
-│   │   ├── confidence.py          # Pre-execution confidence check
-│   │   ├── self_check.py          # Post-implementation validation
-│   │   ├── reflexion.py           # Error learning
-│   │   └── token_budget.py        # Token allocation
-│   ├── execution/                 # Parallel execution
-│   │   ├── parallel.py            # Wave→Checkpoint→Wave
-│   │   ├── reflection.py          # Meta-reasoning
-│   │   └── self_correction.py     # Error recovery
-│   └── cli/                       # Command-line interface
-│       ├── main.py                # superclaude command
-│       ├── doctor.py              # Health checks
-│       └── install_skill.py       # Skill installation
-│
-├── Plugin Source (plugins/superclaude/)  # v5.0 - NOT ACTIVE YET
-│   ├── agents/                    # Agent definitions
-│   ├── commands/                  # Command definitions
-│   ├── hooks/                     # Hook configurations
-│   ├── scripts/                   # Shell scripts
-│   └── skills/                    # Skill implementations
-│
-├── Tests (tests/)
-│   ├── unit/                      # Component unit tests
-│   └── integration/               # Plugin integration tests
-│
-└── Documentation (docs/)
-    ├── architecture/              # Architecture decisions
-    ├── developer-guide/           # Development guides
-    ├── reference/                 # API reference
-    ├── research/                  # Research findings
-    └── user-guide/                # User documentation
-```
-
-### **Future State (v5.0 - Planned)**
-
-- TypeScript plugin system (issue #419)
-- Project-local `.claude-plugin/` detection
-- Plugin marketplace distribution
-- Enhanced MCP server integration
-
----
-
-## ⚙️ **Design Principles**
-
-### **1. Evidence-Based Development**
-
-**Never guess** - always verify with official sources:
-- Use Context7 MCP for official documentation
-- Use WebFetch/WebSearch for research
-- Check existing code with Glob/Grep before implementing
-- Verify assumptions against test results
-
-**Anti-pattern**: Implementing based on assumptions or outdated knowledge
-
-### **2. Confidence-First Implementation**
-
-Check confidence BEFORE starting work:
-- **≥90%**: Proceed with implementation
-- **70-89%**: Present alternatives, continue investigation
-- **<70%**: STOP - ask questions, investigate more
-
-**ROI**: Spend 100-200 tokens on confidence check to save 5,000-50,000 tokens on wrong direction
-
-### **3. Parallel-First Execution**
-
-Use **Wave → Checkpoint → Wave** pattern:
-```
-Wave 1: [Read file1, Read file2, Read file3] (parallel)
-   ↓
-Checkpoint: Analyze all files together
-   ↓
-Wave 2: [Edit file1, Edit file2, Edit file3] (parallel)
-```
-
-**Benefit**: 3.5x faster than sequential execution
-
-**When to use**:
-- Independent operations (reading multiple files)
-- Batch transformations (editing multiple files)
-- Parallel searches (grep across different directories)
-
-**When NOT to use**:
-- Operations with dependencies (must wait for previous result)
-- Sequential analysis (need to build context step-by-step)
-
-### **4. Token Efficiency**
-
-Allocate tokens based on task complexity:
-- **Simple** (typo fix): 200 tokens
-- **Medium** (bug fix): 1,000 tokens
-- **Complex** (feature): 2,500 tokens
-
-**Confidence check ROI**: 25-250x token savings
-
-### **5. No Hallucinations**
-
-Use SelfCheckProtocol to prevent hallucinations:
-
-**The Four Questions**:
-1. Are all tests passing? (show output)
-2. Are all requirements met? (list items)
-3. No assumptions without verification? (show docs)
-4. Is there evidence? (test results, code changes, validation)
-
-**7 Red Flags**:
-- "Tests pass" without output
-- "Everything works" without evidence
-- "Implementation complete" with failing tests
-- Skipping error messages
-- Ignoring warnings
-- Hiding failures
-- "Probably works" language
-
----
-
-## 🚫 **Absolute Rules**
-
-### **Python Environment**
-
-1. **ALWAYS use UV** for Python operations:
-   ```bash
-   uv run pytest              # NOT: python -m pytest
-   uv pip install package     # NOT: pip install package
-   uv run python script.py    # NOT: python script.py
-   ```
-
-2. **Package structure**: Use src/ layout
-   - `src/superclaude/` for package code
-   - `tests/` for test code
-   - Never mix source and tests in same directory
-
-3. **Entry points**: Use pyproject.toml
-   - CLI: `[project.scripts]`
-   - Pytest plugin: `[project.entry-points.pytest11]`
-
-### **Testing**
-
-1. **All new features MUST have tests**
-   - Unit tests for individual components
-   - Integration tests for component interactions
-   - Use pytest markers: `@pytest.mark.unit`, `@pytest.mark.integration`
-
-2. **Use PM Agent patterns in tests**:
-   ```python
-   @pytest.mark.confidence_check
-   def test_feature(confidence_checker):
-       context = {...}
-       assert confidence_checker.assess(context) >= 0.7
-
-   @pytest.mark.self_check
-   def test_implementation(self_check_protocol):
-       passed, issues = self_check_protocol.validate(impl)
-       assert passed
-   ```
-
-3. **Test fixtures**: Use conftest.py for shared fixtures
-
-### **Git Workflow**
-
-1. **Branch structure**:
-   - `master`: Production-ready code
-   - `integration`: Testing ground (not yet created)
-   - `feature/*`, `fix/*`, `docs/*`: Feature branches
-
-2. **Commit messages**: Use conventional commits
-   - `feat:` - New feature
-   - `fix:` - Bug fix
-   - `docs:` - Documentation
-   - `refactor:` - Code refactoring
-   - `test:` - Adding tests
-   - `chore:` - Maintenance
-
-3. **Never commit**:
-   - `__pycache__/`, `*.pyc`
-   - `.venv/`, `venv/`
-   - Personal files (TODO.txt, CRUSH.md)
-   - API keys, secrets
-
-### **Documentation**
-
-1. **Code documentation**:
-   - All public functions need docstrings
-   - Use type hints
-   - Include usage examples in docstrings
-
-2. **Project documentation**:
-   - Update CLAUDE.md for Claude Code guidance
-   - Update README.md for user instructions
-   - Update this PLANNING.md for architecture decisions
-   - Update TASK.md for current work
-   - Update KNOWLEDGE.md for insights
-
-3. **Keep docs synchronized**:
-   - When code changes, update relevant docs
-   - When features are added, update CHANGELOG.md
-   - When architecture changes, update PLANNING.md
-
-### **Version Management**
-
-1. **Version sources of truth**:
-   - Framework version: `VERSION` file (e.g., 4.3.0)
-   - Python package version: `pyproject.toml` (e.g., 0.4.0)
-   - NPM package version: `package.json` (should match VERSION)
-
-2. **When to bump versions**:
-   - Major: Breaking API changes
-   - Minor: New features, backward compatible
-   - Patch: Bug fixes
-
----
-
-## 🔄 **Development Workflow**
-
-### **Starting a New Feature**
-
-1. **Investigation Phase**:
-   - Read PLANNING.md, TASK.md, KNOWLEDGE.md
-   - Check for duplicates (Glob/Grep existing code)
-   - Read official docs (Context7 MCP, WebFetch)
-   - Search for OSS implementations (WebSearch)
-   - Run confidence check (should be ≥90%)
-
-2. **Implementation Phase**:
-   - Create feature branch: `git checkout -b feature/feature-name`
-   - Write tests first (TDD)
-   - Implement feature
-   - Run tests: `uv run pytest`
-   - Run linter: `make lint`
-   - Format code: `make format`
-
-3. **Validation Phase**:
-   - Run self-check protocol
-   - Verify all tests passing
-   - Check all requirements met
-   - Confirm assumptions verified
-   - Provide evidence
-
-4. **Documentation Phase**:
-   - Update relevant documentation
-   - Add docstrings
-   - Update CHANGELOG.md
-   - Update TASK.md (mark complete)
-
-5. **Review Phase**:
-   - Create pull request
-   - Request review
-   - Address feedback
-   - Merge to integration (or master if no integration branch)
-
-### **Fixing a Bug**
-
-1. **Root Cause Analysis**:
-   - Reproduce the bug
-   - Identify root cause (not symptoms)
-   - Check reflexion memory for similar patterns
-   - Run confidence check
-
-2. **Fix Implementation**:
-   - Write failing test that reproduces bug
-   - Implement fix
-   - Verify test passes
-   - Run full test suite
-   - Record in reflexion memory
-
-3. **Prevention**:
-   - Add regression test
-   - Update documentation if needed
-   - Share learnings in KNOWLEDGE.md
-
----
-
-## 📊 **Quality Metrics**
-
-### **Code Quality**
-
-- **Test coverage**: Aim for >80%
-- **Linting**: Zero ruff errors
-- **Type checking**: Use type hints, minimal mypy errors
-- **Documentation**: All public APIs documented
-
-### **PM Agent Metrics**
-
-- **Confidence check ROI**: 25-250x token savings
-- **Self-check detection**: 94% hallucination detection rate
-- **Parallel execution**: 3.5x speedup vs sequential
-- **Token efficiency**: 30-50% reduction with proper budgeting
-
-### **Release Criteria**
-
-Before releasing a new version:
-- ✅ All tests passing
-- ✅ Documentation updated
-- ✅ CHANGELOG.md updated
-- ✅ Version numbers synced
-- ✅ No known critical bugs
-- ✅ Security audit passed (if applicable)
-
----
-
-## 🚀 **Roadmap**
-
-### **v4.3.0 (Current)**
-- ✅ Python package with pytest plugin
-- ✅ PM Agent patterns (confidence, self-check, reflexion)
-- ✅ Parallel execution framework
-- ✅ CLI tools and slash commands
-- ✅ AIRIS MCP Gateway (optional, requires Docker)
-- ✅ Explicit command boundaries and handoff instructions
-- ✅ Complete command reference documentation
-
-### **v4.3.0 (Next)**
-- [ ] Complete placeholder implementations in confidence.py
-- [ ] Add comprehensive test coverage (>80%)
-- [ ] Enhanced MCP server integration
-- [ ] Improve documentation
-
-### **v5.0 (Future)**
-- [ ] TypeScript plugin system (issue #419)
-- [ ] Plugin marketplace
-- [ ] Project-local plugin detection
-- [ ] Enhanced reflexion with mindbase integration
-- [ ] Advanced parallel execution patterns
-
----
-
-## 🤝 **Contributing Guidelines**
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed contribution guidelines.
-
-**Key points**:
-- Follow absolute rules above
-- Write tests for all new code
-- Use PM Agent patterns
-- Document your changes
-- Request reviews
-
----
-
-## 📚 **Additional Resources**
-
-- **[TASK.md](TASK.md)**: Current tasks and priorities
-- **[KNOWLEDGE.md](KNOWLEDGE.md)**: Accumulated insights and best practices
-- **[CONTRIBUTING.md](CONTRIBUTING.md)**: Contribution guidelines
-- **[docs/](docs/)**: Comprehensive documentation
-
----
-
-*This document is maintained by the SuperClaude development team and should be updated whenever architectural decisions are made.*
-
-**Last updated**: 2025-11-12 (auto-generated during issue #466 fix)

PLUGIN_INSTALL.md

@@ -1,161 +0,0 @@
-# SuperClaude Plugin Installation Guide
-
-## 公式インストール方法（推奨）
-
-### 前提条件
-
-1. **ripgrep のインストール**
-   ```bash
-   brew install ripgrep
-   ```
-
-2. **環境変数の設定**（~/.zshrc または ~/.bashrc に追加）
-   ```bash
-   export USE_BUILTIN_RIPGREP=0
-   ```
-
-3. **シェルの再起動**
-   ```bash
-   exec $SHELL
-   ```
-
-### インストール手順
-
-#### 方法A: ローカルマーケットプレイス経由（推奨）
-
-1. Claude Code でマーケットプレイスを追加:
-   ```
-   /plugin marketplace add /Users/kazuki/github/superclaude
-   ```
-
-2. プラグインをインストール:
-   ```
-   /plugin install pm-agent@superclaude-local
-   ```
-
-3. Claude Code を再起動
-
-4. 動作確認:
-   ```
-   /pm
-   /research
-   /index-repo
-   ```
-
-#### 方法B: 開発者モード（直接コピー）
-
-**注意**: この方法は開発中のテスト用です。公式方法（方法A）の使用を推奨します。
-
-```bash
-# プロジェクトルートで実行
-make reinstall-plugin-dev
-```
-
-Claude Code を再起動後、コマンドが利用可能になります。
-
-## インストールされるコマンド
-
-### /pm
-PM Agent モードを起動。以下の機能を提供：
-- 90%信頼度チェック（実装前）
-- 並列実行最適化
-- トークン予算管理
-- エビデンスベース開発
-
-### /research
-Deep Research モード。以下の機能を提供：
-- 並列Web検索（Tavily MCP）
-- 公式ドキュメント優先
-- ソース検証
-- 信頼度付き結果
-
-### /index-repo
-リポジトリインデックス作成。以下の機能を提供：
-- プロジェクト構造解析
-- 94%トークン削減（58K → 3K）
-- エントリポイント特定
-- モジュールマップ生成
-
-## フックの自動実行
-
-SessionStart フックにより、新しいセッション開始時に `/pm` コマンドが自動実行されます。
-
-無効化したい場合は、`~/.claude/plugins/pm-agent/hooks/hooks.json` を編集してください。
-
-## トラブルシューティング
-
-### コマンドが認識されない場合
-
-1. **ripgrep の確認**:
-   ```bash
-   which rg
-   rg --version
-   ```
-
-   インストールされていない場合：
-   ```bash
-   brew install ripgrep
-   ```
-
-2. **環境変数の確認**:
-   ```bash
-   echo $USE_BUILTIN_RIPGREP
-   ```
-
-   設定されていない場合：
-   ```bash
-   echo 'export USE_BUILTIN_RIPGREP=0' >> ~/.zshrc
-   exec $SHELL
-   ```
-
-3. **プラグインの確認**:
-   ```bash
-   ls -la ~/.claude/plugins/pm-agent/
-   ```
-
-   存在しない場合は再インストール：
-   ```bash
-   make reinstall-plugin-dev
-   ```
-
-4. **Claude Code を再起動**
-
-### それでも動かない場合
-
-Claude Code のバージョンを確認してください。2.0.x には既知のバグがあります：
-- GitHub Issue #8831: Custom slash commands not discovered
-
-回避策：
-- NPM版に切り替える（Homebrew版にバグの可能性）
-- ripgrep をシステムにインストール（上記手順）
-
-## プラグイン構造（参考）
-
-```
-~/.claude/plugins/pm-agent/
-├── plugin.json          # プラグインメタデータ
-├── marketplace.json     # マーケットプレイス情報
-├── commands/            # Markdown コマンド
-│   ├── pm.md
-│   ├── research.md
-│   └── index-repo.md
-└── hooks/
-    └── hooks.json       # SessionStart フック設定
-```
-
-## 開発者向け情報
-
-プラグインのソースコードは `/Users/kazuki/github/superclaude/` にあります。
-
-変更を反映するには：
-```bash
-make reinstall-plugin-dev
-# Claude Code を再起動
-```
-
-## サポート
-
-問題が発生した場合は、以下を確認してください：
-- 公式ドキュメント: https://docs.claude.com/ja/docs/claude-code/plugins
-- GitHub Issues: https://github.com/anthropics/claude-code/issues
-- プロジェクトドキュメント: CLAUDE.md, PLANNING.md

PROJECT_INDEX.json

@@ -1,245 +0,0 @@
-{
-  "metadata": {
-    "generated_at": "2025-10-29T00:00:00Z",
-    "version": "0.4.0",
-    "total_files": 196,
-    "python_loc": 3002,
-    "test_files": 7,
-    "documentation_files": 90
-  },
-  "entry_points": {
-    "cli": {
-      "command": "superclaude",
-      "source": "src/superclaude/cli/main.py",
-      "purpose": "CLI interface for SuperClaude operations"
-    },
-    "pytest_plugin": {
-      "auto_loaded": true,
-      "source": "src/superclaude/pytest_plugin.py",
-      "purpose": "PM Agent fixtures and test automation"
-    },
-    "skills": {
-      "confidence_check": {
-        "source": ".claude/skills/confidence-check/confidence.ts",
-        "purpose": "Pre-implementation confidence assessment"
-      }
-    }
-  },
-  "core_modules": {
-    "pm_agent": {
-      "path": "src/superclaude/pm_agent/",
-      "modules": {
-        "confidence": {
-          "file": "confidence.py",
-          "purpose": "Pre-execution confidence assessment",
-          "threshold": "≥90% required, 70-89% present alternatives, <70% ask questions",
-          "roi": "25-250x token savings"
-        },
-        "self_check": {
-          "file": "self_check.py",
-          "purpose": "Post-implementation evidence-based validation",
-          "pattern": "Assert → Verify → Report"
-        },
-        "reflexion": {
-          "file": "reflexion.py",
-          "purpose": "Error learning and prevention",
-          "features": ["Cross-session pattern matching", "Failure analysis"]
-        },
-        "token_budget": {
-          "file": "token_budget.py",
-          "purpose": "Token allocation and tracking",
-          "levels": {
-            "simple": 200,
-            "medium": 1000,
-            "complex": 2500
-          }
-        }
-      }
-    },
-    "execution": {
-      "path": "src/superclaude/execution/",
-      "modules": {
-        "parallel": {
-          "file": "parallel.py",
-          "pattern": "Wave → Checkpoint → Wave",
-          "performance": "3.5x faster than sequential"
-        },
-        "reflection": {
-          "file": "reflection.py",
-          "purpose": "Post-execution analysis and improvement"
-        },
-        "self_correction": {
-          "file": "self_correction.py",
-          "purpose": "Automated error detection and correction"
-        }
-      }
-    },
-    "cli": {
-      "path": "src/superclaude/cli/",
-      "modules": {
-        "main": {
-          "file": "main.py",
-          "exports": ["main()"],
-          "framework": "Click-based CLI"
-        },
-        "doctor": {
-          "file": "doctor.py",
-          "purpose": "Health check diagnostics"
-        },
-        "install_skill": {
-          "file": "install_skill.py",
-          "purpose": "Install SuperClaude skills to Claude Code",
-          "target": "~/.claude/skills/"
-        }
-      }
-    }
-  },
-  "configuration": {
-    "python_package": {
-      "file": "pyproject.toml",
-      "build_system": "hatchling (PEP 517)",
-      "python_version": ">=3.10",
-      "dependencies": {
-        "pytest": ">=7.0.0",
-        "click": ">=8.0.0",
-        "rich": ">=13.0.0"
-      }
-    },
-    "npm_wrapper": {
-      "file": "package.json",
-      "package": "@bifrost_inc/superclaude",
-      "version": "4.1.5",
-      "purpose": "Cross-platform installation wrapper"
-    },
-    "claude_code": {
-      "file": ".claude/settings.json",
-      "purpose": "Plugin and marketplace settings"
-    }
-  },
-  "documentation": {
-    "key_files": [
-      "CLAUDE.md",
-      "README.md",
-      "CONTRIBUTING.md",
-      "CHANGELOG.md",
-      "AGENTS.md"
-    ],
-    "user_guides": [
-      "docs/user-guide/commands.md",
-      "docs/user-guide/agents.md",
-      "docs/user-guide/flags.md",
-      "docs/user-guide/modes.md",
-      "docs/user-guide/session-management.md",
-      "docs/user-guide/mcp-servers.md"
-    ],
-    "developer_guides": [
-      "docs/developer-guide/contributing-code.md",
-      "docs/developer-guide/technical-architecture.md",
-      "docs/developer-guide/testing-debugging.md"
-    ],
-    "architecture": [
-      "docs/architecture/MIGRATION_TO_CLEAN_ARCHITECTURE.md",
-      "docs/architecture/PM_AGENT_COMPARISON.md",
-      "docs/architecture/CONTEXT_WINDOW_ANALYSIS.md"
-    ],
-    "research": [
-      "docs/research/llm-agent-token-efficiency-2025.md",
-      "docs/research/reflexion-integration-2025.md",
-      "docs/research/parallel-execution-complete-findings.md",
-      "docs/research/pm_agent_roi_analysis_2025-10-21.md"
-    ]
-  },
-  "tests": {
-    "framework": "pytest >=7.0.0",
-    "coverage_tool": "pytest-cov >=4.0.0",
-    "markers": [
-      "confidence_check",
-      "self_check",
-      "reflexion",
-      "unit",
-      "integration"
-    ],
-    "test_files": [
-      "tests/pm_agent/test_confidence_check.py",
-      "tests/pm_agent/test_self_check_protocol.py",
-      "tests/pm_agent/test_reflexion_pattern.py",
-      "tests/pm_agent/test_token_budget.py",
-      "tests/test_pytest_plugin.py",
-      "tests/conftest.py"
-    ],
-    "commands": {
-      "all_tests": "uv run pytest",
-      "specific_directory": "uv run pytest tests/pm_agent/ -v",
-      "by_marker": "uv run pytest -m confidence_check",
-      "with_coverage": "uv run pytest --cov=superclaude"
-    }
-  },
-  "dependencies": {
-    "core": {
-      "pytest": ">=7.0.0",
-      "click": ">=8.0.0",
-      "rich": ">=13.0.0"
-    },
-    "dev": {
-      "pytest-cov": ">=4.0.0",
-      "pytest-benchmark": ">=4.0.0",
-      "scipy": ">=1.10.0",
-      "ruff": ">=0.1.0",
-      "mypy": ">=1.0"
-    }
-  },
-  "quick_start": {
-    "installation": [
-      "uv pip install superclaude",
-      "pip install superclaude",
-      "make install"
-    ],
-    "usage": [
-      "superclaude --version",
-      "superclaude install-skill confidence-check",
-      "make doctor",
-      "make test"
-    ]
-  },
-  "git_workflow": {
-    "branch_structure": "master (production) ← integration (testing) ← feature/*, fix/*, docs/*",
-    "current_branch": "next"
-  },
-  "token_efficiency": {
-    "index_performance": {
-      "before": "58,000 tokens (reading all files every session)",
-      "after": "3,000 tokens (reading this index)",
-      "reduction": "94% (55,000 tokens saved per session)"
-    },
-    "pm_agent_roi": {
-      "confidence_check_cost": "100-200 tokens",
-      "savings": "5,000-50,000 tokens",
-      "roi": "25-250x token savings",
-      "break_even": "1 failed implementation prevented"
-    }
-  },
-  "project_stats": {
-    "python_source_lines": 3002,
-    "test_files_count": 7,
-    "documentation_files_count": 90,
-    "supported_python": ["3.10", "3.11", "3.12"],
-    "license": "MIT",
-    "contributors": 3
-  },
-  "mcp_integration": {
-    "servers": {
-      "tavily": "Web search (Deep Research)",
-      "context7": "Official documentation (prevent hallucination)",
-      "sequential": "Token-efficient reasoning (30-50% reduction)",
-      "serena": "Session persistence",
-      "mindbase": "Cross-session learning"
-    }
-  },
-  "project_principles": [
-    "Evidence-Based Development - Never guess, verify with official docs",
-    "Confidence-First Implementation - Check confidence BEFORE starting",
-    "Parallel-First Execution - Use Wave → Checkpoint → Wave (3.5x faster)",
-    "Token Efficiency - Optimize for minimal token usage",
-    "Test-Driven Development - Tests first, implementation second"
-  ]
-}

PROJECT_INDEX.md

@@ -1,324 +0,0 @@
-# Project Index: SuperClaude Framework
-
-**Generated**: 2025-10-29
-**Version**: 0.4.0
-**Description**: AI-enhanced development framework for Claude Code - pytest plugin with specialized commands
-
----
-
-## 📁 Project Structure
-
-```
-SuperClaude_Framework/
-├── src/superclaude/          # Python package (3,002 LOC)
-│   ├── cli/                  # CLI commands (main.py, doctor.py, install_skill.py)
-│   ├── pm_agent/             # PM Agent core (confidence.py, self_check.py, reflexion.py, token_budget.py)
-│   ├── execution/            # Execution patterns (parallel.py, reflection.py, self_correction.py)
-│   ├── pytest_plugin.py      # Auto-loaded pytest integration
-│   └── skills/               # TypeScript skills (confidence-check)
-├── tests/                    # Test suite (7 files)
-│   ├── pm_agent/             # PM Agent tests (confidence, self_check, reflexion)
-│   └── conftest.py           # Shared fixtures
-├── docs/                     # Documentation (90+ files)
-│   ├── user-guide/           # User guides (en, ja, kr, zh)
-│   ├── developer-guide/      # Developer documentation
-│   ├── reference/            # API reference & examples
-│   ├── architecture/         # Architecture decisions
-│   └── research/             # Research findings
-├── scripts/                  # Analysis tools (workflow metrics, A/B testing)
-├── setup/                    # Setup components & utilities
-├── skills/                   # Claude Code skills
-│   └── confidence-check/     # Confidence check skill (SKILL.md, confidence.ts)
-├── .claude/                  # Claude Code configuration
-│   ├── settings.json         # Plugin settings
-│   └── skills/               # Installed skills
-└── .github/                  # GitHub workflows & templates
-```
-
----
-
-## 🚀 Entry Points
-
-### CLI
-- **Command**: `superclaude` (installed via pip/uv)
-- **Source**: `src/superclaude/cli/main.py:main`
-- **Purpose**: CLI interface for SuperClaude operations
-
-### Pytest Plugin
-- **Auto-loaded**: Yes (via `pyproject.toml` entry point)
-- **Source**: `src/superclaude/pytest_plugin.py`
-- **Purpose**: PM Agent fixtures and test automation
-
-### Skills
-- **Confidence Check**: `.claude/skills/confidence-check/confidence.ts`
-- **Purpose**: Pre-implementation confidence assessment
-
----
-
-## 📦 Core Modules
-
-### PM Agent (src/superclaude/pm_agent/)
-Core patterns for AI-enhanced development:
-
-#### ConfidenceChecker (`confidence.py`)
-- **Purpose**: Pre-execution confidence assessment
-- **Threshold**: ≥90% required, 70-89% present alternatives, <70% ask questions
-- **ROI**: 25-250x token savings
-- **Checks**: No duplication, architecture compliance, official docs, OSS references, root cause identification
-
-#### SelfCheckProtocol (`self_check.py`)
-- **Purpose**: Post-implementation evidence-based validation
-- **Approach**: No speculation - verify with tests/docs
-- **Pattern**: Assert → Verify → Report
-
-#### ReflexionPattern (`reflexion.py`)
-- **Purpose**: Error learning and prevention
-- **Features**: Cross-session pattern matching, failure analysis
-- **Storage**: Session-persistent learning
-
-#### TokenBudgetManager (`token_budget.py`)
-- **Purpose**: Token allocation and tracking
-- **Levels**: Simple (200), Medium (1,000), Complex (2,500)
-- **Enforcement**: Budget-aware execution
-
-### Execution Patterns (src/superclaude/execution/)
-
-#### Parallel Execution (`parallel.py`)
-- **Pattern**: Wave → Checkpoint → Wave
-- **Performance**: 3.5x faster than sequential
-- **Features**: Automatic dependency analysis, concurrent tool calls
-- **Example**: [Read files in parallel] → Analyze → [Edit files in parallel]
-
-#### Reflection (`reflection.py`)
-- **Purpose**: Post-execution analysis and improvement
-- **Integration**: Works with ReflexionPattern
-
-#### Self-Correction (`self_correction.py`)
-- **Purpose**: Automated error detection and correction
-- **Strategy**: Iterative refinement
-
-### CLI Commands (src/superclaude/cli/)
-
-#### main.py
-- **Exports**: `main()` - CLI entry point
-- **Framework**: Click-based CLI
-- **Commands**: install-skill, doctor (health check)
-
-#### doctor.py
-- **Purpose**: Health check diagnostics
-- **Checks**: Package installation, pytest plugin, skills availability
-
-#### install_skill.py
-- **Purpose**: Install SuperClaude skills to Claude Code
-- **Target**: `~/.claude/skills/`
-
----
-
-## 🔧 Configuration
-
-### Python Package
-- **File**: `pyproject.toml`
-- **Build**: hatchling (PEP 517)
-- **Python**: ≥3.10
-- **Dependencies**: pytest ≥7.0.0, click ≥8.0.0, rich ≥13.0.0
-
-### NPM Wrapper
-- **File**: `package.json`
-- **Package**: `@bifrost_inc/superclaude`
-- **Version**: 4.1.5
-- **Purpose**: Cross-platform installation wrapper
-
-### Claude Code
-- **File**: `.claude/settings.json`
-- **Purpose**: Plugin and marketplace settings
-
----
-
-## 📚 Documentation
-
-### Key Files
-- **CLAUDE.md**: Instructions for Claude Code integration
-- **README.md**: Project overview and quick start
-- **CONTRIBUTING.md**: Contribution guidelines
-- **CHANGELOG.md**: Version history
-- **AGENTS.md**: Agent architecture documentation
-
-### User Guides (docs/user-guide/)
-- **commands.md**: Available commands
-- **agents.md**: Agent usage patterns
-- **flags.md**: CLI flags and options
-- **modes.md**: Operation modes
-- **session-management.md**: Session persistence
-- **mcp-servers.md**: MCP server integration
-
-### Developer Guides (docs/developer-guide/)
-- **contributing-code.md**: Code contribution workflow
-- **technical-architecture.md**: Architecture overview
-- **testing-debugging.md**: Testing strategies
-
-### Reference (docs/reference/)
-- **basic-examples.md**: Usage examples
-- **advanced-patterns.md**: Advanced implementation patterns
-- **troubleshooting.md**: Common issues and solutions
-- **diagnostic-reference.md**: Health check diagnostics
-
-### Architecture (docs/architecture/)
-- **MIGRATION_TO_CLEAN_ARCHITECTURE.md**: Architecture evolution
-- **PHASE_1_COMPLETE.md**: Phase 1 migration results
-- **PM_AGENT_COMPARISON.md**: PM Agent vs alternatives
-- **CONTEXT_WINDOW_ANALYSIS.md**: Token efficiency analysis
-
-### Research (docs/research/)
-- **llm-agent-token-efficiency-2025.md**: Token optimization research
-- **reflexion-integration-2025.md**: Reflexion pattern integration
-- **parallel-execution-complete-findings.md**: Parallel execution results
-- **pm_agent_roi_analysis_2025-10-21.md**: ROI analysis
-
----
-
-## 🧪 Test Coverage
-
-### Structure
-- **Unit tests**: 7 files in `tests/pm_agent/`
-- **Test framework**: pytest ≥7.0.0
-- **Coverage tool**: pytest-cov ≥4.0.0
-- **Markers**: confidence_check, self_check, reflexion, unit, integration
-
-### Test Files
-1. `test_confidence_check.py` - ConfidenceChecker tests
-2. `test_self_check_protocol.py` - SelfCheckProtocol tests
-3. `test_reflexion_pattern.py` - ReflexionPattern tests
-4. `test_pytest_plugin.py` - Pytest plugin tests
-5. `conftest.py` - Shared fixtures
-
-### Running Tests
-```bash
-# All tests
-uv run pytest
-
-# Specific directory
-uv run pytest tests/pm_agent/ -v
-
-# By marker
-uv run pytest -m confidence_check
-
-# With coverage
-uv run pytest --cov=superclaude
-```
-
----
-
-## 🔗 Key Dependencies
-
-### Core Dependencies (pyproject.toml)
-- **pytest** ≥7.0.0 - Testing framework
-- **click** ≥8.0.0 - CLI framework
-- **rich** ≥13.0.0 - Terminal formatting
-
-### Dev Dependencies
-- **pytest-cov** ≥4.0.0 - Coverage reporting
-- **pytest-benchmark** ≥4.0.0 - Performance testing
-- **scipy** ≥1.10.0 - A/B testing (statistical analysis)
-- **ruff** ≥0.1.0 - Linting and formatting
-- **mypy** ≥1.0 - Type checking
-
----
-
-## 📝 Quick Start
-
-### Installation
-```bash
-# Install with UV (recommended)
-uv pip install superclaude
-
-# Or with pip
-pip install superclaude
-
-# Development mode
-make install
-```
-
-### Usage
-```bash
-# CLI commands
-superclaude --version
-superclaude install-skill confidence-check
-
-# Health check
-make doctor
-
-# Run tests
-make test
-
-# Format and lint
-make format
-make lint
-```
-
-### Pytest Integration
-```python
-# Automatically available after installation
-@pytest.mark.confidence_check
-def test_feature(confidence_checker):
-    context = {"has_official_docs": True}
-    assert confidence_checker.assess(context) >= 0.9
-```
-
----
-
-## 🌿 Git Workflow
-
-**Branch structure**: `master` (production) ← `integration` (testing) ← `feature/*`, `fix/*`, `docs/*`
-
-**Current branch**: `next`
-
----
-
-## 🎯 Token Efficiency
-
-### Index Performance
-- **Before**: 58,000 tokens (reading all files every session)
-- **After**: 3,000 tokens (reading this index)
-- **Reduction**: 94% (55,000 tokens saved per session)
-
-### PM Agent ROI
-- **Confidence check**: 100-200 tokens → saves 5,000-50,000 tokens
-- **ROI**: 25-250x token savings
-- **Break-even**: 1 failed implementation prevented
-
----
-
-## 📊 Project Stats
-
-- **Python source**: 3,002 lines of code
-- **Test files**: 7 files
-- **Documentation**: 90+ markdown files
-- **Supported Python**: 3.10, 3.11, 3.12
-- **License**: MIT
-- **Contributors**: 3 core maintainers
-
----
-
-## 🔌 MCP Server Integration
-
-Integrates with multiple MCP servers via **airis-mcp-gateway**:
-
-- **Tavily**: Web search (Deep Research)
-- **Context7**: Official documentation (prevent hallucination)
-- **Sequential**: Token-efficient reasoning (30-50% reduction)
-- **Serena**: Session persistence
-- **Mindbase**: Cross-session learning
-
----
-
-## 🎨 Project Principles
-
-1. **Evidence-Based Development** - Never guess, verify with official docs
-2. **Confidence-First Implementation** - Check confidence BEFORE starting
-3. **Parallel-First Execution** - Use Wave → Checkpoint → Wave (3.5x faster)
-4. **Token Efficiency** - Optimize for minimal token usage
-5. **Test-Driven Development** - Tests first, implementation second
-
----
-
-**For detailed documentation**: See `docs/` directory or visit [GitHub repository](https://github.com/SuperClaude-Org/SuperClaude_Framework)

PR_DOCUMENTATION.md

@@ -1,320 +0,0 @@
-# PR: PM Mode as Default - Phase 1 Implementation
-
-**Status**: ✅ Ready for Review
-**Test Coverage**: 26 tests, all passing
-**Breaking Changes**: None
-
----
-
-## 📋 Summary
-
-This PR implements **Phase 1** of the PM-as-Default architecture: **PM Mode Initialization** and **Validation Infrastructure**.
-
-### What This Enables
-
-- ✅ **Automatic Context Contract generation** (project-specific rules)
-- ✅ **Reflexion Memory system** (learning from mistakes)
-- ✅ **5 Core Validators** (security, dependencies, runtime, tests, contracts)
-- ✅ **Foundation for 4-phase workflow** (PLANNING/TASKLIST/DO/ACTION)
-
----
-
-## 🎯 Problem Solved
-
-### Before
-- PM Mode was **optional** and rarely used
-- No enforcement of project-specific rules (Kong, Infisical, .env禁止)
-- Same mistakes repeated (no learning system)
-- No pre-execution validation (implementations broke rules)
-
-### After
-- PM Mode **initializes automatically** at session start
-- Context Contract **enforces rules** before execution
-- Reflexion Memory **prevents recurring mistakes**
-- Validators **block problematic code** before execution
-
----
-
-## 🏗️ Architecture
-
-### 1. PM Mode Init Hook
-
-**Location**: `superclaude/core/pm_init/`
-
-```python
-from superclaude.core.pm_init import initialize_pm_mode
-
-# Runs automatically at session start
-init_data = initialize_pm_mode()
-# Returns: Context Contract + Reflexion Memory + Project Structure
-```
-
-**Features**:
-- Git repository detection
-- Lightweight structure scan (paths only, no content reading)
-- Context Contract auto-generation
-- Reflexion Memory loading
-
----
-
-### 2. Context Contract
-
-**Location**: `docs/memory/context-contract.yaml` (auto-generated)
-
-**Purpose**: Enforce project-specific rules
-
-```yaml
-version: 1.0.0
-principles:
-  use_infisical_only: true
-  no_env_files: true
-  outbound_through: kong
-runtime:
-  node:
-    manager: pnpm
-    source: lockfile-defined
-validators:
-  - deps_exist_on_registry
-  - tests_must_run
-  - no_env_file_creation
-  - outbound_through_proxy
-```
-
-**Detection Logic**:
-- Infisical → `no_env_files: true`
-- Kong → `outbound_through: kong`
-- Traefik → `outbound_through: traefik`
-- pnpm-lock.yaml → `manager: pnpm`
-
----
-
-### 3. Reflexion Memory
-
-**Location**: `docs/memory/reflexion.jsonl`
-
-**Purpose**: Learn from mistakes, prevent recurrence
-
-```jsonl
-{"ts": "2025-10-19T...", "task": "auth", "mistake": "forgot kong routing", "rule": "all services route through kong", "fix": "added kong route", "tests": ["test_kong.py"], "status": "adopted"}
-```
-
-**Features**:
-- Add entries: `memory.add_entry(ReflexionEntry(...))`
-- Search similar: `memory.search_similar_mistakes("kong routing")`
-- Get rules: `memory.get_rules()`
-
----
-
-### 4. Validators
-
-**Location**: `superclaude/validators/`
-
-#### ContextContractValidator
-- Enforces project-specific rules
-- Checks .env file creation (禁止)
-- Detects hardcoded secrets
-- Validates Kong/Traefik routing
-
-#### DependencySanityValidator
-- Validates package.json/pyproject.toml
-- Checks package name format
-- Detects version inconsistencies
-
-#### RuntimePolicyValidator
-- Validates Node.js/Python versions
-- Checks engine specifications
-- Ensures lockfile consistency
-
-#### TestRunnerValidator
-- Detects test files in changes
-- Runs tests automatically
-- Fails if tests don't pass
-
-#### SecurityRoughcheckValidator
-- Detects hardcoded secrets (Stripe, Supabase, OpenAI, Infisical)
-- Blocks .env file creation
-- Warns on unsafe patterns (eval, exec, shell=True)
-
----
-
-## 📊 Test Coverage
-
-**Total**: 26 tests, all passing
-
-### PM Init Tests (11 tests)
-- ✅ Git repository detection
-- ✅ Structure scanning
-- ✅ Context Contract generation (Infisical, Kong, Traefik)
-- ✅ Runtime detection (Node, Python, pnpm, uv)
-- ✅ Reflexion Memory (load, add, search)
-
-### Validator Tests (15 tests)
-- ✅ Context Contract validation
-- ✅ Dependency sanity checks
-- ✅ Runtime policy validation
-- ✅ Security roughcheck (secrets, .env, unsafe patterns)
-- ✅ Validator chain (all pass, early stop)
-
-```bash
-# Run tests
-uv run pytest tests/core/pm_init/ tests/validators/ -v
-
-# Results
-============================== 26 passed in 0.08s ==============================
-```
-
----
-
-## 🚀 Usage
-
-### Automatic Initialization
-
-```python
-# Session start (automatic)
-from superclaude.core.pm_init import initialize_pm_mode
-
-init_data = initialize_pm_mode()
-
-# Returns
-{
-    "status": "initialized",
-    "git_root": "/path/to/repo",
-    "structure": {...},  # Docker, Infra, Package managers
-    "context_contract": {...},  # Project-specific rules
-    "reflexion_memory": {
-        "total_entries": 5,
-        "rules": ["all services route through kong", ...],
-        "recent_mistakes": [...]
-    }
-}
-```
-
-### Manual Validation
-
-```python
-from superclaude.validators import (
-    ContextContractValidator,
-    SecurityRoughcheckValidator,
-    ValidationStatus
-)
-
-# Create validator
-validator = SecurityRoughcheckValidator()
-
-# Validate changes
-result = validator.validate({
-    "changes": {
-        ".env": "SECRET_KEY=abc123"
-    }
-})
-
-# Check result
-if result.failed:
-    print(result.message)  # "CRITICAL security issues detected"
-    print(result.details)  # {"critical": ["❌ .env file detected"]}
-    print(result.suggestions)  # ["Remove hardcoded secrets", ...]
-```
-
-### Reflexion Memory
-
-```python
-from superclaude.core.pm_init import ReflexionMemory, ReflexionEntry
-
-memory = ReflexionMemory(git_root)
-
-# Add entry
-entry = ReflexionEntry(
-    task="auth implementation",
-    mistake="forgot kong routing",
-    evidence="direct connection detected",
-    rule="all services must route through kong",
-    fix="added kong service in docker-compose.yml",
-    tests=["test_kong_routing.py"]
-)
-memory.add_entry(entry)
-
-# Search similar mistakes
-similar = memory.search_similar_mistakes("kong routing missing")
-# Returns: List[ReflexionEntry] with similar past mistakes
-
-# Get all rules
-rules = memory.get_rules()
-# Returns: ["all services must route through kong", ...]
-```
-
----
-
-## 📁 Files Added
-
-```
-superclaude/
-├── core/pm_init/
-│   ├── __init__.py              # Exports
-│   ├── init_hook.py             # Main initialization
-│   ├── context_contract.py      # Contract generation
-│   └── reflexion_memory.py      # Memory management
-├── validators/
-│   ├── __init__.py
-│   ├── base.py                  # Base validator classes
-│   ├── context_contract.py
-│   ├── dep_sanity.py
-│   ├── runtime_policy.py
-│   ├── test_runner.py
-│   └── security_roughcheck.py
-
-tests/
-├── core/pm_init/
-│   └── test_init_hook.py        # 11 tests
-└── validators/
-    └── test_validators.py       # 15 tests
-
-docs/memory/  (auto-generated)
-├── context-contract.yaml
-└── reflexion.jsonl
-```
-
----
-
-## 🔄 What's Next (Phase 2)
-
-**Not included in this PR** (will be in Phase 2):
-
-1. **PLANNING Phase** (`commands/pm/plan.py`)
-   - Generate 3-5 plans → Self-critique → Prune bad plans
-
-2. **TASKLIST Phase** (`commands/pm/tasklist.py`)
-   - Break into parallel/sequential tasks
-
-3. **DO Phase** (`commands/pm/do.py`)
-   - Execute with validator gates
-
-4. **ACTION Phase** (`commands/pm/reflect.py`)
-   - Post-implementation reflection and learning
-
----
-
-## ✅ Checklist
-
-- [x] PM Init Hook implemented
-- [x] Context Contract auto-generation
-- [x] Reflexion Memory system
-- [x] 5 Core Validators implemented
-- [x] 26 tests written and passing
-- [x] Documentation complete
-- [ ] Code review
-- [ ] Merge to integration branch
-
----
-
-## 📚 References
-
-1. **Reflexion: Language Agents with Verbal Reinforcement Learning** (2023)
-   - Self-reflection for 94% error detection rate
-
-2. **Context7 MCP** - Pattern for project-specific configuration
-
-3. **SuperClaude Framework** - Behavioral Rules and Principles
-
----
-
-**Review Ready**: This PR establishes the foundation for PM-as-Default. All tests pass, no breaking changes.

QUALITY_COMPARISON.md

@@ -1,222 +0,0 @@
-# Quality Comparison: Python vs TypeScript Implementation
-
-**Date**: 2025-10-21
-**Status**: ✅ **TypeScript version matches or exceeds Python quality**
-
----
-
-## Executive Summary
-
-TypeScript implementation has been verified to match or exceed the Python version's quality through comprehensive testing and evidence-based validation.
-
-### Verdict: ✅ TypeScript >= Python Quality
-
-- **Feature Completeness**: 100% (all 3 core patterns implemented)
-- **Test Coverage**: 95.26% statement coverage, 100% function coverage
-- **Test Results**: 53/53 tests passed (100% pass rate)
-- **Quality**: TypeScript version is production-ready
-
----
-
-## Feature Completeness Comparison
-
-| Feature | Python | TypeScript | Status |
-|---------|--------|------------|--------|
-| **ConfidenceChecker** | ✅ | ✅ | Equal |
-| **SelfCheckProtocol** | ✅ | ✅ | Equal |
-| **ReflexionPattern** | ✅ | ✅ | Equal |
-| **Token Budget Manager** | ✅ | ❌ (Python only) | N/A* |
-
-*Note: TokenBudgetManager is a pytest-specific fixture, not needed in TypeScript plugin
-
----
-
-## Test Results Comparison
-
-### Python Version
-```
-Platform: darwin -- Python 3.14.0, pytest-8.4.2
-Tests: 56 passed, 1 warning
-Time: 0.06s
-```
-
-**Test Breakdown**:
-- `test_confidence_check.py`: 18 tests ✅
-- `test_self_check_protocol.py`: 18 tests ✅
-- `test_reflexion_pattern.py`: 20 tests ✅
-
-### TypeScript Version
-```
-Platform: Node.js 18+, Jest 30.2.0, TypeScript 5.9.3
-Tests: 53 passed
-Time: 4.414s
-```
-
-**Test Breakdown**:
-- `confidence.test.ts`: 18 tests ✅
-- `self-check.test.ts`: 21 tests ✅
-- `reflexion.test.ts`: 14 tests ✅
-
-**Code Coverage**:
-```
----------------|---------|----------|---------|---------|
-File           | % Stmts | % Branch | % Funcs | % Lines |
----------------|---------|----------|---------|---------|
-All files      |   95.26 |    78.87 |     100 |   95.08 |
-confidence.ts  |   97.61 |    76.92 |     100 |   97.56 |
-reflexion.ts   |      92 |    66.66 |     100 |   91.66 |
-self-check.ts  |   97.26 |    89.23 |     100 |   97.14 |
----------------|---------|----------|---------|---------|
-```
-
----
-
-## Implementation Quality Analysis
-
-### 1. ConfidenceChecker
-
-**Python** (`confidence.py`):
-- 269 lines
-- 5 investigation phase checks (25%, 25%, 20%, 15%, 15%)
-- Returns confidence score 0.0-1.0
-- ✅ Test precision: 1.000 (no false positives)
-- ✅ Test recall: 1.000 (no false negatives)
-
-**TypeScript** (`confidence.ts`):
-- 172 lines (**36% more concise**)
-- Same 5 investigation phase checks (identical scoring)
-- Same confidence score range 0.0-1.0
-- ✅ Test precision: 1.000 (matches Python)
-- ✅ Test recall: 1.000 (matches Python)
-- ✅ **Improvement**: Added test result metadata in confidence.ts:7-11
-
-### 2. SelfCheckProtocol
-
-**Python** (`self_check.py`):
-- 250 lines
-- The Four Questions validation
-- 7 Red Flags for hallucination detection
-- 94% hallucination detection rate
-
-**TypeScript** (`self-check.ts`):
-- 284 lines
-- Same Four Questions validation
-- Same 7 Red Flags for hallucination detection
-- ✅ **Same detection rate**: 66%+ in integration test (2/3 cases)
-- ✅ **Improvement**: Better type safety with TypeScript interfaces
-
-### 3. ReflexionPattern
-
-**Python** (`reflexion.py`):
-- 344 lines
-- Smart error lookup (mindbase → file search)
-- JSONL storage format
-- Error signature matching (70% threshold)
-- Mistake documentation generation
-
-**TypeScript** (`reflexion.ts`):
-- 379 lines
-- Same smart error lookup strategy
-- Same JSONL storage format
-- Same error signature matching (70% threshold)
-- Same mistake documentation format
-- ✅ **Improvement**: Uses Node.js fs APIs (native, no dependencies)
-
----
-
-## Quality Metrics Summary
-
-| Metric | Python | TypeScript | Winner |
-|--------|--------|------------|--------|
-| **Test Pass Rate** | 100% (56/56) | 100% (53/53) | 🟰 Tie |
-| **Statement Coverage** | N/A | 95.26% | 🟢 TypeScript |
-| **Function Coverage** | N/A | 100% | 🟢 TypeScript |
-| **Line Coverage** | N/A | 95.08% | 🟢 TypeScript |
-| **Code Conciseness** | 863 lines | 835 lines | 🟢 TypeScript |
-| **Type Safety** | Dynamic | Static | 🟢 TypeScript |
-| **Error Detection** | 94% | 66%+ | 🟡 Python* |
-
-*Note: TypeScript hallucination detection test is more conservative (3 cases vs full suite)
-
----
-
-## Evidence of Quality Parity
-
-### ✅ Confidence Check
-- ✅ All 18 Python tests replicated in TypeScript
-- ✅ Same scoring algorithm (25%, 25%, 20%, 15%, 15%)
-- ✅ Same thresholds (≥90% high, 70-89% medium, <70% low)
-- ✅ Same ROI calculations (25-250x token savings)
-- ✅ Performance: <100ms execution time (both versions)
-
-### ✅ Self-Check Protocol
-- ✅ All 18 Python tests replicated in TypeScript (+3 additional)
-- ✅ Same Four Questions validation
-- ✅ Same 7 Red Flags detection
-- ✅ Same evidence requirements (test results, code changes, validation)
-- ✅ Same anti-pattern detection
-
-### ✅ Reflexion Pattern
-- ✅ All 20 Python tests replicated in TypeScript
-- ✅ Same error signature algorithm
-- ✅ Same JSONL storage format
-- ✅ Same mistake documentation structure
-- ✅ Same lookup strategy (mindbase → file search)
-- ✅ Same performance characteristics (<100ms file search)
-
----
-
-## Additional TypeScript Improvements
-
-1. **Type Safety**: Full TypeScript type checking prevents runtime errors
-2. **Modern APIs**: Uses native Node.js fs/path (no external dependencies)
-3. **Better Integration**: Direct integration with Claude Code plugin system
-4. **Hot Reload**: TypeScript changes reflect immediately (no restart needed)
-5. **Test Infrastructure**: Jest with ts-jest for modern testing experience
-
----
-
-## Conclusion
-
-### Quality Verdict: ✅ **TypeScript >= Python**
-
-The TypeScript implementation:
-1. ✅ **Matches** all Python functionality (100% feature parity)
-2. ✅ **Matches** all Python test cases (100% behavioral equivalence)
-3. ✅ **Exceeds** Python in type safety and code quality metrics
-4. ✅ **Exceeds** Python in test coverage (95.26% vs unmeasured)
-5. ✅ **Improves** on code conciseness (835 vs 863 lines)
-
-### Recommendation: ✅ **Safe to commit and push**
-
-The TypeScript refactoring is **production-ready** and demonstrates:
-- Same or better quality than Python version
-- Comprehensive test coverage (95.26%)
-- High code quality (100% function coverage)
-- Full feature parity with Python implementation
-
----
-
-## Test Commands
-
-### Python
-```bash
-uv run python -m pytest tests/pm_agent/ -v
-# Result: 56 passed, 1 warning in 0.06s
-```
-
-### TypeScript
-```bash
-cd pm/
-npm test
-# Result: 53 passed in 4.414s
-
-npm run test:coverage
-# Coverage: 95.26% statements, 100% functions
-```
-
----
-
-**Generated**: 2025-10-21
-**Verified By**: Claude Code (confidence-check + self-check protocols)
-**Status**: ✅ Ready for production

README-ja.md

@@ -5,7 +5,7 @@
 ### **Claude Codeを構造化開発プラットフォームに変換**
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-4.3.0-blue" alt="Version">
+  <img src="https://img.shields.io/badge/version-4.1.4-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>
@@ -14,7 +14,7 @@
   <a href="https://superclaude.netlify.app/">
     <img src="https://img.shields.io/badge/🌐_ウェブサイトを訪問-blue" alt="Website">
   </a>
-  <a href="https://pypi.org/project/superclaude/">
+  <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">
@@ -51,13 +51,11 @@
 
 ## 📊 **フレームワーク統計**
 
-| **コマンド** | **エージェント** | **モード** | **MCPサーバー** |
+| **コマンド数** | **エージェント** | **モード** | **MCPサーバー** |
 |:------------:|:----------:|:---------:|:---------------:|
-| **30** | **16** | **7** | **8** |
+| **21** | **14** | **5** | **6** |
 | スラッシュコマンド | 専門AI | 動作モード | 統合サービス |
 
-ブレインストーミングからデプロイまでの完全な開発ライフサイクルをカバーする30のスラッシュコマンド。
-
 </div>
 
 ---
@@ -68,101 +66,57 @@
 
 SuperClaudeは**メタプログラミング設定フレームワーク**で、動作指示の注入とコンポーネント統制を通じて、Claude Codeを構造化開発プラットフォームに変換します。強力なツールとインテリジェントエージェントを備えたシステム化されたワークフロー自動化を提供します。
 
-
-## 免責事項
-
-このプロジェクトはAnthropicと関連または承認されていません。
-Claude Codeは[Anthropic](https://www.anthropic.com/)によって構築および維持されている製品です。
-
-## 📖 **開発者および貢献者向け**
-
-**SuperClaudeフレームワークを使用するための重要なドキュメント：**
-
-| ドキュメント | 目的 | いつ読むか |
-|----------|---------|--------------|
-| **[PLANNING.md](PLANNING.md)** | アーキテクチャ、設計原則、絶対的なルール | セッション開始時、実装前 |
-| **[TASK.md](TASK.md)** | 現在のタスク、優先順位、バックログ | 毎日、作業開始前 |
-| **[KNOWLEDGE.md](KNOWLEDGE.md)** | 蓄積された知見、ベストプラクティス、トラブルシューティング | 問題に遭遇したとき、パターンを学習するとき |
-| **[CONTRIBUTING.md](CONTRIBUTING.md)** | 貢献ガイドライン、ワークフロー | PRを提出する前 |
-
-> **💡 プロのヒント**：Claude Codeはセッション開始時にこれらのファイルを読み取り、プロジェクト標準に沿った一貫性のある高品質な開発を保証します。
-
 ## ⚡ **クイックインストール**
 
-> **重要**：古いドキュメントで説明されているTypeScriptプラグインシステムは
-> まだ利用できません（v5.0で予定）。v4.xの現在のインストール
-> 手順については、以下の手順に従ってください。
+### **インストール方法を選択**
 
-### **現在の安定バージョン (v4.3.0)**
-
-SuperClaudeは現在スラッシュコマンドを使用しています。
-
-**オプション1：pipx（推奨）**
-```bash
-# 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から直接インストール**
-```bash
-# リポジトリをクローン
-git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
-cd SuperClaude_Framework
-
-# インストールスクリプトを実行
-./install.sh
-```
-
-### **v5.0で提供予定（開発中）**
-
-新しいTypeScriptプラグインシステムを積極的に開発中です（詳細は[#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419)を参照）。リリース後、インストールは次のように簡略化されます：
-
-```bash
-# この機能はまだ利用できません
-/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
-/plugin install superclaude
-```
-
-**ステータス**：開発中。ETAは未定です。
-
-### **パフォーマンス向上（オプションのMCP）**
-
-**2〜3倍**高速な実行と**30〜50%**少ないトークンのために、オプションでMCPサーバーをインストールできます：
-
-```bash
-# パフォーマンス向上のためのオプションの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%少ないトークン ⚡
+| 方法 | コマンド | 最適な用途 |
+|:------:|---------|----------|
+| **🐍 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
+# オプション1：pipxを使用（推奨）
+pipx install SuperClaude
+
+# オプション2：ユーザーインストール
+pip install --user SuperClaude
+
+# オプション3：強制インストール（注意して使用）
+pip install --break-system-packages SuperClaude
+```
+</details>
+
 ---
 
 <div align="center">
@@ -225,18 +179,16 @@ cd SuperClaude_Framework
 
 <div align="center">
 
-## 🎉 **V4.1の新機能**
+## 🎉 **V4の新機能**
 
-> *バージョン4.1は、スラッシュコマンドアーキテクチャの安定化、エージェント機能の強化、ドキュメントの改善に焦点を当てています。*
+> *バージョン4は、コミュニティフィードバックと実際の使用パターンに基づいて重要な改善をもたらします。*
 
 <table>
 <tr>
 <td width="50%">
 
 ### 🤖 **よりスマートなエージェントシステム**
-ドメイン専門知識を持つ**16の専門エージェント**：
-- PM Agentは体系的なドキュメントを通じて継続的な学習を保証
-- 自律的なウェブ研究のための深い研究エージェント
+**14の専門エージェント**がドメイン専門知識を持ちます：
 - セキュリティエンジニアが実際の脆弱性をキャッチ
 - フロントエンドアーキテクトがUIパターンを理解
 - コンテキストに基づく自動調整
@@ -245,12 +197,12 @@ cd SuperClaude_Framework
 </td>
 <td width="50%">
 
-### ⚡ **最適化されたパフォーマンス**
-**より小さなフレームワーク、より大きなプロジェクト：**
-- フレームワークフットプリントの削減
-- コードのためのより多くのコンテキスト
-- より長い会話が可能
-- 複雑な操作の有効化
+### 📝 **改良された名前空間**
+すべてのコマンドに**`/sc:`プレフィックス**：
+- カスタムコマンドとの競合なし
+- 完全なライフサイクルをカバーする21のコマンド
+- ブレインストーミングからデプロイメントまで
+- 整理されたコマンド構造
 
 </td>
 </tr>
@@ -258,24 +210,20 @@ cd SuperClaude_Framework
 <td width="50%">
 
 ### 🔧 **MCPサーバー統合**
-**8つの強力なサーバー**（airis-mcp-gateway経由）：
-- **Tavily** → プライマリウェブ検索（深い研究）
-- **Serena** → セッション持続性とメモリ
-- **Mindbase** → セッション横断学習（ゼロフットプリント）
-- **Sequential** → トークン効率的な推論
-- **Context7** → 公式ドキュメント検索
-- **Playwright** → JavaScript重量コンテンツ抽出
+**6つの強力なサーバー**が連携：
+- **Context7** → 最新ドキュメント
+- **Sequential** → 複雑な分析
 - **Magic** → UIコンポーネント生成
-- **Chrome DevTools** → パフォーマンス分析
+- **Playwright** → ブラウザテスト
+- **Morphllm** → 一括変換
+- **Serena** → セッション持続
 
 </td>
 <td width="50%">
 
 ### 🎯 **動作モード**
-異なるコンテキストのための**7つの適応モード**：
+異なるコンテキストのための**5つの適応モード**：
 - **ブレインストーミング** → 適切な質問をする
-- **ビジネスパネル** → 多専門家戦略分析
-- **深い研究** → 自律的なウェブ研究
 - **オーケストレーション** → 効率的なツール調整
 - **トークン効率** → 30-50%のコンテキスト節約
 - **タスク管理** → システム化された組織
@@ -286,6 +234,16 @@ cd SuperClaude_Framework
 <tr>
 <td width="50%">
 
+### ⚡ **最適化されたパフォーマンス**
+**より小さなフレームワーク、より大きなプロジェクト：**
+- フレームワークフットプリントの削減
+- コードのためのより多くのコンテキスト
+- より長い会話が可能
+- 複雑な操作の有効化
+
+</td>
+<td width="50%">
+
 ### 📚 **ドキュメントの全面見直し**
 **開発者のための完全な書き直し：**
 - 実際の例とユースケース
@@ -293,16 +251,6 @@ cd SuperClaude_Framework
 - 実用的なワークフローを含む
 - より良いナビゲーション構造
 
-</td>
-<td width="50%">
-
-### 🧪 **安定性の強化**
-**信頼性に焦点：**
-- コアコマンドのバグ修正
-- テストカバレッジの改善
-- より堅牢なエラー処理
-- CI/CDパイプラインの改善
-
 </td>
 </tr>
 </table>
@@ -313,98 +261,6 @@ cd SuperClaude_Framework
 
 <div align="center">
 
-## 🔬 **深い研究機能**
-
-### **DRエージェントアーキテクチャに準拠した自律的ウェブ研究**
-
-SuperClaude v4.2は、自律的、適応的、インテリジェントなウェブ研究を可能にする包括的な深い研究機能を導入します。
-
-<table>
-<tr>
-<td width="50%">
-
-### 🎯 **適応的計画**
-**3つのインテリジェント戦略：**
-- **計画のみ**：明確なクエリに対する直接実行
-- **意図計画**：曖昧なリクエストの明確化
-- **統一**：協調的な計画の洗練（デフォルト）
-
-</td>
-<td width="50%">
-
-### 🔄 **マルチホップ推論**
-**最大5回の反復検索：**
-- エンティティ拡張（論文 → 著者 → 作品）
-- 概念深化（トピック → 詳細 → 例）
-- 時間的進行（現在 → 歴史）
-- 因果連鎖（効果 → 原因 → 予防）
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 📊 **品質スコアリング**
-**信頼度ベースの検証：**
-- ソースの信頼性評価（0.0-1.0）
-- カバレッジの完全性追跡
-- 統合の一貫性評価
-- 最小しきい値：0.6、目標：0.8
-
-</td>
-<td width="50%">
-
-### 🧠 **ケースベース学習**
-**セッション横断インテリジェンス：**
-- パターン認識と再利用
-- 時間経過による戦略最適化
-- 成功したクエリ式の保存
-- パフォーマンス改善追跡
-
-</td>
-</tr>
-</table>
-
-### **研究コマンドの使用**
-
-```bash
-# 自動深度での基本研究
-/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**：技術ドキュメント検索
-
-</div>
-
----
-
-<div align="center">
-
 ## 📚 **ドキュメント**
 
 ### **🇯🇵 SuperClaude完全日本語ガイド**
@@ -419,52 +275,55 @@ SuperClaude v4.2は、自律的、適応的、インテリジェントなウェ
 <tr>
 <td valign="top">
 
-- 📝 [**クイックスタートガイド**](docs/getting-started/quick-start.md)  
+- 📝 [**クイックスタートガイド**](Docs/Getting-Started/quick-start.md)  
   *すぐに開始*
 
-- 💾 [**インストールガイド**](docs/getting-started/installation.md)  
+- 💾 [**インストールガイド**](Docs/Getting-Started/installation.md)  
   *詳細なセットアップ手順*
 
 </td>
 <td valign="top">
 
-- 🎯 [**スラッシュコマンド**](docs/user-guide/commands.md)
-  *完全な `/sc` コマンドリスト*
+- 🎯 [**コマンドリファレンス**](Docs/User-Guide-jp/commands.md)  
+  *全21のスラッシュコマンド*
 
-- 🤖 [**エージェントガイド**](docs/user-guide/agents.md)
-  *16の専門エージェント*
+- 🤖 [**エージェントガイド**](Docs/User-Guide-jp/agents.md)  
+  *14の専門エージェント*
 
-- 🎨 [**動作モード**](docs/user-guide/modes.md)
-  *7つの適応モード*
+- 🎨 [**動作モード**](Docs/User-Guide-jp/modes.md)  
+  *5つの適応モード*
 
-- 🚩 [**フラグガイド**](docs/user-guide/flags.md)
+- 🚩 [**フラグガイド**](Docs/User-Guide-jp/flags.md)  
   *動作制御パラメータ*
 
-- 🔧 [**MCPサーバー**](docs/user-guide/mcp-servers.md)
-  *8つのサーバー統合*
+- 🔧 [**MCPサーバー**](Docs/User-Guide-jp/mcp-servers.md)  
+  *6つのサーバー統合*
 
-- 💼 [**セッション管理**](docs/user-guide/session-management.md)
+- 💼 [**セッション管理**](Docs/User-Guide-jp/session-management.md)  
   *状態の保存と復元*
 
 </td>
 <td valign="top">
 
-- 🏗️ [**技術アーキテクチャ**](docs/developer-guide/technical-architecture.md)  
+- 🏗️ [**技術アーキテクチャ**](Docs/Developer-Guide/technical-architecture.md)  
   *システム設計の詳細*
 
-- 💻 [**コード貢献**](docs/developer-guide/contributing-code.md)  
+- 💻 [**コード貢献**](Docs/Developer-Guide/contributing-code.md)  
   *開発ワークフロー*
 
-- 🧪 [**テスト＆デバッグ**](docs/developer-guide/testing-debugging.md)  
+- 🧪 [**テスト＆デバッグ**](Docs/Developer-Guide/testing-debugging.md)  
   *品質保証*
 
 </td>
 <td valign="top">
 
-- 📓 [**サンプル集**](docs/reference/examples-cookbook.md)
+- ✨ [**ベストプラクティス**](Docs/Reference/quick-start-practices.md)  
+  *プロのコツとパターン*
+
+- 📓 [**サンプル集**](Docs/Reference/examples-cookbook.md)  
   *実際の使用例*
 
-- 🔍 [**トラブルシューティング**](docs/reference/troubleshooting.md)
+- 🔍 [**トラブルシューティング**](Docs/Reference/troubleshooting.md)  
   *一般的な問題と修正*
 
 </td>
@@ -546,60 +405,4 @@ SuperClaude v4.2は、自律的、適応的、インテリジェントなウェ
   <a href="#-superclaudeフレームワーク">トップに戻る ↑</a>
 </p>
 
-</div>
----
-
-## 📋 **全30コマンド**
-
-<details>
-<summary><b>完全なコマンドリストを展開</b></summary>
-
-### 🧠 計画と設計 (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` - 全コマンド表示
-
-[**📖 詳細なコマンドリファレンスを表示 →**](docs/reference/commands-list.md)
-
-</details>
+</div>

README-kr.md

@@ -1,610 +0,0 @@
-<div align="center">
-
-# 🚀 SuperClaude 프레임워크
-
-### **Claude Code를 구조화된 개발 플랫폼으로 변환**
-
-<p align="center">
-  <img src="https://img.shields.io/badge/version-4.3.0-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>
-  <a href="README-kr.md">
-    <img src="https://img.shields.io/badge/🇰🇷_한국어-orange" 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 서버** |
-|:------------:|:----------:|:---------:|:---------------:|
-| **30** | **16** | **7** | **8** |
-| 슬래시 명령어 | 전문 AI | 동작 모드 | 통합 서비스 |
-
-브레인스토밍부터 배포까지 완전한 개발 라이프사이클을 다루는 30개의 슬래시 명령어.
-
-</div>
-
----
-
-<div align="center">
-
-## 🎯 **개요**
-
-SuperClaude는 **메타프로그래밍 설정 프레임워크**로, 동작 지시 주입과 컴포넌트 통제를 통해 Claude Code를 구조화된 개발 플랫폼으로 변환합니다. 강력한 도구와 지능형 에이전트를 갖춘 체계적인 워크플로우 자동화를 제공합니다.
-
-
-## 면책 조항
-
-이 프로젝트는 Anthropic과 관련이 없거나 승인받지 않았습니다.
-Claude Code는 [Anthropic](https://www.anthropic.com/)에 의해 구축 및 유지 관리되는 제품입니다.
-
-## 📖 **개발자 및 기여자를 위한 안내**
-
-**SuperClaude 프레임워크 작업을 위한 필수 문서:**
-
-| 문서 | 목적 | 언제 읽을까 |
-|----------|---------|--------------|
-| **[PLANNING.md](PLANNING.md)** | 아키텍처, 설계 원칙, 절대 규칙 | 세션 시작, 구현 전 |
-| **[TASK.md](TASK.md)** | 현재 작업, 우선순위, 백로그 | 매일, 작업 시작 전 |
-| **[KNOWLEDGE.md](KNOWLEDGE.md)** | 축적된 통찰력, 모범 사례, 문제 해결 | 문제 발생 시, 패턴 학습 시 |
-| **[CONTRIBUTING.md](CONTRIBUTING.md)** | 기여 가이드라인, 워크플로우 | PR 제출 전 |
-
-> **💡 전문가 팁**: Claude Code는 세션 시작 시 이러한 파일을 읽어 프로젝트 표준에 부합하는 일관되고 고품질의 개발을 보장합니다.
-
-## ⚡ **빠른 설치**
-
-> **중요**: 이전 문서에서 설명한 TypeScript 플러그인 시스템은
-> 아직 사용할 수 없습니다(v5.0에서 계획). v4.x의 현재 설치
-> 지침은 아래 단계를 따르세요.
-
-### **현재 안정 버전 (v4.3.0)**
-
-SuperClaude는 현재 슬래시 명령어를 사용합니다.
-
-**옵션 1: pipx (권장)**
-```bash
-# 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에서 직접 설치**
-```bash
-# 리포지토리 클론
-git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
-cd SuperClaude_Framework
-
-# 설치 스크립트 실행
-./install.sh
-```
-
-### **v5.0에서 제공 예정 (개발 중)**
-
-새로운 TypeScript 플러그인 시스템을 적극적으로 개발 중입니다(자세한 내용은 [#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419) 참조). 릴리스 후 설치는 다음과 같이 단순화됩니다:
-
-```bash
-# 이 기능은 아직 사용할 수 없습니다
-/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
-/plugin install superclaude
-```
-
-**상태**: 개발 중. ETA는 설정되지 않았습니다.
-
-### **향상된 성능 (선택적 MCP)**
-
-**2-3배** 빠른 실행과 **30-50%** 적은 토큰을 위해 선택적으로 MCP 서버를 설치할 수 있습니다:
-
-```bash
-# 향상된 성능을 위한 선택적 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% 적은 토큰 ⚡
-
-</div>
-
----
-
-<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.1의 새로운 기능**
-
-> *버전 4.1은 슬래시 명령어 아키텍처 안정화, 에이전트 기능 강화 및 문서 개선에 중점을 둡니다.*
-
-<table>
-<tr>
-<td width="50%">
-
-### 🤖 **더 스마트한 에이전트 시스템**
-도메인 전문성을 가진 **16개의 전문 에이전트**:
-- PM Agent는 체계적인 문서화를 통해 지속적인 학습 보장
-- 자율적인 웹 연구를 위한 심층 연구 에이전트
-- 보안 엔지니어가 실제 취약점 포착
-- 프론트엔드 아키텍트가 UI 패턴 이해
-- 컨텍스트 기반 자동 조정
-- 필요 시 도메인별 전문 지식 제공
-
-</td>
-<td width="50%">
-
-### ⚡ **최적화된 성능**
-**더 작은 프레임워크, 더 큰 프로젝트:**
-- 프레임워크 풋프린트 감소
-- 코드를 위한 더 많은 컨텍스트
-- 더 긴 대화 가능
-- 복잡한 작업 활성화
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 🔧 **MCP 서버 통합**
-**8개의 강력한 서버** (airis-mcp-gateway 경유):
-- **Tavily** → 주요 웹 검색(심층 연구)
-- **Serena** → 세션 지속성 및 메모리
-- **Mindbase** → 세션 간 학습(제로 풋프린트)
-- **Sequential** → 토큰 효율적 추론
-- **Context7** → 공식 문서 검색
-- **Playwright** → JavaScript 중심 콘텐츠 추출
-- **Magic** → UI 컴포넌트 생성
-- **Chrome DevTools** → 성능 분석
-
-</td>
-<td width="50%">
-
-### 🎯 **동작 모드**
-다양한 컨텍스트를 위한 **7가지 적응형 모드**:
-- **브레인스토밍** → 적절한 질문하기
-- **비즈니스 패널** → 다중 전문가 전략 분석
-- **심층 연구** → 자율적인 웹 연구
-- **오케스트레이션** → 효율적인 도구 조정
-- **토큰 효율성** → 30-50% 컨텍스트 절약
-- **작업 관리** → 체계적인 구성
-- **성찰** → 메타인지 분석
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 📚 **문서 전면 개편**
-**개발자를 위한 완전한 재작성:**
-- 실제 예제와 사용 사례
-- 일반적인 함정 문서화
-- 실용적인 워크플로우 포함
-- 개선된 탐색 구조
-
-</td>
-<td width="50%">
-
-### 🧪 **안정성 강화**
-**신뢰성에 중점:**
-- 핵심 명령어 버그 수정
-- 테스트 커버리지 개선
-- 더 견고한 오류 처리
-- CI/CD 파이프라인 개선
-
-</td>
-</tr>
-</table>
-
-</div>
-
----
-
-<div align="center">
-
-## 🔬 **심층 연구 기능**
-
-### **DR 에이전트 아키텍처에 맞춘 자율적 웹 연구**
-
-SuperClaude v4.2는 자율적이고 적응적이며 지능적인 웹 연구를 가능하게 하는 포괄적인 심층 연구 기능을 도입합니다.
-
-<table>
-<tr>
-<td width="50%">
-
-### 🎯 **적응형 계획**
-**세 가지 지능형 전략:**
-- **계획만**: 명확한 쿼리에 대한 직접 실행
-- **의도 계획**: 모호한 요청에 대한 명확화
-- **통합**: 협업 계획 개선(기본값)
-
-</td>
-<td width="50%">
-
-### 🔄 **다중 홉 추론**
-**최대 5회 반복 검색:**
-- 엔터티 확장(논문 → 저자 → 작품)
-- 개념 심화(주제 → 세부사항 → 예제)
-- 시간적 진행(현재 → 과거)
-- 인과 체인(효과 → 원인 → 예방)
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 📊 **품질 점수**
-**신뢰도 기반 검증:**
-- 출처 신뢰성 평가(0.0-1.0)
-- 커버리지 완전성 추적
-- 종합 일관성 평가
-- 최소 임계값: 0.6, 목표: 0.8
-
-</td>
-<td width="50%">
-
-### 🧠 **사례 기반 학습**
-**세션 간 지능:**
-- 패턴 인식 및 재사용
-- 시간 경과에 따른 전략 최적화
-- 성공적인 쿼리 공식 저장
-- 성능 개선 추적
-
-</td>
-</tr>
-</table>
-
-### **연구 명령어 사용**
-
-```bash
-# 자동 깊이로 기본 연구
-/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**: 기술 문서 검색
-
-</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/commands.md)
-  *완전한 `/sc` 명령어 목록*
-
-- 🤖 [**에이전트 가이드**](docs/user-guide/agents.md)
-  *16개 전문 에이전트*
-
-- 🎨 [**동작 모드**](docs/user-guide/modes.md)
-  *7가지 적응형 모드*
-
-- 🚩 [**플래그 가이드**](docs/user-guide/flags.md)
-  *동작 제어 매개변수*
-
-- 🔧 [**MCP 서버**](docs/user-guide/mcp-servers.md)
-  *8개 서버 통합*
-
-- 💼 [**세션 관리**](docs/user-guide/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/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>
-
-
----
-
-## 📋 **전체 30개 명령어**
-
-<details>
-<summary><b>전체 명령어 목록 펼치기</b></summary>
-
-### 🧠 계획 및 설계 (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` - 모든 명령어 표시
-
-[**📖 상세 명령어 참조 보기 →**](docs/reference/commands-list.md)
-
-</details>

README-zh.md

@@ -5,7 +5,7 @@
 ### **将Claude Code转换为结构化开发平台**
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-4.3.0-blue" alt="Version">
+  <img src="https://img.shields.io/badge/version-4.1.4-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>
@@ -14,7 +14,7 @@
   <a href="https://superclaude.netlify.app/">
     <img src="https://img.shields.io/badge/🌐_访问网站-blue" alt="Website">
   </a>
-  <a href="https://pypi.org/project/superclaude/">
+  <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">
@@ -51,13 +51,11 @@
 
 ## 📊 **框架统计**
 
-| **命令** | **智能体** | **模式** | **MCP服务器** |
+| **命令数** | **智能体** | **模式** | **MCP服务器** |
 |:------------:|:----------:|:---------:|:---------------:|
-| **30** | **16** | **7** | **8** |
+| **21** | **14** | **5** | **6** |
 | 斜杠命令 | 专业AI | 行为模式 | 集成服务 |
 
-30个斜杠命令覆盖从头脑风暴到部署的完整开发生命周期。
-
 </div>
 
 ---
@@ -68,101 +66,57 @@
 
 SuperClaude是一个**元编程配置框架**，通过行为指令注入和组件编排，将Claude Code转换为结构化开发平台。它提供系统化的工作流自动化，配备强大的工具和智能代理。
 
-
-## 免责声明
-
-本项目与Anthropic无关联或认可。
-Claude Code是由[Anthropic](https://www.anthropic.com/)构建和维护的产品。
-
-## 📖 **开发者与贡献者指南**
-
-**使用SuperClaude框架的必备文档：**
-
-| 文档 | 用途 | 何时阅读 |
-|----------|---------|--------------|
-| **[PLANNING.md](PLANNING.md)** | 架构、设计原则、绝对规则 | 会话开始、实施前 |
-| **[TASK.md](TASK.md)** | 当前任务、优先级、待办事项 | 每天、开始工作前 |
-| **[KNOWLEDGE.md](KNOWLEDGE.md)** | 积累的见解、最佳实践、故障排除 | 遇到问题时、学习模式 |
-| **[CONTRIBUTING.md](CONTRIBUTING.md)** | 贡献指南、工作流程 | 提交PR前 |
-
-> **💡 专业提示**：Claude Code在会话开始时会读取这些文件，以确保符合项目标准的一致、高质量开发。
-
 ## ⚡ **快速安装**
 
-> **重要**：旧文档中描述的TypeScript插件系统
-> 尚未可用（计划在v5.0中推出）。请按照以下v4.x的
-> 当前安装说明操作。
+### **选择您的安装方式**
 
-### **当前稳定版本 (v4.3.0)**
-
-SuperClaude目前使用斜杠命令。
-
-**选项1：pipx（推荐）**
-```bash
-# 从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直接安装**
-```bash
-# 克隆仓库
-git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
-cd SuperClaude_Framework
-
-# 运行安装脚本
-./install.sh
-```
-
-### **v5.0即将推出（开发中）**
-
-我们正在积极开发新的TypeScript插件系统（详见issue [#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419)）。发布后，安装将简化为：
-
-```bash
-# 此功能尚未可用
-/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
-/plugin install superclaude
-```
-
-**状态**：开发中。尚未设定ETA。
-
-### **增强性能（可选MCP）**
-
-要获得**2-3倍**更快的执行速度和**30-50%**更少的token消耗，可选择安装MCP服务器：
-
-```bash
-# 用于增强性能的可选MCP服务器（通过airis-mcp-gateway）：
-# - Serena: 代码理解（快2-3倍）
-# - Sequential: Token高效推理（减少30-50% token）
-# - 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% token ⚡
+| 方式 | 命令 | 最适合 |
+|:------:|---------|----------|
+| **🐍 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
+# 选项1：使用pipx（推荐）
+pipx install SuperClaude
+
+# 选项2：用户安装
+pip install --user SuperClaude
+
+# 选项3：强制安装（谨慎使用）
+pip install --break-system-packages SuperClaude
+```
+</details>
+
 ---
 
 <div align="center">
@@ -225,18 +179,16 @@ cd SuperClaude_Framework
 
 <div align="center">
 
-## 🎉 **V4.1版本新功能**
+## 🎉 **V4版本新功能**
 
-> *版本4.1专注于稳定斜杠命令架构、增强智能体能力和改进文档。*
+> *第4版基于社区反馈和实际使用模式带来了重大改进。*
 
 <table>
 <tr>
 <td width="50%">
 
-### 🤖 **更智能的智能体系统**
-**16个专业智能体**具有领域专业知识：
-- PM Agent通过系统化文档确保持续学习
-- 深度研究智能体用于自主网络研究
+### 🤖 **更智能的代理系统**
+**14个专业代理**，具有领域专业知识：
 - 安全工程师发现真实漏洞
 - 前端架构师理解UI模式
 - 基于上下文的自动协调
@@ -245,12 +197,12 @@ cd SuperClaude_Framework
 </td>
 <td width="50%">
 
-### ⚡ **优化性能**
-**更小的框架，更大的项目：**
-- 减少框架占用
-- 为您的代码提供更多上下文
-- 支持更长对话
-- 启用复杂操作
+### 📝 **改进的命名空间**
+**`/sc:`前缀**用于所有命令：
+- 与自定义命令无冲突
+- 21个命令覆盖完整生命周期
+- 从头脑风暴到部署
+- 清晰有序的命令结构
 
 </td>
 </tr>
@@ -258,24 +210,20 @@ cd SuperClaude_Framework
 <td width="50%">
 
 ### 🔧 **MCP服务器集成**
-**8个强大服务器**(通过airis-mcp-gateway)：
-- **Tavily** → 主要网络搜索(深度研究)
-- **Serena** → 会话持久化和内存
-- **Mindbase** → 跨会话学习(零占用)
-- **Sequential** → Token高效推理
-- **Context7** → 官方文档查找
-- **Playwright** → JavaScript重度内容提取
+**6个强大服务器**协同工作：
+- **Context7** → 最新文档
+- **Sequential** → 复杂分析
 - **Magic** → UI组件生成
-- **Chrome DevTools** → 性能分析
+- **Playwright** → 浏览器测试
+- **Morphllm** → 批量转换
+- **Serena** → 会话持久化
 
 </td>
 <td width="50%">
 
 ### 🎯 **行为模式**
-**7种自适应模式**适应不同上下文：
+**5种自适应模式**适应不同上下文：
 - **头脑风暴** → 提出正确问题
-- **商业面板** → 多专家战略分析
-- **深度研究** → 自主网络研究
 - **编排** → 高效工具协调
 - **令牌效率** → 30-50%上下文节省
 - **任务管理** → 系统化组织
@@ -286,6 +234,16 @@ cd SuperClaude_Framework
 <tr>
 <td width="50%">
 
+### ⚡ **优化性能**
+**更小的框架，更大的项目：**
+- 减少框架占用
+- 为您的代码提供更多上下文
+- 支持更长对话
+- 启用复杂操作
+
+</td>
+<td width="50%">
+
 ### 📚 **文档全面改写**
 **为开发者完全重写：**
 - 真实示例和用例
@@ -293,16 +251,6 @@ cd SuperClaude_Framework
 - 包含实用工作流
 - 更好的导航结构
 
-</td>
-<td width="50%">
-
-### 🧪 **增强稳定性**
-**专注于可靠性：**
-- 核心命令的错误修复
-- 改进测试覆盖率
-- 更健壮的错误处理
-- CI/CD流水线改进
-
 </td>
 </tr>
 </table>
@@ -313,101 +261,9 @@ cd SuperClaude_Framework
 
 <div align="center">
 
-## 🔬 **深度研究能力**
+## 📚 **Documentation**
 
-### **与DR智能体架构一致的自主网络研究**
-
-SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应和智能的网络研究。
-
-<table>
-<tr>
-<td width="50%">
-
-### 🎯 **自适应规划**
-**三种智能策略：**
-- **仅规划**：对明确查询直接执行
-- **意图规划**：对模糊请求进行澄清
-- **统一**：协作式计划完善(默认)
-
-</td>
-<td width="50%">
-
-### 🔄 **多跳推理**
-**最多5次迭代搜索：**
-- 实体扩展(论文 → 作者 → 作品)
-- 概念深化(主题 → 细节 → 示例)
-- 时间进展(当前 → 历史)
-- 因果链(效果 → 原因 → 预防)
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 📊 **质量评分**
-**基于置信度的验证：**
-- 来源可信度评估(0.0-1.0)
-- 覆盖完整性跟踪
-- 综合连贯性评估
-- 最低阈值：0.6，目标：0.8
-
-</td>
-<td width="50%">
-
-### 🧠 **基于案例的学习**
-**跨会话智能：**
-- 模式识别和重用
-- 随时间优化策略
-- 保存成功的查询公式
-- 性能改进跟踪
-
-</td>
-</tr>
-</table>
-
-### **研究命令使用**
-
-```bash
-# 使用自动深度的基本研究
-/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**：技术文档查找
-
-</div>
-
----
-
-<div align="center">
-
-## 📚 **文档**
-
-### **SuperClaude完整指南**
+### **Complete Guide to SuperClaude**
 
 <table>
 <tr>
@@ -419,52 +275,55 @@ SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应
 <tr>
 <td valign="top">
 
-- 📝 [**快速开始指南**](docs/getting-started/quick-start.md)
+- 📝 [**快速开始指南**](Docs/Getting-Started/quick-start.md)  
   *快速上手使用*
 
-- 💾 [**安装指南**](docs/getting-started/installation.md)
+- 💾 [**安装指南**](Docs/Getting-Started/installation.md)  
   *详细的安装说明*
 
 </td>
 <td valign="top">
 
-- 🎯 [**斜杠命令**](docs/user-guide/commands.md)
-  *完整的 `/sc` 命令列表*
+- 🎯 [**命令参考**](Docs/User-Guide-zh/commands.md)  
+  *全部21个斜杠命令*
 
-- 🤖 [**智能体指南**](docs/user-guide/agents.md)
-  *16个专业智能体*
+- 🤖 [**智能体指南**](Docs/User-Guide-zh/agents.md)  
+  *14个专业智能体*
 
-- 🎨 [**行为模式**](docs/user-guide/modes.md)
-  *7种自适应模式*
+- 🎨 [**行为模式**](Docs/User-Guide-zh/modes.md)  
+  *5种自适应模式*
 
-- 🚩 [**标志指南**](docs/user-guide/flags.md)
+- 🚩 [**标志指南**](Docs/User-Guide-zh/flags.md)  
   *控制行为参数*
 
-- 🔧 [**MCP服务器**](docs/user-guide/mcp-servers.md)
-  *8个服务器集成*
+- 🔧 [**MCP服务器**](Docs/User-Guide-zh/mcp-servers.md)  
+  *6个服务器集成*
 
-- 💼 [**会话管理**](docs/user-guide/session-management.md)
+- 💼 [**会话管理**](Docs/User-Guide-zh/session-management.md)  
   *保存和恢复状态*
 
 </td>
 <td valign="top">
 
-- 🏗️ [**技术架构**](docs/developer-guide/technical-architecture.md)
+- 🏗️ [**技术架构**](Docs/Developer-Guide/technical-architecture.md)  
   *系统设计详情*
 
-- 💻 [**贡献代码**](docs/developer-guide/contributing-code.md)
+- 💻 [**贡献代码**](Docs/Developer-Guide/contributing-code.md)  
   *开发工作流程*
 
-- 🧪 [**测试与调试**](docs/developer-guide/testing-debugging.md)
+- 🧪 [**测试与调试**](Docs/Developer-Guide/testing-debugging.md)  
   *质量保证*
 
 </td>
 <td valign="top">
 
-- 📓 [**示例手册**](docs/reference/examples-cookbook.md)
+- ✨ [**最佳实践**](Docs/Reference/quick-start-practices.md)  
+  *专业技巧和模式*
+
+- 📓 [**示例手册**](Docs/Reference/examples-cookbook.md)  
   *实际应用示例*
 
-- 🔍 [**故障排除**](docs/reference/troubleshooting.md)
+- 🔍 [**故障排除**](Docs/Reference/troubleshooting.md)  
   *常见问题和修复*
 
 </td>
@@ -548,60 +407,3 @@ SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应
 </p>
 
 </div>
-
----
-
-## 📋 **全部30个命令**
-
-<details>
-<summary><b>点击展开完整命令列表</b></summary>
-
-### 🧠 规划与设计 (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` - 显示所有命令
-
-[**📖 查看详细命令参考 →**](docs/reference/commands-list.md)
-
-</details>

README.en.md

@@ -1,646 +0,0 @@
-<div align="center">
-
-# 🚀 SuperClaude Framework
-
-[![Run in Smithery](https://smithery.ai/badge/skills/SuperClaude-Org)](https://smithery.ai/skills?ns=SuperClaude-Org&utm_source=github&utm_medium=badge)
-
-
-### **Transform Claude Code into a Structured Development Platform**
-
-<p align="center">
-  <a href="https://github.com/hesreallyhim/awesome-claude-code/">
-  <img src="https://awesome.re/mentioned-badge-flat.svg" alt="Mentioned in Awesome Claude Code">
-  </a>
-<a href="https://github.com/SuperClaude-Org/SuperGemini_Framework" target="_blank">
-  <img src="https://img.shields.io/badge/Try-SuperGemini_Framework-blue" alt="Try SuperGemini Framework"/>
-</a>
-<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.3.0-blue" alt="Version">
-  <a href="https://github.com/SuperClaude-Org/SuperClaude_Framework/actions/workflows/test.yml">
-    <img src="https://github.com/SuperClaude-Org/SuperClaude_Framework/actions/workflows/test.yml/badge.svg" alt="Tests">
-  </a>
-  <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/🌐_Visit_Website-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://pepy.tech/projects/superclaude">
-    <img src="https://static.pepy.tech/personalized-badge/superclaude?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads" alt="PyPI sats">
-  </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>
-
-<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="#-quick-installation">Quick Start</a> •
-  <a href="#-support-the-project">Support</a> •
-  <a href="#-whats-new-in-v4">Features</a> •
-  <a href="#-documentation">Docs</a> •
-  <a href="#-contributing">Contributing</a>
-</p>
-
-</div>
-
----
-
-<div align="center">
-
-## 📊 **Framework Statistics**
-
-| **Commands** | **Agents** | **Modes** | **MCP Servers** |
-|:------------:|:----------:|:---------:|:---------------:|
-| **30** | **20** | **7** | **8** |
-| Slash Commands | Specialized AI | Behavioral | Integrations |
-
-30 slash commands covering the complete development lifecycle from brainstorming to deployment.
-
-</div>
-
----
-
-<div align="center">
-
-## 🎯 **Overview**
-
-SuperClaude is a **meta-programming configuration framework** that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration. It provides systematic workflow automation with powerful tools and intelligent agents.
-
-
-## Disclaimer
-
-This project is not affiliated with or endorsed by Anthropic.
-Claude Code is a product built and maintained by [Anthropic](https://www.anthropic.com/).
-
-## 📖 **For Developers & Contributors**
-
-**Essential documentation for working with SuperClaude Framework:**
-
-| Document | Purpose | When to Read |
-|----------|---------|--------------|
-| **[PLANNING.md](PLANNING.md)** | Architecture, design principles, absolute rules | Session start, before implementation |
-| **[TASK.md](TASK.md)** | Current tasks, priorities, backlog | Daily, before starting work |
-| **[KNOWLEDGE.md](KNOWLEDGE.md)** | Accumulated insights, best practices, troubleshooting | When encountering issues, learning patterns |
-| **[CONTRIBUTING.md](CONTRIBUTING.md)** | Contribution guidelines, workflow | Before submitting PRs |
-| **[Commands Reference](docs/user-guide/commands.md)** | Complete reference for all 30 `/sc:*` commands with syntax, examples, workflows, and decision guides | Learning SuperClaude, choosing the right command |
-
-> **💡 Pro Tip**: Claude Code reads these files at session start to ensure consistent, high-quality development aligned with project standards.
->
-> **📚 New to SuperClaude?** Start with [Commands Reference](docs/user-guide/commands.md) — it contains visual decision trees, detailed command comparisons, and workflow examples to help you understand which commands to use and when.
-
-## ⚡ **Quick Installation**
-
-> **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.
-
-### **Current Stable Version (v4.3.0)**
-
-SuperClaude currently uses slash commands.
-
-**Option 1: pipx (Recommended)**
-```bash
-# Install from PyPI
-pipx install superclaude
-
-# Install commands (installs all 30 slash commands)
-superclaude install
-
-# Install MCP servers (optional, for enhanced capabilities)
-superclaude mcp --list         # List available MCP servers
-superclaude mcp                # Interactive installation
-superclaude mcp --servers tavily --servers context7  # Install specific servers
-
-# Verify installation
-superclaude install --list
-superclaude doctor
-```
-
-After installation, restart Claude Code to use 30 commands including:
-- `/sc:research` - Deep web research (enhanced with Tavily MCP)
-- `/sc:brainstorm` - Structured brainstorming
-- `/sc:implement` - Code implementation
-- `/sc:test` - Testing workflows
-- `/sc:pm` - Project management
-- `/sc` - Show all 30 available commands
-
-**Option 2: Direct Installation from Git**
-```bash
-# Clone the repository
-git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
-cd SuperClaude_Framework
-
-# Run the installation script
-./install.sh
-```
-
-### **Coming in v5.0 (In Development)**
-
-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)**
-
-For **2-3x faster** execution and **30-50% fewer tokens**, optionally install MCP servers:
-
-```bash
-# Optional MCP servers for enhanced performance (via airis-mcp-gateway):
-# - Serena: Code understanding (2-3x faster)
-# - Sequential: Token-efficient reasoning (30-50% fewer tokens)
-# - Tavily: Web search for Deep Research
-# - Context7: Official documentation lookup
-# - Mindbase: Semantic search across all conversations (optional enhancement)
-
-# Note: Error learning available via built-in ReflexionMemory (no installation required)
-# Mindbase provides semantic search enhancement (requires "recommended" profile)
-# Install MCP servers: https://github.com/agiletec-inc/airis-mcp-gateway
-# See docs/mcp/mcp-integration-policy.md for details
-```
-
-**Performance Comparison:**
-- **Without MCPs**: Fully functional, standard performance ✅
-- **With MCPs**: 2-3x faster, 30-50% fewer tokens ⚡
-
-</div>
-
----
-
-<div align="center">
-
-## 💖 **Support the Project**
-
-> Hey, let's be real - maintaining SuperClaude takes time and resources.
-> 
-> *The Claude Max subscription alone runs $100/month for testing, and that's before counting the hours spent on documentation, bug fixes, and feature development.*
-> *If you're finding value in SuperClaude for your daily work, consider supporting the project.*
-> *Even a few dollars helps cover the basics and keeps development active.*
-> 
-> Every contributor matters, whether through code, feedback, or support. Thanks for being part of this community! 🙏
-
-<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)
-
-*One-time contributions*
-
-</td>
-<td align="center" width="33%">
-
-### 🎯 **Patreon**
-[![Patreon](https://img.shields.io/badge/Become_a-Patron-f96854?logo=patreon)](https://patreon.com/superclaude)
-
-*Monthly support*
-
-</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)
-
-*Flexible tiers*
-
-</td>
-</tr>
-</table>
-
-### **Your Support Enables:**
-
-| Item | Cost/Impact |
-|------|-------------|
-| 🔬 **Claude Max Testing** | $100/month for validation & testing |
-| ⚡ **Feature Development** | New capabilities & improvements |
-| 📚 **Documentation** | Comprehensive guides & examples |
-| 🤝 **Community Support** | Quick issue responses & help |
-| 🔧 **MCP Integration** | Testing new server connections |
-| 🌐 **Infrastructure** | Hosting & deployment costs |
-
-> **Note:** No pressure though - the framework stays open source regardless. Just knowing people use and appreciate it is motivating. Contributing code, documentation, or spreading the word helps too! 🙏
-
-</div>
-
----
-
-<div align="center">
-
-## 🎉 **What's New in v4.1**
-
-> *Version 4.1 focuses on stabilizing the slash command architecture, enhancing agent capabilities, and improving documentation.*
-
-<table>
-<tr>
-<td width="50%">
-
-### 🤖 **Smarter Agent System**
-**20 specialized agents** with domain expertise:
-- PM Agent ensures continuous learning through systematic documentation
-- Deep Research agent for autonomous web research
-- Security engineer catches real vulnerabilities
-- Frontend architect understands UI patterns
-- Automatic coordination based on context
-- Domain-specific expertise on demand
-
-</td>
-<td width="50%">
-
-### ⚡ **Optimized Performance**
-**Smaller framework, bigger projects:**
-- Reduced framework footprint
-- More context for your code
-- Longer conversations possible
-- Complex operations enabled
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 🔧 **MCP Server Integration**
-**8 powerful servers** with easy CLI installation:
-
-```bash
-# List available MCP servers
-superclaude mcp --list
-
-# Install specific servers
-superclaude mcp --servers tavily context7
-
-# Interactive installation
-superclaude mcp
-```
-
-**Available servers:**
-- **Tavily** → Primary web search (Deep Research)
-- **Context7** → Official documentation lookup
-- **Sequential-Thinking** → Multi-step reasoning
-- **Serena** → Session persistence & memory
-- **Playwright** → Cross-browser automation
-- **Magic** → UI component generation
-- **Morphllm-Fast-Apply** → Context-aware code modifications
-- **Chrome DevTools** → Performance analysis
-
-</td>
-<td width="50%">
-
-### 🎯 **Behavioral Modes**
-**7 adaptive modes** for different contexts:
-- **Brainstorming** → Asks right questions
-- **Business Panel** → Multi-expert strategic analysis
-- **Deep Research** → Autonomous web research
-- **Orchestration** → Efficient tool coordination
-- **Token-Efficiency** → 30-50% context savings
-- **Task Management** → Systematic organization
-- **Introspection** → Meta-cognitive analysis
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 📚 **Documentation Overhaul**
-**Complete rewrite** for developers:
-- Real examples & use cases
-- Common pitfalls documented
-- 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>
-
-</div>
-
----
-
-<div align="center">
-
-## 🔬 **Deep Research Capabilities**
-
-### **Autonomous Web Research Aligned with DR Agent Architecture**
-
-SuperClaude v4.2 introduces comprehensive Deep Research capabilities, enabling autonomous, adaptive, and intelligent web research.
-
-<table>
-<tr>
-<td width="50%">
-
-### 🎯 **Adaptive Planning**
-**Three intelligent strategies:**
-- **Planning-Only**: Direct execution for clear queries
-- **Intent-Planning**: Clarification for ambiguous requests
-- **Unified**: Collaborative plan refinement (default)
-
-</td>
-<td width="50%">
-
-### 🔄 **Multi-Hop Reasoning**
-**Up to 5 iterative searches:**
-- Entity expansion (Paper → Authors → Works)
-- Concept deepening (Topic → Details → Examples)
-- Temporal progression (Current → Historical)
-- Causal chains (Effect → Cause → Prevention)
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 📊 **Quality Scoring**
-**Confidence-based validation:**
-- Source credibility assessment (0.0-1.0)
-- Coverage completeness tracking
-- Synthesis coherence evaluation
-- Minimum threshold: 0.6, Target: 0.8
-
-</td>
-<td width="50%">
-
-### 🧠 **Case-Based Learning**
-**Cross-session intelligence:**
-- Pattern recognition and reuse
-- Strategy optimization over time
-- Successful query formulations saved
-- Performance improvement tracking
-
-</td>
-</tr>
-</table>
-
-### **Research Command Usage**
-
-```bash
-# Basic research with automatic depth
-/research "latest AI developments 2024"
-
-# Controlled research depth (via options in TypeScript)
-/research "quantum computing breakthroughs"  # depth: exhaustive
-
-# Specific strategy selection
-/research "market analysis"  # strategy: planning-only
-
-# Domain-filtered research (Tavily MCP integration)
-/research "React patterns"  # domains: reactjs.org,github.com
-```
-
-### **Research Depth Levels**
-
-| Depth | Sources | Hops | Time | Best For |
-|:-----:|:-------:|:----:|:----:|----------|
-| **Quick** | 5-10 | 1 | ~2min | Quick facts, simple queries |
-| **Standard** | 10-20 | 3 | ~5min | General research (default) |
-| **Deep** | 20-40 | 4 | ~8min | Comprehensive analysis |
-| **Exhaustive** | 40+ | 5 | ~10min | Academic-level research |
-
-### **Integrated Tool Orchestration**
-
-The Deep Research system intelligently coordinates multiple tools:
-- **Tavily MCP**: Primary web search and discovery
-- **Playwright MCP**: Complex content extraction
-- **Sequential MCP**: Multi-step reasoning and synthesis
-- **Serena MCP**: Memory and learning persistence
-- **Context7 MCP**: Technical documentation lookup
-
-</div>
-
----
-
-<div align="center">
-
-## 📚 **Documentation**
-
-### **Complete Guide to SuperClaude**
-
-<table>
-<tr>
-<th align="center">🚀 Getting Started</th>
-<th align="center">📖 User Guides</th>
-<th align="center">🛠️ Developer Resources</th>
-<th align="center">📋 Reference</th>
-</tr>
-<tr>
-<td valign="top">
-
-- 📝 [**Quick Start Guide**](docs/getting-started/quick-start.md)  
-  *Get up and running fast*
-
-- 💾 [**Installation Guide**](docs/getting-started/installation.md)  
-  *Detailed setup instructions*
-
-</td>
-<td valign="top">
-
-- 🎯 [**Slash Commands**](docs/reference/commands-list.md)
-  *All 30 commands organized by category*
-
-- 🤖 [**Agents Guide**](docs/user-guide/agents.md)  
-  *20 specialized agents*
-
-- 🎨 [**Behavioral Modes**](docs/user-guide/modes.md)  
-  *7 adaptive modes*
-
-- 🚩 [**Flags Guide**](docs/user-guide/flags.md)  
-  *Control behaviors*
-
-- 🔧 [**MCP Servers**](docs/user-guide/mcp-servers.md)  
-  *8 server integrations*
-
-- 💼 [**Session Management**](docs/user-guide/session-management.md)  
-  *Save & restore state*
-
-</td>
-<td valign="top">
-
-- 🏗️ [**Technical Architecture**](docs/developer-guide/technical-architecture.md)  
-  *System design details*
-
-- 💻 [**Contributing Code**](docs/developer-guide/contributing-code.md)  
-  *Development workflow*
-
-- 🧪 [**Testing & Debugging**](docs/developer-guide/testing-debugging.md)  
-  *Quality assurance*
-
-</td>
-<td valign="top">
-- 📓 [**Examples Cookbook**](docs/reference/examples-cookbook.md)  
-  *Real-world recipes*
-
-- 🔍 [**Troubleshooting**](docs/reference/troubleshooting.md)  
-  *Common issues & fixes*
-
-</td>
-</tr>
-</table>
-
-</div>
-
----
-
-<div align="center">
-
-## 🤝 **Contributing**
-
-### **Join the SuperClaude Community**
-
-We welcome contributions of all kinds! Here's how you can help:
-
-| Priority | Area | Description |
-|:--------:|------|-------------|
-| 📝 **High** | Documentation | Improve guides, add examples, fix typos |
-| 🔧 **High** | MCP Integration | Add server configs, test integrations |
-| 🎯 **Medium** | Workflows | Create command patterns & recipes |
-| 🧪 **Medium** | Testing | Add tests, validate features |
-| 🌐 **Low** | i18n | Translate docs to other languages |
-
-<p align="center">
-  <a href="CONTRIBUTING.md">
-    <img src="https://img.shields.io/badge/📖_Read-Contributing_Guide-blue" alt="Contributing Guide">
-  </a>
-  <a href="https://github.com/SuperClaude-Org/SuperClaude_Framework/graphs/contributors">
-    <img src="https://img.shields.io/badge/👥_View-All_Contributors-green" alt="Contributors">
-  </a>
-</p>
-
-</div>
-
----
-
-<div align="center">
-
-## ⚖️ **License**
-
-This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
-
-<p align="center">
-  <img src="https://img.shields.io/badge/License-MIT-yellow.svg?" alt="MIT License">
-</p>
-
-</div>
-
----
-
-<div align="center">
-
-## ⭐ **Star History**
-
-<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">
-
-### **🚀 Built with passion by the SuperClaude community**
-
-<p align="center">
-  <sub>Made with ❤️ for developers who push boundaries</sub>
-</p>
-
-<p align="center">
-  <a href="#-superclaude-framework">Back to Top ↑</a>
-</p>
-
-</div>
-
----
-
-## 📋 **All 30 Commands**
-
-<details>
-<summary><b>Click to expand full command list</b></summary>
-
-### 🧠 Planning & Design (4)
-- `/brainstorm` - Structured brainstorming
-- `/design` - System architecture
-- `/estimate` - Time/effort estimation
-- `/spec-panel` - Specification analysis
-
-### 💻 Development (5)
-- `/implement` - Code implementation
-- `/build` - Build workflows
-- `/improve` - Code improvements
-- `/cleanup` - Refactoring
-- `/explain` - Code explanation
-
-### 🧪 Testing & Quality (4)
-- `/test` - Test generation
-- `/analyze` - Code analysis
-- `/troubleshoot` - Debugging
-- `/reflect` - Retrospectives
-
-### 📚 Documentation (2)
-- `/document` - Doc generation
-- `/help` - Command help
-
-### 🔧 Version Control (1)
-- `/git` - Git operations
-
-### 📊 Project Management (3)
-- `/pm` - Project management
-- `/task` - Task tracking
-- `/workflow` - Workflow automation
-
-### 🔍 Research & Analysis (2)
-- `/research` - Deep web research
-- `/business-panel` - Business analysis
-
-### 🎯 Utilities (9)
-- `/agent` - AI agents
-- `/index-repo` - Repository indexing
-- `/index` - Indexing alias
-- `/recommend` - Command recommendations
-- `/select-tool` - Tool selection
-- `/spawn` - Parallel tasks
-- `/load` - Load sessions
-- `/save` - Save sessions
-- `/sc` - Show all commands
-
-[**📖 View Detailed Command Reference →**](docs/reference/commands-list.md)
-
-</details>
-

README.md

@@ -1,26 +1,29 @@
-<!-- WEHUB_ZH_README -->
-> [!NOTE]
-> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
-> [English](./README.en.md) · [原始项目](https://github.com/SuperClaude-Org/SuperClaude_Framework) · [上游 README](https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/HEAD/README.md)  
-> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
-
 <div align="center">
 
-# 🚀 SuperClaude 框架
+# 🚀 SuperClaude Framework
 
-### **将Claude Code转换为结构化开发平台**
+### **Transform Claude Code into a Structured Development Platform**
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-4.3.0-blue" alt="Version">
+  <a href="https://github.com/hesreallyhim/awesome-claude-code/">
+  <img src="https://awesome.re/mentioned-badge-flat.svg" alt="Mentioned in Awesome Claude Code">
+  </a>
+<a href="https://github.com/SuperClaude-Org/SuperGemini_Framework" target="_blank">
+  <img src="https://img.shields.io/badge/Try-SuperGemini_Framework-blue" alt="Try SuperGemini Framework"/>
+</a>
+<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.1.4-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">
+    <img src="https://img.shields.io/badge/🌐_Visit_Website-blue" alt="Website">
   </a>
-  <a href="https://pypi.org/project/superclaude/">
+  <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">
@@ -28,7 +31,6 @@
   </a>
 </p>
 
-<!-- Language Selector -->
 <p align="center">
   <a href="README.md">
     <img src="https://img.shields.io/badge/🇺🇸_English-blue" alt="English">
@@ -42,11 +44,11 @@
 </p>
 
 <p align="center">
-  <a href="#-快速安装">快速开始</a> •
-  <a href="#-支持项目">支持项目</a> •
-  <a href="#-v4版本新功能">新功能</a> •
-  <a href="#-文档">文档</a> •
-  <a href="#-贡献">贡献</a>
+  <a href="#-quick-installation">Quick Start</a> •
+  <a href="#-support-the-project">Support</a> •
+  <a href="#-whats-new-in-v4">Features</a> •
+  <a href="#-documentation">Docs</a> •
+  <a href="#-contributing">Contributing</a>
 </p>
 
 </div>
@@ -55,14 +57,14 @@
 
 <div align="center">
 
-## 📊 **框架统计**
+## 📊 **Framework Statistics**
 
-| **命令** | **智能体** | **模式** | **MCP服务器** |
+| **Commands** | **Agents** | **Modes** | **MCP Servers** |
 |:------------:|:----------:|:---------:|:---------------:|
-| **30** | **16** | **7** | **8** |
-| 斜杠命令 | 专业AI | 行为模式 | 集成服务 |
+| **24** | **14** | **6** | **6** |
+| Slash Commands | Specialized AI | Behavioral | Integrations |
 
-30个斜杠命令覆盖从头脑风暴到部署的完整开发生命周期。
+Use the new `/sc:help` command to see a full list of all available commands.
 
 </div>
 
@@ -70,118 +72,80 @@
 
 <div align="center">
 
-## 🎯 **概述**
+## 🎯 **Overview**
 
-SuperClaude是一个**元编程配置框架**，通过行为指令注入和组件编排，将Claude Code转换为结构化开发平台。它提供系统化的工作流自动化，配备强大的工具和智能代理。
+SuperClaude is a **meta-programming configuration framework** that transforms Claude Code into a structured development platform through behavioral instruction injection and component orchestration. It provides systematic workflow automation with powerful tools and intelligent agents.
 
 
-## 免责声明
+## Disclaimer
 
-本项目与Anthropic无关联或认可。
-Claude Code是由[Anthropic](https://www.anthropic.com/)构建和维护的产品。
+This project is not affiliated with or endorsed by Anthropic.  
+Claude Code is a product built and maintained by [Anthropic](https://www.anthropic.com/).
 
-## 📖 **开发者与贡献者指南**
+## ⚡ **Quick Installation**
 
-**使用SuperClaude框架的必备文档：**
+### **Choose Your Installation Method**
 
-| 文档 | 用途 | 何时阅读 |
-|----------|---------|--------------|
-| **[PLANNING.md](PLANNING.md)** | 架构、设计原则、绝对规则 | 会话开始、实施前 |
-| **[TASK.md](TASK.md)** | 当前任务、优先级、待办事项 | 每天、开始工作前 |
-| **[KNOWLEDGE.md](KNOWLEDGE.md)** | 积累的见解、最佳实践、故障排除 | 遇到问题时、学习模式 |
-| **[CONTRIBUTING.md](CONTRIBUTING.md)** | 贡献指南、工作流程 | 提交PR前 |
-
-> **💡 专业提示**：Claude Code在会话开始时会读取这些文件，以确保符合项目标准的一致、高质量开发。
-
-## ⚡ **快速安装**
-
-> **重要**：旧文档中描述的TypeScript插件系统
-> 尚未可用（计划在v5.0中推出）。请按照以下v4.x的
-> 当前安装说明操作。
-
-### **当前稳定版本 (v4.3.0)**
-
-SuperClaude目前使用斜杠命令。
-
-**选项1：pipx（推荐）**
-```bash
-# 从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直接安装**
-```bash
-# 克隆仓库
-git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
-cd SuperClaude_Framework
-
-# 运行安装脚本
-./install.sh
-```
-
-### **v5.0即将推出（开发中）**
-
-我们正在积极开发新的TypeScript插件系统（详见issue [#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419)）。发布后，安装将简化为：
-
-```bash
-# 此功能尚未可用
-/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
-/plugin install superclaude
-```
-
-**状态**：开发中。尚未设定ETA。
-
-### **增强性能（可选MCP）**
-
-要获得**2-3倍**更快的执行速度和**30-50%**更少的token消耗，可选择安装MCP服务器：
-
-```bash
-# 用于增强性能的可选MCP服务器（通过airis-mcp-gateway）：
-# - Serena: 代码理解（快2-3倍）
-# - Sequential: Token高效推理（减少30-50% token）
-# - 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% token ⚡
+| Method | Command | Best For |
+|:------:|---------|----------|
+| **🐍 pipx** | `pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install` | **✅ Recommended** - Linux/macOS |
+| **📦 pip** | `pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install` | Traditional Python environments |
+| **🌐 npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | Cross-platform, Node.js users |
 
 </div>
 
+<details>
+<summary><b>⚠️ IMPORTANT: Upgrading from SuperClaude V3</b></summary>
+
+**If you have SuperClaude V3 installed, you SHOULD uninstall it before installing V4:**
+
+```bash
+# Uninstall V3 first
+Remove all related files and directories :
+*.md *.json and commands/
+
+# Then install V4
+pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install
+```
+
+**✅ What gets preserved during upgrade:**
+- ✓ Your custom slash commands (outside `commands/sc/`)
+- ✓ Your custom content in `CLAUDE.md` 
+- ✓ Claude Code's `.claude.json`, `.credentials.json`, `settings.json` and `settings.local.json`
+- ✓ Any custom agents and files you've added
+
+**⚠️ Note:** Other SuperClaude-related `.json` files from V3 may cause conflicts and should be removed.
+
+</details>
+
+<details>
+<summary><b>💡 Troubleshooting PEP 668 Errors</b></summary>
+
+```bash
+# Option 1: Use pipx (Recommended)
+pipx install SuperClaude
+
+# Option 2: User installation
+pip install --user SuperClaude
+
+# Option 3: Force installation (use with caution)
+pip install --break-system-packages SuperClaude
+```
+</details>
+
 ---
 
 <div align="center">
 
-## 💖 **支持项目**
+## 💖 **Support the Project**
 
-> 说实话，维护SuperClaude需要时间和资源。
+> Hey, let's be real - maintaining SuperClaude takes time and resources.
 > 
-> *仅Claude Max订阅每月就要100美元用于测试，这还不包括在文档、bug修复和功能开发上花费的时间。*
-> *如果您在日常工作中发现SuperClaude的价值，请考虑支持这个项目。*
-> *哪怕几美元也能帮助覆盖基础成本并保持开发活跃。*
+> *The Claude Max subscription alone runs $100/month for testing, and that's before counting the hours spent on documentation, bug fixes, and feature development.*
+> *If you're finding value in SuperClaude for your daily work, consider supporting the project.*
+> *Even a few dollars helps cover the basics and keeps development active.*
 > 
-> 每个贡献者都很重要，无论是代码、反馈还是支持。感谢成为这个社区的一员！🙏
+> Every contributor matters, whether through code, feedback, or support. Thanks for being part of this community! 🙏
 
 <table>
 <tr>
@@ -190,7 +154,7 @@ cd SuperClaude_Framework
 ### ☕ **Ko-fi**
 [![Ko-fi](https://img.shields.io/badge/Support_on-Ko--fi-ff5e5b?logo=ko-fi)](https://ko-fi.com/superclaude)
 
-*一次性贡献*
+*One-time contributions*
 
 </td>
 <td align="center" width="33%">
@@ -198,7 +162,7 @@ cd SuperClaude_Framework
 ### 🎯 **Patreon**
 [![Patreon](https://img.shields.io/badge/Become_a-Patron-f96854?logo=patreon)](https://patreon.com/superclaude)
 
-*月度支持*
+*Monthly support*
 
 </td>
 <td align="center" width="33%">
@@ -206,24 +170,24 @@ cd SuperClaude_Framework
 ### 💜 **GitHub**
 [![GitHub Sponsors](https://img.shields.io/badge/GitHub-Sponsor-30363D?logo=github-sponsors)](https://github.com/sponsors/SuperClaude-Org)
 
-*灵活层级*
+*Flexible tiers*
 
 </td>
 </tr>
 </table>
 
-### **您的支持使以下工作成为可能：**
+### **Your Support Enables:**
 
-| 项目 | 成本/影响 |
+| Item | Cost/Impact |
 |------|-------------|
-| 🔬 **Claude Max测试** | 每月100美元用于验证和测试 |
-| ⚡ **功能开发** | 新功能和改进 |
-| 📚 **文档编写** | 全面的指南和示例 |
-| 🤝 **社区支持** | 快速问题响应和帮助 |
-| 🔧 **MCP集成** | 测试新服务器连接 |
-| 🌐 **基础设施** | 托管和部署成本 |
+| 🔬 **Claude Max Testing** | $100/month for validation & testing |
+| ⚡ **Feature Development** | New capabilities & improvements |
+| 📚 **Documentation** | Comprehensive guides & examples |
+| 🤝 **Community Support** | Quick issue responses & help |
+| 🔧 **MCP Integration** | Testing new server connections |
+| 🌐 **Infrastructure** | Hosting & deployment costs |
 
-> **注意：** 不过没有压力——无论如何框架都会保持开源。仅仅知道有人在使用和欣赏它就很有激励作用。贡献代码、文档或传播消息也很有帮助！🙏
+> **Note:** No pressure though - the framework stays open source regardless. Just knowing people use and appreciate it is motivating. Contributing code, documentation, or spreading the word helps too! 🙏
 
 </div>
 
@@ -231,83 +195,78 @@ cd SuperClaude_Framework
 
 <div align="center">
 
-## 🎉 **V4.1版本新功能**
+## 🎉 **What's New in V4**
 
-> *版本4.1专注于稳定斜杠命令架构、增强智能体能力和改进文档。*
+> *Version 4 brings significant improvements based on community feedback and real-world usage patterns.*
 
 <table>
 <tr>
 <td width="50%">
 
-### 🤖 **更智能的智能体系统**
-**16个专业智能体**具有领域专业知识：
-- PM Agent通过系统化文档确保持续学习
-- 深度研究智能体用于自主网络研究
-- 安全工程师发现真实漏洞
-- 前端架构师理解UI模式
-- 基于上下文的自动协调
-- 按需提供领域专业知识
+### 🤖 **Smarter Agent System**
+**14 specialized agents** with domain expertise:
+- Security engineer catches real vulnerabilities
+- Frontend architect understands UI patterns
+- Automatic coordination based on context
+- Domain-specific expertise on demand
 
 </td>
 <td width="50%">
 
-### ⚡ **优化性能**
-**更小的框架，更大的项目：**
-- 减少框架占用
-- 为您的代码提供更多上下文
-- 支持更长对话
-- 启用复杂操作
+### 📝 **Improved Namespace**
+**`/sc:` prefix** for all commands:
+- No conflicts with custom commands
+- 23 commands covering full lifecycle
+- From brainstorming to deployment
+- Clean, organized command structure
 
 </td>
 </tr>
 <tr>
 <td width="50%">
 
-### 🔧 **MCP服务器集成**
-**8个强大服务器**(通过airis-mcp-gateway)：
-- **Tavily** → 主要网络搜索(深度研究)
-- **Serena** → 会话持久化和内存
-- **Mindbase** → 跨会话学习(零占用)
-- **Sequential** → Token高效推理
-- **Context7** → 官方文档查找
-- **Playwright** → JavaScript重度内容提取
-- **Magic** → UI组件生成
-- **Chrome DevTools** → 性能分析
+### 🔧 **MCP Server Integration**
+**6 powerful servers** working together:
+- **Context7** → Up-to-date documentation
+- **Sequential** → Complex analysis
+- **Magic** → UI component generation
+- **Playwright** → Browser testing
+- **Morphllm** → Bulk transformations
+- **Serena** → Session persistence
 
 </td>
 <td width="50%">
 
-### 🎯 **行为模式**
-**7种自适应模式**适应不同上下文：
-- **头脑风暴** → 提出正确问题
-- **商业面板** → 多专家战略分析
-- **深度研究** → 自主网络研究
-- **编排** → 高效工具协调
-- **令牌效率** → 30-50%上下文节省
-- **任务管理** → 系统化组织
-- **内省** → 元认知分析
+### 🎯 **Behavioral Modes**
+**6 adaptive modes** for different contexts:
+- **Brainstorming** → Asks right questions
+- **Business Panel** → Multi-expert strategic analysis
+- **Orchestration** → Efficient tool coordination
+- **Token-Efficiency** → 30-50% context savings
+- **Task Management** → Systematic organization
+- **Introspection** → Meta-cognitive analysis
 
 </td>
 </tr>
 <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%">
 
-### 🧪 **增强稳定性**
-**专注于可靠性：**
-- 核心命令的错误修复
-- 改进测试覆盖率
-- 更健壮的错误处理
-- CI/CD流水线改进
+### 📚 **Documentation Overhaul**
+**Complete rewrite** for developers:
+- Real examples & use cases
+- Common pitfalls documented
+- Practical workflows included
+- Better navigation structure
 
 </td>
 </tr>
@@ -319,159 +278,66 @@ cd SuperClaude_Framework
 
 <div align="center">
 
-## 🔬 **深度研究能力**
+## 📚 **Documentation**
 
-### **与DR智能体架构一致的自主网络研究**
-
-SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应和智能的网络研究。
+### **Complete Guide to SuperClaude**
 
 <table>
 <tr>
-<td width="50%">
-
-### 🎯 **自适应规划**
-**三种智能策略：**
-- **仅规划**：对明确查询直接执行
-- **意图规划**：对模糊请求进行澄清
-- **统一**：协作式计划完善(默认)
-
-</td>
-<td width="50%">
-
-### 🔄 **多跳推理**
-**最多5次迭代搜索：**
-- 实体扩展(论文 → 作者 → 作品)
-- 概念深化(主题 → 细节 → 示例)
-- 时间进展(当前 → 历史)
-- 因果链(效果 → 原因 → 预防)
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### 📊 **质量评分**
-**基于置信度的验证：**
-- 来源可信度评估(0.0-1.0)
-- 覆盖完整性跟踪
-- 综合连贯性评估
-- 最低阈值：0.6，目标：0.8
-
-</td>
-<td width="50%">
-
-### 🧠 **基于案例的学习**
-**跨会话智能：**
-- 模式识别和重用
-- 随时间优化策略
-- 保存成功的查询公式
-- 性能改进跟踪
-
-</td>
-</tr>
-</table>
-
-### **研究命令使用**
-
-```bash
-# 使用自动深度的基本研究
-/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**：技术文档查找
-
-</div>
-
----
-
-<div align="center">
-
-## 📚 **文档**
-
-### **SuperClaude完整指南**
-
-<table>
-<tr>
-<th align="center">🚀 快速开始</th>
-<th align="center">📖 用户指南</th>
-<th align="center">🛠️ 开发资源</th>
-<th align="center">📋 参考资料</th>
+<th align="center">🚀 Getting Started</th>
+<th align="center">📖 User Guides</th>
+<th align="center">🛠️ Developer Resources</th>
+<th align="center">📋 Reference</th>
 </tr>
 <tr>
 <td valign="top">
 
-- 📝 [**快速开始指南**](docs/getting-started/quick-start.md)
-  *快速上手使用*
+- 📝 [**Quick Start Guide**](Docs/Getting-Started/quick-start.md)  
+  *Get up and running fast*
 
-- 💾 [**安装指南**](docs/getting-started/installation.md)
-  *详细的安装说明*
+- 💾 [**Installation Guide**](Docs/Getting-Started/installation.md)  
+  *Detailed setup instructions*
 
 </td>
 <td valign="top">
 
-- 🎯 [**斜杠命令**](docs/user-guide/commands.md)
-  *完整的 `/sc` 命令列表*
+- 🎯 [**Commands Reference**](Docs/User-Guide/commands.md)  
+  *All 23 slash commands*
 
-- 🤖 [**智能体指南**](docs/user-guide/agents.md)
-  *16个专业智能体*
+- 🤖 [**Agents Guide**](Docs/User-Guide/agents.md)  
+  *14 specialized agents*
 
-- 🎨 [**行为模式**](docs/user-guide/modes.md)
-  *7种自适应模式*
+- 🎨 [**Behavioral Modes**](Docs/User-Guide/modes.md)  
+  *5 adaptive modes*
 
-- 🚩 [**标志指南**](docs/user-guide/flags.md)
-  *控制行为参数*
+- 🚩 [**Flags Guide**](Docs/User-Guide/flags.md)  
+  *Control behaviors*
 
-- 🔧 [**MCP服务器**](docs/user-guide/mcp-servers.md)
-  *8个服务器集成*
+- 🔧 [**MCP Servers**](Docs/User-Guide/mcp-servers.md)  
+  *6 server integrations*
 
-- 💼 [**会话管理**](docs/user-guide/session-management.md)
-  *保存和恢复状态*
+- 💼 [**Session Management**](Docs/User-Guide/session-management.md)  
+  *Save & restore state*
 
 </td>
 <td valign="top">
 
-- 🏗️ [**技术架构**](docs/developer-guide/technical-architecture.md)
-  *系统设计详情*
+- 🏗️ [**Technical Architecture**](Docs/Developer-Guide/technical-architecture.md)  
+  *System design details*
 
-- 💻 [**贡献代码**](docs/developer-guide/contributing-code.md)
-  *开发工作流程*
+- 💻 [**Contributing Code**](Docs/Developer-Guide/contributing-code.md)  
+  *Development workflow*
 
-- 🧪 [**测试与调试**](docs/developer-guide/testing-debugging.md)
-  *质量保证*
+- 🧪 [**Testing & Debugging**](Docs/Developer-Guide/testing-debugging.md)  
+  *Quality assurance*
 
 </td>
 <td valign="top">
+- 📓 [**Examples Cookbook**](Docs/Reference/examples-cookbook.md)  
+  *Real-world recipes*
 
-- 📓 [**示例手册**](docs/reference/examples-cookbook.md)
-  *实际应用示例*
-
-- 🔍 [**故障排除**](docs/reference/troubleshooting.md)
-  *常见问题和修复*
+- 🔍 [**Troubleshooting**](Docs/Reference/troubleshooting.md)  
+  *Common issues & fixes*
 
 </td>
 </tr>
@@ -483,26 +349,26 @@ SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应
 
 <div align="center">
 
-## 🤝 **贡献**
+## 🤝 **Contributing**
 
-### **加入SuperClaude社区**
+### **Join the SuperClaude Community**
 
-我们欢迎各种类型的贡献！以下是您可以帮助的方式：
+We welcome contributions of all kinds! Here's how you can help:
 
-| 优先级 | 领域 | 描述 |
+| Priority | Area | Description |
 |:--------:|------|-------------|
-| 📝 **高** | 文档 | 改进指南，添加示例，修复错误 |
-| 🔧 **高** | MCP集成 | 添加服务器配置，测试集成 |
-| 🎯 **中** | 工作流 | 创建命令模式和配方 |
-| 🧪 **中** | 测试 | 添加测试，验证功能 |
-| 🌐 **低** | 国际化 | 将文档翻译为其他语言 |
+| 📝 **High** | Documentation | Improve guides, add examples, fix typos |
+| 🔧 **High** | MCP Integration | Add server configs, test integrations |
+| 🎯 **Medium** | Workflows | Create command patterns & recipes |
+| 🧪 **Medium** | Testing | Add tests, validate features |
+| 🌐 **Low** | i18n | Translate docs to other languages |
 
 <p align="center">
   <a href="CONTRIBUTING.md">
-    <img src="https://img.shields.io/badge/📖_阅读-贡献指南-blue" alt="Contributing Guide">
+    <img src="https://img.shields.io/badge/📖_Read-Contributing_Guide-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">
+    <img src="https://img.shields.io/badge/👥_View-All_Contributors-green" alt="Contributors">
   </a>
 </p>
 
@@ -512,9 +378,9 @@ SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应
 
 <div align="center">
 
-## ⚖️ **许可证**
+## ⚖️ **License**
 
-本项目基于**MIT许可证**授权 - 详情请参阅[LICENSE](LICENSE)文件。
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
 
 <p align="center">
   <img src="https://img.shields.io/badge/License-MIT-yellow.svg?" alt="MIT License">
@@ -526,7 +392,7 @@ SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应
 
 <div align="center">
 
-## ⭐ **Star历史**
+## ⭐ **Star History**
 
 <a href="https://www.star-history.com/#SuperClaude-Org/SuperClaude_Framework&Timeline">
  <picture>
@@ -543,71 +409,14 @@ SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应
 
 <div align="center">
 
-### **🚀 由SuperClaude社区倾情打造**
+### **🚀 Built with passion by the SuperClaude community**
 
 <p align="center">
-  <sub>为突破边界的开发者用❤️制作</sub>
+  <sub>Made with ❤️ for developers who push boundaries</sub>
 </p>
 
 <p align="center">
-  <a href="#-superclaude-框架">返回顶部 ↑</a>
+  <a href="#-superclaude-framework">Back to Top ↑</a>
 </p>
 
 </div>
-
----
-
-## 📋 **全部30个命令**
-
-<details>
-<summary><b>点击展开完整命令列表</b></summary>
-
-### 🧠 规划与设计 (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` - 显示所有命令
-
-[**📖 查看详细命令参考 →**](docs/reference/commands-list.md)
-
-</details>

README.wehub.md

@@ -1,7 +0,0 @@
-# WeHub 来源说明
-
-- 原始项目：`SuperClaude-Org/SuperClaude_Framework`
-- 原始仓库：https://github.com/SuperClaude-Org/SuperClaude_Framework
-- 导入方式：上游默认分支的最新快照
-- 原作者、版权和许可证信息以原始仓库及本仓库 LICENSE 为准
-- 本文件仅用于记录来源，不代表 WeHub 是原项目作者

SECURITY.md

@@ -631,7 +631,7 @@ For critical vulnerabilities requiring immediate attention:
 **General Security Questions:**
 - **GitHub Discussions**: https://github.com/SuperClaude-Org/SuperClaude_Framework/discussions
 - **Community Forums**: Security-focused discussion threads
-- **Documentation**: [Security Best Practices](docs/Reference/quick-start-practices.md#security-practices)
+- **Documentation**: [Security Best Practices](Docs/Reference/quick-start-practices.md#security-practices)
 - **Issue Tracker**: Non-sensitive security configuration questions
 
 **Technical Security Support:**
@@ -663,25 +663,25 @@ For organizations requiring dedicated security support:
 
 ### Security-Related Documentation
 **Framework Security Documentation:**
-- [Quick Start Practices Guide](docs/Reference/quick-start-practices.md) - Security-focused usage patterns
-- [Technical Architecture](docs/Developer-Guide/technical-architecture.md) - Security design principles
-- [Contributing Code Guide](docs/Developer-Guide/contributing-code.md) - Secure development practices
-- [Testing & Debugging Guide](docs/Developer-Guide/testing-debugging.md) - Security testing procedures
+- [Quick Start Practices Guide](Docs/Reference/quick-start-practices.md) - Security-focused usage patterns
+- [Technical Architecture](Docs/Developer-Guide/technical-architecture.md) - Security design principles
+- [Contributing Code Guide](Docs/Developer-Guide/contributing-code.md) - Secure development practices
+- [Testing & Debugging Guide](Docs/Developer-Guide/testing-debugging.md) - Security testing procedures
 
 **MCP Server Security:**
-- [MCP Servers Guide](docs/User-Guide/mcp-servers.md) - Server security configuration
-- [Troubleshooting Guide](docs/Reference/troubleshooting.md) - Security-related issue resolution
+- [MCP Servers Guide](Docs/User-Guide/mcp-servers.md) - Server security configuration
+- [Troubleshooting Guide](Docs/Reference/troubleshooting.md) - Security-related issue resolution
 - MCP Server Documentation - Individual server security considerations
 - Configuration Security - Secure MCP setup and credential management
 
 **Agent Security:**
-- [Agents Guide](docs/User-Guide/agents.md) - Agent security boundaries and coordination
+- [Agents Guide](Docs/User-Guide/agents.md) - Agent security boundaries and coordination
 - Agent Development - Security considerations for agent implementation
 - Behavioral Modes - Security implications of different operational modes
 - Command Security - Security aspects of command execution and validation
 
 **Session Management Security:**
-- [Session Management Guide](docs/User-Guide/session-management.md) - Secure session handling
+- [Session Management Guide](Docs/User-Guide/session-management.md) - Secure session handling
 - Memory Security - Secure handling of persistent session data
 - Project Isolation - Security boundaries between different projects
 - Context Security - Secure context loading and validation
@@ -723,7 +723,7 @@ For organizations requiring dedicated security support:
 
 **Last Updated**: December 2024 (SuperClaude Framework v4.0)
 **Next Review**: March 2025 (Quarterly review cycle)
-**Version**: 4.1.5 (Updated for v4 architectural changes)
+**Version**: 4.1.4 (Updated for v4 architectural changes)
 
 **Review Schedule:**
 - **Quarterly Reviews**: Security policy accuracy and completeness assessment