掲載済み (2026-06-13号)
043 109文字 • 1分

Claude Codeで仕様書をMarkdown/HTMLで記述を比較

日本語

掲載情報

2026年6月13日土曜日号 アネックス掲載

概要

Claude Codeを用いて仕様書をMarkdownとHTMLで生成し、視認性・生成時間・トークン消費量のトレードオフを比較検証した研究。

詳細内容

Claude Code(モデル:Opus 4.8 / high effort)を使用し、実装コードから仕様書をリバース生成する際の形式による違いを検証。Markdown(プレーン/Mermaid併用)とHTML(静的/Playwright自己検証/インタラクティブ要素)の5パターンで比較した。結果、HTML形式はデザイン性やインタラクティブな操作性(折りたたみ、ホバー等)で圧倒的に優れる一方、生成時間はMarkdownの3分に対し最大33分、トークン量は13.7kから114.1kへと激増することが判明。仕様駆動開発におけるドキュメントの質とコスト、メンテナンス性のバランスを考える上での指標を提示している。