作らないものリストを先に書く — 個人開発の題材選び

個人開発の題材選び。アプリの企画ノートと三つの画面案、範囲を決めるチェックリスト。

手が止まるのは実力の問題ではなく、決めていないからです。作らないものリストを先に書いて、題材を1つに絞ります。

前回: 障害対応は切り分けの順番がすべて — わざと壊して直す この回は、ほとんどコードを書きません。 使うのは紙とペン、そしてVMの中(Ubuntu Server)のテキストエディタだけです。新しいソフトは1つも入れません。

道具は、もうそろっています。

Ubuntu の入ったVMがあって、Node.js でAPIが書けて、MySQLにデータを残せて、ログインの仕組みも分かっていて、Reactで画面が作れて、nginx で前に立てられて、systemd で自動起動できます。

それでも、エディタを開いた瞬間に手が止まります。

私は止まりました。しかも、止まった理由を長いあいだ勘違いしていました。

「まだ実力が足りないから、作れないんだ」

違いました。 足りていないのは実力ではありません。

何を作るか、決めていないだけです。

この2つは、外から見ると同じ「手が止まっている」に見えます。だから間違えます。 そして「実力不足だ」と判断すると、対処が「もう1つ勉強する」になります。私はここで、TypeScript を触り、Go を触り、GraphQL を触りました。どれも面白かったのですが、作品は1ミリも進みませんでした。

勉強は、止まっている自分から目を逸らすのに、いちばん都合のいい行動です。やっている感覚があって、しかも「無駄ではない」と言い訳が立つからです。

この回でやるのは、その逆です。

新しいことを1つも学ばずに、いま持っている道具だけで作れるものを、1つに絞り込みます。 そして絞り込むために、「作らないもの」を先に、長く、書きます。

この記事の主題は、「何を作るか」ではありません。

「何を作らないか」です。

対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • 手が止まる原因は実力不足ではなく「決めていないこと」だということ。この2つを取り違えると、対処が「もっと勉強する」になって永遠に作り始められない
  • 題材選びには条件が3つしかないこと。自分が使う / 1週間で形になる / データが単純。「人に見せて評価されるもの」を選ぶと、まず続かない
  • 作るものリストより、作らないものリストのほうが長くなるのが正常だということ。短い作らないリストは、決めきれていない証拠
  • 機能を削るのと、あとで足せなくするのは別だということ。削っても足せる形で削る判断のしかた
  • 画面が1枚増えると、作る量は1枚分では増えないこと。画面は「作業単位」ではなく「掛け算の項」
  • 完成の定義を書かないと、永遠に終わらないこと。「だいたいできた」には終わりがない
  • 見積もりは個人開発では機能しないこと。かわりに「順番」を決めれば、途中で止まっても手元に動くものが残る
  • 設計書を書き込むのは、コードを書かないための立派な言い訳になること。今日の成果物は紙1枚とファイル1つで十分

この記事でやること

  1. 題材を3条件に照らして選ぶ。この連載で作る hitokoto を決める
  2. 作らないものリストを、作るものリストより長く紙に書く。1つずつ「なぜ今はやらないか」を1行添える
  3. 画面を数える。3枚に収まっていることを確認する
  4. データを3つの箱に分け、ER図を紙で描く(users / books / quotes)
  5. 完成の定義を、チェックできる文章で書く
  6. docs/adr/0001-what-to-build.md に全部残して、コミットする

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
要件そのアプリが何をできる必要があるかを、文章にしたもの。「ログインできる」「本を登録できる」の粒度
スコープどこまでを作る範囲に入れるかの線。線の外側を書くことが、この記事の主題
スコープクリープ作っている途中で、範囲がじわじわ広がっていくこと。個人開発が完成しない最大の原因
MVPMinimum Viable Product。「使える最小のもの」。「機能が少ない版」ではなく「1本の用途が通る最小版」
YAGNIYou Aren’t Gonna Need It(それ、どうせ要らない)。要りそうだからという理由で先に作らないという考え方
完成の定義何ができたら「できた」と言うかを、先に決めた文章。チームでは Definition of Done と呼ばれる
ADRArchitecture Decision Record。「なぜその設計にしたか」を1件1ファイルで残す記録。デザインシステムの回で書いた
ER図箱(表)と線(関係)だけで、データの設計を描いた図。正規化の回で描いた
垂直に切る「画面だけ全部作る」ではなく、1つの機能を画面からDBまで貫通させて完成させる進め方

① 手が止まるのは、実力ではなく「決めていない」から

