公開開発
FinancyをSeedで作り直す(第1回):SaaSスターターで本物のプロダクトを作る
公開日:· 1分で読めます· Anton Shubin
他の言語:العربية、Deutsch、English、Español、Français、Português (Brasil)、Русский、简体中文

要点
- オープンソースの家計管理アプリFinancyは、Seedのコピーとして一から作り直します。旧版はブランチに凍結し、何ができたかを確かめる資料として残します。
- 最初のコミットはSeedのファイルに、Financy独自の19ファイルを足したものです。ライセンス、README、エージェント向けルール、プロダクト資料、2つの.seedファイルです。
- コピーの翌日、ブランド変更の後に行った最初の同期では、Seedの19コミット・616ファイルを取り込み、コンフリクトはゼロでした。
- お金に関する機能はまだありません。どのプロダクトにも必要なものは先にSeedで作り、Financyは同期で受け取ります。
SaaSスターターの上に本物のプロダクトを作り、しかもスターターのアップデートを受け取り続けることはできるのか。いま、まさにそれをFinancyでやっています。Financyは個人や家族のための、無料でオープンソース(AGPL-3.0)の家計管理アプリです。2026年11月3日にSeedのコピーとして作り直しを始め、11月4日には最初のSeedの変更を取り込みました。19コミット、616ファイル、コンフリクトはゼロです。このシリーズでは、作り直しを進行形で追いかけます。
対象は、SaaSスターターを選んでいて、デモ以外で実際に使われている例を見たい開発者と、Financyに興味がある方です。ここに書くことはすべて公開情報で、数字はどれもGitHub上の2つのリポジトリから取っており、gitで自分で数え直せます。
なぜ直すのではなく作り直すのか
初代Financyは2025年4月に始まり、157コミットまで育ちました。複数通貨の口座を管理し、通貨間の換算をし、E2Eテストもありました。一方で、もう信用できないコードも抱えていました。多くは当時のAIモデルを使って急いで書いたもので、目指すプロダクトにするには、構造も状態管理も同期も結局作り直す必要がありました。
答えのもう半分は、Financyに足りなかったものです。家庭向けの家計管理アプリには、二要素認証つきのログイン、ロールつきのグループ、全端末へのリアルタイム反映、オフラインで動くアプリ、管理画面、公開サイトが必要です。これはお金の話ではなく、どのSaaSにも要る配管です。そして私はちょうど10月いっぱいをかけて、その大半をSeedに作り込んだところでした(10月に入ったもの、英語)。Financyの中でもう一度書くのは、Seedが防ぐために存在する失敗そのものです。
そこで旧Financyはlegacyブランチに凍結しました。Financyが何をするか(機能、お金のルール、境界ケース)を確かめる資料であって、どう作るかの資料ではありません。ヘルパー関数ひとつ移植しません。旧版から取ったお金のルールは仮説として扱い、まずテストにしてから新しいコードを書きます。
FinancyはどうやってSeedから始まったのか
プルリクエスト1つ、financy#83です。Seedのファイルに、コピーをFinancyにする19ファイルを足しました。この数は、Financyの最初のコミットと、そこに記録されたSeedのコミットを比べて数えました。
git fetch https://github.com/spy4x/seed main
git diff --stat "$(git show 3d267c6f:.seed/commit)" 3d267c6f
19ファイルの中身は次のとおりです。AGPL-3.0のライセンス(SeedのMIT表記は別ファイルに残す)、アプリがまだ使えないと正直に書いたREADME、FinancyのAGENTS.md(関わるエージェントと人が従うルール)、プロダクト資料、Financyのタグが決してSeedのイメージを上書きしないようにするリリースパイプラインのイメージ名、削除したSeedの暗号化サーバー設定4つ、そして同期を可能にする2つのファイルです。
この2つが仕掛けのすべてです。.seed/commitにはコピーが対応するSeedのコミットを、.seed/skipにはFinancyが変更を受け取らないSeedのパス(READMEなど)を書きます。同期とは、そのコミットからSeedの現在のmainまでのgit diffを、3-wayマージで適用することです。手順の全体はStart a product from Seed and keep getting its updates(英語)にあります。この記事は、それを実際にやってみたらどうなったかの記録です。
最初の同期は本当にうまくいったのか
はい。しかも、わざと小さな罠を仕掛けたうえでです。同期の前に、FinancyはすでにSeedのファイルを変えていました。financy#123で、名前、財布のアイコン、Seedの紫に代わる独自の青を、32ファイルにわたって入れています。手つかずのコピーでしか動かない同期では、何の証明にもなりません。
続いてfinancy#127で、Seedをec61062bからd9641f03まで進めました。Seedのプルリクエスト19件、変更ファイル616個を、git apply --3wayはコンフリクトなしで適用しました。届いたものの一部です。
- メールで届くコードでのログイン
- 月額の横に並ぶ年額料金
- グループ全体のタイムゾーン
- Denoに加えてNodeとBunでも動くAPIとワーカー
- プロダクトの変更履歴をどこから始めるかの設定
同期では、プロダクト側が手で行う手順も1つ見つかりました。Seedには、Seed自身のリポジトリ用ルールであるAGENTS.seed.mdが追加されたばかりでした。Financyはこれを削除して.seed/skipに加え、以後の同期で戻ってこないようにしました。同期後、FinancyとSeedの差は59ファイルで、そのすべてがFinancyが意図して変えたファイルです。
FinancyではなくSeedに入れるものは何か
どのSaaSにも必要なものすべてです。順番はFinancyのAGENTS.mdが決めています。どのプロジェクトでも使えるコードは共有ライブラリ@spy4x/*へ、Seed上のどのプロダクトにも必要なコードはSeedへ、そしてお金のプロダクトにだけ必要なもの(口座、取引、予算、為替レート)だけがFinancyに残ります。「あとで移す」ローカルの仮実装は作りません。「あとで」こそ、フォークが離れていく原因だからです。
上のリストのうち3つが、まさにそれです。Financyには年額課金が必要で、家庭の「1か月」は全員で同じタイムゾーンでなければならず、変更履歴が旧アプリの何年分ものコミットから始まってはいけません。どれもお金の話ではないので、それぞれSeedで作り、同期でFinancyに届きました。11月3日と4日に、Financyに触れたSeedの新しいissueが31件立ち、11月5日までにそのうち8件がクローズされました。
作り直しは、私自身の手順の穴も見つけました。プロダクトがSeedのサイトから取り除くもののリストはいくつかのファイルを漏らしていましたし、手順1はSeedの最新コミットを記録していました。最新コミットはコピーより新しいことがあり、その場合、最初の同期は間のコミットを黙って飛ばしてしまいます。どちらもSeedで修正済みで(seed#811)、ガイドには、自分のファイルと一致するコミットの見つけ方が書いてあります。この修正は私よりあなたの役に立ちます。次にSeedで作られるプロダクトは、もうこの穴に落ちません。
まだできていないことは何か
ほとんど全部です。これを書いている時点のFinancyは、Financyの名前とライセンスと色をまとったSeedです。口座、取引、予算の画面はまだないので、今は使わないでください。名前さえ決まっていません。financy#126で、ローンチ前に名前を変えるかどうかを検討しています。
計画は公開しています。Financyのissueは、土台からローンチ、そしてその後までの7つのマイルストーンに分かれています。そこで見つかったSeedの穴はSeedで直すので、このシリーズでは両方の側、つまりFinancyが何を必要とし、Seedがそこから何を学んだかをお見せしていきます。
続きを追いかける
FinancyのリポジトリをWatchすると、プルリクエストが入るたびに見られます。このブログを購読すれば、第2回がメールで届きます。自分のプロダクトを始めようとしているなら、ガイドはFinancyが従っているものと同じです。もし途中の手順でつまずいたら、issueを開いてください。手順に1行足りないということです。


