アプリの作り方

AIでアプリを作るなら、先に設計書を書く。

INARYでは、AIにアプリを作らせ、そのまま動かせます。ただ「〇〇のアプリを作って」の一言だけでは、決まっていないところをAIが自分で決めて作るので、思っていたものと違うアプリができあがります。何のために作るかを企画書で決め、何をどう作るかを設計書に書いてから、AIに渡して作らせる。これがAIコーディングの基礎です。

作るまでの流れ

  1. 企画書を書く何のためのアプリかを決めます。
  2. 設計書を書く何をどう作るかを決めます。
  3. 設計書を渡して作らせる会話に設計書を添付して「@INARY この設計書の通りに作って」と送ります。
  4. 確かめる設計書に書いた確かめ方の通りに動かします。

直したいところがあれば、設計書を直して作り直させる

企画書に書くこと

企画書は、アプリを作る理由を決める文書です。スレッドでメンバーと話し、AIに調べものを頼みながら書けます。調べた結果も決まったことも、全員がその場で読めます。

  • 誰が使うか
  • 今どうやっていて、何に困っているか
  • アプリができたら、何が変わるか
  • 作らないもの

設計書に書くこと

設計書は、AIに渡す作り方の指示書です。AIは書いてあることを書いてあるとおりに作り、書いていないところは自分で決めます。決めておきたいことは、全部書きます。

  • 画面どんな画面があり、何を入力して、何が表示されるか。
  • データ何を残すか。残すものがあれば、データベースに保存すると書きます。データベースは PostgreSQL が使えます。
  • 誰が何をできるか見るだけの人、変えられる人、管理者だけができること。
  • 開き方INARYの中で開くか、ブラウザで開くか(次の節)。
  • 言語とフレームワーク(その次の節)。
  • ほかのサービスとのつなぎ方何とつなぐか。APIキーなどの値は、設計書にも会話にも書きません。ストレージにある、そのアプリのフォルダの「環境変数」に入れます。ここに入れた値は、組織のメンバーなら誰でも取り出せます。
  • AIにさせたいことアプリの中身をAIに読ませたり、操作させたりしたいなら、何を読ませ、何をさせるかを書きます。書いておけば、あとで会話で聞くだけで、AIがアプリを使って答えます。
  • やらないこと作らない機能、変えてはいけないもの。
  • 確かめ方どうなったら完成か。「これを入れたら、こう表示される」の組で書きます。

開き方の選び方

  • INARYの中で開く組織のメンバーだけが開けます。ログインの仕組みを作る必要はなく、アプリは、誰が開いているかをINARYから受け取れます。組織の中で使うアプリに向いています。
  • ブラウザで開くINARYを開かずに、ブラウザから直接使います。どこからでも届くので、組織のメンバーだけが入れるログインの仕組みと、ロボットからのアクセスを断る仕組みを、アプリ自身に持たせます(設計書に書きます)。

設計書に書いていなければ、作る前にAIから聞かれます。

フレームワークの選び方

  • 書かなければ、AIが選びます。
  • あとでコードを読んで直す人がいるなら、その人が読める言語とフレームワークを書きます。
  • 使えるメモリと処理能力は、どのアプリも同じで、増やせません。軽いものが向いています。
  • データを残すなら、データベースは PostgreSQL です。

1つの文書の長さ

AIが一度に読める量には上限があります。長すぎる文書は、最初の部分だけを読んで作業を始めてしまうことがあります。企画書と設計書は、1つの文書に1つの話題を書き、長くなったら意味の切れ目で分けます。

作らせて、確かめる

設計書ができたら、会話に添付して「@INARY この設計書の通りに作って」と送ります。できあがると、AIが実際にアプリを動かして確かめ、確かめられたことと確かめられなかったことを分けて、同じ会話で知らせます。そのうえで、設計書に書いた確かめ方の通りに、自分でも動かしてみます。作れなかったときは、理由と、次に何を頼めばよいかを、AIが知らせます。

直す

直したいところが見つかったら、会話で思いつきを足していくのではなく、先に設計書を直します。設計書と中身がずれていくと、次に直すときに、何が正しいのか分からなくなるからです。

作ったアプリのファイルは、ストレージの「アプリ」フォルダにあります。設計書もそのアプリのフォルダに置いておけば、「@INARY 設計書を読んで、変わったところを直して」と頼めます。

作ったあと

アプリのファイルは、組織のメンバーなら誰でも見て、差し替えられます。ファイルを変えると、そのまま作り直されて、使っているアプリに反映されます。作り直しに失敗したときは、前の版が動き続けます。

手元で作って試してから反映したいときは、GitHubを使うやり方があります。