まず、自分がどちらで止まっているのかを見分けます。簡単な見分け方があります。

いま、エディタに最初の1行として何を書けばいいか、言えますか。

「app.get('/api/books', ...) と書く」と言えるなら、実力の問題ではありません。 手は動きます。

言えないなら、止まっているのは判断です。そして判断が止まっているとき、コードは1行も書けません。 実力があっても、です。

もう1つ、確かめ方があります。 紙に「これから作るものを、一文で書いてください」。

私が最初に書いた一文は、これでした。

自分の生活を便利にする、いい感じのWebアプリ

これでは1行も書けません。 「いい感じ」に対応するコードが存在しないからです。

この回の目的は、この一文を、コードに変換できる文に書き換えることです。

勉強と作品づくりは、別の行動

ここまでの回で、私たちはずっと「新しいことを1つ知る」をやってきました。そのやり方が、ここで通用しなくなります。

勉強作品づくり
目的知らないことを減らす決まっていないことを減らす
良い状態選択肢が増える選択肢が減る
詰まる原因知識が足りない判断していない
詰まったとき調べる調べても解決しない。決めるしかない

この表の右側は、調べても出てきません。 「自分のアプリに通知機能を付けるべきか」を検索しても、答えは書いてありません。あなたにしか決められないからです。

作品づくりで最初にやる作業は、コードを書くことではなく、選択肢を捨てることです。

② 題材の選び方 — 条件は3つだけ

「何を作るか」で悩む時間は、いくらでも伸ばせます。伸ばさないために、条件を3つに固定します。

条件1: 自分が使うものであること

いちばん重要です。 理由は根性論ではありません。

自分が使わないアプリは、動いているかどうかも分かりません。

自分で毎日開くアプリなら、バグは自分で踏みます。 「一覧の並び順が変だ」「検索に引っかからない」に、勝手に気づきます。気づけば直したくなります。 これが、個人開発が続く唯一の仕組みです。

自分が使わないものは、作り終わったあと二度と開きません。 そして、開かないものは直せません。

条件2: 1週間で最初の形になること

「1週間で完成する」ではありません。 「1週間で、自分が触れる状態になる」です。

なぜ1週間かというと、それ以上かかるものは、途中で自分の興味が切れるからです。私は2週間分の設計をして、10日目に飽きました。飽きたのは根性の問題ではなく、その間ずっと「動くもの」を見ていなかったからです。

判定のしかたは単純です。

「その機能を作るのに、いま知らない技術がいくつ要るか」を数えて、1つ以下ならOK。

2つ以上あるなら、それは作品ではなく勉強です。悪くはありませんが、この段階でやることではありません。

条件3: データが単純であること

データの形が、そのままアプリの難しさになります。

データの形難しさ
箱が2〜3個で、1対多で繋がるここを狙う。 正規化の回でやったことがそのまま使える
多対多が出てくる中間テーブルが要る。作れるが、量が1.5倍になる
ユーザー同士が繋がる一気に難しくなる。 権限・公開範囲・通知が芋づるで付いてくる
時系列で状態が変わる履歴を持つか上書きするかの判断が要る

選んではいけないもの

この3つは、条件を満たしていても避けます。 私が実際に失敗したものです。

避けるものなぜ
人に見せて評価されるためのもの完成前に評価軸ができてしまう。 「これでは人に見せられない」が発生した瞬間、作業が止まる
既にあるサービスの完全な模写本家と比べられる。比べる相手は本家ではなく、昨日の自分でないと続かない
他人のためのツール要望が外から来る。自分で範囲を決められなくなる

「ポートフォリオになるものを作ろう」は、一見まっとうですが、条件1と正面から衝突します。 人に見せるためのものは、自分では使いません。使わないから、バグに気づきません。

人に見せられるものは、「自分が使い続けたもの」の結果として、あとから出てきます。 順番を逆にすると、両方失います。

③ この連載で作るもの — hitokoto

上の3条件で絞った結果、この連載ではこれを作ります。

hitokoto(ひとこと)

読んだ本と、そこから引いた一文を残すアプリ。

やれることは、これだけです。

  • 本を登録する(タイトル・著者・読了日)
  • その本から引用を1つ以上残す(本文・ページ番号)
  • 一覧で見る/検索する
  • 書き込めるのは自分だけ(ログインが要る)
  • 公開ページは、ログイン無しで読める

使う技術は、全部この連載で通ってきたものだけです。

