AIでアプリを作るなら、先に設計書を書く。
INARYでは、AIにアプリを作らせ、そのまま動かせます。ただ「〇〇のアプリを作って」の一言だけでは、決まっていないところをAIが自分で決めて作るので、思っていたものと違うアプリができあがります。何のために作るかを企画書で決め、何をどう作るかを設計書に書いてから、AIに渡して作らせる。これがAIコーディングの基礎です。
作るまでの流れ
- 企画書を書く何のためのアプリかを決めます。
- 設計書を書く何をどう作るかを決めます。
- 設計書を渡して作らせる会話に設計書を添付して「@INARY この設計書の通りに作って」と送ります。
- 確かめる設計書に書いた確かめ方の通りに動かします。
直したいところがあれば、設計書を直して作り直させる
企画書に書くこと
企画書は、アプリを作る理由を決める文書です。スレッドでメンバーと話し、AIに調べものを頼みながら書けます。調べた結果も決まったことも、全員がその場で読めます。
- 誰が使うか
- 今どうやっていて、何に困っているか
- アプリができたら、何が変わるか
- 作らないもの
設計書に書くこと
設計書は、AIに渡す作り方の指示書です。AIは書いてあることを書いてあるとおりに作り、書いていないところは自分で決めます。決めておきたいことは、全部書きます。
- 画面どんな画面があり、何を入力して、何が表示されるか。
- データ何を残すか。残すものがあれば、データベースに保存すると書きます。データベースは PostgreSQL が使えます。
- 誰が何をできるか見るだけの人、変えられる人、管理者だけができること。
- 開き方INARYの中で開くか、ブラウザで開くか(次の節)。
- 言語とフレームワーク(その次の節)。
- ほかのサービスとのつなぎ方何とつなぐか。APIキーなどの値は、設計書にも会話にも書きません。ストレージにある、そのアプリのフォルダの「環境変数」に入れます。ここに入れた値は、組織のメンバーなら誰でも取り出せます。
- AIにさせたいことアプリの中身をAIに読ませたり、操作させたりしたいなら、何を読ませ、何をさせるかを書きます。書いておけば、あとで会話で聞くだけで、AIがアプリを使って答えます。
- やらないこと作らない機能、変えてはいけないもの。
- 確かめ方どうなったら完成か。「これを入れたら、こう表示される」の組で書きます。
開き方の選び方
- INARYの中で開く組織のメンバーだけが開けます。ログインの仕組みを作る必要はなく、アプリは、誰が開いているかをINARYから受け取れます。組織の中で使うアプリに向いています。
- ブラウザで開くINARYを開かずに、ブラウザから直接使います。どこからでも届くので、組織のメンバーだけが入れるログインの仕組みと、ロボットからのアクセスを断る仕組みを、アプリ自身に持たせます(設計書に書きます)。
設計書に書いていなければ、作る前にAIから聞かれます。
フレームワークの選び方
- 書かなければ、AIが選びます。
- あとでコードを読んで直す人がいるなら、その人が読める言語とフレームワークを書きます。
- 使えるメモリと処理能力は、どのアプリも同じで、増やせません。軽いものが向いています。
- データを残すなら、データベースは PostgreSQL です。
1つの文書の長さ
AIが一度に読める量には上限があります。長すぎる文書は、最初の部分だけを読んで作業を始めてしまうことがあります。企画書と設計書は、1つの文書に1つの話題を書き、長くなったら意味の切れ目で分けます。
作らせて、確かめる
設計書ができたら、会話に添付して「@INARY この設計書の通りに作って」と送ります。できあがると、AIが実際にアプリを動かして確かめ、確かめられたことと確かめられなかったことを分けて、同じ会話で知らせます。そのうえで、設計書に書いた確かめ方の通りに、自分でも動かしてみます。作れなかったときは、理由と、次に何を頼めばよいかを、AIが知らせます。
直す
直したいところが見つかったら、会話で思いつきを足していくのではなく、先に設計書を直します。設計書と中身がずれていくと、次に直すときに、何が正しいのか分からなくなるからです。
作ったアプリのファイルは、ストレージの「アプリ」フォルダにあります。設計書もそのアプリのフォルダに置いておけば、「@INARY 設計書を読んで、変わったところを直して」と頼めます。
作ったあと
アプリのファイルは、組織のメンバーなら誰でも見て、差し替えられます。ファイルを変えると、そのまま作り直されて、使っているアプリに反映されます。作り直しに失敗したときは、前の版が動き続けます。
手元で作って試してから反映したいときは、GitHubを使うやり方があります。
