手が止まるのは実力の問題ではなく、決めていないからです。作らないものリストを先に書いて、題材を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つで十分
この記事でやること
- 題材を3条件に照らして選ぶ。この連載で作る
hitokotoを決める - 作らないものリストを、作るものリストより長く紙に書く。1つずつ「なぜ今はやらないか」を1行添える
- 画面を数える。3枚に収まっていることを確認する
- データを3つの箱に分け、ER図を紙で描く(
users/books/quotes) - 完成の定義を、チェックできる文章で書く
docs/adr/0001-what-to-build.mdに全部残して、コミットする
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| 要件 | そのアプリが何をできる必要があるかを、文章にしたもの。「ログインできる」「本を登録できる」の粒度 |
| スコープ | どこまでを作る範囲に入れるかの線。線の外側を書くことが、この記事の主題 |
| スコープクリープ | 作っている途中で、範囲がじわじわ広がっていくこと。個人開発が完成しない最大の原因 |
| MVP | Minimum Viable Product。「使える最小のもの」。「機能が少ない版」ではなく「1本の用途が通る最小版」 |
| YAGNI | You Aren’t Gonna Need It(それ、どうせ要らない)。要りそうだからという理由で先に作らないという考え方 |
| 完成の定義 | 何ができたら「できた」と言うかを、先に決めた文章。チームでは Definition of Done と呼ばれる |
| ADR | Architecture 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 + Express | APIの回 |
| データ | MySQL + Knex | MySQLの回 / マイグレーションの回 |
| ログイン | セッション認証 | 認証の回 / ハッシュの回 |
| 画面 | React + Vite | Reactの回 / ビルドの回 |
| 公開 | 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の中で、リポジトリを作ります。
中身の全文です。 私が実際に書いたものを、そのまま載せます。
# 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件を超えたら測って判断する。
書けたら、コミットします。
[スクリーンショット: 04_adrをコミットした画面.png] git log --oneline の結果と、docs/adr/0001-what-to-build.md が入っている状態を撮ってください。
今日の成果物は、これだけです。 コードは0行です。それでいいのです。
このファイルがあると、3週間後に迷ったとき、判断をやり直さずに済みます。 無いと、毎回ゼロから考え直して、毎回少しずつ機能が増えます。
戻し方(この回で作ったものを全部消したいとき):
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冊登録して、一覧に出す」の、いちばん手前です。
参考リンク
- roadmap.sh — Full Stack Developer
- Yagni(Martin Fowler)
- Architecture Decision Records
- ADR のテンプレート集(joelparkerhenderson)
- Scrum.org — Definition of Done
- Shape Up(Basecamp・全文公開)
- MoSCoW method(Wikipedia)
- The Twelve-Factor App(日本語)
- Knex.js 公式ドキュメント
次に読む
この記事は 【第9段階】作品を1つ完成させる の 1 / 10 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | バックアップの復元試験 — 戻して件数と集計で照合する |
| → 次の記事 | 全部書いてから動かさない — 作品のAPIと認証 |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
作品づくりは roadmap.sh の地図の外。何を学ぶかではなく、何を作るかの話。

コメント