層使うものどの回でやったか
動かす場所Ubuntu Server(VM)VMの回
サーバーNode.js + ExpressAPIの回
データMySQL + KnexMySQLの回 / マイグレーションの回
ログインセッション認証認証の回 / ハッシュの回
画面React + ViteReactの回 / ビルドの回
公開nginx + systemdリバースプロキシの回 / サービスの回

新しく学ぶ技術は、ゼロです。 これは手抜きではなく、意図した条件です。 作品づくりの最中に新技術を1つ入れると、詰まったときに「設計の問題」なのか「技術を知らないだけ」なのかが切り分けられなくなります。

なぜこれを選んだのか(3条件に照らす)

条件hitokoto はどうか
自分が使うか使います。 本を読むたびに開きます。読書は毎週あるので、データが自然に増えます
1週間で形になるかなります。知らない技術がゼロなので、詰まるのは自分の設計だけです
データが単純か箱3つ、1対多が2本だけ。 多対多がありません

もう1つ、隠れた理由があります。

hitokoto は、「機能を足したくなる誘惑」が強いアプリです。

タグを付けたい、書影を出したい、他の人の引用を見たい、月ごとの冊数をグラフにしたい——全部、思いつきます。 そして全部、この連載でやりません。

題材として、これがちょうどいいのです。 誘惑が無いアプリでは、「作らないと決める」練習になりません。

④ 【】作らないものリストを、作るものリストより長く書く

ここがこの記事の中心です。 紙を1枚出してください。画面ではなく、紙です。

理由は2つあります。紙は消しにくいので、書く前に少し考えます。 そしてあとで見返したとき、字の勢いで「そのとき何に迷ったか」が思い出せます。

まず、作るものを書く

7個で止めます。 8個目を書きたくなったら、それは作らないもの側です。

【作る】
1. ログイン / ログアウト(ユーザーは自分1人)
2. 本を登録・編集・削除する(タイトル / 著者 / 読了日)
3. 引用を登録・削除する(本文 / ページ番号)
4. 本と引用の一覧を見る
5. タイトル・著者・引用本文で検索する(部分一致)
6. 公開ページ(ログイン無しで読める、引用の一覧)
7. VM上で nginx + systemd で動き、再起動しても勝手に上がる

次に、作らないものを書く(こちらを長くする)

14個書きます。 各行に「なぜ今はやらないか」を1行、そして「あとで足せるか」を必ず添えます。

【作らない】
 1. 他人のフォロー / タイムライン
    → ユーザーが2人以上いる前提が全部の表に波及する。あとで足せる(新しい表を足すだけ)
 2. 画像アップロード(書影)
    → 保存先・容量・配信の3つの判断が要る。あとで足せる(books に1列足すだけ)
 3. 通知(メール / プッシュ)
    → 送信元の用意と到達確認で、それ自体が1本の記事になる。あとで足せる
 4. スマホアプリ
    → 配布とストアの審査が別世界。ブラウザで足りる。あとで足せる
 5. 全文検索エンジン(Meilisearch など)
    → 自分のデータは数百件。LIKE で足りる。あとで差し替えられる
 6. おすすめ / レコメンド
    → 推薦の良し悪しを自分で判定できない。あとで足せる
 7. ユーザー登録画面
    → 使うのは自分だけ。アカウントは SQL で1行入れる。あとで足せる
 8. パスワード再発行
    → メール送信が要る(3と同じ理由)。忘れたら SQL で入れ直す。あとで足せる
 9. タグ / カテゴリ
    → 多対多になり、中間テーブルと管理画面が付いてくる。あとで足せる
10. いいね / コメント
    → 他人が要る(1と同じ)。あとで足せる
11. ページネーション / 無限スクロール
    → 件数が数百なら要らない。1000件を超えたら考える。あとで足せる
12. ダークモード / テーマ切替
    → 見た目の分岐が全画面に増える。あとで足せる(トークンを差し替えるだけ)
13. CSV インポート / エクスポート
    → 入力の検証が本体より複雑になる。あとで足せる
14. 外部に公開する API
    → 公開した瞬間、勝手に変えられなくなる。あとで足せる(今は足さない方が自由)

[スクリーンショット: 01_作らないものリスト.png] あなた自身が書いた「作る」と「作らない」の紙を撮ってください。私のリストの写しではなく、自分のアプリのものを書いてください。 字は汚くて構いません。

なぜ「作らない側」を長く書くのか

3つ理由があります。

理由1: 短いリストは、決めきれていない証拠です。

作らないものが3個しか出てこないなら、それは候補を思いついていないだけです。思いついていないものは、作っている途中で思いつきます。 そして途中で思いついた機能は、必ず作りたくなります。

