3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【個人開発/未経験】エラーログが風流な短歌になる「絶望えらぁ短歌」開発してみた【Rails 8 + OpenAI API】

3
Last updated at Posted at 2026-11-17

はじめに

はじめまして!RUNTEQでエンジニアを目指して学習中の、もーと申します!

突然ですが、皆さんはエラーで心が折れたことはありますか?
真っ赤なエラーログを前に「自分だけができない」と落ち込んだことがある人に、ぜひ読んでほしい記事です。

この記事では、入学して1か月ちょっとのときにAIと一緒に作り始めた個人開発アプリ「絶望えらぁ短歌」について、作った理由、機能、実装でこだわったところを、最新アップデートの「絶望百人一首」も含めて紹介します。

初学者のため、技術的な内容に誤りがあるかもしれません。お気づきの点があれば、コメントで教えていただけるとうれしいです🙇


作成したアプリ

エラーログを貼り付けると、AIが風流で悲痛な「短歌(5・7・5・7・7)」に詠み上げてくれるWebアプリです。
詠んだ短歌は縦書きのOGP画像になり、そのままX(旧Twitter)でシェアできます。

エラーに心が折れそうな初学者エンジニアの 「自分だけができない」という孤独を、自虐と共感の笑いに変える ことを目指しています。

項目 内容
誰のため エラーログと格闘中の初学者・若手エンジニア(独学・スクール生・リモート学習中の人)
どんな課題 エラーでの挫折感と「自分だけができない」という孤独感で、開発の足が止まってしまう
どう解決 エラーログを短歌に変え、展覧会やXで共有して共感を集める。絶望を笑いと自己表現に変える

開発期間

2026年8月11日 ~ 現在(運用しながら機能追加中)

日付 できごと
2026年8月11日 バトランへの出場を決めて開発開始。MVPを公開
2026年8月15日 本リリース
2026年9月 BATTLE OF RUNTEQ Vol.7(バトラン)にファイナリストとして出場
2026年11月12日 「絶望百人一首」(CPU戦・戦績・合言葉の部屋)を追加

開発の背景

きっかけは、卒業制作でつまずいていたスクールの先輩を応援していたときの体験です。画面共有越しに真っ赤なエラーログを見せてもらったものの、入学したばかりの自分には原因を解決できず、「応援することしかできない」もどかしさ を感じました。

技術で助けられなくても、せめてこの空気を笑いに変えられないか。エラーを辞世の句のような短歌にしてしまえば、辛い戦いもユーモアのあるアートになるのではないか。そう思いついたのが始まりです。

エラーでつまずくのは誰もが通る道ですが、その最中は「自分だけができない」と孤独になりがちです。ただの愚痴は投稿しづらくても、短歌という風流な形にすれば「ネタ」として気軽に共有でき、「みんな同じように苦しんでいる」と共感し合えます。今もエラーと格闘している自分自身が、一番のユーザーです。

RUNTEQのコミュニティのたくさんの方のおかげで、このアプリができています。(感謝の気持ちは、最後に改めて書かせてください!)


主な機能

AI短歌生成とAI法師の解脱助言

  • エラーログを貼ると、OpenAI API(gpt-4o)が5・7・5・7・7の短歌を詠む
  • 音数をRails側で検証し、ずれていれば最大3回まで作り直させる
  • 「AI法師」が、エラーの原因と最初に試すことを励ましと一緒に教えてくれる
  • 自分で詠んだ短歌を投稿する「自作短歌モード」もあり

00_tanka_generate.gif

00b_ai_hoshi_advice.gif

エラー:NoMethodError (undefined method 'name' for nil:NilClass)

短歌:
なにゆえか 空の引数に 消えた名は
誰も知らない 闇にまぎれつ

展覧会(ギャラリー)と共感・同調バッジ

  • みんなの短歌を和紙カード風に一覧でき、新着順/共感順で並べ替え、エラー種別タグで絞り込める
  • 「わかる」ボタンで共感を送れる。共感数の週間ランキングでは上位3首を金銀銅で飾る
  • 同調バッジ:同じ型のエラーで詠んだ人の数が表示され、「自分だけじゃない」と分かる
  • 短歌に「返歌」を返して、歌でやりとりできる

