Mister Clean

Mister Clean は、リポジトリの作業を最後まで完了させるためのエージェントスキルです。完了負債の返済、計画と Git 状態の整合、結果の検証、そして後任者がすぐに引き継げるコードベースの整備を行います。その前提はシンプルです。リポジトリは次のチームへのプロンプトであり、きれいに引き継がれたコードベースはインテリジェントな勢いを生み出しますが、未完了のままのコードベースはその後のすべてのセッションにわたって負債を複利で積み上げます。

起動は、スキルに文書化された手順に対する常設の承認です。通常のスコープ内クリーンアップは、キューに入れずに実行されます。ハードな安全性と所有権の境界は、引き続きハードな境界として維持されます。

スキルを使用する

このリポジトリをエージェントハーネスにスキルとしてインストールし、次を起動します:

$mister-clean

エントリポイントは SKILL.md です。現在のリポジトリに関連する場合にのみ、焦点を絞ったリファレンスにルーティングします。

Related MCP server: capalith

MCP サーバーを使用する

ローカルの stdio サーバーを実行します:

npx -y --package @bradheitmann/mister-clean mister-clean-mcp

または、Streamable HTTP クライアントを次に接続します:

https://mister-clean.bradheitmann.ai/mcp

MCP サーバーは意図的に読み取り専用です。正規のスキル、リファレンス、テンプレート、例、およびクローズアウトプロンプトを公開します。呼び出し側エージェントは、リポジトリポリシーと所有権を検証できるローカルで承認された作業を実行します。

クローズアウトを検証する

権威あるローカルバリデータは、Node 互換の 1 つの CLI を通じて公開されます:

mister-clean validate report path/to/closeout-report.json
mister-clean validate manifest path/to/action-manifest.json
mister-clean validate bundle path/to/closure-bundle.json --repo path/to/live-checkout
mister-clean audit planning path/to/live-checkout --json

計画監査は、実行可能な後任準備完了性の最低基準です。Markdown/MDX の YAML フロントマターとトップレベルの JSON および YAML オブジェクトレコードを解析し、計画ディレクトリと ROADMAP.md、STATUS.md、PLAN.md、TASKS.md、BACKLOG.md、CURRENT.md などの正確な正規ファイルの両方を検出し、物理レーンと現在の本文状態を調整し、構造化リストと子テーブルから正確な子 ID を解決し、同じ受け入れゲートの重複した投影をグループ化します。不正な構造化レコード、サポートされていないライフサイクルまたはゲート状態、矛盾する親子関係、バンドルのみのアーカイブラベル、完了した子の後の欠落ゲート、未実行または失敗した受け入れは、すべて非ゼロを返します。すべての計画項目は、検証済みのライフサイクル/関係グラフに構造的に配置されるか、根拠付きで非アーティファクトのガイダンスとして明示的に分類される必要があります。ガイダンス/テンプレート/スキーマのラベルがライフサイクル、アイデンティティ、関係、子テーブル、または受け入れシグナルを上書きすることはありません。受け入れは、構造化された根拠がある場合にのみ not_applicable にできます。リポジトリ固有のスキーマとバリデータは、この保守的なクロスリポジトリゲートに加えて引き続き実行されます。

子参照には明示的な意味上の役割があります。通常の作業アーティファクトは child_parentage を使用します。子行は正確に 1 つのアーティファクトに解決され、グラフエッジを作成します。index、status_index、または rollup と型指定されたアーティファクトは rollup_projection を使用します。すべての行は引き続き一意に解決され、現在の状態と一致する必要がありますが、2 番目の親になることはありません。リポジトリ固有のアーティファクトは、relationship_role: child_parentage または relationship_role: rollup_projection に加えて relationship_role_rationale でデフォルトを上書きできます。サポートされていない、競合する、曖昧な、または説明のない上書きはフェイルクローズします。組み込みの階層型およびロールアップ型は不変の役割を持つため、根拠によってストーリー/タスクをインデックスとして再ラベル付けしたり、インデックスを親として再ラベル付けしたりすることはできません。ロールアップは正規の作業項目ターゲット列を認識します。リポジトリ固有の列には rollup_target_column と rollup_target_column_rationale が必要です。カスタム親テーブルは child_target_column と child_target_column_rationale を使用します。認識された、または宣言されたターゲット列のない状態を保持する関係テーブルはフェイルクローズします。テーブル行と構造化された子コレクションエントリにはすべて、解決可能なアイデンティティが 1 つ含まれている必要があります。投影された状態は認識され、整合性が取れている必要があります。CamelCase と snake_case のレコードキーは同じスキーマを共有します。通常の階層アーティファクトは、non_relationship_table_columns と non_relationship_table_rationale を使用してチェックリスト/決定テーブルのターゲット列を除外できます。ロールアップアーティファクトと正規の関係/ライフサイクル列は、そのエスケープを使用できません。 アーティファクトタイプ、アイデンティティ、ライフサイクル、役割、ターゲット、根拠、および top_level エイリアスは存在認識型です。宣言された各単数エイリアスには、空でないスカラーが 1 つ含まれている必要があり、同等のエイリアスは一致している必要があります。推論またはデフォルトは、対応するエイリアスが存在しない場合にのみ許可されます。重複する JSON キー、サポートされていない状態のようなエイリアス、不正な関係スコープ、および複合ライフサイクルの散文はフェイルクローズします。アイデンティティを確立するのは、アーティファクト自身の型付き ID と汎用の id のみであり、親フィールドではありません。単数、複数、スネークケース、キャメルケースの子/親参照エイリアスは、エントリごとに調整されます。親参照のライフサイクルは、解決された親と一致する必要があります。

受け入れの発見は、サポートされている親関係を構造化レコードを通じて再帰的に追跡し、宣言されたすべての成果スコープを検証します。not_applicable の根拠は、その正確なスコープ内にある必要があります。構造化された JSON/YAML が散文として再解釈されることはありません。Markdown スキャンは、フェンスで囲まれた例と HTML コメントを無視しながら、表示されている見出しとブロッククォートの状態ラベル、受け入れラベル、保留中のレビュー文言、および未チェックの受け入れ項目を引き続き調整します。ネストされた正規の作業宣言と型未解決の階層エイリアスは、汎用メタデータや非アーティファクト分類の背後に隠れることはできません。検出された計画ルート内のサポートされていない、バイナリ、およびシンボリックリンクされたエントリは、スタンドアロン監査を失敗させます。CLEAN バンドルには、すべてのライブエントリを含め、サポートされていない通常ファイルを根拠のある非アーティファクトとして明示的に分類する必要があります。

インストールされたスキルは、自身の bin/mister-clean.js から同じスタンドアロン CLI を解決します。ターゲットリポジトリに Mister Clean ツールが含まれていることを想定することはありません。レポート、マニフェスト、バンドル、およびそれらのダイジェストバインドされた証拠レコードを、1 つの実行ディレクトリの下にまとめて保持します。

リリースを提案する前に、プロジェクト全体のチェックを実行します:

bun install --frozen-lockfile
bun run check
bun src/cli.ts audit public-safety .

公開安全性の境界

公開配布物には、一般化されたドクトリンと合成例が含まれています。プライベートなケーススタディ、ローカルパス、資格情報、プロジェクト名、および運用上の証拠は、このリポジトリまたはその Git 履歴に属しません。

ライセンス

MIT