個人サイトビルダー
「1枚の履歴書 + 多数のリンク + 散らばった成果物」を、情報構造があり、視覚スタイルがあり、そのままデプロイ可能な静的サイトに変換します。
成果物:純粋な静的HTML/CSS/JS(ビルド不要、フレームワーク不要、単一ファイルCSS)。Cloudflare Pages / Vercel / GitHub Pagesに直接デプロイ可能。
コア原則
- 順序を逆転させない:コンテンツ → 構造 → ビジュアル → 最後にコード。最初からテンプレートを当てたり、色やフォントを質問しない。
- 4つの情報タイプを区別する:ユーザー確認済みの事実 / ソース原文の要約 / AIが起草したコピー / 未確認の推論。経歴、数字、顧客、評価、身分、協力関係を捏造しない。
- プライバシーをデフォルトで保護する:公開電話番号、住所、プライベートメール、顧客資料の公開は個別に確認が必要。
- テンプレートを埋めるために空のセクションを作らない:資料が足りなければ内容の深さを下げるか、欠落項目をリストアップする。プレースホルダーの事例で埋めない。
- 推奨付きの選択肢を提示する:各決定ポイントで実質的に異なる2~3の案と明確な推奨を提示し、選択をすべてユーザーに任せない。
- デプロイは対外向け公開アクション:ユーザーの明確な許可を得た場合のみ実行する。
ワークフロー
① 境界設定 → ② 資料収集 → ③ 情報階層決定 → ④ 視覚スタイル決定 → ⑤ 生成 → ⑥ 検収 → ⑦ 許可後デプロイ
① 境界設定
最初に新規作成か既存サイトの改造かを判断する。
- プロジェクトがある場合:まずディレクトリ構造、既存ページ、コンテンツソース、ビルドコマンド、デプロイ設定、git状態を読み、既存の技術スタックとデザイン制約を継承する。新しいものを作り直さない。
- 新規作成の場合:デフォルトで軽量レスポンシブ静的サイト。CMS、ログイン、動的データが本当に必要な場合のみ、フレームワークやバックエンドを導入する。
その後、方向性を決める質問を1つだけする:
「このサイトは主に誰に見せるのか? 見た後に何をしてほしいのか?」
この段階では色、フォント、アニメーションについて質問しない。
② 資料収集
references/intake.md(最小限の開始資料、段階的な質問順序、コンテンツエンティティのフィールド、証拠のグレード、プライバシールール、取得可能なソース一覧を含む)を読む。
ポイント:
- 最初の返信は軽くする。ユーザーが既に何を持っているか言っているので、最初の返信ではそれを送ってもらうだけにする。最初のバッチを読んだ後に次の質問をする。毎回、次のステップに最も影響を与える質問を1つだけ行い、十数ものフォームを一度に送信しない。
- 読めるものは先に読む、質問しない。履歴書(Read / docx / pdf skill)、GitHub、ブログ、微信公衆号(WeChat Official Account)の記事(WebFetch)、ログインが必要なプラットフォーム(claude-in-chrome)。ログイン壁、CAPTCHA、スクレイピング対策に遭遇したらすぐに停止し、代わりにエクスポートファイル、テキスト、リンクリスト、スクリーンショットをユーザーに提供してもらう。
- 数字は形容詞より優先され、検証可能な表現のみを使用する。「10製品、5万ユーザー、200近いSkill」は「経験豊富」より優れている。検証できないものは推定値を補わない。
- クロスプラットフォームの重複コンテンツは1つのコンテンツエンティティに統合し、複数のソースリンクを保持する。情報が矛盾する場合は、ユーザーが確認できるように両方のバージョンを保持する。
収集後、資料一覧確認(既存 / 未確認 / 欠落 / 推奨補足)を出力し、ユーザーが確認した後に次のステップに進む。
③ 情報階層決定
references/architectures.mdを読む。二軸で決定する:
軸1:サイト目標(主要目標1つを選択。最大で副次目標1つ追加可能)
| ユーザー資料の主な内容 | 主要目標 |
|---|---|
| 職務経歴、スキル、学歴、転職希望 | 求職コンバージョン |
| プロジェクト / デザイン / 写真 / 動画、ビジュアル素材が多い | ポートフォリオ展示 |
| 人生のストーリー + 興味 + 価値観、完成品が少ない | 自己紹介 |
| 長期間書いてきた記事 / 読んだ本 / 歩んできた道、アーカイブしたい | 長期記録 |
| コンサルティング、執筆依頼、指導、仕事の依頼を受けたい | コンサルティング顧客獲得 |
| 微信公衆号 / X / 小紅書 / ポッドキャスト、フォロワーとコンテンツアセットがある | クリエイターページ |
| 製品やオープンソースプロジェクトをリリースしたことがあり、それを使ってほしい/買ってほしい | インディーデベロッパー |
軸2:コンテンツの深さ(資料の量で決まり、願望では決まらない)
L1 名刺レベル— 単一ページ。身分 / ポジショニング / メインアクション / 3つの代表リンクのみ。資料が少ない、または迅速な立ち上げが必要。L2 証明レベル— トップページ + プロジェクト/経験の詳細ページ。個人の貢献、プロセス、結果、メディア素材が必要。L3 コンテンツシステムレベル— トップページ + 詳細 + カテゴリインデックス + アーカイブ + 継続的更新メカニズム。安定したコンテンツソースと更新意欲が必要。
資料がL2をサポートできない場合は、まずL1にする。継続的な更新能力がなければL3を選択しない。
architectures.mdのテンプレートに従って、実質的に異なる2〜3の案(違いは訪問者のタスクに基づく必要があり、単なるセクション名の変更ではならない)を出力する。各案には以下を明記:誰に適しているか / ファーストビューの約束 / メインアクション / ナビゲーション / トップページの順序 / 使用する既存素材 / 他に補う必要があるもの / 主なトレードオフ。明確に1つを推奨し、ユーザーが確認した後にビジュアルに進む。
④ 視覚スタイル決定
まず質問:「好きなウェブサイトやデザインはありますか? あればリンクやスクリーンショットを送ってください。」 ユーザーが形容詞から選ぶよりも、参考例がある方がはるかに正確。
3つのパス、ユーザーが持っているものに応じて選択:
- ユーザーが参考URL / スクリーンショット / デザイン仕様を提供した場合 →
references/style-extraction.mdを読む。まずclaude-in-chromeで参考サイトを開き、その中のスクリプトを実行して実際のcomputed style(フォントスタック、色値、角丸、シャドウ、コンテナ幅)をサンプリングする。明るいテーマと暗いテーマの両方をサンプリングする。開けない場合やログインが必要な場合は、スクリーンショット分析に切り替える。雰囲気を抽出し、サイト全体をクローンしない。ロゴ、コピー、イラスト、独自のレイアウトを取らない。 - ユーザーがブランド名を指定した場合(「Notionのような感じ」「Apple風」)→ brand-design-md skillを呼び出してDESIGN.mdを取得し、
site.cssの:root変数にマッピングする。 - ユーザーに参考例がない場合 →
references/visual-styles.mdを読み、6つの内蔵スタイルから2〜3の方向性と推奨理由を提示する。それぞれに直接貼り付け可能なCSS変数値を含める。
ユーザーが複数の参考サイトを提供した場合、まず「どのサイトの雰囲気が一番欲しいですか? 他のサイトで具体的に好きな点はどこですか?」と質問する。多くの人はAのレイアウト + Bの配色が好きだが、直接交差させると4不肖(何にも似ていない)になる。
ユーザーがWordPress / Framer / Webflow / Notionに言及した場合、その情報整理と雰囲気を参考にするだけで、対応するプラットフォームのテーマやプロジェクトを生成したふりをしない。
どのパスを選んでも、最後は:root変数のみを変更し、site.cssのコンポーネント部分を書き換えない。選択後にコードを書く。
⑤ サイト生成
最初にassets/starter/をコピー:
site.css— CSS変数 + タイポグラフィベースライン + カード/リストコンポーネント、明るい/暗いデュアルテーマ。スタイル変更 =:root変数の変更。ファイル全体を書き換えない。nav.js— 単一ファイルで注入される固定トップバー(ダークモード切り替え + スクロールによる非表示)。上部設定領域でSITE_NAME/LINKS/THEME_KEYを変更。そのインラインCSS内の760pxは、site.cssの--maxと一致させる必要がある。index.html— トップページのスケルトン。セクションは案に応じて追加/削除。
以下の条件を満たす必要がある:
- ファーストビューに本人の名前または一般的な呼称 + ポジショニング + 1つのメインアクションが表示される。メインアクションは1つだけ、サブアクションは最大1つ。
- ナビゲーションは確認済みの情報アーキテクチャを反映し、プラットフォームテンプレートのセクションをそのままコピーしない。項目数は4〜6。
- 作品は問題 / 自分の役割 / やり方 / 結果を優先的に説明し、サムネイルだけを載せない。
- ソーシャルリンクはそのプラットフォームで何が見られるかを説明し、単なるアイコンの羅列にしない。
- 各ページは独立した
xxx/index.htmlで、/site.cssと/nav.jsを共有。CDN、フレームワーク、ビルド手順を導入しない。 <title>、<meta name="description">、favicon、共有画像が完全。外部リンクはtarget="_blank" rel="noreferrer"。- デスクトップ + モバイルでスムーズに閲覧可能。キーボードで主要フローを完了可能。セマンティック構造とaltが完全。
prefers-reduced-motionをサポート。 - 画像は実際の作品/人物/スクリーンショットを使用。画像がない場合はまず素材を要求。生成された画像は生成素材であることを明記する必要がある。
- 「これは私の個人サイトです」「以下は私の作品です」などのプロンプトをデザインとして使用しない。
中国語タイポグラフィ:行高 ≥ 1.7、段落間隔 ≥ 18px、フォントスタックにPingFang SCを残す。より強力なフロントエンドデザイン能力が必要な場合は、frontend-design skillを呼び出す。
⑥ 検収
references/delivery-checklist.mdを読み、項目ごとに確認する。少なくとも以下を検証:
- トップページ、ナビゲーション、詳細ページ、外部リンク、メインアクション
- 360 / 390 / 768 / 1280 / 1440 の5つの幅
- 最長の名前とタイトルがオーバーフローしない。空のコンテンツ、画像読み込み失敗、外部リンク切れの表示
- コンソールに使用に影響するエラーがない。予期しない横スクロールとレイアウト重複がない
- 明るい/暗い両方のテーマで読み取り可能(コントラスト ≥ 4.5:1)
- サイト内に残っているTODOプレースホルダー、架空の数字、テストリンクがない
- 公開情報がユーザー確認済みのリストと一致している
python3 -m http.serverでローカルプレビューを起動するか、claude-in-chromeでスクリーンショットを撮り、ユーザーが公開前に確認できるようにする。
⑦ 許可後デプロイ
まずどこに公開するか、公開するかどうか、どのリポジトリ/アカウントを使用するか、どのドメインや環境変数を変更するかを説明し、明確な許可を得てから実行する。
- 既存プロジェクトは既存のデプロイ方法を継承。新しい静的サイトは優先的にCloudflare Pages / Vercel / GitHub Pages(ビルドコマンドは空白、出力ディレクトリはサイトルート)。
- まずビルド → 次に公開 → その後本番URLにアクセスして主要コンテンツを検証。プレビュー成功 ≠ カスタムドメインの反映。
- キー、履歴書の原本、プラットフォームのエクスポートデータをサイトにパッケージ化しない。
最終納品説明
簡潔にリストアップ:選択した目標とコンテンツの深さ / 実装したページと主要コンテンツ / アクセスURL / 検証結果 / まだ公開していない、または補足が必要なコンテンツ。長い説明で未完了のコード、検収、デプロイを隠さない。
禁止リスト
- ❌ トップページにすべてのコンテンツを詰め込む — ファーストビューの3秒で「あなたは誰 + 何ができるか + どうやって連絡するか」を明確にし、残りはすべてダウングレード
- ❌ 「技術に情熱を持ち、卓越性を追求する」のような空文句 — 検証可能な事実と数字に置き換える
- ❌ ユーザーが提供していないのに、経歴、プロジェクト、数字、顧客評価を代わりに作る
- ❌ 一度に十数もの質問をする。または、資料確認と案確認をスキップして直接コードを書く
- ❌ 資料が足りないのに無理にL3に上げ、空のブログやプレースホルダーの事例で体裁を整える
- ❌ 複雑なアニメーション、グラデーションの積み重ね、セクションごとに異なるフォント — 個人サイトの信頼性は抑制から生まれる
- ❌ 参考サイト全体をダウンロードして名前を変更する — 抽出するのは配色/タイポグラフィ/スペーシングの雰囲気であり、ロゴ、コピー、イラスト、独自のレイアウトではない
- ❌ 許可なくpush / デプロイ / 連絡先を公開する