📚 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-12-29 16:16:08 +00:00 · 2025-08-21 19:03:25 +02:00
parent c78d5f8c01
commit 41761f405c
43 changed files with 3098 additions and 23245 deletions
--- a/Docs/Developer-Guide/documentation-index.md
+++ b/Docs/Developer-Guide/documentation-index.md
@@ -6,54 +6,52 @@ This index provides comprehensive access to all SuperClaude Framework developmen

 ### Quick Navigation

-**For New Contributors**: Start with [Contributing Code Guide → Onboarding Checklist](contributing-code.md#-comprehensive-contributor-onboarding-checklist)
+**For New Contributors**: Start with [Contributing Guide → Setup](contributing-code.md#development-setup)

-**For System Architects**: Begin with [Technical Architecture Guide → Architecture Overview](technical-architecture.md#architecture-overview)
+**For System Understanding**: Begin with [Technical Architecture Guide → Context Architecture](technical-architecture.md#context-file-architecture)

-**For Testers/QA**: Start with [Testing & Debugging Guide → Quick Start Tutorial](testing-debugging.md#quick-start-testing-tutorial)
+**For Verification**: Start with [Verification Guide → Installation Check](testing-debugging.md#installation-verification)

 ---

 ## Primary Documentation

-### 📋 [Contributing Code Guide](contributing-code.md)
-**Purpose**: Complete development workflow and contribution guidelines  
-**Target Audience**: Framework contributors and developers  
-**Length**: 2,200+ lines with comprehensive examples and procedures
+### 📋 [Contributing Context Files Guide](contributing-code.md)
+**Purpose**: Complete context file development and contribution guidelines  
+**Target Audience**: Framework contributors and context file developers  
+**Length**: ~1,000 lines focused on context file reality

 **Key Sections**:
 - [Development Setup](contributing-code.md#development-setup) - Environment configuration and prerequisites
- [Comprehensive Contributor Onboarding](contributing-code.md#-comprehensive-contributor-onboarding-checklist) - 45-minute guided setup
+- [Context File Guidelines](contributing-code.md#context-file-guidelines) - Standards and structure
 - [Development Workflow](contributing-code.md#development-workflow) - Git workflow and submission process
- [Contributing to V4 Components](contributing-code.md#contributing-to-v4-components) - Agent, mode, and MCP development
- [Security Guidelines](contributing-code.md#security-guidelines) - Secure coding practices
- [Glossary](contributing-code.md#glossary) - 90+ technical terms with definitions
+- [Contributing to Components](contributing-code.md#contributing-to-components) - Agent, command, and mode development
+- [File Validation](contributing-code.md#file-validation) - Context file verification methods

-### 🏗️ [Technical Architecture Guide](technical-architecture.md)
-**Purpose**: Comprehensive system architecture and technical specifications  
-**Target Audience**: System architects, advanced developers, framework maintainers  
-**Length**: 3,140+ lines with detailed diagrams and technical analysis
+### 🏗️ [Context Architecture Guide](technical-architecture.md)
+**Purpose**: Understanding how context files work and are structured  
+**Target Audience**: Anyone wanting to understand or extend SuperClaude  
+**Length**: ~800 lines focused on context file patterns and Claude Code integration

 **Key Sections**:
- [Architecture Overview](technical-architecture.md#architecture-overview) - Multi-layered orchestration patterns
- [Agent Coordination](technical-architecture.md#agent-coordination) - 13-agent collaboration architecture
- [MCP Integration](technical-architecture.md#mcp-integration) - External tool coordination protocols
- [Security Architecture](technical-architecture.md#security-architecture) - Multi-layer security model
- [Performance System](technical-architecture.md#performance-system) - Optimization and resource management
- [Architecture Glossary](technical-architecture.md#architecture-glossary) - 75+ architectural terms
+- [Context File Architecture](technical-architecture.md#context-file-architecture) - Directory structure and file types
+- [The Import System](technical-architecture.md#the-import-system) - How Claude Code loads context
+- [Agent Context Structure](technical-architecture.md#agent-context-structure) - Domain specialist contexts
+- [Command Context Structure](technical-architecture.md#command-context-structure) - Workflow patterns
+- [How Claude Code Reads Context](technical-architecture.md#how-claude-code-reads-context) - Processing sequence
+- [Extending the Framework](technical-architecture.md#extending-the-framework) - Adding new components

-### 🧪 [Testing & Debugging Guide](testing-debugging.md)
-**Purpose**: Comprehensive testing strategies and debugging procedures  
-**Target Audience**: QA engineers, testers, contributors  
-**Length**: 4,815+ lines with practical examples and frameworks
+### 🧪 [Verification & Troubleshooting Guide](testing-debugging.md)
+**Purpose**: Verifying installation and troubleshooting context file issues  
+**Target Audience**: Users and maintainers  
+**Length**: ~500 lines focused on file verification and Claude Code integration

 **Key Sections**:
- [Quick Start Testing Tutorial](testing-debugging.md#quick-start-testing-tutorial) - Basic testing setup
- [Testing Framework](testing-debugging.md#testing-framework) - Development testing procedures
- [Performance Testing & Optimization](testing-debugging.md#performance-testing--optimization) - Benchmarking
- [Security Testing](testing-debugging.md#security-testing) - Vulnerability validation
- [Integration Testing](testing-debugging.md#integration-testing) - End-to-end workflows
- [Testing Glossary](testing-debugging.md#testing-glossary) - 65+ testing terms
+- [Installation Verification](testing-debugging.md#installation-verification) - Check context file installation
+- [Context File Verification](testing-debugging.md#context-file-verification) - File structure validation
+- [MCP Server Verification](testing-debugging.md#mcp-server-verification) - External tool configuration
+- [Common Issues](testing-debugging.md#common-issues) - Troubleshooting activation problems
+- [Troubleshooting Commands](testing-debugging.md#troubleshooting-commands) - Diagnostic procedures

 ---

@@ -62,214 +60,168 @@ This index provides comprehensive access to all SuperClaude Framework developmen
 ### 🚀 Getting Started

 **Complete Beginners**:
-1. [Contributing Code → Onboarding Checklist](contributing-code.md#-comprehensive-contributor-onboarding-checklist) - 45-minute setup
-2. [Testing Guide → Quick Start Tutorial](testing-debugging.md#quick-start-testing-tutorial) - Basic testing
-3. [Architecture → System Design Principles](technical-architecture.md#system-design-principles) - Core concepts
+1. [Contributing Guide → Setup](contributing-code.md#development-setup) - Environment setup
+2. [Architecture Guide → Overview](technical-architecture.md#overview) - Understanding context files
+3. [Verification Guide → Installation Check](testing-debugging.md#installation-verification) - Basic verification

 **Environment Setup**:
 - [Development Setup](contributing-code.md#development-setup) - Prerequisites and configuration
- [Testing Environment Setup](testing-debugging.md#testing-environment-setup) - Test configuration
- [Docker Development Environment](contributing-code.md#development-environment-setup) - Containerized setup
-
-**Prerequisites Validation**:
- [Prerequisites Validation](contributing-code.md#prerequisites-validation) - Environment verification
- [System Check Scripts](contributing-code.md#development-environment-setup) - Automated validation
+- [Installation Verification](testing-debugging.md#installation-verification) - File installation check

 ### 🏗️ Architecture & Design

-**System Architecture**:
- [Architecture Overview](technical-architecture.md#architecture-overview) - Complete system design
- [Detection Engine](technical-architecture.md#detection-engine) - Task classification
- [Routing Intelligence](technical-architecture.md#routing-intelligence) - Resource allocation
- [Orchestration Layer](technical-architecture.md#orchestration-layer) - Component coordination
+**Context File Architecture**:
+- [Context File Architecture](technical-architecture.md#context-file-architecture) - Complete system design
+- [The Import System](technical-architecture.md#the-import-system) - How Claude Code loads context
+- [Agent Context Structure](technical-architecture.md#agent-context-structure) - Domain specialist patterns
+- [Command Context Structure](technical-architecture.md#command-context-structure) - Workflow definitions

-**Agent System**:
- [Agent Coordination](technical-architecture.md#agent-coordination) - Multi-agent collaboration
- [Creating New Agents](contributing-code.md#creating-new-agents) - Agent development
- [Agent Testing](testing-debugging.md#testing-framework) - Agent validation
+**Component Development**:
+- [Contributing to Components](contributing-code.md#contributing-to-components) - Agent, command, mode development
+- [Adding New Agents](contributing-code.md#adding-new-agents) - Domain specialist creation
+- [Adding New Commands](contributing-code.md#adding-new-commands) - Workflow pattern development
+- [Extending the Framework](technical-architecture.md#extending-the-framework) - Framework expansion

-**MCP Integration**:
- [MCP Integration](technical-architecture.md#mcp-integration) - External tool coordination
- [MCP Server Integration](contributing-code.md#mcp-server-integration) - Development guide
- [MCP Server Testing](testing-debugging.md#integration-testing) - Integration validation
+### 🧪 Verification & Quality

-### 🧪 Testing & Quality
+**File Verification**:
+- [Context File Verification](testing-debugging.md#context-file-verification) - File structure validation
+- [File Validation](contributing-code.md#file-validation) - Context file verification methods

-**Testing Frameworks**:
- [Testing Framework](testing-debugging.md#testing-framework) - Core testing procedures
- [Component Testing](testing-debugging.md#debugging-superclaude-components) - Component validation
- [Integration Testing](testing-debugging.md#integration-testing) - End-to-end workflows
-
-**Performance & Optimization**:
- [Performance Testing](testing-debugging.md#performance-testing--optimization) - Benchmarking
- [Performance System](technical-architecture.md#performance-system) - Architecture optimization
- [Performance Requirements](contributing-code.md#📈-performance-testing-requirements) - Standards
-
-**Security & Validation**:
- [Security Testing](testing-debugging.md#security-testing) - Vulnerability validation
- [Security Architecture](technical-architecture.md#security-architecture) - Security model
- [Security Guidelines](contributing-code.md#security-guidelines) - Development practices
+**Troubleshooting**:
+- [Common Issues](testing-debugging.md#common-issues) - Activation and configuration problems
+- [Troubleshooting Commands](testing-debugging.md#troubleshooting-commands) - Diagnostic procedures

 ### 🔧 Development Workflows

-**Code Contribution**:
+**Context File Development**:
 - [Development Workflow](contributing-code.md#development-workflow) - Git workflow
- [Code Contribution Guidelines](contributing-code.md#code-contribution-guidelines) - Standards
- [Pull Request Process](contributing-code.md#development-workflow) - Submission process
+- [Context File Guidelines](contributing-code.md#context-file-guidelines) - Standards and practices
+- [Pull Request Process](contributing-code.md#pull-request-template) - Submission process

 **Component Development**:
- [V4 Components](contributing-code.md#contributing-to-v4-components) - Agent, mode, MCP development
- [Behavioral Modes](contributing-code.md#developing-behavioral-modes) - Mode development
- [Session Enhancement](contributing-code.md#enhancing-session-lifecycle) - Session development
+- [Agent Development](contributing-code.md#adding-new-agents) - Domain specialist creation
+- [Command Development](contributing-code.md#adding-new-commands) - Workflow pattern creation
+- [Mode Development](contributing-code.md#adding-new-modes) - Behavioral modification patterns

-**Quality Assurance**:
- [Quality Framework](technical-architecture.md#quality-framework) - Validation systems
- [Quality Validation](testing-debugging.md#quality-validation) - QA frameworks
- [Backward Compatibility](contributing-code.md#🔄-backward-compatibility-guidelines) - Compatibility testing
+### 🛠️ MCP Integration

-### 🛡️ Security & Compliance
+**MCP Configuration**:
+- [MCP Server Configuration](technical-architecture.md#mcp-server-configuration) - External tool setup
+- [MCP Server Verification](testing-debugging.md#mcp-server-verification) - Configuration validation

-**Security Development**:
- [Security Guidelines](contributing-code.md#security-guidelines) - Secure coding
- [Security Architecture](technical-architecture.md#security-architecture) - System security
- [Security Testing](testing-debugging.md#security-testing) - Security validation
-
-**Compliance & Standards**:
- [Code Review Security](contributing-code.md#code-review-security-checklist) - Review checklist
- [Security Incident Response](contributing-code.md#security-incident-response) - Response procedures
- [Vulnerability Testing](testing-debugging.md#security-testing) - Vulnerability assessment
-
-### 🚨 Troubleshooting & Support
+### 🚨 Support & Troubleshooting

 **Common Issues**:
- [Error Handling](contributing-code.md#error-handling-and-troubleshooting) - Development issues
- [Troubleshooting Guide](testing-debugging.md#troubleshooting-guide) - Testing issues
- [Error Handling Architecture](technical-architecture.md#error-handling-architecture) - System recovery
+- [Commands Not Working](testing-debugging.md#issue-commands-not-working) - Context trigger problems
+- [Agents Not Activating](testing-debugging.md#issue-agents-not-activating) - Activation issues
+- [Context Not Loading](testing-debugging.md#issue-context-not-loading) - Loading problems

 **Support Resources**:
 - [Getting Help](contributing-code.md#getting-help) - Support channels
- [Community Resources](testing-debugging.md#community-resources) - Community support
- [Development Support](testing-debugging.md#troubleshooting-guide) - Technical assistance
+- [Issue Reporting](contributing-code.md#issue-reporting) - Bug reports and features

 ---

 ## Skill Level Pathways

-### 🟢 Beginner Path (0-3 months)
+### 🟢 Beginner Path (Understanding SuperClaude)

-**Week 1-2: Foundation**
-1. [Contributing Code → Onboarding Checklist](contributing-code.md#-comprehensive-contributor-onboarding-checklist)
-2. [Testing Guide → Quick Start Tutorial](testing-debugging.md#quick-start-testing-tutorial)
-3. [Architecture → Core Concepts](technical-architecture.md#core-architecture-terminology)
+**Week 1: Foundation**
+1. [Architecture Overview](technical-architecture.md#overview) - What SuperClaude is
+2. [Installation Verification](testing-debugging.md#installation-verification) - Check your setup
+3. [Context File Architecture](technical-architecture.md#context-file-architecture) - Directory structure

-**Week 3-4: Basic Development**
-1. [Development Setup](contributing-code.md#development-setup)
-2. [Basic Testing](testing-debugging.md#testing-framework)
-3. [Code Guidelines](contributing-code.md#code-contribution-guidelines)
+**Week 2: Basic Usage**
+1. [How Claude Code Reads Context](technical-architecture.md#how-claude-code-reads-context) - Processing sequence
+2. [Common Issues](testing-debugging.md#common-issues) - Troubleshooting basics
+3. [Context File Guidelines](contributing-code.md#context-file-guidelines) - File standards

-**Month 2-3: Component Understanding**
-1. [Architecture Overview](technical-architecture.md#architecture-overview)
-2. [Component Testing](testing-debugging.md#debugging-superclaude-components)
-3. [First Contribution](contributing-code.md#development-workflow)
+### 🟡 Intermediate Path (Contributing Context Files)

-### 🟡 Intermediate Path (3-9 months)
+**Month 1: Context Development**
+1. [Development Setup](contributing-code.md#development-setup) - Environment preparation
+2. [Agent Context Structure](technical-architecture.md#agent-context-structure) - Domain specialists
+3. [Command Context Structure](technical-architecture.md#command-context-structure) - Workflow patterns

-**Months 3-6: Component Development**
-1. [Agent Development](contributing-code.md#creating-new-agents)
-2. [Behavioral Modes](contributing-code.md#developing-behavioral-modes)
-3. [Integration Testing](testing-debugging.md#integration-testing)
+**Month 2: Component Creation**
+1. [Adding New Agents](contributing-code.md#adding-new-agents) - Domain specialist development
+2. [Adding New Commands](contributing-code.md#adding-new-commands) - Workflow creation
+3. [File Validation](contributing-code.md#file-validation) - Context verification

-**Months 6-9: System Integration**
-1. [MCP Integration](contributing-code.md#mcp-server-integration)
-2. [Performance Testing](testing-debugging.md#performance-testing--optimization)
-3. [Security Practices](contributing-code.md#security-guidelines)
+### 🔴 Advanced Path (Framework Extension)

-### 🔴 Advanced Path (9+ months)
-
-**Advanced Architecture**
-1. [System Architecture](technical-architecture.md#architecture-overview)
-2. [Security Architecture](technical-architecture.md#security-architecture)
-3. [Performance System](technical-architecture.md#performance-system)
-
-**Framework Extension**
-1. [Extension Architecture](technical-architecture.md#extensibility)
-2. [Custom Development](contributing-code.md#contributing-to-v4-components)
-3. [Release Process](contributing-code.md#release-process)
+**Advanced Understanding**
+1. [The Import System](technical-architecture.md#the-import-system) - Context loading mechanics
+2. [Extending the Framework](technical-architecture.md#extending-the-framework) - Framework expansion
+3. [MCP Server Configuration](technical-architecture.md#mcp-server-configuration) - External tool integration

 ---

 ## Reference Materials

-### 📚 Glossaries
+### 📚 Key Concepts

-**Technical Terms**:
- [Contributing Code Glossary](contributing-code.md#glossary) - 90+ development terms
- [Architecture Glossary](technical-architecture.md#architecture-glossary) - 75+ architectural terms
- [Testing Glossary](testing-debugging.md#testing-glossary) - 65+ testing terms
-
-**Framework Concepts**:
- Meta-Framework Architecture
- Agent Coordination Protocols  
+**Framework Fundamentals**:
+- Context-Oriented Configuration Framework
+- Agent Domain Specialists  
+- Command Workflow Patterns
+- Mode Behavioral Modifications
 - MCP Integration Patterns
- Behavioral Programming Models
- Configuration-Driven Development

 ### 🔗 Cross-References

 **Development → Architecture**:
- [Component Architecture](contributing-code.md#architecture-overview) → [Technical Architecture](technical-architecture.md#architecture-overview)
- [Agent Development](contributing-code.md#creating-new-agents) → [Agent Coordination](technical-architecture.md#agent-coordination)
+- [Context File Guidelines](contributing-code.md#context-file-guidelines) → [Context File Architecture](technical-architecture.md#context-file-architecture)
+- [Adding Components](contributing-code.md#contributing-to-components) → [Agent/Command Structure](technical-architecture.md#agent-context-structure)

-**Development → Testing**:
- [Development Workflow](contributing-code.md#development-workflow) → [Testing Framework](testing-debugging.md#testing-framework)
- [Security Guidelines](contributing-code.md#security-guidelines) → [Security Testing](testing-debugging.md#security-testing)
+**Development → Verification**:
+- [Development Workflow](contributing-code.md#development-workflow) → [File Verification](testing-debugging.md#context-file-verification)
+- [File Validation](contributing-code.md#file-validation) → [Installation Verification](testing-debugging.md#installation-verification)

-**Architecture → Testing**:
- [Performance System](technical-architecture.md#performance-system) → [Performance Testing](testing-debugging.md#performance-testing--optimization)
- [Error Handling](technical-architecture.md#error-handling-architecture) → [Troubleshooting](testing-debugging.md#troubleshooting-guide)
+**Architecture → Verification**:
+- [How Claude Code Reads Context](technical-architecture.md#how-claude-code-reads-context) → [Troubleshooting](testing-debugging.md#common-issues)
+- [MCP Configuration](technical-architecture.md#mcp-server-configuration) → [MCP Verification](testing-debugging.md#mcp-server-verification)

 ---

-## Quality Validation
+## Quality Standards

-### ✅ Documentation Standards
- **Accessibility**: WCAG 2.1 compliant with screen reader support
- **Technical Accuracy**: All examples tested and verified
- **Cross-Platform**: Works across Linux, macOS, Windows
- **Professional Quality**: Suitable for framework-level development
+### ✅ Documentation Accuracy
+- **Technical Precision**: All examples reflect SuperClaude reality (context files, not software)
+- **Command Accuracy**: Correct Python module execution paths and Claude Code context triggers
+- **No Fiction**: Removed all references to non-existent testing frameworks and performance systems

-### ✅ Content Completeness
- **240+ Glossary Terms**: Comprehensive technical definitions
- **15+ Architectural Diagrams**: With accessibility descriptions
- **50+ Cross-References**: Strategic linking between concepts
- **Complete Workflows**: End-to-end development procedures
+### ✅ Content Focus
+- **Context Files**: Documentation centers on .md instruction files and Claude Code behavior
+- **File Verification**: Practical approaches to validating context file installation and structure
+- **Real Workflows**: Actual development processes for context file contribution

 ### ✅ User Experience
- **Skill Level Guidance**: Clear progression paths for all experience levels
- **Time Estimates**: Realistic expectations for learning activities
- **Support Integration**: Clear guidance to help resources
- **Framework Alignment**: Documentation quality matches framework sophistication
+- **Clear Progression**: Skill-based learning paths from understanding to contribution
+- **Practical Examples**: Working context file examples and Claude Code integration
+- **Support Integration**: Clear guidance to help resources for real issues

 ---

 ## Usage Guidelines

 ### For Contributors
-1. **Start with**: [Onboarding Checklist](contributing-code.md#-comprehensive-contributor-onboarding-checklist)
-2. **Development**: Follow [Contributing Workflow](contributing-code.md#development-workflow)
-3. **Testing**: Use [Testing Framework](testing-debugging.md#testing-framework)
+1. **Start with**: [Development Setup](contributing-code.md#development-setup)
+2. **Context Development**: Follow [Context File Guidelines](contributing-code.md#context-file-guidelines)
+3. **Validation**: Use [File Validation](contributing-code.md#file-validation)
 4. **Support**: Reference [Getting Help](contributing-code.md#getting-help)

 ### For Architects
-1. **System Understanding**: [Architecture Overview](technical-architecture.md#architecture-overview)
-2. **Design Patterns**: [Agent Coordination](technical-architecture.md#agent-coordination)
-3. **Integration**: [MCP Architecture](technical-architecture.md#mcp-integration)
-4. **Performance**: [Performance System](technical-architecture.md#performance-system)
+1. **System Understanding**: [Context File Architecture](technical-architecture.md#context-file-architecture)
+2. **Component Patterns**: [Agent and Command Structure](technical-architecture.md#agent-context-structure)
+3. **Extension**: [Extending the Framework](technical-architecture.md#extending-the-framework)
+4. **Integration**: [MCP Configuration](technical-architecture.md#mcp-server-configuration)

-### For QA/Testers
-1. **Quick Start**: [Testing Tutorial](testing-debugging.md#quick-start-testing-tutorial)
-2. **Framework Testing**: [Testing Framework](testing-debugging.md#testing-framework)
-3. **Security Validation**: [Security Testing](testing-debugging.md#security-testing)
-4. **Performance Testing**: [Performance & Optimization](testing-debugging.md#performance-testing--optimization)
+### For Verification
+1. **Installation Check**: [Installation Verification](testing-debugging.md#installation-verification)
+2. **File Validation**: [Context File Verification](testing-debugging.md#context-file-verification)
+3. **Troubleshooting**: [Common Issues](testing-debugging.md#common-issues)
+4. **Diagnostics**: [Troubleshooting Commands](testing-debugging.md#troubleshooting-commands)

-This comprehensive index ensures efficient navigation and discovery of SuperClaude Framework development information, supporting contributors at all skill levels and technical requirements.
+This comprehensive index reflects the reality of SuperClaude as a context-oriented configuration framework, focusing on practical context file development and Claude Code integration.