docs: optimize CLAUDE.md for improved readability and MCP integration

[lgallard]

Summary

• Optimized CLAUDE.md from 1,281 lines to 405 lines (68% reduction)
• Enhanced with MCP (Model Context Protocol) server integration for real-time validation
• Maintained all essential development guidelines while removing redundancy

Changes Made

📉 Size Reduction (876 lines removed)

• Removed redundant example configurations: Replaced 286 lines of inline examples with a concise table referencing the existing examples/ directory
• Consolidated security patterns: Merged 4 similar validation examples into 1 comprehensive pattern
• Streamlined pre-commit section: Reduced from 163 to ~30 lines, keeping only essentials
• Optimized testing section: Removed inline code, referenced actual test files
• Condensed development patterns: Combined similar patterns, removed boilerplate

✨ New Features Added

• MCP-Powered Validation Workflow: Development lifecycle with integrated validation commands
• Quick MCP Commands Reference: Ready-to-use commands for Terraform MCP and Context7 servers
• Example Directory Table: All 16 examples with corresponding MCP validation commands
• Inline MCP validation hints: Throughout the document for real-time verification

📋 Structure Improvements

• Better organization with clear sections
• Direct references to existing files instead of duplication
• Focused on AWS Backup-specific guidance
• Enhanced with validation checkpoints

Benefits

• Faster navigation to relevant information
• No information loss - all content remains accessible
• Better maintainability with less duplication
• Real-time validation through MCP integration
• Living documentation that stays current via MCP servers

Test Plan

• Verify all essential information is preserved
• Check that all example references are valid
• Confirm MCP commands are properly formatted
• Review by maintainers for completeness
• Validate that linked files exist in repository