[DOCS] Add Comprehensive Automation System Guide

[raegAI]

This PR creates comprehensive documentation for the Claude Code automation system.

Documentation Added

• docs/AUTOMATION_GUIDE.md - Complete guide to the automation system
• Updated README.md - Links to automation guide
• Enhanced CLAUDE.md - Project configuration and guidelines

Documentation Guide Features

• System Overview: Complete explanation of the automation pipeline
• Workflow Architecture: Mermaid diagrams showing workflow interactions
• Usage Instructions: Step-by-step guide for creating automation requests
• Workflow Details: In-depth explanation of each workflow stage
• Best Practices: Security considerations, request formulation, troubleshooting
• Configuration Files: Documentation for CLAUDE.md and issue templates

Architecture Documentation

graph TD
    A[Issue with @claude] --> B[claude.yml - Main Workflow]
    B --> C[claude-test-debug.yml - Testing]
    C --> D[claude-documentation.yml - Docs]
    D --> E[claude-monitor-merge.yml - Merge]
    E --> F[Automated Merge & Close]

Loading

User Guide Sections

• Creating Automation Requests: Using issue templates, proper @claude syntax
• Monitoring Progress: Tracking workflow status, understanding /CC_progress documentation
• Quality Gates and Merging: Automatic merging conditions, manual intervention scenarios
• Integration with Existing Workflow: How automation preserves existing development practices

Technical Documentation

• Workflow Details: Each workflow's triggers, outputs, and capabilities
• Configuration Management: CLAUDE.md usage and issue template guidelines
• Troubleshooting: Common failure scenarios and resolution procedures
• Security Considerations: API key handling, code review requirements

Examples and Use Cases

• Feature implementation automation examples
• Bug fix automation examples
• Documentation update examples
• Refactoring task examples

Integration Benefits

• Comprehensive Reference: Definitive guide for using Claude Code automation
• Onboarding: Clear instructions for new users
• Troubleshooting: Detailed problem resolution guidance
• Best Practices: Security and quality considerations

This documentation ensures users can effectively leverage the full automation system capabilities.

Closes #10

Generated with Claude Code automation system.