AI改変可能ソフトウェア

ソース同梱・AIエージェントによる改変を前提としたソフトウェア製品の設計思想。

AI改変可能ソフトウェアとは、ソースコードを購入者に同梱し、AIエージェント（例: claude-code）が安全に改変・拡張できることを前提に設計されたソフトウェア製品の概念である。kurage-app-storeの商品群に顕著に見られ、従来の「ブラックボックス製品」ではなく「AIが読み・書き・検証できるホワイトボックス製品」を志向する。

背景と目的

• 小規模事業者が個別ニーズに合わせた業務システムを、低コストで手に入れられるようにする。
• プログラマーでなくても、AIエージェントに指示を出すことで自社向けに改造できる状態を目指す。
• 「買い切り・ソース同梱・MITライセンス」により、ベンダー依存を排し、自社サーバー上で自由に運用・改変できる。

設計上の特徴

1. ソースコード完全同梱・改変自由

• 全商品がoss（MITライセンス）として提供される。
• 1ファイルPHP・DB不要のself-contained-php-app構成が多く、全体を「全部読めるサイズ」（数百行〜約1,350行）に保つ。

2. AIエージェントによる改変を前提とした構成

• 設定ファイルをコードから分離し、AIに変更させる範囲を明確化（例: kreserveの設定ファイル、kurage-vibe-groupware-coreの定義ファイル）。
• ai-readable-manualとして、Claude Code向け設計マニュアルや設置手順書を同梱。
• 「AIに渡せば設置まで進む手順書」「AIにアプリを書かせる手順」などが商品説明に明記されている。

3. 安全な改変を可能にする「宣言的スコープ」

• config-declared-scope方式を採用。例えばkdbagentは「設定で宣言した表・列・操作だけを触らせる」ことで、AIが範囲外を壊せない設計。
• 認可はコード内の1か所に集約し、権限（担当／責任者／管理者）を明確化。

4. AIと人間の役割分担

• AIは下書き・候補を作成し、人間が承認するapproval-workflowを採用（例: kurage-crm-agent、kurage-ai-meishi-analysis）。
• 照合・判定など「決定的事実」はサーバーの決定的コードが行い、AIは台帳に直接書き込めない。

製品例

• kurage-kintai: 顔打刻勤怠。照合はサーバーの決定的コード、写真証跡つき。
• kurage-crm-agent: 日報からAIが顧客・商談を下書き、1タップ承認で台帳へ。
• kdbagent: 宣言した範囲だけ操作できるDB管理ツール。
• kcaldav: 1ファイルCalDAVサーバー。設計マニュアル同梱。
• kreserve: 予約システム。設定ファイルとAI向け設計マニュアル同梱。
• kbilling / kpaylink / kinvoice: 請求・注文・領収書系。AIに渡せば設置まで進む手順書つき。

関連概念

• ai-agent: 改変を実行する主体。
• ai-modifiable-software: 本概念自体。
• ai-readable-manual: AIが読むための設計ドキュメント。
• config-declared-scope: 安全性の基盤となる設計パターン。
• approval-workflow: AI成果物を人間が承認する運用。
• self hosted business apps: 自社サーバー運用（※whitelistに無いためプレーンテキスト）※注意: 実際にはself-hostingが該当。
• self-hosting: データを自社サーバーで持つモデル。
• kurage-app-store: この概念を具現化した販売プラットフォーム。
• kappstore-ecosystem: 商品群と販売代理店を含むエコシステム。
• kurage-products: 本概念の源泉文書の要約。

意義

AI改変可能ソフトウェアは、「AIエージェントを危険な道具にしない」ための製品設計である。ソース開示とマニュアル整備だけでなく、AIの暴走を防ぐための「宣言的制約」と「人間承認プロセス」を組み込むことで、非エンジニアでもAIの力を安全に活用できる。これはvibe-codingの実践基盤とも言える。