01_gallery_kyokan.gif

縦書きOGPとXシェア

  • 投稿ごとに、短歌と雅号(詠み手名)を合成したOGP画像をMiniMagickで生成
  • ハッシュタグ「#絶望えらぁ短歌」付きでXにワンタップでシェア

02_detail_share.gif

クソコードのお焚き上げ・本日の絶望おみくじ

  • お焚き上げ:二度と見たくないコードを、画面いっぱいの炎で浄化する演出
  • おみくじ:運勢(大凶・極凶・絶望など)とエンジニアあるあるのテーマで、毎日引けるおみくじ短歌

03_omikuji.gif

04_otakiage.gif

マイページ(絶望年表・称号)

  • これまでのエラーと短歌を、年表のような縦のタイムラインで振り返れる
  • 共感した短歌、届いた返歌、詠んだ数や集めた共感に応じた称号(迷える魂 → … → 絶望の神)をタブで切り替えて表示

05_mypage_nenpyo.gif

和の世界観

  • writing-mode: vertical-rl による縦書きの短冊表示。フォントはGoogle Fontsの明朝体や和風のものを自分で選んだ
  • 漆黒(#0d0808)と朱色(#8c1d1d)の配色、「バグの神々の宣託を受信中…」などの全画面ローディング
  • 画面を移動しても途切れない和風BGM

ユーザー管理

  • Deviseによるログイン・新規登録。ログインしなくても展覧会の閲覧やおみくじは体験できる
  • マイページから自分でアカウントを削除できる。利用規約・プライバシーポリシーでOpenAI APIへのデータ送信についても明記

最新アップデート:絶望百人一首(2026年11月12日)

展覧会で共感を集めた短歌が札になる、かるた機能を追加しました。

機能 内容
CPU戦 上位100首から札を作り、法師と早取りで勝負。上の句(5・7・5)を一文字ずつ詠み上げ、場の下の句(7・7)を取る。難易度3段階(見習い法師/歌聖法師/絶望の神)、お手つき判定、Web Speech APIによる音声読み上げ、結果のXシェア
戦績と称号 マイページの「かるた戦績」タブで難易度別の勝率を表示。勝ち方に応じて称号が上がる(かるた初陣 → 札取りの若武者 → 歌聖破り → 神をも退けし名人)
合言葉の部屋 6文字の合言葉(URL)を送るだけで、友達とリアルタイムに2人対戦(ActionCable)。相手の接続が30秒途絶えると不戦勝

06_karuta_play.gif

作者みずから、中級の「歌聖法師」に挑んだ結果がこちらです。

07_karuta_haiboku.gif

3対8、お手つき3回。自分で作ったCPUに、自分のアプリで負けました。 称号はもちろん「かるた初陣」のままです。

作りたる 法師に札を 奪われて
お手つき三度 初陣のまま

あわせて、音数カウントで「っ」「ー」を正しく数える修正、本番でのメール送信設定、脆弱性が報告されたgemの更新も行いました。

絶望百人一首を追加した理由

バトランの審査で、「AIによる生成という印象が強く、もう一工夫あるとさらに良さそう」 というコメントをいただいたことがきっかけです。AIに短歌を詠んでもらうだけでなく、みんなが詠んだ歌そのものを使って遊べる仕組みを作りたいと考えました。

バトラン本戦の発表でも今後の機能として「絶望カルタ」を予告し、審査員から「ユーザーにまた来てもらう工夫は」と聞かれたときにも、「自分だけの百人一首を作りたい」と答えていました。絶望百人一首は、そのときの宣言を形にしたものでもあります。

  • 短歌はもともと5・7・5/7・7の上の句・下の句に分かれるので、百人一首の形式と相性がよい
  • 展覧会で共感を集めた歌が札になるので、投稿した人にも「自分の歌が札になった」という喜びが生まれる
  • 仲間と「合言葉」だけで対戦できれば、孤独を和らげるというアプリの目的にも近づく
  • 学習面では、ActionCableによるリアルタイム通信と、同時操作の排他制御に挑戦できる

バトランに向けて、AIと一緒に調べながら作った

このアプリは、RUNTEQの「バトラン(BATTLE OF RUNTEQ Vol.7)」への出場をきっかけに作り始めました。

入学前は「ChatGPTに書いてもらったコードは読めるけど自分で書けない」と悩んでいました(note)。このアプリも、自分の力量だけでは作れないと分かっていたので、AIとタッグを組み、分からないところはその都度調べながら進めました。

ただ、動くものは作れても、コードの裏側にある仕組みやRailsの理解が追いついていないことに、何度も打ちのめされました。だからこそ、AIの出力をそのまま信じず、音数をRails側で検証するような「確かめる仕組み」を入れること を大事にしています。

参加を決めたとき

当時は入学して約1か月ちょっとで、まだ何も分からない状態でした。それでも、憧れだったバトランにどうしても出たかった。ただ、予選の締め切りまでは残り1週間で、AIを使うしか間に合う方法はありませんでした。8月11日、その迷いをXにこう書きました。

バトラン、またとない機会だし今からでも作って出したい。
今の力量だと絶対AI頼りになっちゃうけど、調べながらならいけるか〜?

この投稿を、RUNTEQ代表のひさじゅさんが引用してくださいました。

こういうタイミングであればAI頼って進めてもいいと思いますよ。
特にまだ自分のアプリをデプロイしたことない人は、デプロイ経験積んでおくことでそのあとのアプリ開発がやりやすくなりますし、作ったアプリを改修する時にAIなしでやればコードリーディングの練習教材にも出来ます。
バトランいい機会なので、ぜひうまく使ってください。

— ひさじゅさんの投稿(2026年8月11日)

この言葉で「安心して進められそう」と思え、AIとの共闘でデプロイまで漕ぎつけて申し込むと決めました。「とりあえず動くならどんな状態でもOK」というルールを支えに、まず形にすることを優先し、その日のうちに短歌を詠むところまでを備えたMVPを公開しています。

「改修するときはコードリーディングの教材になる」という助言は、本リリース後も機能を足し、不具合を直し続ける中で、自分の書いたコードを読み直すときの支えになっています。

開発の進め方

使ったAIは Gemini です。

  1. 手書きの画面遷移図を描く:Webデザインを学んでいたころのワイヤーフレームの書き方で、画面とそのつながりを紙に書き出しました
  2. AIに読み込ませる:その図をGeminiに渡し、何を作りたいかを伝えました
  3. 壁打ちを重ねる:分からないところは何度も質問し、Railsのディレクトリ構成から提案してもらいました
  4. 確かめながら自分の手で実装する:当時はCLIの使い方も知らなかったので、提案されたコードを確認しながら、vimで一つずつコピーして貼り付けました
  5. 動作を確かめてから反映する:ローカルで動きを確認し、問題がなければコミットしてpushしました

大事にしたのは、AIに任せきりにしないこと です。「こういうふうに実装したい」「動かしてみたら、ここはこうしたい」と、作りたい形は自分から指示するようにしていました。和の世界観や演出、音数をRailsで確かめる仕組みは、その積み重ねから生まれています。

反省点:すべて main ブランチに直接pushしていたことです。今は作業ごとにブランチを切って、PRで取り込んでいます。

ファイナリストに選ばれて

正直に言うと、自信がなくて参加はとても迷いました。それでも「失敗してもデプロイ経験になれば儲けもの」と踏み出した結果、BATTLE OF RUNTEQ Vol.7 の ファイナリスト(優秀賞)に選ばれました。

本戦での部門賞には届かず悔しい思いもしましたが、実際に使ってもらってフィードバックを受け、改修するサイクルや、スライドとプレゼンの準備、本番の質疑応答は大きな学びになりました。


工夫した点・苦労した点

1. LLMは「音数」を数えられない → Rails側で検証して再生成させる

LLMはトークン単位で文章を扱うため、日本語の「読みの音数」を数えるのが苦手です。「5・7・5・7・7で。」と指示しても、字余り・字足らずの歌がよく返ってきました。

そこで、句ごとに「漢字混じりの本文」と「ひらがなの読み」をJSONで返させ、読みの音数をRailsが数える ようにしました。ひらがななら文字を数えるだけで音数になり、拗音(ゃ・ゅ・ょ)だけ前の文字とまとめ、促音「っ」と長音「ー」は1音として数えればよいからです。この数え方は TankaMora.count にまとめて、短歌投稿とおみくじで共通化しています。

app/controllers/posts_controller.rb
def count_mora(kana)
  TankaMora.count(kana) # 数え方は app/models/tanka_mora.rb に共通化
end

def validate_tanka_mora(data)
  expected_mora = [ 5, 7, 5, 7, 7 ]
  kus = [ "ku1", "ku2", "ku3", "ku4", "ku5" ]
  errors = []

  kus.each_with_index do |ku, index|
    kana = data.dig(ku, "kana") || ""
    actual_count = count_mora(kana)
    target = expected_mora[index]

    if (actual_count - target).abs > 1 # ±1音を超えるズレはエラー判定
      errors << "#{index + 1}句目の音数が「#{actual_count}音」になっています(目標: #{target}音)。"
    end
  end

  if errors.empty?
    [ true, nil ]
  else
    [ false, errors.join(" ") ]
  end
end

不合格のときは、このエラー文(例:「3句目の音数が「8音」になっています」)をそのまま次のプロンプトに入れて、最大3回まで作り直してもらいます。「やり直して」とだけ伝えるのではなく、「何句目が何音ずれたか」を具体的に返す ことで、修正の精度が上がりました。さらに temperature を 0.9 から 0.6 に下げ、音数の崩れを減らしています。

3回とも不合格だった場合は、定型文を返すのではなく、3回目のAIの歌を採用します。音数が少し崩れていても、その人のエラーに寄り添った歌のほうが価値があると判断したためです。

2. 合言葉の部屋:審判はサーバーが務める

早取り対戦では、2人がほぼ同時に同じ札を押すことがあります。ブラウザ側で勝ち負けを決めると、両方が「自分が取った」と表示されてしまいます。

そこで対局の状態はすべて KarutaRoom レコードが持ち、状態を変える操作は with_lock(行ロック)の中で行うようにしました。先にロックを取った1人だけが札を取れ、2人目は「もう取られている」と判定されます。

app/models/karuta_room.rb
def take!(user, card_id, turn_number)
  with_lock do
    role = role_of(user)
    return [] unless role && status == "playing" && turn_open && turn == turn_number
    return [] if missed.include?(role) || taken.key?(card_id.to_s)
    # ...(正解なら得点、違えばお手つき。以下省略)
  end
end

ActionCableのチャネル(KarutaRoomChannel)は中継だけを担当し、判定はモデルに集めています。そのほかにも次の点を工夫しました。

  • 不正対策:どの上の句がどの取り札に対応するかは、札が取られるまでブラウザに渡しません。ブラウザに送るのは札のIDと下の句だけです(field_cards)
  • 不戦勝の判定:切断をブラウザの通知だけで判断すると、再読み込みしただけで負けになってしまいます。そこで対局中は各ブラウザが定期的にハートビートを送り、最後の合図から30秒経ったときだけ不戦勝を認めるようにしました
  • 合言葉:見間違えやすい 0/O・1/I を除いた32文字から6文字を作り、部屋名は「エラータグ+和風の部屋」(例:無限ループの間)で自動命名しています

3. 同調バッジ:「同じエラー」をどう判定するか

同じ NoMethodError でも、ファイルパスや変数名、行番号は人によって違います。そこで保存前にエラーの1行目を正規化し、「エラーの型」だけを残したシグネチャ を作っています。同じシグネチャを持つ投稿の数が「同じ罠にかかった仲間の数」です。

app/models/post.rb
cleaned = first_line
  .gsub(%r{/([a-zA-Z0-9_.-]+/)+[a-zA-Z0-9_.-]+}, "[PATH]") # パス
  .gsub(/0x[0-9a-fA-F]+/, "[ADDR]")                        # メモリアドレス
  .gsub(/\b\d+\b/, "[NUM]")                                # 数値
  .gsub(/['"][^'"]*['"]/, "[VAR]")                          # クォート内の動的な文字列
  .squish

4. 縦書きの「ー」が横を向く問題

MiniMagickでOGP画像に短歌を描くと、長音符「ー」が横向きのままになり、縦書きでは不自然に見えました。描画前に 「ー」「〜」を縦線の「丨」に置き換える ことで対応しています。画像生成が失敗したときは既定のOGP画像を返し、シェアが壊れないようにしています。

5. 画面を移動しても途切れないBGM

Turboは画面遷移のたびに <body> を差し替えるため、普通に <audio> を置くとBGMが止まってしまいます。data-turbo-permanent 属性を付けて要素を引き継がせることで、SPAにせずに音楽が流れ続ける ようにしました。

<audio id="bgm-player" src="/audio/bgm.mp3" loop preload="auto" data-turbo-permanent></audio>

6. 一番苦労したのは、動的OGP画像の生成

開発全体で一番大変だったのが、投稿ごとのOGP画像です。バトラン本戦の質疑で「一番絶望したエラーは?」と聞かれたときも、これを答えました。つまずいたのは主に3か所です。

  1. DBとの紐付け:ActiveRecord::RecordNotFound で既定画像に切り替わっていました。Railsコンソールで Post.pluck(:id) を調べると、開発用DBで削除と追加を繰り返したせいで、指定したIDのレコードが存在していませんでした。「ロジックより先にDBの中身を疑う」 ことを学びました
  2. MiniMagickの使い方:MiniMagick::Image.open("xc:...") は既存ファイルを開くメソッドなので、新しい画像は作れません。MiniMagick::Tool::Convert に切り替え、出力先に png: を明示して解決しました
  3. Xでカードが出ない:画像は正しく出ているのに、Xが失敗していたころの結果をキャッシュしていました。カードの確認ツールで読み直させて更新しました

詳しい経緯とコードは、別の記事にまとめています。


使用技術

カテゴリ 使用技術 選定理由
バックエンド Ruby 3.3 / Ruby on Rails 8.1 迅速にプロトタイピングでき、Hotwireなど最新のRails標準を使えるため
フロントエンド Hotwire(Turbo / Stimulus)/ importmap / CSS(writing-mode: vertical-rl) SPAにせず、非同期のソートやいいねを実現するため
リアルタイム通信 ActionCable 合言葉の部屋の2人対戦を、Rails標準の機能で実現するため
データベース PostgreSQL 堅牢なリレーショナルデータ管理とRenderとの相性のため。対戦の排他制御に行ロックを使用
AI OpenAI API(gpt-4o / gpt-4o-mini)/ ruby-openai 短歌生成は精度重視でgpt-4o、解脱助言とおみくじは速度とコスト重視でgpt-4o-miniを使い分け。短歌は当初別のモデルだったが、字余りや不自然な言葉が多く、gpt-4oに変更
画像処理 MiniMagick / ImageMagick 短歌と雅号を合成した動的OGP画像を生成するため
認証 Devise ログイン・登録・パスワード再設定を実績のあるgemで実装するため
ページネーション Kaminari 展覧会を12件ずつ表示するため
インフラ Render / Docker(Docker Compose) 本番と開発の環境をそろえ、デプロイを円滑にするため
CI GitHub Actions(RuboCop / Brakeman / bundler-audit / rails test)、Dependabot Push・PRごとに静的解析・脆弱性チェック・テストを自動実行するため

テストはモデル・コントローラー・チャネルにわたり約60件あり、合言葉の部屋の「先に取った方だけが得点する」「30秒途絶えたら不戦勝」といった審判のルールもテストで確認しています。

ER図


フィードバックをもとに改善した点

MVPを公開してからバトランまでに、受講生のみなさんからたくさんのフィードバックをいただきました。そのうち、実際に直したものです。

いただいた声 どう直したか
展覧会の「共感順」が新着順のままになっている 共感数の更新と並べ替えの処理を修正(8月19日)
短歌が多くて、スクロールしないと他の歌が見られない 12件ずつのページネーションと、開閉できるカテゴリ絞り込みを追加(8月26日)
自分の短歌を編集・削除したい マイページから編集・削除できるようにした(8月25日)
マイページやおみくじで500エラーが出る 原因を調べて修正。おみくじは例外処理と代わりの表示も追加(8月25〜26日)
長い短歌が短冊からはみ出す 縦書き短冊の高さと余白を調整(9月7日)
「五七五七七」を明らかに超えている 音数ルールを厳密にし、モデルをgpt-4oに変更(9月15日)。「っ」「ー」の数え方も修正(11月17日)
短歌を読み上げる機能があったら臨場感が出そう 結果的に、絶望百人一首で上の句を音声で読み上げる形で実現(11月12日)

バトランの審査コメント

良かった点
世界観の統一感、BGMまで含めた完成度、「エラーで落ち込む初学者の孤独感を笑いに変える」という着眼点、縦書きOGPまで作り込んだシェアの体験設計を評価していただきました。

改善点
「AIによる生成という印象が強く、もう一工夫あるとさらに良さそう」

この一言が、AIに生成させるのではなく みんなが詠んだ歌で遊ぶ 絶望百人一首を作るきっかけになりました。


今後追加したい機能

  • エラー別の「絶望歌集」
    同じエラーで詠まれた短歌を一か所にまとめて読める機能です。保存してある error_signature を使えば、「このエラーで絶望したのは自分だけじゃない」と感じてもらえるはず。同調バッジの、その先を作りたいと考えています。
  • 自作短歌にも「絶望回避の助言」を
    今はAI法師の助言が届くのは、エラーログから詠んだ短歌だけです。「自分で詠んだ歌にも助言がほしい」という声をいただいたので、詠んだあとも愛着を持てるようにしたいです。
  • 合言葉の部屋の3人以上対戦・観戦機能
    今は2人までなので、複数人でわいわい札を取り合えるようにしたいです。

いつか、あの「歌聖法師」にも勝てるように。まずは作者が修行します💪🔥


終わりに

8月11日、私は「今の力量だと絶対AI頼りになっちゃう」とXに書いていました。バトランの審査でも「AIによる生成という印象が強い」と言われ、正直、図星でした。

でも、その一言があったから、AIに詠ませるだけではなく「みんなが詠んだ歌で遊ぶ」絶望百人一首が生まれました。最初は「AIに作ってもらったアプリ」だったものが、今はフィードバックをもらって直し、機能を足して育てている 「自分のアプリ」 になっています。

まだまだ自分の力だけでは書けません。だからこそ、カリキュラムを少しずつ進めながら、このアプリも一緒に育てていきたいと思っています。エラーを短歌にして笑い飛ばしながら、一歩ずつ。

現在はRUNTEQ受講5か月目で、卒業制作はこれからです。卒業制作でも、また記事を書く予定でおります!

感謝を込めて

このアプリは、本当にたくさんの方に支えられてできました。

  • ひさじゅさんへ。「AI頼って進めてもいいと思いますよ」という引用がなければ、バトランに申し込むことも、このアプリが生まれることもありませんでした。
  • このアプリのきっかけをくれた先輩方と、背中を押してくれた先輩方へ。画面越しに見せてもらったデプロイの時のエラーログが、すべての始まりでした。憧れのまま終わるはずだったバトランに出られたのは、迷っていた私の背中を押してくれた方々のおかげです。予選の締め切りまで一緒に駆け抜けた最後の1週間は、RUNTEQ生活の宝物です。
  • MVPの直後から触ってくださった受講生や先輩方へ。不具合を見つけて、率直なフィードバックをくださったおかげで、アプリは何倍も良くなりました。
  • 憧れの、歴代バトランのファイナリストの先輩方へ。受講前に見ていた皆さんのご活躍があったから、頑張れました!これからもずっと憧れです!
  • バトランの審査員の皆さんへ。「AIの印象が強い」という一言が、絶望百人一首を生みました。
  • そして、展覧会に絶望の歌を詠んでくださった皆さんへ。皆さんの歌が、今では百人一首の札になっています。

本当に、本当にありがとうございました!
これからも一緒に、絶望を詠みながら前に進んでいけたらうれしいです。


本記事が、エラーと格闘している誰かの小さな笑いになれば幸いです。
最後まで読んでいただき、ありがとうございました🙇

3
0
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?