External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-17 17:56:46 +00:00
Code Issues Packages Projects Releases Wiki Activity
166 Commits 9 Branches 17 Tags
Commit Graph

3 Commits

Author SHA1 Message Date
NomenAK
41761f405c 📚 Major documentation cleanup: Fix CLI confusion and streamline content 
## Critical Fixes ✅
- **CLI Command Syntax**: Fixed all ambiguous `SuperClaude --version` → `python3 -m SuperClaude --version`
- **Architecture Clarity**: Verified dual architecture documentation (Python CLI + Context Framework)
- **External Dependencies**: Marked unverified APIs as experimental (TWENTYFIRST_API_KEY, MORPH_API_KEY)
- **Installation Instructions**: Clarified NPM package names with verification warnings

## Content Optimization 🗑️
- **Removed unnecessary files**:
  - optimization-guide.md (inappropriate for context files)
  - quick-start-practices.md (duplicate content)
  - Various outdated socratic learning components
- **Updated cross-references**: Fixed all broken links to point to existing, relevant content
- **Consolidated navigation**: Streamlined Reference/README.md documentation matrix

## Technical Accuracy 🎯
- **Command References**: All commands now specify exact usage context (terminal vs Claude Code)
- **Framework Nature**: Consistently explains SuperClaude as context framework, not executable software
- **Installation Verification**: Updated diagnostic scripts with correct Python CLI commands
- **MCP Configuration**: Marked experimental services appropriately

## Impact Summary 📊
- **Files Modified**: 15+ documentation files for accuracy and consistency
- **Files Removed**: 5+ unnecessary/duplicate files
- **Broken Links**: 0 (all cross-references updated)
- **User Clarity**: Significantly improved understanding of dual architecture

Result: Professional documentation that accurately represents SuperClaude's sophisticated
dual architecture (Python CLI installation system + Claude Code context framework).

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-08-21 19:03:25 +02:00
NomenAK
c09b0c5755 🚨 Remove fictional error codes and error handling that don't exist in SuperClaude 
## Critical Framework Accuracy Fixes

### Remove Non-Existent Error Codes
- **Deleted E001-E008 error code table** from commands.md
- These error codes never existed in SuperClaude Framework
- SuperClaude is instruction-based, not code-based, so cannot generate error codes

### Fix Non-Existent Commands
- **Fixed `SuperClaude status --mcp`** references in commands.md
- This command doesn't exist - replaced with actual working commands
- Updated validation steps to use real installation verification

### Correct Error Handling Documentation
- **Reframed fictional error classes** in technical-architecture.md
- Replaced `ComponentInstallationError`, `AgentCoordinationError` with conceptual issues
- Clarified that SuperClaude operates through instruction files, not runtime exceptions
- Converted exception examples to conceptual issue categories

## Why This Matters
SuperClaude Framework enhances Claude Code through behavioral instruction files (.md files).
Since it doesn't execute code (except Python installation), it cannot generate runtime
errors or error codes. This fix ensures documentation accurately reflects the framework's
instruction-based nature.

## Files Updated
- `User-Guide/commands.md`: Removed error code table and fixed command references
- `Developer-Guide/technical-architecture.md`: Converted fictional error handling to conceptual issues

## Result
Documentation now accurately represents SuperClaude as a behavioral enhancement framework
rather than incorrectly presenting it as a traditional error-generating application.

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-08-20 20:46:15 +02:00
NomenAK
d2f4ef43e4 📁 Major documentation restructure and comprehensive Reference section 
- Restructured all documentation under unified Docs/ directory
- Removed outdated phase summaries and consolidated content
- Added comprehensive Reference section with 11 new guides:
  * Advanced patterns and workflows
  * Basic examples and common issues
  * Integration patterns and MCP server guides
  * Optimization and diagnostic references
- Enhanced User-Guide with updated agent and mode documentation
- Updated MCP configurations for morphllm and serena
- Added TODO.md for project tracking
- Maintained existing content quality while improving organization

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-08-18 11:58:55 +02:00