メインコンテンツへスキップ
見出し画像

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実装 → レビュー → 修正仕様

    1. 仕様書を先に全部そろえる。アプリ仕様、DB設計、画面設計、UI、テスト、ストア公開手順、プライバシー方針、デバッグ手順を docs/ に置きました。作成にはAIの支援も使っています。

    2. 実装はCodexに任せる。更新履歴を見ると、コマ管理、実施ログ、音声入力、エラー処理などの実装は大半がCodexの担当です。

    3. 自分はレビューとQAを担う。MVPをレビューし、指摘を「FIX_V1」「FIX_V2」という修正仕様書にまとめました。

    4. 修正仕様書の範囲だけ実装してもらう。

    ここで効いたのが、修正仕様書に 「直さないこと」も書く ことです。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:ソースコードと更新履歴の管理

    あなたへのおすすめ