Claude Codeを使って放置していた個人プロジェクトを復活させる方法：実践ガイド

Matthew Brunelle氏は、AIコーディング支援ツール（具体的にはOpus 4.6を搭載したClaude Code）を使って、放置していた個人プロジェクトを復活させた経験を語っています。そのプロジェクトとは、YouTube MusicとOpenSubsonic APIの間のシャムであり、Subsonic互換クライアント（Navidrome、Feishin、Symfoniumなど）がYouTube Musicから音楽をストリーミングできるようにするものです。このプロジェクトは、実装すべきエンドポイントの長いテールのために当初頓挫していました。

セットアップ

Brunelle氏は、依存関係としてfastapi、pydantic、ytmusicapi、yt-dlpを含むuvプロジェクトを作成しました。OpenSubsonicのOpenAPI仕様をフォルダに置き、簡単なREADME、空のTODOファイルを追加し、/initでCLAUDE.mdを生成しました。また、CLAUDE.mdに次のような規約を追加しました：

## 規約
- メソッドには引数と戻り値の型アノテーション、およびdocstringを付けること。
- データモデリングにはPydanticを使用する。最新のPydantic V2の規約に従うこと。
- docstringはGoogleスタイル形式で、argsとreturnsのセクションを含めること。
- 単体テストは最新のpytestスタイル（トップレベルの関数でassertを使い、fixtureを利用する）で書くこと。

ワークフロー

Brunelle氏の典型的なワークフロー：

• プランモードに入る。次の作業をプロンプトする。
• 初期プランを受け取った後、ギャップや問題を探し、満足するまでフォローアップの質問をする。
• Claudeが間違っているときはリソースへのリンクを提供する。
• 慣用的なアプローチについては、Claudeに検索ツールを使うよう依頼する。
• 「Accept and clear context」を使用する。繰り返す。

初期実装

最初のプロンプト：openapi.jsonファイルを見てください。これはopensubsonic APIの仕様です。すべてのメソッドをスタブ化する非同期FastAPIサーバーを実装してください。新しいJSONエンドポイントのみを処理すれば十分です。

スタブを実装した後、フォローアッププロンプトで正しさを再確認しました。仕様があったにもかかわらず、Claudeは最初は間違いを犯しましたが、2回目で修正しました。また、/initを再実行してCLAUDE.mdを更新しました。

次の主要プロンプト

すべてのエンドポイントのメソッドはスタブ化されました。subsonicクライアントを接続し、曲を検索し、その曲をクライアントにストリーミングしたいと考えています。それを実装するために最低限必要な機能は何ですか？検索にはytmusicapi、ストリーミングにはyt-dlpを使用してください。

Brunelle氏によると、最初のストリーミング実装は妥当に見えましたが、Feishinと接続したときに失敗しました。記事は修正の詳細を説明する前に切れていますが、完全な投稿には解決策が含まれています。

Brunelle氏は、放置されたプロジェクトはAIコーディング支援を試すのに最適な候補だと述べています：「どうせ完成しなかったプロジェクトだからです。」彼はOpenCodeに関するフォローアップ記事を投稿する予定です。