先に思いついて、先に捨てておけば、途中で拾わずに済みます。

理由2: 「なぜやらないか」を書くと、判断が復元できます。

3週間後のあなたは、リストを見て「タグくらい付けてもよくない?」と思います。そのとき理由が書いてあれば、5秒で思い出せます。「多対多になるからだ」と。

理由が書いていないと、もう一度ゼロから考えます。 そして今度は「まあいいか」と足します。これはADRを書く理由と、まったく同じ構造です。

理由3: 「あとで足せる」を確認すると、削るのが怖くなくなります。

削るのをためらう本当の理由は、「もう二度と足せない気がする」からです。

これはほとんどの場合、誤解です。 上の14個のうち、あとで足せないものは1つもありません。 どれも、表を1つ足すか、列を1つ足すか、ライブラリを1つ入れれば済みます。

逆に、あとから足すのが本当に高くつくものは、別にあります。

あとから足すのが高いものなぜ
ユーザーを1人前提から複数前提に変える全部の表に user_id が要る。 全部のクエリに条件が増える
公開 / 非公開の区別データの見せ方が全経路に影響する
IDの型を変える(連番 ↔ UUID)既存データの移行が要る
文字コード・タイムゾーンの決め方入ってしまったデータは直せない

だから hitokoto では、この4つだけ最初から決めます。

  • user_id は、持ち主を表す books に最初から入れる(使うのは1人でも、列は持つ。quotes は books を辿れば分かるので持たない)
  • 公開 / 非公開のフラグは最初から持つ(今は全部公開でよい)
  • IDは連番(AUTO_INCREMENT)にする
  • 文字コードは utf8mb4、日時は UTC で保存して表示時に変換する

削ってよいのは「機能」で、削ってはいけないのは「前提」です。 この2つを見分けるのが、作らないものリストを書く本当の目的です。

⑤ 画面を数える — 3枚に収める

次にやるのは、画面を数えることです。 数えるだけです。まだ描きません。

hitokoto の画面は、3枚です。

#画面URL誰が見るか
1一覧/ログイン済みの自分
2登録 / 編集/books/new /books/:idログイン済みの自分
3公開ページ/p/:id誰でも(ログイン不要)

ログイン画面は? と思ったはずです。入れません。 一覧を開いたときにログインしていなければ、その場に入力欄を出します。 画面を1枚増やすより安いからです。

画面は「作業単位」ではなく「掛け算の項」

「画面1枚くらい、増えても大したことない」と思ってしまいます。 ここが罠です。

画面が1枚増えると、増えるのは1枚分ではありません。

増えるもの内訳
ルーティング1経路。直リンクで404にならないかの確認も要る
APIの口1〜3本(取得・保存・削除)
状態読み込み中 / 空 / エラー / 正常の4通りを毎回書く
権限ログイン要否の判定が1つ
見た目幅が狭いときの崩れの確認が1画面分
テスト手で触る確認手順が1つ

つまり、画面1枚は「6種類の作業 × 1」です。 3枚なら18、5枚なら30。5枚は3枚の1.7倍ではなく、体感では3倍近くになります。

画面を数える作業の目的は、「何を作るか」を決めることではありません。 増やそうとしたときに、いくら払うのかを知っておくことです。

[スクリーンショット: 02_画面3枚のスケッチ.png] 紙に、四角を3つ描いて、中に何が並ぶかを箇条書きしたものを撮ってください。線と文字だけで十分です。 きれいに描く必要はありません。この段階で色や余白を考え始めたら、それは手が止まっている合図です。

⑥ データを3つの箱に分ける — ER図を紙で描く

正規化の回でやったことを、ここで回収します。 やり方は同じです。箱を描いて、線で結んで、両端に「1」か「多」を書きます。

hitokoto の箱は3つです。

[ users ]---1----多---[ books ]---1----多---[ quotes ]

線は2本、どちらも1対多。多対多はありません。 これが「データが単純」の中身です。

中に入れる列は、これだけです。

users
  id            連番
  username      ログイン名(重複させない)
  password_hash ハッシュ(生のパスワードは絶対に置かない)
  display_name  公開ページに出す名前
  created_at

books
  id            連番
  user_id       → users.id(誰の本か)
  title         書名
  author        著者
  finished_on   読了日(読み終わっていなければ空でよい)
  is_public     公開してよいか(0 / 1)
  created_at

