AGENTS.md / CLAUDE.md をlintする — katalint を作った話
この記事で分かること
AGENTS.mdやCLAUDE.mdといった設定ファイルをlintするツール「katalint」の作成話が得られる。設定ファイルの品質を自動チェックする方法と、開発チーム内で一貫性を保つための運用ルールを学べる。
詳細要約
AIエージェント向け設定ファイルの記述ミスを自動チェックするツール「katalint」の開発経緯。このツールは、AGENTS.mdやCLAUDE.mdに書かれた指示が実際に動作するかどうかを検証するためのlinterであり、設定の不整合や誤字脱字を事前に発見できる。具体的な使い方としては、プロジェクトのルートに置かれたMarkdownファイルを指定して実行するだけで、未定義のコマンドや存在しないパスを警告する。注意点として、linterは構文チェックが主であり、指示の論理的な正しさまでは保証しないため、出力結果を参考に手動で内容を確認する必要がある。