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

@@ -67,4 +67,46 @@ final readonly class DiscoveryOptions
             includePatterns: $this->includePatterns
         );
     }
+
+    /**
+     * Create default discovery options
+     */
+    public static function default(): self
+    {
+        return new self();
+    }
+
+    /**
+     * Create comprehensive discovery options
+     */
+    public static function comprehensive(): self
+    {
+        return new self(
+            scanType: ScanType::FULL,
+            paths: ['/src', '/app'],
+            useCache: true,
+            parallel: true,
+            batchSize: 100,
+            showProgress: true,
+            excludePatterns: [],
+            includePatterns: ['*.php']
+        );
+    }
+
+    /**
+     * Create minimal discovery options
+     */
+    public static function minimal(): self
+    {
+        return new self(
+            scanType: ScanType::INCREMENTAL,
+            paths: ['/src'],
+            useCache: true,
+            parallel: false,
+            batchSize: 25,
+            showProgress: false,
+            excludePatterns: ['*/test/*', '*/tests/*'],
+            includePatterns: ['*.php']
+        );
+    }
 }