quotes
  id            連番
  book_id       → books.id(どの本からの引用か)
  body          引用の本文
  page          ページ番号(分からなければ空でよい)
  created_at

[スクリーンショット: 03_er図.png] 紙に描いた3つの箱と2本の線を撮ってください。線の両端に「1」「多」を書き忘れないでください。 ここを書かないと、図の意味が半分になります。

図を描く途中で、決まっていないことが見つかる

この図を描くと、必ず手が止まる場所があります。 私が止まったのは、この4つでした。

迷ったこと決めたこと理由
引用は本に必ず紐づくのか紐づける。 本の無い引用は作れない「どこから引いたか」が分からない一文は、この アプリの意味を失う
user_id は quotes にも要るか要らない。 books を辿れば分かる2箇所に持つと、必ずズレる(正規化の回で見た通り)
公開の単位は本か引用か本(books.is_public)引用ごとにすると、公開ページの組み立てが一気に複雑になる
本を消したら引用はどうなるか一緒に消す(ON DELETE CASCADE)本の無い引用は上の決定により存在できないため

紙の上で迷った4つは、コードの上でも必ず迷います。 違いは、紙なら消しゴムで済むことです。 データが入ってからだと、マイグレーションとデータ移行になります。

この4つを決めた時点で、CREATE TABLE はもう書けます。 ただし、この記事では書きません。 書くのは次の回です。

⑦ 完成の定義を書く — 「だいたいできた」には終わりがない

個人開発が終わらない原因のうち、機能の多さは半分です。 もう半分は、これです。

終わりが定義されていないので、終われません。

「だいたいできた」の状態は、永遠に「だいたい」のままです。 直すところは、いつでも見つかるからです。

なので、先に書きます。 書き方の条件は1つだけです。

「はい / いいえ」で答えられる文にすること。

悪い例と、良い例を並べます。

❌ こう書くと終われない✅ こう書けば終われる
使いやすい一覧になっている一覧に本が10件表示され、新しい順に並んでいる
ちゃんとログインできるログアウト状態で / を開くと入力欄が出て、正しい組み合わせで一覧に入れる
検索がうまく動く「夏」で検索すると、タイトル・著者・引用本文のどれかに「夏」を含む本だけが出る
公開ページがきれいブラウザのシークレットウィンドウで /p/1 を開き、ログインせずに引用が読める
安定して動くVMを再起動したあと、何も操作せずに / が表示される

hitokoto の完成の定義は、この9行にしました。

【完成の定義】この9つが全部「はい」になったら完成とする。

 1. ログアウト状態で / を開くと、ログイン入力欄が出る
 2. 正しい組み合わせでログインでき、リロードしてもログインが続く
 3. 本を1冊登録でき、一覧に出る
 4. その本に引用を2つ登録でき、本の下に並ぶ
 5. 本を削除すると、その引用も消えている(DBを直接見て確認する)
 6. 検索欄に語を入れると、タイトル・著者・引用本文の部分一致で絞られる
 7. シークレットウィンドウで公開ページを開き、ログインせずに読める
 8. 非公開にした本は、公開ページから消える
 9. VM を再起動したあと、何も操作せずに 7 がもう一度できる

この9行に無いものは、完成に必要ありません。 見た目の美しさは、1行も入っていません。 これは意図的です。

見た目は「完成の条件」ではなく「完成のあとの作業」です。 条件に入れると、終わりが判定できなくなります。

そして、9番が最重要です。

「自分のPCで npm run dev したら動く」は、完成ではありません。 それは開発中です。手を離しても動いているところまでが、この連載の完成です。

⑧ 見積もりはしない。かわりに順番を決める

「何日でできますか」を自分に聞くのは、やめます。

理由は、当たらないからではありません。外れたときに、作業ではなく気持ちが折れるからです。 「3日で終わるはずが10日かかった」と思った瞬間、まだ動いているコードが、失敗作に見えます。

個人開発に締切はありません。 無いものを自分で作って、自分で破って、自分で落ち込むのは、完全に無駄です。

かわりに決めるのは、順番です。

順番の原則: 動く一番小さいものを、まず貫通させる

やってはいけない進め方から書きます。

❌ 悪い順番(層で切る)
   1. 全部のテーブルを作る
   2. 全部のAPIを作る
   3. 全部の画面を作る
   → 3 の途中まで、一度も動いているものを見られない

この順番だと、最初に「動いた」を見るのが最終日です。 そして途中で飽きます。私はこれで1本、捨てました。

