Kurage
Kurage WikiKurageナレッジベース
Kurage.AIに聞く →
ホーム › Wiki › 概念 › AIが読める設計マニュアル
概念

AIが読める設計マニュアル

ソフトウェアの設計・仕様・導入手順を、人間だけでなくAIエージェントが直接読んで実行できる形で記述したドキュメント。

AIが読める設計マニュアルとは、人間だけでなくAIが直接読んで理解・実行できることを前提に設計された、ソフトウェアの設計・仕様・導入手順を記述するドキュメントである。

概要

通常の設計書は人間の開発者向けに書かれるが、AIが読める設計マニュアルは、AIがコードの意図・構造・変更手順を把握できるように、明確で構造化された形式で書かれる。これにより、AIが保守・改修・機能追加・設置などの作業を自律的または半自律的に行いやすくなる。Kurageでは、単なる付属資料ではなく、ai-modifiable-softwareを支える中核的な構成要素と位置づけている。

マニュアルは必ずしも一枚岩ではない。実測に基づく導入手順書、AIエージェントに作業を任せるための設置指示書、設定の変更点を宣言する設計マニュアル、動作確認のスクリプト、AI活用を学ぶ教材、そしてAIが直接ツールとして呼び出せるmcpサーバー同梱まで、目的に応じた複数の形態をとる。共通するのは「人ではなくAIに渡すことを前提に書かれている」という点である。

Kurageにおける位置づけ

Kurageは、このマニュアルをビジネスモデルの中核に位置づけている。

三点セットとしての商品

kurage-productsを通して見えるのは、商品が「ソースコード+設計マニュアル+公開デモ」の三点セットで提示されていることである。ほぼ全商品にデモURLが用意され、「デモを触ってからご判断ください」という一文が繰り返される。マニュアルは、デモで確かめた挙動を自分のサーバーで再現し、その先を自分で変えるための手引きという位置にある。

商品への展開

kurage-productsの商品一覧によると、Kurage App Storeで販売されるほぼすべての商品がMITライセンスでソースコードを公開し、AI向けの設計マニュアルまたは手順書を同梱している。有料商品の多くには特に「Claude Code向け設計マニュアル」や「AIに渡せば設置まで進む手順書」が含まれる。

代表的な例は以下のとおり。

実測手順書と「落とし穴」の記録

oss-japanese-localizationキット(5,500円)では、公式ドキュメントには書かれていない失敗を実機で踏み、その回避手順を番号つきで収録する型が繰り返される。

これらは「AIが読んで実行する」だけでなく、「AIが間違えやすい箇所を先に潰しておく」ための文書でもある。エラーが出ないまま壊れる種類の失敗(日本語OCRの無言スキップ、初回起動20秒の中断による恒久破損、BASE_URL不一致による白画面など)が特に重視されており、measured-pitfall-catalogとして商品価値の中心を成している。

設計思想を書き残す文書

商品一覧が繰り返し掲げる設計原則は、コードだけでなくマニュアルにも書き残される。AIが改変する際に思想ごと壊さないようにするためである。

MCP同梱という新しい形態

マニュアルを読ませるだけでなく、AIが同じ計算・判定をツールとして直接呼べるよう、mcpサーバーを同梱する商品が増えている。

これらのマニュアルは、config-declared-scopeと組み合わせることで、AIが宣言された範囲だけを変更し、範囲外を壊さない仕組みを実現している。kdbagentのように、設定ファイルで「表・列・操作」を宣言する設計は、AIエージェントに安全に任せるための典型例である。また、こうしたマニュアルはsales-partner-systemにおいて代理店が顧客に説明する際の重要な訴求材料にもなっている。販売代理店向けの商品カタログが存在すること自体、マニュアルの有無が販売力に直結することを示している。

関連する概念・エンティティ

See also: kurage-sites

「AIが読める設計マニュアル」についてもっと知りたいですか?
Kurage.AI に質問する