Portfolio Genesis
ワンプロンプトでポートフォリオを生成。プロフェッショナルなGSAPアニメーション、レスポンシブデザイン、そしてAI生成とは思えない手作り感あふれる独自の美しさを備えた、完全でデプロイ可能なサイトを生成します。ユーザーが index.html をブラウザで開けば、プロ品質のポートフォリオが表示されます。
哲学
- すべてのポートフォリオはストーリーを語る。デザイン自体がポートフォリオの最初のプロジェクトである。
- アンチテンプレート:生成されるサイトはどれも同じ見た目にしてはならない。テーマはユーザーの分野、人格、トーンによって決定される。
- 「index.htmlを開いて「ワウ」と言わせる」— npmゼロ、ビルドステップゼロ、即座に満足感を得られる。
- 制約=自由:バニラHTML/CSS/JS + GSAPは、手作り感のあるクリエイティブなCSSを強制する。
- 3つしっかりと紹介されたプロジェクトがあるポートフォリオは、20の一般的なカードに勝る。質は量に勝る。
- スクロール体験こそがポートフォリオである。スクロールするすべてのピクセルが意図的に感じられるべきである。
プロセス
ステップ1:情報収集
ユーザープロンプトから以下を抽出する:
- アイデンティティ: 名前、ハンドル/エイリアス、役割/肩書き
- 自己紹介: 1〜3文(提供されていない場合は文脈から合成)
- プロジェクト: タイトル、説明、タグ、リンク、取引金額、役割
- ソーシャル: X、Discord、Telegram、GitHub、LinkedIn、メール、YouTube(提供されたもののみ含める)
- アバター: ファイルパス、またはイニシャルでCSSグラデーション円を生成
- 統計: 経験年数、プロジェクト数、コミュニティリーチ、探求したツール
- トーン: プロフェッショナル | ハッカー | クリエイティブ | エレガント | 遊び心 | ミニマル | サイバー
ユーザーからの入力が最小限の場合は、文脈に関連したプレースホルダーデータを生成し、インジェクションポイントにマークを付ける:<!-- CUSTOMIZE: Replace with your Twitter handle -->。URLが提供されていない場合はソーシャルボタンを完全に省略する — href="#" を決してレンダリングしない。
ステップ2:テーマ選択
以下の決定木を使用して、5つのテーマから選択する。その後、 references/themes/{theme-name}.md からテーマファイルを読み込む。
ユーザーはcrypto/web3/blockchainにいますか?
YES → "clean"/"minimal" に言及? → mono-minimal
それ以外 → midnight-glass(デフォルト)または neon-cyberpunk("neon"/"cyber" に言及)
ユーザーはデザイナー/アーティスト/クリエイティブですか?
YES → ダークを好む? → midnight-glass
それ以外 → warm-organic(デフォルト)または paper-brutalist("editorial"/"print" に言及)
ユーザーは開発者/エンジニアですか?
YES → midnight-glass(デフォルト)または mono-minimal("clean"/"minimal" に言及)
ユーザーは学生/初心者ですか?
YES → warm-organic(フレンドリー)または neon-cyberpunk(若い/エネルギッシュな場合)
ユーザーはビジネス/プロフェッショナルですか?
YES → mono-minimal(デフォルト)または warm-organic("approachable" に言及)
明示的なオーバーライド(最優先):
"dark" / "glass" → midnight-glass
"light" / "clean" / "paper" → paper-brutalist
"neon" / "cyber" / "futuristic" → neon-cyberpunk
"warm" / "earthy" / "organic" → warm-organic
"minimal" / "mono" / "typography" → mono-minimal
ステップ3:ファイル生成
参照ファイルを以下の順序で読み込む:
references/themes/{selected-theme}.md— 色、フォント、カードスタイルreferences/animations/gsap-patterns.md— アニメーションレシピreferences/sections/hero-variants.md— ヒーローレイアウトを選択references/typography/font-pairings.md— フォントの選択を確定
3つのファイル(index.html、css/style.css、js/main.js)を正確に生成する。
ヒーローレイアウト決定
アバター画像が提供されている?
YES → 中央寄せアバター(デフォルト)
例外:強いプロジェクト紹介があるデザイナー → スプリットヒーロー
NO → 強いタイトル/タグライン? → 全画面タイポグラフィ
それ以外 → ミニマル(名前+役割+スクロールインジケーター)
役割記述子の数:
1 → 単一の大きなサブタイトル
2-3 → ドット区切りのサブタイトル行
4+ → GSAPテキストスワップによるアニメーション役割ローテーション
プロジェクトセクション決定
プロジェクト数:
0 → プロジェクトをスキップ。代わりにスキル/テクノロジータグクラウドセクションを追加
1-2 → 大きなフィーチャーカード(全幅または余分なパディングを付けた2カラム)
3-4 → 均等サイズの2カラムグリッド
5-8 → ベントーグリッド(1つの大きなカード+小さなカード)
9+ → トップ6を表示し、「すべて表示」リンクを追加、または水平スクロール
ステップ4:品質チェック
ファイルを出力する前に、納品前チェックリストを実行する。
出力構成
index.html
完全なセマンティックHTML5。Google FontsとGSAP 3.12.5のCDNリンク。すべてのコンテンツはインライン。セクション:ナビ、ヒーロー、アバウト、プロジェクト(該当する場合)、オプションのマーキー/スキル、コンタクト、フッター。以下を含む:
<!DOCTYPE html>、<html lang="en">、charset、viewport- ユーザー名+役割を含む
<title> - 自己紹介を含む
<meta name="description"> - OGタグ:
og:title、og:description、og:type(website) - Google Fonts
<link rel="preconnect">+ スタイルシート defer付きGSAP + ScrollTrigger CDN<link rel="stylesheet" href="css/style.css">- bodyの最後に
<script src="js/main.js" defer>
css/style.css
すべてのスタイル。 :root でのCSSカスタムプロパティ(色、フォント、間隔、半径、イージングをカバーする最小20変数)。完全なレスポンシブ(768px + 480pxブレークポイント)。以下を含める必要がある:
- リセット:
*、*::before、*::after { margin:0; padding:0; box-sizing:border-box } html { scroll-behavior: smooth }+ カスタムスクロールバーbody { overflow-x: hidden; -webkit-font-smoothing: antialiased }- テーマアクセントカラーでの
::selection - ノイズオーバーレイ(インラインSVG feTurbulence、不透明度0.02-0.04)
.reveal-up { opacity: 0; transform: translateY(30px) }初期状態@media (prefers-reduced-motion: reduce)— すべてのアニメーションを無効にし、カーソルのグローを非表示にする- すべての装飾的なfixed/absolute要素に
pointer-events: none
js/main.js
DOMContentLoaded でラップされたGSAPアニメーション。GSAP利用可能性チェックから始まる:
if (typeof gsap === 'undefined') {
document.querySelectorAll('.reveal-up').forEach(el => {
el.style.opacity = '1';
el.style.transform = 'none';
});
return;
}
ScrollTriggerを登録。以下を含む:ヒーローエントランスタイムライン、スクロールリビール、統計カウンター、カードチルト、カーソルグロー、マグネティックボタン、パララックス、ナビ収縮。正確な実装については references/animations/gsap-patterns.md を参照。
パーソナライゼーションポイント
| 場所 | データソース | フォールバック |
|---|---|---|
<title> | 名前+役割 | "Portfolio" |
<meta description> | 役割+スキル | 役割から生成 |
| OGタグ | タイトル/説明と同じ | 同上 |
| ナビロゴ | 角括弧内のハンドル [MX] | イニシャル |
| ヒーローh1 | 役割またはアイデンティティステートメント | 分野+ "Builder" |
| ヒーローサブタイトル | · で区切られた役割 | 3つのスキル領域 |
| ヒーローバッジ | @ハンドル | "@username" |
アバター src + alt | ユーザーパス | イニシャル付きCSSグラデーション円 |
| ソーシャルボタン | 実際のURLのみ | URLがない場合はボタンを省略 |
| アバウト見出し | パーソナルステートメント | "Building at the intersection of X, Y & Z" |
| アバウト自己紹介 | ユーザー提供または合成 | 3文の自己紹介 |
| タグ | スキル領域 | 役割/プロジェクトから |
| 統計カード | 実際の数字+ラベル | 文脈からの推定 |
| プロジェクトカード | タイトル、説明、タグ、リンク | プロジェクト情報から |
| コンタクトカード | プラットフォーム、ハンドル、URL | 提供されたプラットフォームのみ |
| フッター | 名前+ new Date().getFullYear() | JSで動的年度 |
アンチパターン
| # | アンチパターン | なぜダメか | 代わりにこうする |
|---|---|---|---|
| 1 | 見出しフォントにInter/Roboto | すぐに「AI生成」とわかる。これらはボディフォントであり、ディスプレイフォントではない。 | Syne、Outfit、Instrument Serif、Bricolage Grotesque、Unboundedなどの特徴的なディスプレイフォントを使用する。 |
| 2 | 白地に紫のグラデーション | 2023年以来、#1の「AIスロップ」ビジュアルクリシェ。誰もが認識する。 | 暗い背景に鮮やかなアクセント、または暖色系パレットを使用する。 |
| 3 | デフォルトとしてのSpace Grotesk | 2023年は特徴的だったが、現在はAI生成サイトで最も使い古されたフォント。 | 12のキュレーションされたペアリングでローテーションする。ユーザーが明示的にブランドとして使用する場合のみ使用する。 |
| 4 | GSAPフォールバックなしの opacity:0 | GSAP CDNが失敗すると、サイト全体が表示されなくなる。空白ページ。 | 最初のJS行:typeof gsap をチェックし、未定義の場合はすべての .reveal-up を表示可能に設定する。 |
| 5 | 素晴らしいヒーローだが、下のほうは平凡 | スクロールすると「ワウ」が消える。映画的なヒーローの下に型にはまったカード。 | すべてのセクションに均等なデザインの注意を払う。スクロールジャーニーがポートフォリオである。 |
| 6 | ソーシャルリンクの href="#" | サイトが明らかに偽物であることがわかる。信頼性を損なう。 | 実際のURLを使用する。提供されていない場合は、ボタンを完全に省略する。 |
| 7 | どこでも同じアニメーションタイミング | すべてが同じ速度で同じイージングだと、ロボットのように感じられる。 | 持続時間(0.4秒〜1.2秒)を変える。要素ごとに異なるイージング。ネガティブオフセットでスタガー。 |
| 8 | pointer-events: none のない装飾要素 | オーブ、ノイズ、カーソルグローが下のコンテンツのマウスクリックをブロックする。 | すべての装飾的なfixed/absolute要素に pointer-events: none を設定する。 |
| 9 | グラデーション背景上のグラデーションテキスト | 読みにくい。2つの競合するグラデーションが打ち消し合う。 | グラデーションテキストは、無地/ほぼ無地の暗い背景の上のみに使用する。視覚領域ごとに1つのグラデーション。 |
| 10 | カードの cursor: pointer の欠如 | カードはインタラクティブに見えるが、カーソルはデフォルトのまま。ユーザーは混乱する。 | ホバー状態またはクリックハンドラーを持つすべての要素に cursor: pointer を設定する。 |
| 11 | UI内の絵文字アイコン | 普遍的な「AIが作った」シグナル。デザインの努力なし。 | assets/social-icons.svg からのインラインSVG。ナビ、ボタン、ヘッダーに絵文字なし。 |
| 12 | width: 100vw | Windowsでスクロールバーがある場合、スクロールバーの幅を含むため、水平オーバーフローが発生する。 | width: 100% または body に overflow-x: hidden を使用する。 |
| 13 | 5つのアイコンのためにアイコンライブラリを読み込む | 余分なHTTPリクエスト、FOUC、約2KBのSVGパスのためのCDN依存。 | HTMLに直接インラインSVGを埋め込む。5〜8つのソーシャルアイコン=約2KBのインライン。 |
| 14 | 一般的なCTAテキスト | 「Let's Connect」/「Get In Touch」— すべてのAIポートフォリオがこれらを使用する。 | 人格に合わせる:「Let's Build Something」(ビルダー)、「Say gm」(暗号通貨)、「Drop a Line」(カジュアル)。 |
| 15 | アバターの alt の欠如 | アクセシビリティに失敗。スクリーンリーダーは何もアナウンスしない。 | alt="[ユーザー名]" — シンプルで説明的。 |
| 16 | 4色以上の虹色グラデーションテキスト | おもちゃのように見える。多色グラデーションはめったにうまく機能しない。 | 同じファミリーから最大2〜3色(ピンク→紫、ピンク→緑→青ではない)。 |
必須アニメーション
実装については references/animations/gsap-patterns.md を参照。すべてのサイトに以下を含める必要がある:
- ヒーローエントランスタイムライン — スタガード
.from():アバター(back.out)、バッジ、タイトル行、サブタイトル、ソーシャル(back.outスタガー)、スクロールインジケーター。ネガティブオフセットで重複。 - スクロールリビール —
.reveal-up要素が{y:30, opacity:0}からstart: "top 85%"でアニメーション。ビューポートグループ内でスタガー。 - 統計カウンター —
onUpdateを介して0から目標までアニメーション。スクロールでトリガー。 - カードチルト — mousemove → カーソルオフセットからの
rotateX/rotateY。transformPerspective: 1000。mouseleaveでリセット。 - カーソルグロー — 600pxのラジアルグラデーションがマウスを追跡。
requestAnimationFrame+ 0.08 lerp。 - マグネティックボタン — ソーシャルボタンがカーソルに向かって移動(0.3倍係数)。
elastic.out(1, 0.5)でスナップバック。 - パララックス背景 — 装飾要素がスクロールで
scrub: 1で移動。 - ナビ収縮 — 80pxスクロール深度で
.scrolledクラスをトグル。
オプション(テーマ/コンテンツに基づいて追加):
- スクロール速度ブースト付きマーキー
- 文字単位のテキスト分割リビール(サイバーパンク/ドラマチック)
- 5つ以上のプロジェクトの水平スクロール
- ホバー時のグラデーションテキストシャイマー
- 左からのセクションラベルスライドイン
品質チェックリスト
構造:
- 3つのファイルすべて生成(index.html、css/style.css、js/main.js)
- DOCTYPE、charset、viewport、lang属性が存在する
- ユーザーの実際の情報を含むOGメタタグ
-
:root内のすべてのCSSカスタムプロパティ -
defer付きGSAP CDNリンク - bodyの最後に
deferでJSがリンクされている
コンテンツ:
- すべてのユーザーデータが注入されている(名前、リンク、プロジェクト、自己紹介)
- 一般的なプレースホルダーがない("Lorem ipsum"、"Your Name Here")
- ソーシャルリンクは実際のURLを使用し、提供されたリンクに
href="#"がない - フッターに正しい名前と動的年度がある
ビジュアル:
- フォントペアリングがInter、Roboto、Arial、またはSpace Groteskではない(ユーザー指定の場合を除く)
- 紫地に白の配色パターンがない
- UIに絵文字アイコンがない
- 色のコントラストがWCAG AA(ボディテキストで4.5:1)を満たしている
- 375px、768px、1440pxでレスポンシブ — 水平スクロールなし
-
prefers-reduced-motionでアニメーションを無効にし、カーソルグローを非表示にする
技術:
- GSAPフォールバックが存在する(typeofチェック+不透明度リセット)
- すべての装飾要素に
pointer-events: noneがある - CSSに
width: 100vwがない - すべてのインタラクティブ要素に
cursor: pointerがある - 画像に
alt属性がある - 外部リンクに
target="_blank" rel="noopener"がある