✅ 良い順番(機能で貫通させる = 垂直に切る)
   1. 本を1冊登録して、一覧に出す(DB → API → 画面を1本つなぐ)
   2. ログインを付ける
   3. 引用を足す
   4. 検索を足す
   5. 公開ページを足す
   6. nginx と systemd に載せる

1が終わった時点で、すでに「動くアプリ」です。 貧弱ですが、動いています。 ここが決定的に違います。

2番目以降は、全部「肉付け」です。 途中で止まっても、手元には動くものが残ります。

この考え方は、モノリスの回で「まず1つのプロセスで作る」と決めたのと同じ形です。 分けるのも、飾るのも、動いてからです。

順番だけ決めて、日数は書かない

紙にはこう書きます。

【順番】
1 → 2 → 3 → 4 → 5 → 6

いま: 1 の途中

「いま」の行だけ、作業のたびに書き換えます。 これで十分です。日付を書かないので、遅れることがありません。

⑨ 決めたことを docs/adr/0001-what-to-build.md に残す

紙に書いたものは、無くします。 私は無くしました。

なので、コードと同じ場所に残します。デザインシステムの回で書いた ADR を、そのまま使います。

VMの中で、リポジトリを作ります。

bash
$ mkdir -p ~/hitokoto/docs/adr
$ cd ~/hitokoto
$ git init
bash
$ nano ~/hitokoto/docs/adr/0001-what-to-build.md

中身の全文です。 私が実際に書いたものを、そのまま載せます。

# 0001. hitokoto を作る。作らないものを先に確定させる

- 状態: 採用
- 日付: 2026-09-14

## 背景

道具(Ubuntu / Node.js / MySQL / セッション認証 / React / nginx / systemd)は
一通り触り終えたが、作品に着手できていない。
原因を「実力不足」と判断して新しい技術を3つ触ったが、作品は1行も進まなかった。
実際に足りていなかったのは、何を作るかの決定である。

## 決めたこと

読んだ本と、そこから引いた一文を残すアプリ「hitokoto」を作る。

作るもの(7つ):
1. ログイン / ログアウト(ユーザーは自分1人)
2. 本の登録・編集・削除(タイトル / 著者 / 読了日)
3. 引用の登録・削除(本文 / ページ番号)
4. 本と引用の一覧
5. タイトル・著者・引用本文の部分一致検索
6. 公開ページ(ログイン不要で読める)
7. VM 上で nginx + systemd で常時動く

画面は3枚に固定する(一覧 / 登録・編集 / 公開ページ)。
ログイン画面は作らず、一覧の中に入力欄を出す。

データは3つの箱に分ける。
  users --1--多-- books --1--多-- quotes
多対多は作らない。

新しい技術は1つも使わない。既習のものだけで組む。

## 作らないもの(と、その理由)

 1. 他人のフォロー / タイムライン  → 全表に多人数前提が波及する。後から足せる
 2. 画像アップロード(書影)      → 保存先・容量・配信の判断が要る。後から足せる
 3. 通知(メール / プッシュ)     → 送信基盤の用意が別作業。後から足せる
 4. スマホアプリ                  → 配布と審査が別世界。ブラウザで足りる
 5. 全文検索エンジン              → 数百件なら LIKE で足りる。後から差し替え可能
 6. おすすめ / レコメンド         → 良し悪しを自分で判定できない
 7. ユーザー登録画面              → 利用者は自分だけ。SQL で1行入れる
 8. パスワード再発行              → メール送信が要る(3と同じ)
 9. タグ / カテゴリ               → 多対多と管理画面が付いてくる
10. いいね / コメント             → 他人が必要(1と同じ)
11. ページネーション              → 1000件を超えるまで不要
12. ダークモード                  → 見た目の分岐が全画面に増える
13. CSV 入出力                    → 入力検証が本体より複雑になる
14. 外部公開 API                  → 公開すると仕様を変えられなくなる

上記14件は、いずれも後から追加できることを確認済み。

## 逆に、最初から入れておくもの(後から変えると高いため)

- books に user_id を持つ(利用者が1人でも列は持つ。quotes は books 経由で辿る)
- books に is_public を持つ(公開範囲は後から入れると全経路に影響する)
- 主キーは連番(AUTO_INCREMENT)
- 文字コードは utf8mb4、日時は UTC で保存し表示時に変換する

## 完成の定義

