はじめに X 上で見かけた 「もう Markdown じゃなくて HTML でドキュメント書いた方がよくない?」 系の議論(@trq212 のポスト等)には、まったく同感です。 というのも、自分は もう半年ほど前から、Claude CodeにHTMLでドキュメント生成させています。エージェントを使えばつかうほど、その生成物を直接人間が修正することが減るからです。プランファイルがその典型で、プランがまちがっていたらそれはAIに指示して修正させるべきで手動修正するべきではないのです。その理由は手間を減らしたいからではなく、「なぜそう出力されたか」の理由にたちもどって指示しないとAIは同じ間違いをくりかえしてしまうからです。そうすることで人間はAIと思考を共有することができます。 その場合、Markdownは人間が作成も修正することはなくなるわけで、Markdown形式がドキュメントの形式として

