本文へ
ハクソク

世界を動かす技術を、日本語で。

プロジェクトを復活させるためのコーディング支援ツールの活用方法

元記事: 原文(blog.matthewbrunelle.com)

概要

  • 個人プロジェクト の進行とAIコーディング支援の活用体験
  • OpenSubsonic API を利用したYouTube Musicのクライアント化
  • Claude Code による実装過程とワークフローの詳細
  • 必要最小限の MVP構築 と実用化までの課題整理
  • AI支援の意義 と自己成長とのバランスへの考察

Claude CodeでOpenSubsonic対応YouTube Music Shimを作った話

  • 長年未完だった 個人プロジェクト の再挑戦
    • 例：日本語の「 積ん読」のような、いつかやりたい積みプロジェクト
  • 今回のPOCは YouTube Music と OpenSubsonic API の橋渡し
    • OpenSubsonicはクライアント・サーバー分離を容易にする API仕様
    • サーバーに Navidrome、デスクトップに Feishin、Androidに Symfonium を愛用
  • ytmusicapi でメタデータ取得、 yt-dlp で音楽ストリーミングを実装
  • 基本的なストリーミングはすぐ動作、だが 全エンドポイントの準拠実装 に手間
  • 新しいプロジェクトに目移りしがちで中断、典型的な積みプロジェクト化

Claude CodeによるMVP実装の準備

  • すでに手書きでPOC済みのため、実装方針を明確化
  • uvプロジェクト 作成、 FastAPI ・ Pydantic ・ ytmusicapi ・ yt-dlp を依存関係に追加
  • main.pyをFastAPIのサンプルに変更、openapi.json（OpenSubsonic仕様）を配置
  • READMEにプロジェクト説明を記載
  • CLAUDE.md を/initコマンドで生成し、コーディング規約も追記
    • 型アノテーション・Googleスタイルdocstring・Pydantic V2・pytestスタイルのユニットテスト推奨
  • この初期状態を Gitリポジトリ として公開

Claude Codeを使った開発ワークフロー

  • プランモード で次の作業をプロンプト
    • 初期プランの抜けや問題点は追加質問で深掘り
    • 必要に応じてリソースリンクを提示、検索ツールでイディオム調査も依頼
    • 「Accept and clear context」で文脈を整理しつつ繰り返し進行
  • 最初のプロンプト例：
    • openapi.jsonを参照し、 新しいjsonエンドポイント のみFastAPIで非同期stub実装を依頼
  • 実装後は ダブルチェック を依頼し、ミスを修正
  • 主要な変更ごとに/initで CLAUDE.md を更新

MVP（Minimum Viable Product）で必要な機能の実装

  • サブソニッククライアント接続、曲検索、ストリーミングに必要な 最小機能 をClaudeに質問
  • ytmusicapiで検索、yt-dlpでストリーム
  • Feishin で接続時に問題発生→サーバーログをClaudeに渡して反復修正
    • 例：.viewサフィックスの除去、エンドポイントのレスポンス形式修正
  • エラー発生時には ユニットテスト を追加し、再発防止
  • 数回の反復で 音声ストリーミング成功 を体験

実用化への長い道のり

  • OpenSubsonicは約 80エンドポイント、15カテゴリに分散
  • MVPでは以下のみサポート
    • getLicense, getUser, getGenres, getMusicDirectories（いずれも空だが構造は正しいレスポンス）
    • getSong（IDパススルー）、search3（シンプルな検索）、stream（最適音質URL抽出）、getCoverArt（カバー画像URL抽出）
  • フル機能対応には
    • ytmusicapiの キャッシュ 導入、 sqlite でメタデータ保存、閲覧系エンドポイントの実装
    • ストリーム中の曲をディスクに保存し、再ダウンロード防止
    • クライアントが途中切断した場合の ファイルクリーンアップ 処理
    • 認証 関連は未対応（公開予定なしのため）

AIコーディング支援の意義と自己成長のバランス

  • AI支援で「 本当に欲しいけど実現できなかったプロジェクト」を形に
    • 例：積ん読の本が一冊減る感覚
  • 一方で、AI依存による スキル低下 も懸念
    • 例：Rust学習は自力で継続
  • 学び・成長のためのプロジェクト と 実現したい願望系プロジェクト を分けて考える重要性
    • どちらも大切、バランスが肝要
  • 「Sub-standard」と命名したこのプロジェクトは、後者の典型例

まとめ

  • AIコーディング支援 は積みプロジェクトの消化や、願望実現に有用
  • ただし、 自己成長のための挑戦 も並行して行うことが大切
  • それぞれのプロジェクトの意味合いを意識しつつ、AIツールを活用する姿勢

提供: ハクソク · 要約更新:

AIによる日本語要約です。内容は原文とあわせてご確認ください。

Hacker Newsの議論を読む

Hackerたちの意見

自分が一番放置しがちなプロジェクトはゲームだな。放置したプロジェクトが何十個も入ったフォルダがあって、今はそれを実験として捉えてる。先週、これらのプロジェクトの一つをClaudeにやらせてみたんだけど、めっちゃ楽しかった！すぐに全体の流れを掴んでくれた。CCに放置プロジェクトだって言ったら、「まずはV0のゲームプレイループを完成させよう、そしたらさらに楽しめるし、諦めないで済むよ」って言ってくれた。ゲーム開発がすごく楽しくて、デザインのアイデアを出したら、ちゃんと動くコードを持ってきてくれる。手続き型アルゴリズムに関する資料を渡したら、実装もしてくれたし、ブレインストーミングもしてくれた。グラフィック資産も作ってくれて（外部ツールとして手続き型2Dジェネレーターのセットを作った）、ストーリー作りも手伝ってくれた。最近、コンピュータを使っててこんなに楽しいのは久しぶりだよ。Claude Code + Godot = 楽しい。またやりたくなってきた。