以下の9つがすべて「はい」になった時点で完成とする。

 1. ログアウト状態でトップを開くとログイン入力欄が出る
 2. ログインでき、リロードしても継続する
 3. 本を1冊登録でき、一覧に出る
 4. その本に引用を2つ登録でき、本の下に並ぶ
 5. 本を削除すると引用も消える(DB を直接見て確認)
 6. 検索でタイトル・著者・引用本文の部分一致が効く
 7. シークレットウィンドウで公開ページをログインせず読める
 8. 非公開にした本は公開ページから消える
 9. VM 再起動後、何も操作せずに 7 が再現できる

見た目の良し悪しは完成条件に含めない。完成後の作業とする。

## 作る順番(日数は決めない)

1 本を登録して一覧に出す(DB → API → 画面を1本貫通)
2 ログイン
3 引用
4 検索
5 公開ページ
6 nginx + systemd に載せる

層ごと(全テーブル → 全API → 全画面)には作らない。
途中で止まったときに、動くものが1つも残らないため。

## 検討して採用しなかった案

- 家計簿アプリ: 金額の計算と締めの概念があり、データが単純でない。
- 既存SNSの模写: 本家と比較してしまい、完成前に評価軸ができる。
- 人に見せる前提のポートフォリオ: 自分で使わないため、バグに気づけない。

## 結果として困りうること

- 利用者が自分1人のため、同時アクセスや権限の問題を経験できない。
  これは意図的に外した。必要になった時点で 0002 として作り直す。
- LIKE 検索は件数が増えると遅くなる。1000件を超えたら測って判断する。

書けたら、コミットします。

bash
$ cd ~/hitokoto
$ git add docs/adr/0001-what-to-build.md
$ git commit -m "docs: 作るものと作らないものを決めてADRに記録"
bash
$ git log --oneline

[スクリーンショット: 04_adrをコミットした画面.png] git log --oneline の結果と、docs/adr/0001-what-to-build.md が入っている状態を撮ってください。

今日の成果物は、これだけです。 コードは0行です。それでいいのです。

このファイルがあると、3週間後に迷ったとき、判断をやり直さずに済みます。 無いと、毎回ゼロから考え直して、毎回少しずつ機能が増えます。

戻し方(この回で作ったものを全部消したいとき):

bash
$ rm -rf ~/hitokoto

rm -rf はパスを打ち間違えると別のものを消します。 打つ前に ls ~/hitokoto で中身を確認してください。

⑩ ここでやりすぎない — 設計書を書き込まない

最後に、いちばん危ない罠を書きます。

ここまでで、「決めるのは気持ちがいい」ことに気づいたはずです。紙に線を引いて、リストが埋まって、ファイルができました。進んだ感覚があります。

その感覚が危険です。

設計は、いくらでも書き込めます。 API仕様書を書き、画面遷移図を描き、状態遷移を整理し、命名規則を決め、エラーコードの一覧を作り——全部「役に立ちそう」に見えます。

そして、コードは1行も進みません。

設計書を書き込むのは、コードを書かないための、いちばん立派な言い訳です。 誰にも責められません。自分でも「ちゃんとやっている」と思えます。私はこれで、3日使いました。

線引きを、はっきり書きます。

今日やってよいこと今日やってはいけないこと
作るもの7個・作らないもの14個のリストAPI仕様書(エンドポイントの一覧と型)
画面を数える(3枚)画面のデザイン、配色、余白
ER図(箱3つと線2本)CREATE TABLE の完全なSQL
完成の定義9行テスト計画・工数表
作る順番(日数なし)詳細なスケジュール
ADR 1本ADR 5本

判定のしかたは、1つです。

「これを書かないと、明日の作業が始められないか?」 答えが「いいえ」なら、今日は書きません。

API仕様書を書かなくても、明日「本を登録して一覧に出す」は始められます。だから書きません。 必要になったときに、そのとき分かっていることだけ書けば十分です。

これが YAGNI(それ、どうせ要らない)です。 機能だけでなく、ドキュメントにも同じことが起きます。

つまずいたところ

この回は「決めるだけ」なのに、いちばん時間がかかりました。 遠回りした過程を、消さずに書きます。

1. 題材を決めるのに、3週間かけた

「いいアイデアが降ってくるまで待とう」としていました。 降ってきません。

降ってこなかった理由は、アイデアを「面白いかどうか」で判定していたからです。面白さは、作る前には分かりません。分からない基準で判定しようとするので、いつまでも決まりません。

「自分が使うか / 1週間で形になるか / データが単純か」の3条件に変えたら、30分で決まりました。 判定できる基準に変えるのが先で、考える時間を増やすのは無意味でした。

2. 作らないものリストが、最初は5個しか出なかった

「作らないものを書いてください」と言われても、5個くらいで手が止まります。 思いついていないからです。

