概要
AIエージェントとのコミュニケーションにおいて、Markdownに代わるHTMLの利点を、情報密度、視覚的明瞭性、共有の容易さ、双方向性、データ取り込み、そして何よりも「楽しさ」という観点から解説しています。
詳細内容
本記事は、AIエージェントとのやり取りにおける出力フォーマットとして、従来のMarkdownに代わりHTMLを推奨する理由を詳細に解説しています。AIエージェントはMarkdownで情報を伝達するのに長けていますが、ファイルが長大になると可読性が低下し、視覚的な表現力にも限界があります。一方、HTMLは、表形式データ、CSSによるデザイン、SVGによる図、JavaScriptによるインタラクションなど、Markdownでは表現しきれない豊富な情報密度を誇ります。
視覚的な明瞭性においても、HTMLはタブ、イラスト、リンクなどを効果的に配置でき、モバイル対応も容易なため、大量の仕様書や計画書の読解を容易にします。共有の容易さもHTMLの利点であり、S3などにアップロードすればリンク一つで共有でき、閲覧率の向上に繋がります。さらに、HTMLはスライダーやノブなどのインタラクティブな要素を組み込めるため、デザインの調整やアルゴリズムのパラメータ変更といった「双方向のやり取り」も可能になります。
Claude Codeは、ファイルシステム、Slack、GitHubなど、多様なコンテキストを読み込んでHTMLファイルを生成できるため、より質の高いアウトプットが期待できます。筆者は、HTMLでの生成プロセスが「楽しい」ことも、その採用を後押しする要因として挙げています。
**ユースケース**としては、仕様書・計画・調査（HTMLでのブレインストーミング、モックアップ、実装計画）、コードレビュー・理解（差分表示、注釈、フローチャート）、デザイン・プロトタイプ（インタラクション、コンポーネント調整）、レポート・調査・学習（SVG図解、インシデントレポート）、カスタム編集インターフェース（チケットの並べ替え、機能フラグ編集、プロンプトチューニング）などが紹介されています。
Markdownと比較して生成に時間がかかる、バージョン管理での差分確認が煩雑になるというデメリットも存在しますが、AIとの連携をより深く、楽しくするための強力な手段としてHTMLへの移行を提唱しています。