
SEの経験×AIで、iOSアプリ「コマログ」を個人開発した話 ― 仕様駆動でCodexに実装を任せる
【PR】この記事には、筆者が運営するサイト(MINILAB)への案内が含まれます。
「先週のこのクラス、何やったっけ?」
習い事や教室のレッスンでは、毎週こうなりがちです。同じ曜日、同じ時間、同じクラス。だからこそ、前回の内容が思い出せない。
この課題を解決するiOSアプリ コマログ(komalog) を、個人で開発しました。進め方は、SEとしての経験を土台にした 仕様駆動の開発 です。仕様は自分で固め、実装はAI(Codex)に任せ、レビューと品質保証は自分が持つ。この記事では、その進め方と設計判断をまとめます。
コマログってどんなアプリ?
「コマ」ごとにレッスンの記録を残すアプリです。
曜日・時間・クラスの「固定コマ」を登録する
毎週のレッスンで、やった内容を記録する
記録するときは 前回のログが表示される
音声入力 で、話すだけで記録できる
想定ユーザーは、習い事や教室で毎週レッスンをしている先生です。
設計で最初に決めたこと
1. データは端末内だけ。ログイン・クラウド・広告・課金なし
保存先は 端末内のSQLiteだけ にしました。生徒さんに関わるメモが入るアプリなので、外に出さない構成がいちばん説明しやすく、守りやすい。認証やサーバーを持たない分、運用コストと攻撃面も減ります。プライバシー方針も「データ収集なし・端末内保存のみ」の一文で書けます。
2. ただし、将来の同期に備えておく
ローカル専用でも、DBは後戻りしにくい部分です。そこで次のように決めました。
主キーは連番ではなく UUID
削除は物理削除ではなく 論理削除(deleted_at)
日時は UTCのISO 8601 で保存
「同じコマ・同じ日に1件」はDBのUNIQUE制約ではなく アプリ側でチェック(振替や臨時レッスンに対応するため)
今は使わない拡張性に、どこまでコストをかけるか。ここは今回いちばん考えたトレードオフです。生徒名簿のテーブルは「需要がわかるまで凍結」としました。
3. 核機能を2つに絞る
前回ログの表示 と 音声入力 の2つです。仕様書には「音声入力が本アプリの要」と明記しました。機能を増やすより、この2つの体験を磨くことを優先しています。
技術スタック
Expo(development build前提。Expo Goは使わない)
React Native + TypeScript
Expo Router(ファイルベースのルーティング)
expo-sqlite
expo-speech-recognition
EAS Build / EAS Submit
構成上のルールも決めています。
SQLiteの処理は必ず lib/ のRepository層を通す。画面にSQLは書かない
色はテーマファイルから参照する。HEXの直書きは禁止
入力チェック、DB処理、権限確認、エラー処理には日本語のコメントを必ず残す
開発フロー:仕様 → Codex実装 → レビュー → 修正仕様
仕様書を先に全部そろえる。アプリ仕様、DB設計、画面設計、UI、テスト、ストア公開手順、プライバシー方針、デバッグ手順を docs/ に置きました。作成にはAIの支援も使っています。
実装はCodexに任せる。更新履歴を見ると、コマ管理、実施ログ、音声入力、エラー処理などの実装は大半がCodexの担当です。
自分はレビューとQAを担う。MVPをレビューし、指摘を「FIX_V1」「FIX_V2」という修正仕様書にまとめました。
修正仕様書の範囲だけ実装してもらう。
ここで効いたのが、修正仕様書に 「直さないこと」も書く ことです。AIは気を利かせて、関係のないリファクタや仕様外の改善までしがちです。日付ピッカー化、アニメーション、仕様外のリファクタは「やらない」と明記しました。そうすると差分が小さくなり、レビューしやすくなります。
人がやるのは、スコープの管理、受け入れの判断、実機での確認。この役割分担は、SEの現場でいう発注側とレビュー側の動きに近いものでした。
つまずいたところ(そして、どう切り分けたか)
デバッグ手順書には「原因が確定する前に修正しない」と書きました。AIに直させるときほど、このルールが効きます。
音声入力を開くと画面が落ちる:ネイティブモジュールがビルドに入っていなかったのが原因でした。入っていなくても落ちずに手入力を続けられる作りにしました。「モジュールが入っていない」と「端末で音声認識が使えない」も区別して案内しています。
パッケージのバージョンずれ:音声認識パッケージが、使っているExpo SDK 53に合わない世代のものでした。EASのビルドログを見て、iOSで自動リンクされていないことを確認し、対応版に固定しました。
npx eas が別のパッケージを呼んでしまう:npx eas-cli@latest に統一しました。
Appleの提出要件:iOS 26 SDKの要件に合わせ、EASのビルドイメージをXcode 26に固定しました。
ほかにも、二重保存の防止、未保存のまま画面を離れるときの確認、読み込み失敗時の再試行などを、レビューと実機確認で一つずつ潰しました。
TestFlightで配布中
現在は MVPの実装が終わり、TestFlightで配布しています。2026年11月5日時点では、build 1.0.0 (7) が使えます。
その前のbuildでは、iPhone実機で次の項目を確認済みです。
初回起動
コマの管理と実施ログ
SQLiteへの保存
オフラインでの動作
音声入力と長文入力
強制終了したあとの復帰
エンジニア向けの学び
AIに渡すのはタスクではなく仕様。正常系と異常系まで書いておくと、出てくるコードの質が安定します。
「やらないこと」を書くのがスコープ管理。差分が小さければ、レビューのコストが下がります。
ネイティブまわりは実機でしか確かめられない。権限、音声、ビルド構成は、人が実機で確かめる前提で計画します。
ローカルファーストでも、データ設計は将来を見る。UUIDと論理削除は、後から入れるより最初に入れるほうが安く済みます。
これから
App Storeへの公開に向けて、残りのチェック項目を片づけています。その先の拡張案も仮で決めています。
v1.1:エクスポート
v1.2:タグ・検索や通知
v2:Android対応や同期をやるかの判断
ミニアプリや作品はMINILABで
コマログのように、身近な課題から生まれたミニアプリや作品は、Webポータル MINILAB にまとめていく予定です。
👉 https://mini-lab-5lf.pages.dev/
感想や「こんなアプリがほしい」という声は、noteのコメントやXで気軽にどうぞ。
使ったツール
Expo / EAS:ビルドからTestFlight配布まで
React Native + TypeScript:アプリ本体
expo-sqlite:端末内のデータ保存
expo-speech-recognition:音声入力
Codex:実装の大部分と不具合修正
AI支援(仕様書・レビュー):仕様書一式と修正仕様書の作成
GitHub:ソースコードと更新履歴の管理