docs: consolidate documentation into organized structure

- Move 12 markdown files from root to docs/ subdirectories
- Organize documentation by category:
  • docs/troubleshooting/ (1 file)  - Technical troubleshooting guides
  • docs/deployment/      (4 files) - Deployment and security documentation
  • docs/guides/          (3 files) - Feature-specific guides
  • docs/planning/        (4 files) - Planning and improvement proposals

Root directory cleanup:
- Reduced from 16 to 4 markdown files in root
- Only essential project files remain:
  • CLAUDE.md (AI instructions)
  • README.md (Main project readme)
  • CLEANUP_PLAN.md (Current cleanup plan)
  • SRC_STRUCTURE_IMPROVEMENTS.md (Structure improvements)

This improves:
✅ Documentation discoverability
✅ Logical organization by purpose
✅ Clean root directory
✅ Better maintainability

src/Framework/Discovery/ValueObjects/DiscoveredAttribute.php

@@ -226,6 +226,12 @@ final readonly class DiscoveredAttribute
                     $sanitizedAdditionalData[$key] = (string)$value;
                 } elseif (method_exists($value, 'getFullyQualified')) {
                     $sanitizedAdditionalData[$key] = $value->getFullyQualified();
+                } elseif ($value instanceof \BackedEnum) {
+                    // Handle PHP backed enums (like Method::GET)
+                    $sanitizedAdditionalData[$key] = $value->value;
+                } elseif ($value instanceof \UnitEnum) {
+                    // Handle PHP unit enums
+                    $sanitizedAdditionalData[$key] = $value->name;
                 } else {
                     // Skip unsupported objects to prevent serialization issues
                     continue;