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

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

Browse Source 
- 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>
This commit is contained in:
NomenAK
2025-06-26 13:08:33 +02:00
parent c4c0434c77
commit c40a0795ee
5 changed files with 37 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
CLAUDE.md
View File

@@ -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*

9
COMMANDS.md
View File

@@ -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

2
CONTRIBUTING.md
View File

@@ -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*

34
README.md
View File

@@ -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)

2
VERSION
View File

@@ -1 +1 @@
2.0.0
2.0.1