やり方を変えました。 一度、作りたいものを制限なしに全部書きます。 私は22個出ました。そのあと、7個だけ丸を付けて、残りを作らない側に移しました。

「捨てるものを考える」のは難しく、「全部書いてから残すものを選ぶ」のは簡単です。 同じ作業なのに、難易度がまったく違いました。

3. 「あとで足せる」を確認せずに削って、不安になった

削った直後は、「これ、本当に作品と呼べるのか」と不安になりました。機能が7個しかないからです。

14個を1つずつ「あとで足せるか」で確かめたら、不安が消えました。 どれも足せます。削ったのではなく、順番を後ろにしただけだと分かったからです。

逆に、「user_id を後から全表に足す」は足せないと気づいたのが、この確認の最大の収穫でした。 確認していなければ、1人用として作って、あとで作り直していました。

4. 完成の定義に「使いやすい」と書いてしまった

最初の版の完成の定義に、「一覧が見やすい」と書いていました。これは判定できません。 見やすさに上限が無いからです。

「はい / いいえ」で答えられるかで全行を見直したら、5行が書き直しになりました。 「見やすい」は「10件が新しい順に並んでいる」に変えました。

5. ER図を描きながら、テーブルを作り始めそうになった

図が描けた瞬間、CREATE TABLE を打ちたくなります。 打ちませんでした。

打たなかった理由は、まだ Knex のマイグレーションで作るか、手で CREATE TABLE するかを決めていなかったからです。手で打つと、マイグレーションの回でやった「履歴に残す」が最初から崩れます。次の回でマイグレーションから作ります。

6. 紙に書いたものを、写真に撮り忘れた

1週間後、紙が見つかりませんでした。

ADR にテキストで残していたので、助かりました。 紙は考えるための道具で、残すための道具ではありません。 考え終わったら、必ずファイルに移してコミットしてください。

まとめ

この回で理解できたことです。

  • 道具がそろっても手が止まるのは、実力不足ではありません。 何を作るか決めていないだけです。ここを取り違えると、対処が「もっと勉強する」になり、永遠に作り始められません
  • 題材の条件は3つだけです。 自分が使う / 1週間で形になる / データが単純。「人に見せて評価されるもの」を選ぶと、完成前に評価軸ができて止まります
  • 作らないものリストは、作るものリストより長くなるのが正常です。 短いのは、まだ候補を思いついていないだけで、思いついていないものは、作っている途中で必ず思いつきます
  • 「捨てるものを選ぶ」は難しく、「全部書いてから残すものを選ぶ」は簡単です。 同じ作業ですが、手の動き方がまったく違います
  • 削ってよいのは「機能」、削ってはいけないのは「前提」です。 タグも通知も後から足せますが、user_id・公開フラグ・IDの型・文字コードは、後から変えると全部に波及します
  • 画面は「作業単位」ではなく「掛け算の項」です。 1枚増えると、ルーティング・API・4種類の状態・権限・見た目・確認手順が、まとめて1セット増えます
  • 完成の定義は「はい / いいえ」で答えられる文で書きます。 「使いやすい」「きれい」は判定できないので、書いた瞬間に終われなくなります
  • 見た目は完成の条件に入れません。 完成のあとの作業です
  • 見積もりはしません。 個人開発に締切は無く、無い締切を自分で作って破ると、動いているコードが失敗作に見えます
  • かわりに順番を決めます。 層で切らず、機能で貫通させます。 1本目が通った時点で、貧弱でも動くアプリです。途中で止まっても、手元に動くものが残ります
  • 設計書を書き込むのは、コードを書かないための立派な言い訳です。 「これを書かないと明日の作業が始められないか」で線を引きます

この回の成果物は、紙3枚と、ファイル1つと、コミット1つです。 コードは0行です。

それでも、ここが作品づくりの本番でした。

作るものを決める作業は、選択肢を増やす作業ではありません。 選択肢を捨てて、明日の朝いちばんに打つ1行を、1つに絞り込む作業です。

明日打つ1行は、もう決まっています。 「本を1冊登録して、一覧に出す」の、いちばん手前です。

参考リンク


次に読む

この記事は 【第9段階】作品を1つ完成させる の 1 / 10 本目です。

記事
← 前の記事バックアップの復元試験 — 戻して件数と集計で照合する
→ 次の記事全部書いてから動かさない — 作品のAPIと認証

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

作品づくりは roadmap.sh の地図の外。何を学ぶかではなく、何を作るかの話。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次