10 Commits

Author SHA1 Message Date
NomenAK
bdfa09af32 📚 Update documentation with pipx installation instructions
- Added pipx as recommended installation method across all docs
- Updated troubleshooting guides with PEP 668 error solutions
- Added multiple installation options with clear hierarchy
- Enhanced error handling instructions with fallback options
- Consistent installation instructions throughout documentation
2025-08-22 21:20:12 +02:00
NomenAK
418683c265 📝 Complete version update to 4.0.4 across all files
- Updated all documentation references
- Updated all Python module versions
- Updated configuration and metadata files
- Synchronized version across entire codebase
2025-08-22 21:13:05 +02:00
NomenAK
5d0546e041 🔖 Complete version standardization to 4.0.3
- Update all remaining version references to 4.0.3
- Fix documentation files (SECURITY.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md)
- Update PUBLISHING.md version references and examples
- Fix all component metadata versions (mcp, modes, mcp_docs)
- Update setup/data/features.json versions
- Fix SuperClaude __main__.py version strings
- Update all documentation command examples
- Standardize version across 15+ files

All components now consistently at v4.0.3 for dual PyPI/NPM release.

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-22 20:49:39 +02:00
NomenAK
f7cf87c5ad 🔧 Standardize agent invocation syntax: @agents- → @agent-
## Changes Made
- **Agent Syntax Standardization**: Updated all agent invocations from `@agents-` to `@agent-`
- **Consistency**: Applied change across all 14 documentation files and 1 source file
- **Examples Updated**: All agent invocation examples now use singular `@agent-` format
- **Pattern Recognition**: Updated references to trigger pattern documentation

## Files Updated (14 total)
### Documentation
- Docs/User-Guide/commands.md - Core command reference
- Docs/User-Guide/agents.md - Agent guide with all examples
- Docs/README.md - Quick reference updated
- Docs/Getting-Started/installation.md & quick-start.md - Setup instructions
- Docs/Developer-Guide/ - Technical architecture and testing docs
- Docs/Reference/ - All example files and troubleshooting

### Source Files
- SuperClaude/Agents/security-engineer.md - Agent context file

## Impact
 **Consistent Syntax**: All agent invocations now use `@agent-[name]` format
 **User Clarity**: Clear distinction from previous `@agents-` plural form
 **Documentation Alignment**: All examples and references updated consistently
 **Framework Standards**: Aligns with SuperClaude naming conventions

Examples now correctly show:
- `@agent-security "review authentication"`
- `@agent-python-expert "optimize code"`
- `@agent-frontend-architect "design components"`

Total replacements: 80+ instances across entire documentation

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-21 19:05:51 +02:00
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
88f2b9a296 🔧 Fix platform-specific documentation issues and standardize shell syntax
## Major Platform-Specific Improvements

### Windows Path Standardization
- **Fixed forward slash issues**: All Windows paths now use proper backslashes
- **Standardized path variables**: Consistent use of %USERPROFILE% instead of mixed %USERNAME%
- **Proper error path examples**: Fixed error messages to show correct Windows paths

### Shell Command Organization
- **Clear platform separation**: Added distinct Linux/macOS vs Windows sections
- **Proper language tags**: bash for Unix, cmd for Windows Command Prompt, powershell for PowerShell
- **Platform headers**: Clear "Linux/macOS" and "Windows" labels for all command blocks

### Cross-Platform Command Coverage
- **Diagnostic commands**: Both platforms now have equivalent diagnostic procedures
- **Recovery procedures**: Platform-specific backup/restore operations
- **Installation fixes**: Proper installation commands for both environments

## Files Updated
- `Reference/common-issues.md`: Platform-specific quick fixes with proper shell tags
- `Reference/troubleshooting.md`: Comprehensive cross-platform diagnostic procedures

## Technical Details
- Windows commands use proper path syntax (backslashes, %USERPROFILE%)
- Unix commands maintained with proper forward slash paths
- All code blocks properly tagged with language identifiers
- Platform-specific alternatives provided for all major operations

This resolves platform-specific issues identified in documentation review and ensures
consistent user experience across Windows, Linux, and macOS environments.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-20 20:46:15 +02:00
NomenAK
0e856a9975 Standardize internal markdown references with explicit relative paths
• Updated troubleshooting.md, optimization-guide.md, mcp-server-guide.md, diagnostic-reference.md, and README.md
• Changed internal references from (filename.md) to (./filename.md) format
• Improved link robustness and portability across different viewing contexts
• Completed cross-reference standardization throughout Reference directory

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-20 20:46:15 +02:00
NomenAK
fa14274ab4 📚 Consolidate documentation duplications and improve troubleshooting workflow
## Changes Made:

### common-issues.md Redesign (552 → 171 lines, 69% reduction)
- Transformed to "Top 10 Quick Fixes" format with 2-minute solutions
- Removed all duplicate platform-specific content
- Added clear cross-references to detailed troubleshooting guide
- Focused on immediate problem resolution

### troubleshooting.md Enhancement
- Added Quick Fix reference boxes linking to common-issues.md
- Maintained comprehensive content for complex problems
- Removed basic duplicate content covered in quick reference
- Improved navigation between files

### Eliminated Content Duplication
- **Permission errors**: Quick fix vs detailed diagnosis separation
- **Python version issues**: Rapid solution vs comprehensive management
- **Component installation**: Basic fix vs advanced dependency resolution
- **Command problems**: Immediate fixes vs deep troubleshooting

### User Experience Improvements
- Clear file purpose distinction (quick vs detailed help)
- Progressive support pathway (2-min fixes → comprehensive guide)
- Eliminated ~400 lines of redundant content
- Better cross-file navigation and reference system

## Result:
- No duplicate content between troubleshooting files
- Faster problem resolution with clear escalation path
- Improved maintainability and reduced documentation debt
- Enhanced user experience with appropriate help level selection

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-18 12:55:14 +02:00
NomenAK
1eab5e3bc4 🔧 Fix command syntax inconsistencies and improve documentation clarity
## Command Syntax Standardization
- Fix lowercase "superclaude" → "SuperClaude" in installation.md
- Distinguish between terminal commands (SuperClaude install) and Claude Code commands (/sc:*)
- Add clear command context headers to all major documentation files

## Documentation Improvements
- Add command reference tables to key guides
- Create visual distinction markers (🖥️ Terminal vs 💬 Claude Code)
- Update verification sections with proper command separation
- Fix content duplications in Developer-Guide and Getting-Started files

## Cross-Reference Updates
- Standardize all documentation links to use Docs/ prefix structure
- Replace invalid email addresses with anton.knoery@gmail.com
- Remove non-existent team references from security documentation

## Files Enhanced
- Getting-Started: installation.md, quick-start.md with command clarity
- User-Guide: commands.md with comprehensive command context
- Reference: troubleshooting.md, common-issues.md with mixed command support
- Root files: README.md, CONTRIBUTING.md, SECURITY.md link updates

This resolves command confusion between installation (terminal) and development (/sc:) commands.

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-18 12:45:06 +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