Portfolio Builder
ハッカソンプロジェクトのための、リクルーター向けの一ページポートフォリオサイトを構築します。このサイトは、プロジェクト自体がWebアプリでない場合(ハードウェア、MLモデル、CLI、研究プロジェクトなど)でも、その成果を動画、図、写真、インタラクティブなレプリカを通じて示すことができる成果物です。目標は、dispatchai.art3m1s.me、talktuah.art3m1s.me、slugloop.com、adapted.art3m1s.meといったケーススタディサイトの水準を目指すことです。それぞれのサイトは他とはまったく異なる外観を持ちます。そのユニークさこそが重要であり、そのためにこのスキルは固定テンプレートではなく、フロントエンドデザインスキルに依存します。
ステップ1: デザインエンジンを利用可能にする
デザインはAnthropicのfrontend-designスキルから得られ、これにより結果が一般的なAI生成ページのように見えるのを防ぎます。デザインの前に、このスキルが利用可能である必要があります。
これはユーザーの事前条件であり、エージェントが自分で行えるものではありません(エージェントはスラッシュコマンドを実行できないため)。frontend-designが既に利用可能なスキルとして表示されていれば準備完了です。そうでない場合は、ユーザーにClaude Codeで以下の2つのコマンドを実行してプラグインをインストールするよう依頼してください。
/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official
最初の行は、そのマーケットプレイスがまだ追加されていない場合にのみ必要です。Claudeはフロントエンド作業にfrontend-designを自動的に適用するため、その原則が既に適用されている可能性もありますが、プラグインが存在することを前提とせず、ユーザーに確認を依頼してください。ステップ3のすべてのデザイン決定は、このスキルを通じて実行されます。
ステップ2: 事実を収集する
まず検出し、次に質問します。AGENTS.md、PRD.md、README、package.json、およびリポジトリ内の写真、スクリーンショット、図を読み取ります。その後、不足しているものだけを質問します。
- プロジェクト名と、テクノロジーではなくプロジェクトの重要性を示すタグライン。
- プロジェクトタイプ: Webアプリ、ハードウェアまたはIoT、MLモデル、CLIまたは開発ツール、モバイルアプリ、研究またはデータ。これにより、ステップ4での表示方法が決まります。
- 問題: 1つの実際の統計とその出典。
- 機能: 3~5のコア機能。
- 仕組み: アーキテクチャ図を描くのに十分なシステムの説明。
- 証拠: デモ動画(YouTube)、公開URL、Devpost、GitHub、プレス報道、およびオープンソースの成果物(モデル、データセット、Figma)。
- イベントメディア: リポジトリにはほとんど含まれていない、ハッカソン当日の写真やクリップ。チームや制作過程の写真、デモデイやステージ、受賞の写真、ホワイトボードやナプキンのスケッチ、会場の写真を明示的に依頼し、それらがどこにあるか(スマートフォン、共有ドライブ、Devpostギャラリー)も確認します。これらはサイトにリアリティを与えるため、リポジトリにあると仮定せずに依頼してください。存在しない場合は、スクリーンショット、図、デモ動画で代替します。
- 結果: 受賞歴と順位、イベント名と日付、規模と順位、開発時間、チーム規模、およびメトリクス(コミット数、レイテンシ、ユーザー数)。
- チーム: 名前、役割、GitHubハンドル、LinkedIn URL、ヘッドショット。
賞、統計、賞金、順位、引用を決して捏造しないでください。質問しても事実が不明な場合は、推測せずにそのセクションを省略してください。
ステップ3: フロントエンドデザインを通じてデザインする
ステップ2から構築したブリーフをfrontend-designに渡し、その完全なループ(ブレインストーミング、探索、計画、批判、構築、再批判)を実行します。その中核ルールがここでも適用されます。デフォルトではなく、対象から外観を導き出します。このプロジェクトに特化した、コンパクトなトークンシステムを生成します。
- パレット: プロジェクトの世界から引き出された、4~6の名前付き16進数値。911ディスパッチャーは、危険を示す赤と琥珀色をほぼ黒の背景に使用します。音声バンクは信頼の青。UCSCの自転車メッシュ構築は、使い古された「フィールドログ」アーカイブパレット。
- タイポグラフィ: 特徴的なディスプレイ書体(控えめに使用)、補完的な本文書体、データ用のユーティリティまたはモノスペース書体。プロジェクトごとに同じファミリーを使用するのではなく、意図的にペアリングします。
- レイアウト: ステップ5の骨格に従った、スクロールストーリーテリングのワンページ。
- モーション: 対象に貢献する1つのオーケストレーションされたモーションモーメント。例えば、スクロールトリガーのアーキテクチャ表示やテレメトリリプレイ。散在するエフェクトはAI生成と見なされるため、モーションは1箇所に集中させます。これはステップ6の動きを減らしたアクセシビリティとは別です。
- シグネチャー: このサイトが記憶される単一の要素であり、このプロジェクトを体現するもの。Dispatchには、シードデータで動作する埋め込みインタラクティブオペレーターコンソールがあります。Slugloopには「受信機はもうピンとは鳴らない」というアーカイブフレームがあります。AdaptEdには番号付き学習ループがあります。
フロントエンドデザインから引き継がれた2つのガード。
- デフォルトのAIルックを避ける プロジェクトの世界が本当にそれを必要とする場合を除く:(1) クリーム色の背景、高コントラストのセリフ体、テラコッタのアクセント、(2) ほぼ黒の背景に単一のライムグリーンまたは朱色のアクセント、(3) ブロードシートのヘアラインルール、border-radiusゼロ、高密度カラム。もしパレットとタイプ計画がこれらに該当する場合は、修正し、その理由を説明してください。
- 構造は情報です。番号付きマーカー、アイブロウ、仕切りは、実際のシーケンス(AdaptEdのループなど)をエンコードする場合にのみ使用し、決して装飾として使用しないでください。ステップ5の骨格の番号は、作成チェックリストであり、必須の視覚的処理ではありません。
セクションラベルもデザインサーフェスです。骨格は基礎となる構造です。その見出しをプロジェクトのボイスに変更します(「Showcase」の代わりに「Field log」、「Honest limits」の代わりにゲーム内のライン、対象に合う場合は番号01から0N)。構築前に計画を立ててから批判するゲートを実行します。選択肢が他の類似プロジェクトでも同じように見える場合は、修正します。このブリーフに本当に特化した計画になってから構築を開始します。
ステップ4: 作業の表示方法を選択する
プロジェクトの種類に関係なく、サイトはプロジェクトを紹介します。普遍的なベースは、デモ動画とプロジェクトの主要な成果物(映像、写真、テレメトリリプレイ、評価図、ターミナルリプレイ)です。次に、プロジェクトタイプごとにメインの表示デバイスを選択します。
- Webアプリ: シードデータで動作する埋め込みインタラクティブウィジェットまたはコンソール(Dispatchのオペレーターコンソール)。インタラクティブ性が不可能な場合のみ、読み取り専用ビューをフォールバックとして使用します。
- ハードウェアまたはIoT: 制作写真、配線またはシステム図、現場映像、およびマップまたはテレメトリリプレイ(Slugloop)。
- MLモデル: インタラクティブ推論ウィジェットまたは比較ビフォーアフター、評価数値、Hugging Faceリンク。
- CLIまたは開発ツール: ターミナルリプレイ(asciinemaスタイル)またはアニメーションコマンドシーケンス。
- モバイル: デバイスフレームの動画またはクリッカブル画面フロー。
- 研究またはデータ: 主要な図、チャート、方法論図。
デモは複数可能です。役立つ場合は2つのデモモード(パッシブウォークスルーとインタラクティブモード、TalkTuahのように)を提供するか、初期プロトタイプクリップと最終現場クリップをペアにして反復を示します(Slugloop)。実際のバックエンドが静的サイトで実行できない場合にのみ、レプリカをモックします。その場合、現実的なデータでシードし、レプリカであることを明確にラベル付けします。実際の現場映像に基づくハードウェアサイトにはモックやそのようなラベルは必要ありません。
プロジェクトが実際のプレス報道を受けた場合は、それを信頼性デバイスとして扱います。クリッピングをカードまたはアウトレットロゴとして、引用と出典付きでレンダリングします(Slugloop)。裸のリンクとしてではなく。
ステップ5: ケーススタディの骨格
シングルページスクロール、リクルーター第一。メニューとして扱います。事実が存在する場合のみセクションを含め、その見出しをプロジェクトのボイスに変更します(ステップ3参照)。ここでの番号は作成チェックリストであり、必須の視覚スタイルではありません。
- ヒーロー(テーゼ): プロジェクトの最も特徴的な点、タグライン、主要なCTA(デモ、Devpost、GitHub)で開きます。主要な受賞歴や資格情報を表示します。
- 信頼性ストリップ: 順位、賞金、順位、フィールドサイズ。
- 問題: 重要性と出典付きの1つの統計。
- 機能: コア機能。機能カードは、アーキテクチャセクションの該当部分にディープリンクまたはスクロールアンカーし、「何を」と「どのように」を結び付けます(TalkTuah)。
- 仕組み: アーキテクチャまたはシステム図。エンジニアリングの深さを示します。
- ショーケース: ステップ4で選択されたデバイス(インタラクティブウィジェット、動画、写真、テレメトリリプレイ)。該当する場合は、デュアルまたは反復動画ブロックを許可します。
- 数字で見る: 大きな数字と短いラベルの太字の統計グリッド。チーム規模、開発時間、コミット数、順位を1つのシグネチャーブロックに統合できます(Slugloop: 4人の学生、36時間、500以上のコミット、トップ10)。順位は信頼性ストリップにも表示される場合があります。
- プレス(オプション): 実際の報道をクリッピングカードまたはアウトレットロゴとして、引用と出典付きで。
- チームまたはクルー: 役割、GitHub、LinkedIn付きの経歴。
- 正直な限界: 週末ビルドが何であり、何でないか。トレードオフを明示することは、弱さではなく成熟度として読まれます。
- リンクと出典: GitHub、Devpost、YouTube、モデルまたはデータセット、プレス。
- フッター: イベントでN時間で構築、リポジトリとライブリンク付き。
ステップ6: 構築する
- 静的にエクスポート可能でVercel対応のスタンドアロンシングルページサイトを構築し、デフォルトでNext.js(App Router)を使用します。プロジェクトの既存スタックがある場合はそれに合わせます。独自のフォルダ(
site/またはportfolio/)または別のリポジトリに配置し、プロダクトコードと絡まないようにします。 - コンテンツはすべて実際のものを使い、Lorem Ipsumは使用しません。フロントエンドデザインのライティングガイダンスに従います。平易で具体的、読者の画面側から書きます。
- 品質フロアを宣言せずに保持します。モバイル対応のレスポンシブ、可視キーボードフォーカス、動きの軽減を尊重します。
- SEOの基本をカバーします。キーワードを認識したタイトルと説明、正規URL、OGP画像、1つの
h1、セマンティックセクション。 - 実際のスクリーンショット、写真、図を使用します。ステップ2で収集したイベントメディアをショーケース、チーム、数字で見るセクションに配置します。モックしたレプリカを出荷する場合はラベル付けします。デモにはYouTubeのポスターを使用します。
- フロントエンドデザインの指示に従い、レンダリング後にもう一度批判します。ページのスクリーンショットを撮り、「このルックを無関係なプロジェクトにも作成しただろうか?」と再質問し、ブリーフに貢献しない装飾を1つ削除します。
確認
frontend-designが実際に使用され、結果が一般的なAIデフォルトとして読まれないか、3つのデフォルトルックの1つになっていないこと。構築後に自己批判を適用します。このルックを無関係なプロジェクトにも作成しただろうか?- 1つの
h1、セマンティック見出し、モバイルレスポンシブ、可視フォーカス状態、動きの軽減が尊重されていること。 - すべての賞と統計は実際のものであり、モックしたレプリカはラベル付けされ、すべてのリンクが解決し、デモ動画が埋め込まれていること。
- ローカルでビルドしてプレビューし、可能であればCore Web VitalsまたはLighthouseパスを確認すること。
最終出力
- サイト: パスまたはルート、実行方法。
- デザインシステム: パレット、タイプペアリング、モーションモーメント、シグネチャー要素。それぞれがなぜこのプロジェクトに合うかを1行で説明。
- ショーケースデバイス: 使用したデバイスと、それがプロジェクトタイプに適している理由。
- 使用された事実と省略された事実: 何が含まれ、どのセクションが実際の事実不足でスキップされたか。
- デプロイ: Vercelに出荷する手順。
- 次のステップ: 例:カスタムドメイン、READMEやLinkedIn投稿からサイトへのリンク。
境界線
- まず
frontend-designを利用可能にし、テンプレート化されたデフォルトを決して出荷しないこと。デザインはこのプロジェクトに固有である必要があります。 - 賞、統計、プレスを決して捏造せず、モックしたレプリカには常にラベルを付けること。
- 1つの焦点を絞ったページに保つこと。プロダクト全体を再構築しないでください。
- 実際に存在するものを説明すること。サイトは実際のプロジェクトを反映し、理想的なバージョンではありません。