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

AIが直接読んで理解できる設計マニュアル。Kurage製品に標準同梱され、AIエージェントでの改変を可能にする。

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

概要

通常の設計書は人間の開発者向けに書かれるが、AIが読める設計マニュアルは、AIがコードの意図・構造・変更手順を把握できるように、明確で構造化された形式で書かれる。これにより、AIが保守・改修・機能追加などの作業を自律的または半自律的に行いやすくなる。

Kurageにおける位置づけ

Kurageは、このマニュアルを単なる付属資料ではなく、ビジネスモデルの中核に位置づけている。

• vibe-prototype（バイブプロトタイプ制作サービス）の納品物には、ソースコード一式（MIT） とともに「AIが読める設計マニュアル」が含まれる。低価格・短期間で作った土台を、AIを使って顧客自身が改良できるようにする狙いがある。
• kurage-app-storeで販売される商品は、全商品にソースコードが同梱され、AIエージェントによる改変・拡張が可能とされている。有料商品には特に「Claude Code向け設計マニュアル」や「AIに渡せば設置まで進む手順書」が同梱される。

商品への展開

kcaldav、kreserve、kdbagent、ktrackgeo、kcheckit、kbilling、kpaylink、kinvoiceなどの各商品は、以下の特徴を持つ。

• 設定変更や機能追加を同梱の設計マニュアルでAIエージェント（特にClaude Code）に依頼できる
• 設計マニュアルは、AIが安全にコードを変更できるように、設定ファイルの役割や処理の流れを明示する
• config-declared-scopeと組み合わせることで、AIが宣言された範囲だけを変更し、範囲外を壊さない仕組みを実現している

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

• kurage — このマニュアルを提供する企業
• vibe-prototype — マニュアルが同梱されるプロトタイプ制作サービス
• kurage-app-store — 全商品に設計マニュアルが同梱されるストア
• ai-agent — マニュアルの主な読者となるAIエージェント
• config-declared-scope — マニュアルと併用される安全な変更範囲の制限手法
• self-contained-php-app — マニュアルが対象とする、1ファイル完結型のPHPアプリ
• sales-partner-system — 代理店が紹介する際の商品価値の一部として、このマニュアルが訴求ポイントになりうる
• kurage-agency — 本概念の初期の出典ドキュメント
• kurage-products — Kurage App Store商品群におけるマニュアル同梱の詳細