feat: Add --introspect flag for framework self-analysis and improvement (v2.0.1)

- Introduce --introspect flag as universal option for all commands
- Enable self-aware analysis mode for debugging SuperClaude behavior
- Add dedicated "Analysis & Introspection" section in command reference
- Document introspection mode for framework troubleshooting workflows
- Update README with introspection examples and configuration options
- Bump version to 2.0.1 across all documentation

The --introspect flag provides cognitive transparency, allowing users to:
• Debug and understand SuperClaude's internal behavior
• Optimize framework performance and token usage
• Analyze framework patterns with sequential reasoning
• Improve SuperClaude configuration effectiveness

This enhancement makes SuperClaude more maintainable and debuggable
by exposing its cognitive processes for inspection and improvement.

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

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

CLAUDE.md

@@ -148,4 +148,4 @@ You should use the following configuration to guide your behavior.
 @include shared/superclaude-personas.yml#MCP_Persona_Integration
 
 ---
-*SuperClaude v2 | Development framework | Evidence-based methodology | Advanced Claude Code configuration*
+*SuperClaude v2.0.1 | Development framework | Evidence-based methodology | Advanced Claude Code configuration*

COMMANDS.md

@@ -1,4 +1,4 @@
-# SuperClaude Commands Reference v2
+# SuperClaude Commands Reference v2.0.1
 
 ## Table of Contents
 - [Quick Start](#quick-start)
@@ -51,6 +51,11 @@
 | `--no-magic` | Disable Magic UI builder specifically |
 | `--no-pup` | Disable Puppeteer specifically |
 
+### 🔍 Analysis & Introspection
+| Flag | Description |
+|------|-------------|
+| `--introspect` | Enable self-aware analysis with cognitive transparency |
+
 ### 📋 Planning & Execution
 | Flag | Description |
 |------|-------------|
@@ -475,4 +480,4 @@ Load and analyze project context.
 
 ---
 
-**SuperClaude v2** - 18 professional commands | 9 cognitive personas | Advanced MCP integration | Evidence-based methodology
+**SuperClaude v2.0.1** - 18 professional commands | 9 cognitive personas | Advanced MCP integration | Evidence-based methodology

CONTRIBUTING.md

@@ -225,4 +225,4 @@ Contributors are recognized through:
 
 **Ready to contribute?** Create an issue or submit a PR!
 
-*SuperClaude v2 | Community-driven configuration framework*
+*SuperClaude v2.0.1 | Community-driven configuration framework*

README.md

@@ -1,13 +1,13 @@
 # SuperClaude – Development Framework for Claude Code
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://github.com/NomenAK/SuperClaude)
+[![Version](https://img.shields.io/badge/version-2.0.1-blue.svg)](https://github.com/NomenAK/SuperClaude)
 [![GitHub issues](https://img.shields.io/github/issues/NomenAK/SuperClaude)](https://github.com/NomenAK/SuperClaude/issues)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/NomenAK/SuperClaude/blob/master/CONTRIBUTING.md)
 
 **A configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.**
 
-## 🚀 Version 2.0 Update
+## 🚀 Version 2.0.1 Update
 
 IMPORTANT: Start Fresh by removing old files and dir in .claude (RULES.md MCP.md PERSONAS.md CLAUDE.md and /commands dir)
 
@@ -39,10 +39,11 @@ SuperClaude enhances Claude Code with:
 - **Evidence-Based Methodology** encouraging documentation
 - **MCP Integration** with Context7, Sequential, Magic, Puppeteer
 - **Git Checkpoint Support** for safe experimentation
+- **Introspection Mode** for framework improvement and troubleshooting
 
 ## 🚀 Installation
 
-### Enhanced Installer v2.0
+### Enhanced Installer v2.0.1
 The installer provides various options:
 
 ```bash
@@ -60,7 +61,7 @@ cd SuperClaude
 ./install.sh --log install.log        # Log all operations
 ```
 
-**v2 Installer Features:**
+**v2.0.1 Installer Features:**
 - 🔄 **Update Mode**: Preserves customizations while updating
 - 👁️ **Dry Run**: Preview changes before applying
 - 💾 **Smart Backups**: Automatic backup with timestamping
@@ -82,7 +83,7 @@ Switch between different approaches with persona flags:
 /troubleshoot --prod --persona-analyzer # Root cause analysis approach
 ```
 
-**v2 Update**: All 9 personas are now universal flags, available on every command for consistent access to specialized approaches.
+**v2.0.1 Update**: All 9 personas are now universal flags, available on every command for consistent access to specialized approaches.
 
 ### ⚡ **18 Commands**
 Development lifecycle coverage:
@@ -141,6 +142,13 @@ SuperClaude's @include template system helps manage token usage:
 /test --integration --e2e --pup                             # Validation
 ```
 
+### Framework Troubleshooting & Improvement
+```bash
+/troubleshoot --introspect                                  # Debug SuperClaude behavior
+/analyze --introspect --seq                                 # Analyze framework patterns
+/improve --introspect --uc                                  # Optimize token usage
+```
+
 ### Full-Stack Feature Development
 ```bash
 /build --react --magic --watch --persona-frontend           # UI development
@@ -176,6 +184,18 @@ SuperClaude's @include template system helps manage token usage:
 /troubleshoot --ultrathink
 ```
 
+### Introspection Mode
+```bash
+# Enable self-aware analysis for SuperClaude improvement
+/analyze --introspect
+
+# Debug SuperClaude behavior
+/troubleshoot --introspect --seq
+
+# Optimize framework performance
+/improve --introspect --persona-performance
+```
+
 ### Token Management
 ```bash
 # Standard mode
@@ -339,7 +359,7 @@ SuperClaude welcomes contributions:
 
 Join the community: [Discussions](https://github.com/NomenAK/SuperClaude/discussions)
 
-## 📈 Version 2.0 Changes
+## 📈 Version 2.0.1 Changes
 
 **🎯 Architecture Improvements:**
 - **Configuration Management**: @include reference system
@@ -362,6 +382,6 @@ SuperClaude provides a structured approach to using Claude Code with specialized
 
 ---
 
-*SuperClaude v2 – Development framework for Claude Code*
+*SuperClaude v2.0.1 – Development framework for Claude Code*
 
 [⭐ Star on GitHub](https://github.com/NomenAK/SuperClaude) | [💬 Discussions](https://github.com/NomenAK/SuperClaude/discussions) | [🐛 Report Issues](https://github.com/NomenAK/SuperClaude/issues)

VERSION

@@ -1 +1 @@
-2.0.0
+2.0.1