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/DiscoveryRegistryInitializer.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Discovery;
+
+use App\Framework\Context\ContextType;
+use App\Framework\DI\Initializer;
+use App\Framework\Discovery\Results\AttributeRegistry;
+use App\Framework\Discovery\Results\DiscoveryRegistry;
+use App\Framework\Discovery\Results\InterfaceRegistry;
+use App\Framework\Discovery\Results\TemplateRegistry;
+use App\Framework\Discovery\Runtime\DiscoveryLoader;
+
+/**
+ * Lädt Discovery-Daten aus gespeicherten Dateien und erstellt DiscoveryRegistry
+ *
+ * Dieser Initializer ersetzt den alten UnifiedDiscoveryService und lädt
+ * die vorher gescannten Discovery-Daten aus storage/discovery/
+ */
+final readonly class DiscoveryRegistryInitializer
+{
+    public function __construct(
+        private DiscoveryLoader $discoveryLoader
+    ) {
+    }
+
+    #[Initializer(ContextType::ALL)]
+    public function __invoke(): DiscoveryRegistry
+    {
+        // Lade alle Discovery-Daten aus Storage
+        $attributes = $this->discoveryLoader->loadAttributes() ?? new AttributeRegistry();
+        $interfaces = $this->discoveryLoader->loadInterfaces() ?? new InterfaceRegistry();
+        $templates = $this->discoveryLoader->loadTemplates() ?? new TemplateRegistry();
+
+        // Erstelle und returne DiscoveryRegistry mit geladenen Daten
+        return new DiscoveryRegistry(
+            attributes: $attributes,
+            interfaces: $interfaces,
+            templates: $templates
+        );
+    }
+}