どんなサイトにするか決める|だれに・何を・どのページを、作る前にメモにする
このレッスンの要点
- 作り始める前に「だれに・何を・どこまで」を決めます。ここがぶれると、Claude Code の作るものもぶれます
- ページの一覧と URL を表にします。Google も、URL には中身がわかる言葉を使うようすすめています
- 載せないもの(名前・連絡先・秘密の値)も先に決めて、メモと CLAUDE.md に書いておきます
先に決める3つ:だれに・何を・どこまで
Claude Code は、頼んだとおりに手早く作ってくれます。だからこそ、「だれに向けて」「何を届けるか」が決まっていないと、どこかで見たようなサイトができてしまいます。作り始める前に、次の3つだけ決めておきます。
| 決めること | 例(猫のサイト) |
|---|---|
| だれに | はじめて猫をむかえる人 |
| 何を | 子猫のごはん・トイレ・病院の基本 |
| どこまで | 最初は記事10本と、このサイトについてのページだけ |
ページの一覧と URL を決める
次に、作るページを書き出して、それぞれの URL を決めます。Google は、URL には中身がわかる言葉を使うようすすめています。URL の一部が、検索結果に表示されることもあるからです。
| ページ | URL | 中身 |
|---|---|---|
| トップ | / | サイトの紹介と、新しい記事 |
| 記事の一覧 | /articles/ | 全部の記事 |
| 記事 | /articles/kitten-food/ | 1本ずつの記事 |
| このサイトについて | /about/ | だれに向けた、何のサイトか |
ページごとの題名と説明も、ここで考えておくと楽です。Google は、題名はページごとにちがっていて中身を正しく短く表すもの、説明はそのページだけの要点を短くまとめたもの、をすすめています。
載せないものも決めておく
サイトに何を載せないかも、先に決めておきます。書いておかなければ、Claude Code にも伝わりません。
載せるもの
サイトの名前・何のサイトか・記事
載せないもの
自分の名前・メールアドレス・API キーなどの秘密の値
サイトのファイルは GitHub のリポジトリに置きます。リポジトリを「公開」にすると、中のファイルはインターネットのだれでも見られます。秘密の値は、ページに出さないだけでなく、リポジトリにも入れません。
決めたことを Claude Code に渡す
決めたことは、docs/設計.md のような1つのメモにまとめてもらいます。作るときは毎回「このメモを読んでから」と頼めば、話がぶれません。いつも守ってほしいこと(載せないもの・言葉づかい)は Claude Code が作業を始めるときに読む、申し送りメモのファイル。
くわしく見る にも書いておきます(コース2のレッスン4でくわしく)。
docs/設計.md を読んで。まだコードは書かないで、作る順番の計画を見せて
メモを読みました。1. ひな形を作る 2. 共通の部品 3. トップ 4. 記事の一覧と記事…の順で進めます。
確認させてください。最初の公開では、記事は10本そろえてから出しますか?
くわしく見るの1つ。コース2のレッスン6)を使うのも手です。
よくある勘違い
「とりあえず作ってもらって、あとから考えればいい」わけではありません
「いい感じのサイトを作って」とだけ頼む
だれ向けかがわからないので、どこかで見たようなページができ、直しが何度も続きます
決めたことをメモにして、読んでもらってから作る
同じメモを毎回読んでもらえるので、途中で頼み直しても方向がぶれません
やってみよう
- サイト用の新しいフォルダを作り、そこで
claudeを起動します(レッスン3も、このフォルダで続けます) - レッスン1の練習で書いた「だれに」「何を届けるか」を、下の表の形に書き足します
- 作りたいページを書き出して、ページの名前と URL(英語の短い言葉)の表にします
- 載せないもの(自分の名前・メールアドレス・秘密の値など)を書き出します
- 下の依頼文を Claude Code に送って、メモを
docs/設計.mdにまとめてもらいます
決めたことをメモにしてもらう依頼文(Claude Code に)これから Astro で Webサイトを作ります。まだコードは書かないで。
下に書いたことを、docs/設計.md という1つのメモにまとめて。わからないところや、決まっていないところは、質問してから書いて。
- だれに:(例)はじめて猫をむかえる人
- 何を:(例)子猫のごはん・トイレ・病院の基本
- どこまで:(例)最初は記事10本と、このサイトについてのページだけ
- ページ:トップ、記事の一覧、記事、このサイトについて
- 載せないもの:自分の名前、メールアドレス、秘密の値
確認問題
Q1. ページの URL を決めるとき、Google のすすめる考え方に近いのは?
Q2. リポジトリを「公開(Public)」にすると、中のファイルはだれが見られる?
今日の練習
作りたいサイトのページを5つまで書き出して、それぞれに英語の短い URL を付けてみましょう。
この記事の用語
コース4 Webサイト編の目次
- 1Webサイトができるまでの全体図✓ できた
- 2どんなサイトにするか決める✓ できた
- 3Claude Code でサイトを作る✓ できた
- 4サーバーとドメインを選ぶ✓ できた
- 5公開する✓ できた
- 6検索に出るようにする✓ できた