『CLAUDE.md Analyzer』CLAUDE.mdをMarkdown ASTで解析してSPECIA 6軸スコアを出すまでの設計記録

Zenn / 4/22/2026

💬 OpinionDeveloper Stack & InfrastructureTools & Practical Usage

Key Points

  • CLAUDE.md(プロンプト/指示の文書)をMarkdown ASTとして解析し、構造を保ったまま評価するための設計記録がまとめられている
  • 解析結果からSPECIAという6軸スコアを算出するまでの一連の処理(AST解釈→特徴抽出→スコアリングの流れ)を明確化している
  • 文章の見た目ではなく構文・要素単位で評価することで、スコアの再現性と運用性を高める方針が示されている
  • 既存のテキスト評価では難しい「指示文書の品質」を定量化するための実装アプローチとして位置づけられている
はじめに Claude Codeのプロジェクトで必ず作るのがCLAUDE.mdだ。 LLM(大規模言語モデル)への指示書であり、Claude Codeの全動作の前提になる。「どのくらい良いものが書けているか」を客観的に評価したくなるのは自然だ。 ところが既存ツール(codewithclaude.net / cc-health-check / ccat)はいずれも単純なキーワードチェックかルールベースの検証に留まっていた。arXiv論文3本分の知見を統合した多次元評価は、どこにも存在しなかった。 実物はこちら。 CLAUDE.md Analyzer この記事では「どんな設計判断をした...

Continue reading this article on the original site.

Read original →