エージェントが書く。それでも、あなたが理解しなければならない。
AI エージェントは、計画書や仕様書、メモをすばやく書き上げられます。それでも、書かれたものを実際に行動に移す人が理解する必要があります。読みやすいからといって、そのまま信用してはいけません。
MarsDawn は、まさにそう読むために作られています。レンダリングされたページをソースの隣に置き、Mermaid 図と KaTeX 数式を記号のままにせず描画するので、文書の構造が一目で分かります。
読みやすさと、正しさは別物
AI を使ったコーディングについて書きながら、Simon Willison は、書き捨てではなく後々また手を加えるコードについてこう述べています。「the quality and understandability of the underlying code is crucial」(根底にあるコードの品質と、理解しやすさが極めて重要だ、Vibe coding、2025年)。文書についても同じことが言えます。すらすら読めるエージェントの草稿でも、構造や数字、論理が間違っていることはあり、読みやすい文章は、どこを確認すべきかを教えてはくれません。
推論であって、コンパイルではない
Thoughtworks の Birgitta Böckeler は、この違いをはっきりと言い切っています。「LLMs are NOT compilers, interpreters, transpilers or assemblers of natural language, they are inferrers」(LLM は自然言語のコンパイラでも、インタプリタでも、トランスパイラでも、アセンブラでもなく、推論器である、I still care about the code)。コンパイラは入力を受理するか、エラーを報告するかのどちらかです。エージェントは、動く、あるいは読める何かを返してきても、それが正しいとは限りません。それでもなお、誰かが確認する必要があります。
MarsDawn が、読む人に与えるもの
- レンダリングされたページをソースの隣に置き、どちらか一方が変わるたびに更新するので、文章の中の主張と、その構造とを同時に見られます。
- Mermaid 図を描画します。エージェントが文章で説明したフローチャートが、実際に目で追える形になります。
- KaTeX 数式を、バックスラッシュの羅列のままにせずレンダリングします。数式は、数式として読めます。
- 何も勝手には動きません。MarsDawn は文書を採点したり、要約したり、代わりに印を付けたりはしません。構造をあなたの目の前に置くだけです。あとはあなたが判断します。
次に
- このレビューが、なぜエージェント自身の context にとって安上がりなのか:トークンを節約するレビュー方法。
- レビュー済みの文書を、ほかの人に渡す:PDF を共有する。
- MarsDawn とは何か、1ページで:ホームページ。