10 Commits

Author SHA1 Message Date
NomenAK
3c819e1162
🚀 Merge SuperClaude V4 to Master - Complete Framework Overhaul (#289)
*  Enhance documentation with advanced markdown formatting

Major improvements to documentation presentation and usability:

README.md:
- Added centered hero section with framework statistics dashboard
- Created visual support section with donation cards
- Enhanced What's New section with feature grid layout
- Reorganized documentation links into categorized table
- Added professional badges and visual separators

installation.md:
- Centered title with platform badges and quick navigation
- Consolidated 4 installation methods into unified table
- Created visual requirement cards (Required vs Optional)
- Added collapsible troubleshooting sections
- Removed 3 duplicate "What's Next" sections
- Enhanced learning journey with progression tables

quick-start.md:
- Added visual framework architecture flow diagram
- Created component statistics dashboard (21|14|6|6)
- Built comparison table for SuperClaude vs Standard Claude
- Added 4-week learning timeline with milestones
- Enhanced workflow patterns with step-by-step tables
- Created key insights cards explaining framework philosophy

All documents now feature consistent styling with centered titles,
organized tables, emojis for visual scanning, and improved navigation.

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

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

* 🔥 Remove outdated publishing and release instruction files

Cleaned up repository by removing:
- PUBLISHING.md: Outdated publishing guidelines
- RELEASE_INSTRUCTIONS.md: Old release process documentation

These files are no longer needed as the project has evolved
and the processes have been streamlined or moved elsewhere.

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

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

---------

Signed-off-by: NomenAK <39598727+NomenAK@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
2025-08-22 23:05:55 +02:00
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
7409e4d5c8 📝 Update NPM package references to @bifrost_inc/superclaude
- Updated all documentation to use @bifrost_inc/superclaude
- Fixed installation commands in README and docs
- Updated release instructions with correct NPM package name
- Cleaned up temporary package files
2025-08-22 21:04:59 +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
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
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