└

手続き型の話で、実験してることの一つは、手続きループの中にLLMを組み込むことなんだ。つまり、ライブでナラティブを書く感じ。残念ながら、ローカルモデルはまだちょっと遅くて弱いけど、どんな結果が出るか見るのは面白かったよ。

└

誰かがLLMを「彼」と呼んでるのを初めて見た気がする。「それ」とは言わずにね。別に批判するわけじゃないけど、ちょっと興味深かったし、戸惑った。

└

Godotって、LLMと一緒に使うにはちょっと設計が悪い気がするんだけど。例えば、何度か間違ったtresファイルができちゃったし、LLMにIDを生成させるのはちょっと不安定に感じる。

└

最近楽しいのは、数ヶ月前や1年前にLLMを使って始めたプロジェクトを再開することなんだ。途中で壁にぶつかって、最新のClaudeやCodexでは続けられなかったプロジェクトを進めるのが面白い。一部は今すぐにでも立ち上げられるけど、まだエージェントが構築するには複雑すぎるものもある。でも、個人アプリを作るのがどんどん簡単になってきてる。もうすぐ「アレクサ、冷蔵庫の食材の写真を撮って栄養価をまとめて、ワークアウトアプリと同期させて、健康アプリのフィットネス目標に基づいて理想的な食材を比較して、コストパフォーマンスが良くて地元の、そしてダイエット制限に合った食材を見つけてメールで教えて」って言ったら、15分でそのアプリができちゃう時代が来るよ。

└

彼は「V0のゲームプレイループを完成させよう」と明言して、 > 彼はストーリー作りも手伝ってくれた。これまでのところ、コンピュータを使って一番楽しかった時間の一つだよ。大人の男と彼のニューラルネットワークの間の友情についての、心温まる感動的な話だね。でも、こんなバカげた話を読んで大笑いできたから、感謝してるよ！

AIコーディングのおかげで、ずっと作りたかったアプリを3つも作れたんだ。でも今はちょっと違う。使う時間がないんだよね。

12年前、自分のためにシンプルなアプリを作ろうとしたんだ。日や週、月が短くなるにつれて小さくなるバーを表示して、天気を最大気温と最小気温、雲のカバーなどのバーで示すものだった。テキストとASCIIで表示するのはうまくいったけど、日常的に使いたくなるようなインターフェースにはできなかったし、グラフィカルインターフェースも全然うまくいかなかった。Claude Codeに投げて、グラフィカルインターフェースのイメージを伝えたら、まさに自分が欲しかったアプリができたんだ。しかも、気づかなかった日付パーサーのバグまで見つけてくれた。今は画面の隅で常に動かしてる。次に作るアプリは、子供が学校に行ってないときに朝のアラームを全部オフにするiPhoneアプリ。ずっと欲しかったけど、iPhoneアプリの作り方なんて全然知らないし、学ぶ時間もないから作れなかった（子供のせいでね）。Claude Codeは個人アプリにピッタリだよ。コードの質なんてあんまり関係ないから、出てきたものをそのまま使えばいいんだ。

└

ほんとそうだね。物を作るのが好きだけど、時々は誰かに作ってもらいたい時もある。特定の目的のために個人的なツールが欲しい時、LLMの助けは最高だよ。コードの質なんて気にしないで、週末を潰さずに済むからね。

└

アプリを作る必要はないよ。内蔵のショートカットアプリを使えばいいんだ。すべてのアラームをオフにするショートカットを作って、カレンダーを読み込ませたりして、特定の日や時間にアラームをオン/オフするかどうかを判断させることができるよ。定期的に実行するように設定すればOK。

└

Claude Codeは個人用アプリには最高だよね。そう思う。何年も使ってたMacのクリップボードマネージャーがOSのアップデート後に調子を崩しちゃって、App Storeの類似アプリも探してた機能がなかったんだ。だから、Simon Willisonのブログ記事を見て、SwiftUIアプリを作るためにClaude Codeに頼んでみた。動くまでに何度か試行錯誤したけど、今はMacのメニューバーに常駐して、俺が望んでたことを全部やってくれてる。特に驚いたのは、CCに追加機能の提案を頼んだときに、考えもしなかったアイデアのリストをくれたこと。自分が欲しいものを選んで、それを実装してくれた。二日前、自分用の専用マークダウンエディタが欲しくなって、LibreOfficeの新しいマークダウン編集コンポーネントみたいな、もっと小さくて軽いものを頼んだんだ。新しいGPT 5.5にそのプログラムのアウトラインを作ってもらって、CCに実装してもらった。二回のバイブコーディングセッションの後、今はほとんどやりたいことを全部できる軽量のネイティブMacアプリができたよ：マークダウンファイルを開いたり作ったり、ワープロみたいな環境で編集したり、標準的なマークダウン形式で保存したり。まだマークダウンテーブルには対応してないけど、その機能も今日中にCCに実装してもらうつもり。

サイドプロジェクトに関しては、ほとんどの場合、やる気がないときはやる価値がないと思ってる。結果よりもプロセスや経験を重視するのがレジャーだと呼んでる。結果を重視するのが仕事だね。もし多くのサイドプロジェクトが結果のためだけにやってるなら、それは自由な時間を使って働いてるってことだし、それを考えると本当に自由なのか？現代は、精神的な余裕以上に結果を求められる時代だから、サイドプロジェクトは精神のために残しておきたい。例外として、本当に信じる大義のための結果は、目的を与えてプロセスや経験を豊かにしてくれるかもしれないね。

Hacker Newsで議論の続きを見る