Skip @deprecated rules

src/DirectoryToMarkdownPrinter.php

@@ -77,6 +77,9 @@ public function print(string $workingDirectory, array $directories, ?int $catego
      */
     private function filterOutSkippedTypes(array $ruleClassWithFilePaths, array $skipTypes): array
     {
+        // remove deprecated classes, as no point in promoting them
+        $ruleClassWithFilePaths = array_filter($ruleClassWithFilePaths, static fn (RuleClassWithFilePath $ruleClassWithFilePath): bool => $ruleClassWithFilePath->isDeprecated() === false);
+
         if ($skipTypes === []) {
             return $ruleClassWithFilePaths;
         }

src/FileSystem/ClassByTypeFinder.php

@@ -37,8 +37,10 @@ public function findByType(string $workingDirectory, array $directories, string
                 continue;
             }
 
+            $isDeprecated = str_contains((string) $reflectionClass->getDocComment(), '@deprecated');
+
             $relativeFilePath = PathsHelper::relativeFromDirectory($filePath, $workingDirectory);
-            $desiredClasses[] = new RuleClassWithFilePath($class, $relativeFilePath);
+            $desiredClasses[] = new RuleClassWithFilePath($class, $relativeFilePath, $isDeprecated);
         }
 
         usort(

src/ValueObject/RuleClassWithFilePath.php

@@ -8,7 +8,8 @@ final class RuleClassWithFilePath
 {
     public function __construct(
         private readonly string $class,
-        private readonly string $path
+        private readonly string $path,
+        private readonly bool $isDeprecated
     ) {
     }
 
@@ -21,4 +22,9 @@ public function getPath(): string
     {
         return $this->path;
     }
+
+    public function isDeprecated(): bool
+    {
+        return $this->isDeprecated;
+    }
 }