# Clean-Cut-MCP Project Mapping
This directory contains comprehensive documentation and analysis of the Clean-Cut-MCP project structure, similar to professional project documentation.
## 📋 Contents
### Core Documentation
- **[PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md)** - Complete project overview and architecture
- **[COMPONENT_ARCHITECTURE.md](./COMPONENT_ARCHITECTURE.md)** - Component relationships and hierarchy
- **[MCP_SERVER_ARCHITECTURE.md](./MCP_SERVER_ARCHITECTURE.md)** - MCP server tools and validation system
- **[VALIDATION_SYSTEM.md](./VALIDATION_SYSTEM.md)** - Validation rules and enforcement mechanisms
- **[DEVELOPMENT_WORKFLOW.md](./DEVELOPMENT_WORKFLOW.md)** - Development and deployment guide
### Interactive Analysis Tool
- **[Project Deep Dive Skill](../.claude/skills/project-deep-dive.js)** - Interactive skill for real-time project analysis
## 🎯 Purpose
This mapping provides:
1. **Complete Directory Structure** - Every file and directory with its purpose
2. **Component Architecture** - React components, their relationships, and data flow
3. **MCP Server Details** - All 18 tools, validation system, and learning capabilities
4. **Docker Architecture** - Container setup, bind mounts, and deployment workflow
5. **Development Workflow** - Build, test, and deployment processes
6. **Validation System** - Professional standards and user learning mechanisms
## 🔍 Using the Interactive Skill
To perform a real-time deep dive analysis of the project:
```bash
# Run the skill directly
node .claude/skills/project-deep-dive.js
```
The skill will:
- Analyze the current project structure
- Map all components and their relationships
- Document MCP tools and validation rules
- Analyze Docker configuration and workflow
- Generate a comprehensive report
## 📊 Key Findings
### Project Scale
- **18 MCP tools** across 5 categories
- **20+ animation components** with shared utilities
- **Multi-stage Docker architecture** with optimized bind mounts
- **Comprehensive validation system** with user learning
- **Professional broadcast standards** enforcement
### Architecture Highlights
- **MCP Server Core**: AST-based validation with auto-correction
- **Animation Workspace**: Template-based component creation
- **Docker Integration**: Environment-aware path resolution
- **Learning System**: User preference storage and application
- **Professional Quality**: Broadcast-ready animation standards
### Development Features
- **Hot Reload**: Real-time preview in Remotion Studio
- **Quick Deploy**: Fast iteration for code changes
- **Comprehensive Testing**: Unit, integration, and end-to-end tests
- **Documentation-Driven**: Clear standards and guidelines
## 🏗️ Architecture Overview
```
Claude Desktop → MCP Server → Validation → Animation Workspace → Remotion Studio
↓ ↓ ↓ ↓ ↓
User Input → Code Gen → Quality Ctrl → File System → Preview
```
## 📚 Documentation Priority
This mapping follows the project's documentation hierarchy:
1. **Highest Priority**: `claude-dev-guidelines/` - Project standards
2. **Configuration**: `PROJECT_CONFIG.md` values
3. **Reference**: This mapping documentation
## 🚀 Getting Started
1. **Read the Core Documentation** - Start with PROJECT_STRUCTURE.md
2. **Explore Components** - Review COMPONENT_ARCHITECTURE.md
3. **Understand Validation** - Study VALIDATION_SYSTEM.md
4. **Set Up Development** - Follow DEVELOPMENT_WORKFLOW.md
5. **Use Interactive Skill** - Run the deep dive analysis
## 🎯 Professional Standards
This project demonstrates:
- **Enterprise-grade architecture** with proper separation of concerns
- **Quality assurance** through comprehensive validation
- **User experience** via learning systems and auto-correction
- **Developer productivity** with hot reload and quick deployment
- **Documentation excellence** with clear standards and guidelines
---
*Generated for Clean-Cut-MCP AI-powered video generation system*
