🚀 Prepare for dual PyPI/NPM release v4.0

- Fix version consistency (PyPI: 4.0.0, NPM: 4.0.3)
- Update license format to PEP 639 compliance
- Restore NPM package components (bin/ and package.json)
- Fix NPM package name to @superclaude-org/superclaude
- Add comprehensive RELEASE_INSTRUCTIONS.md
- Update .gitignore to include NPM files
- Ready for production release on both PyPI and NPM

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

Docs/Developer-Guide/technical-architecture.md

@@ -40,7 +40,7 @@ This guide documents how SuperClaude's Context-Oriented Configuration Framework
 ├── MODE_Orchestration.md           # Tool coordination mode
 ├── MODE_Task_Management.md         # Task orchestration mode
 ├── MODE_Token_Efficiency.md        # Compressed communication mode
-├── agents/                         # Domain specialist contexts (13 total)
+├── agents/                         # Domain specialist contexts (14 total)
 │   ├── backend-architect.md        # Backend expertise
 │   ├── devops-architect.md         # DevOps expertise
 │   ├── frontend-architect.md       # Frontend expertise
@@ -52,6 +52,7 @@ This guide documents how SuperClaude's Context-Oriented Configuration Framework
 │   ├── requirements-analyst.md     # Requirements expertise
 │   ├── root-cause-analyst.md       # Problem diagnosis expertise
 │   ├── security-engineer.md        # Security expertise
+│   ├── socratic-mentor.md          # Educational expertise
 │   ├── system-architect.md         # System design expertise
 │   └── technical-writer.md         # Documentation expertise
 └── commands/                       # Workflow pattern contexts

Docs/Developer-Guide/testing-debugging.md

@@ -237,10 +237,10 @@ echo ""
 # Check installation system
 echo "1. Installation System:"
 if command -v SuperClaude &> /dev/null; then
-    echo "   ✅ SuperClaude CLI available"
+    echo "   ✅ SuperClaude installation available"
     python3 -m SuperClaude --version
 else
-    echo "   ❌ SuperClaude CLI not found - install with: pip install SuperClaude"
+    echo "   ❌ SuperClaude not found - install with: pip install SuperClaude"
 fi
 
 # Check context files

Docs/Reference/diagnostic-reference.md

@@ -46,7 +46,7 @@ ls -la ~/.claude/
 echo "=== SuperClaude Context File Diagnostic ==="
 
 # Define expected counts
-EXPECTED_AGENTS=13
+EXPECTED_AGENTS=14
 EXPECTED_COMMANDS=21
 EXPECTED_MODES=6
 

Docs/User-Guide/agents.md

@@ -815,6 +815,6 @@ Observe agent coordination patterns. Understand how complexity and domain keywor
 Master multi-domain requests that trigger optimal agent combinations. Leverage troubleshooting techniques for effective agent selection. Use advanced patterns for complex workflows.
 
 **The SuperClaude Advantage:**
-Experience the power of 13 specialized AI experts working in coordinated response, all through simple, natural language requests. No configuration, no management, just intelligent collaboration that scales with your needs.
+Experience the power of 14 specialized AI experts working in coordinated response, all through simple, natural language requests. No configuration, no management, just intelligent collaboration that scales with your needs.
 
 🎯 **Ready to experience intelligent agent coordination? Start with `/sc:implement` and discover the magic of specialized AI collaboration.**

Docs/User-Guide/flags.md

@@ -166,7 +166,7 @@
 | `--all-mcp` | Enable all MCP servers | Boolean |
 | `--no-mcp` | Native tools only | Boolean |
 
-### System Flags (SuperClaude CLI)
+### System Flags (SuperClaude Installation)
 | Flag | Purpose | Values |
 |------|---------|--------|
 | `--verbose` / `-v` | Verbose logging | Boolean |