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
886323b240
📚 Major documentation improvements and corrections
...
- Fix directory structure in technical-architecture.md to match actual ~/.claude/ structure
- Correct session management documentation to show true persistent memory via Serena MCP
- Add comprehensive flags documentation with 40+ missing command-specific flags
- Remove verification status sections across all documentation
- Fix component counts: 14 agents, 5 modes, 21 commands
- Update gitignore to exclude CRUSH.md and TODO.txt personal files
- Standardize documentation structure and remove fictional content
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-08-22 20:09:27 +02:00
NomenAK
850e5a69a6
📚 Complete documentation restructure and content cleanup
...
- Standardize documentation structure across all sections
- Fix CLI confusion and streamline user guidance
- Remove fictional content and align with actual functionality
- Improve technical architecture documentation
- Update installation and quick-start guides
- Enhance reference materials and examples
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-08-22 19:18:44 +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
