ai-slop-cleaner

AI Slop Cleaner タスクカード

このバウンドされたヘルパーは、クリーンアップ・リファクタリング・deslop 作業に使用してください。競合するトップレベルのワークフローとしては使用しないでください。共通の運用上の不変条件は templates/AGENTS.md にあります。このカードでは、スコープ、スメルの分類、パス、および証拠を定義します。

使用するタイミングと入力

作業中のコードが肥大化、ノイズが多い、反復的、過度に抽象化されている、またはAI生成である場合、ユーザーがクリーンアップ・リファクタリング・deslop を依頼した場合、またはフォローアップ作業で重複コードやデッドコード、脆弱な境界、テストの欠如、フォールバックのような経路、ラッパーが残された場合に使用します。入力は、対象の機能やファイル、および維持すべき動作です。ファイル一覧によるスコープ指定は有効であり、その場合パスはそのファイルに限定してください。より広範なクリーンアップが依頼されていない限り、呼び出し元タスクで変更されたファイルに限定してください。

編集前

1. コードを変更する前に回帰テストで動作を固定する: 維持すべき動作を特定し、最も狭い範囲のターゲットテストを実行または追加します。主要な経路と、維持すべき互換性・フェイルセーフのフォールバック経路の両方をカバーしてください。
2. コードを変更する前にクリーンアップ計画を作成する: スコープとスメルを列挙し、フォールバックの検出結果・分類・エスカレーションを含め、最も安全で効果の高い修正を先に並べます。
3. スコープ内のフォールバックのようなコードを棚卸しする: 簡易的なハック、一時的な回避策、一時的なフォールバック、単にバイパスする、単にスキップする、失敗時のフォールバック、握りつぶされたエラー、サイレントなデフォルト値、広範な互換性シム、重複する代替実行経路を対象とします。
4. 各フォールバックを分類します。マスキングフォールバックのスロップは、証拠を隠す、契約をバイパスする、検証を抑制する、失敗を握りつぶす、サイレントにデフォルト値を設定する、またはテストされていない経路を追加するものです。根拠のある互換性・フェイルセーフのフォールバックは、外部・バージョン・フェイルセーフの境界で狭く限定され、根拠を文書化し、失敗の証拠を保持し、主要経路とフォールバックの両方をテストするものです。
5. 根本原因の修正、削除、境界の修正、または明示的な失敗動作を優先します。広範・曖昧・クロスレイヤー・アーキテクチャ上の検出結果については、合意形成のために $ralplan を呼び出してください。すでに ralplan、ultragoal、team、またはその他の OMX ワークフロー内にいる場合は、入れ子の $ralplan を起動せず、検出結果をアクティブなハンドオフに添付してください。

スメルの分類とパス

変更する前に分類してください:

• フォールバックのようなコード: マスキングフォールバック、回避策の分岐、バイパス、握りつぶされたエラー、サイレントなデフォルト値、広範なシム、代替経路。
• 重複: 繰り返されるロジック、コピー&ペーストされた分岐、冗長なヘルパー。
• デッドコード: 未使用・到達不能なコード、古いフラグ、デバッグの残骸。
• 不要な抽象化: パススルーのラッパー、投機的な間接参照、単一用途のレイヤー。
• 境界違反: 隠れた結合、責務の漏れ、誤ったレイヤーからのインポートや副作用。
• テストの欠如: 動作が固定されていない、またはエッジケースがカバーされていないこと。
• UI/デザインのスロップ: 絶対的な禁止ではなく、文脈に依存するシグナルです。意図的なブランド、デザインシステム、アクセシビリティ、またはプロダクト文脈上の例外は維持してください。11〜12px の韓国語本文（一般に 14px 以上が望ましい）、過剰なボックスシャドウ、繰り返しのアイブロウ＋タイトル＋説明＋段落の積み重ね、汎用的な絵文字バッジ、#3B82F6 のようなデフォルトの AI 風の青・紫、条件反射的な 3 列・4 列グリッド、文脈で正当化されない極端なグラデーションには疑問を投げかけてください。

まずフォールバックのようなコードの解決ゲートを処理し、その後一度に一つのスメルに取り組んでください: パス 1: デッドコードの削除; パス 2: 重複の削除; パス 3: 命名・エラー処理のクリーンアップ; パス 4: テストの強化。各パスの後にターゲットの検証を再実行し、無関係なリファクタリングは避けてください。既存のユーティリティの削除・再利用を優先し、明示的に必要とされない限り新しい抽象化や依存関係は追加しないでください。

証拠・出力の契約

報告には以下を含めてください:

AI SLOP CLEANUP REPORT
Scope: [files/feature]
Behavior Lock: [targeted tests added/run]
Cleanup Plan: [bounded smells/order]
Fallback Findings: [finding -> masking fallback slop | grounded compatibility/fail-safe fallback -> escalation]
UI/Design Findings: [none/N/A or signal -> action/defer -> intentional rationale]
Passes Completed: [resolution gate; Passes 1-4]
Quality Gates: Regression tests, Lint, Typecheck, Tests, Static/security scan (PASS/FAIL/N/A)
Changed Files: [path -> simplification]
Remaining Risks: [none or deferred item]

変更されたファイル、簡素化の内容、フォールバックの分類とエスカレーションの状況、実行したテスト・診断・ビルドチェック、関連する場合は UI の検出結果、および残存するリスクを含めてください。クリーンアップ計画と承認については、作成者とレビュアーの役割を分離してください。

終了条件

要求されたスコープに動作固定の証拠があり、選択された各スメル検出パスが完了しているか理由付きで延期されており、検証結果が報告され、無関係なファイルや一時的な成果物が残っていない場合に停止します。検証されていないクリーンアップを完了として提示しないでください。実際のアーキテクチャ上の障害は隠さず、エスカレーションしてください。