Communitygithub.com

zernie/vigiles

vigiles.sh ランディングサイト(site/)の目的、UXフロー、モダンミニマリストデザイン基準を定義します。site/ コンポーネント、ヒーローセクション、マーケティングコピーのデザイン、編集、追加、レビュー時に必ず読み、すべての変更をこの基準に照らして判断してください。docs/ やアプリ本体には適用されません。

vigiles とは?

このスキルは、AIエージェント開発ツール「vigiles」のランディングサイト(site/)のデザインとUXに関する包括的なガイドラインです。Vite + React + Tailwind で構築されたダークモード専用のサイトで、訪問者に `npx vigiles audit` を実行してもらうことを最優先のコンバージョン指標としています。デザインの根本原則は「引き算によるデザイン」であり、不要な要素は迷わず削除し、ページをすっきりとモダンに保つことを重視します。このスキルは、Claude Code、Codex、Cursor などのエージェンティックコーディングツールを使いこなす開発者を主な対象としており、具体的で明確なコピー、デモ結果の信頼性、モバイル対応、そしてプライベートリポジトリの取り扱いに関する詳細なルールを定めています。

対応✓Claude Code✓Codex CLI✓Cursor✓Antigravity
npx skills add https://github.com/zernie/vigiles/tree/HEAD/.claude/skills/landing-site

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ランディングサイト — 目的、UX、デザイン基準

正面玄関は site/(Vite + React + Tailwind、ダークモード専用)で、vigiles.sh にデプロイされています。このスキルは、すべての変更が準拠すべき基準です。このスキルが存在する目的は、繰り返し発生する失敗を防ぐことです。その失敗とは要素を削除する代わりに追加してしまい、ページをモダンではなく、ごちゃごちゃしたテンプレート風(「tildaっぽい」)にしてしまうことです。

他のすべてのルールに優先する唯一のルール: 迷ったら、削除せよ。引き算によるデザイン。 要素を削除しても意味が失われないなら、削除してください。ボックス、キャプション、2番目のボタン、安心させるための一文を_追加_する変更は、必要性が証明されるまで疑わしいものと見なします。

目的(サイトの役割)

  • 最優先目標 — npx vigiles audit を実際に実行する訪問者の割合を最大化する。 これこそが、すべてのデザイン決定が奉仕する唯一のコンバージョン指標です。CTAは素晴らしいもの(摩擦がなく、明確で、常に到達可能)である必要があります。変更が誰かのコマンド実行を助けないのであれば、その場所に値しません。
  • 対象者: エージェンティックコーディングツール(Claude Code、Codex、Cursor)を既に使いこなしている開発者。彼らは懐疑的で、スマートフォンでざっと目を通します。
  • 魅力は評価レポートです — メカニズムを説明するのではなく、結果を見せてください。
  • 玄関での約束: 「エージェントハーネスのためのLighthouse」 — ワンコマンド、ゼロ設定、何もアップロード不要でスキル/フック/サブエージェント/リファレンスを評価します。
  • デモフレームは4つの役割を同時に果たします — すべての役割を考慮してデザインし、1つの役割が他の役割を圧迫しないようにしてください。 (1) 導入 — vigiles が一目で何か分かるようにする(評価レポート自体が売り)。 (2) デモ — 努力ゼロで即座に実際の評価結果を表示する(組み込みの FEATURED チップ)。 (3) ブラウザ内実行 — 自分の公開リポジトリを入力してライブで評価する(GitHub 匿名API経由、公開リポジトリのみ)。 (4) 残りのユーザー向けコマンドコピー — プライベートリポジトリやローカルリポジトリはブラウザ内で実行できないため、ここでの役割は npx vigiles audit をクリーンかつ明確にコピーすること(コマンドの受け渡しであり、ブラウザ内での擬似実行ではない)です。ここから2つの明確化ルールが導き出され、これらは重要な役割を担います: (a) フレームは常に、どのリポジトリが表示されているか、それが事前定義された例(チップ)なのか、自身のリポジトリ(入力)なのかを明確にしなければなりません — 曖昧さは絶対に避けること; (b) プライベートリポジトリのパスは第一級の機能として扱い、文章の最後に付け足しにしてはいけません — ラベル付きのクリーンなコマンドコピーとして、390pxの画面幅でも確認できるようにすること。 コマンドを3行に重ねて表示しないでください($ vigiles audit <slug> というヘッダーを、既に名前が表示されているハイライトされたチップの上に配置するのは情報過多です — ヘッダーの役割は、評価されたリポジトリとそのソースを特定することであり、コマンドを再表示することではありません)。
  • コピーライティング: 賢さより具体性を、そして決して読者が元々抱いていなかった疑念を植え付けないこと。 このルールが防ぐ2つの実際の失敗例: (1) 謎めいたキャッチーな見出し(「'Valid' is not 'true.'」) — 具体的な問題点(「Valid config. Broken agent.」)で始め、ニュアンスは下のカードに任せること; (2) 防御的なFAQで、読者が気づいていなかった弱点を強調してしまう(「Is it stable enough to adopt?」という質問は、恐ろしいバージョン番号に目を向けさせてしまう) — 疑念を植え付けるものを、懐疑的なユーザーが実際に尋ねる自信を高めるものに置き換えること(「Does anything leave my machine?」、「Can I grade a private repo?」)。すべての文章を冷めた懐疑的なユーザーの立場でテストすること: これによってコマンドを実行する可能性が高まるか、低くなるか?低くなるなら、削除するか言い換えること。
  • 信頼性: デモレポートは実際のスキャンのみを表示し、結果を決して偽装しないこと。 ブランドは「主張するではなく、測定する」です。そのため、レポート内にハードコードされた偽の数字が1つでもあると、すべての実際の発見に対する信頼を遡及的に損なうことになります。本当にここでは実行できないもの(モデルゲートされたトリガーレートなど)に対して、誠実なプレースホルダー(数字なしで「実行して確認」を示すemダッシュ)を使ったロック表示は問題ありません — 何も偽装していないからです。ツールが実際に計算するものに対する偽の「結果」は許されません — 実際の計算結果を表示するか、レポートフレームの外側に正直な説明カードとして残してください。
  • 試すための摩擦を減らす: 人気のあるOSSリポジトリを「これを評価」というワンクリックチップとして事前入力しておき、訪問者が自分で入力したりリポジトリを持っていなくても実際のレポートを見られるようにします。既に実装済み — DemoAudit 内の FEATURED チップは、ベイク済みの実際のレポートを即座に表示します。
  • すべての結果画面には共有機能と安定したリンクが含まれていること。 チームメイトに渡せない評価結果は行き止まりです。そのため: (1) 完了したすべての評価結果は、コピー可能なディープリンク(vigiles.sh/?repo=owner/repo#try)を持ち、読み込み時に自動で監査を実行します — URL自体が共有単位です; (2) すべての結果はワンタップで共有可能です(モバイルではネイティブ共有シート、それ以外ではリンクコピー — DemoAudit 内の ShareRow); (3) ディープリンクは入力/チップと同じスラッグを使用するため、共有リンク、入力されたリポジトリ、チップはすべて1つのコードパスに解決されます。新しい結果画面には必ず両方を含める必要があります。既に実装済み — 動作を維持し続けてください。(ここで動作する評判ルール — 共有はオプトイン、辞退は自由、評価対象はアーティファクトであって人ではない — は、ルートの CLAUDE.md にある gate-first-adoption ルールです。ここで再述しないでください。)
  • コンバージョンを計測する: ファネル分析(コマンドコピー、入力送信、チップ試行、再評価、共有クリック)。サイトは GitHub Pages 上にあり、Vercel ではありません — そのため Vercel Analytics は適用されません。静的ホスティングには、軽量でプライバシーに配慮したスクリプトタグ型の分析ツールを使用してください: Plausible / Fathom / GoatCounter。ファネルは既に計装されています — track()(site/src/lib/track.ts)は demo_* イベントを発火し、プロバイダーが接続されるまでは安全なno-opとして動作します。残作業: index.html にプロバイダーのスクリプトタグを追加し、イベントが実際に届くことを確認してください。分析では結果の種類のみを追跡し、入力されたスラッグ(プライベートリポジトリ名が漏洩してはいけません)は決して追跡しません。

方向性 — 記録すべき決定事項(最新を維持; ここに方向性が記録されます)

現在のサイトの背後にある戦略的な判断。このセクションは方向性が変わったときに更新してください — これは単なるスタイルガイドではなく、設計ドキュメントです。各項目は、実際の反復を経て到達した決定であり、暗黙のうちに元に戻さないでください。

  • デフォルトのデモは低評価を表示し、高評価の羅列にしてはいけません。 FEATURED チップは、有名なリポジトリ上で実際の F → C → B → A のスケールを示します(現在: davila7/claude-code-templates → F, disler/claude-code-hooks-mastery → C, madappgang → B, obra/superpowers → A)。なぜこのようにしなければならないのか: 実際の人気プラグインのほとんどは、ブラウザで実行できる決定論的な軸では A/B 評価になります — 劇的な失敗(スキルが発動しない、説明が衝突する)は、ブラウザで実行できないモデルゲートされたトリガーレート層に存在します — そのため、きれいなデフォルト表示はツールに反する議論になります(「全部問題ないじゃないか、これがなぜ必要なんだ?」)。デフォルトは実際に壊れているリポジトリにして、レポート(魅力)が vigiles が何かをキャッチしていることを示すようにする必要があります。低評価デフォルトの更新(リポジトリは時間とともに修正されます): git clone https://github.com/<slug> を実行し、続けて node dist/cli.js audit <dir> --json を実行してください(注意: codeload/api.github.com はクラウド環境でプロキシによりブロックされる場合があります — github.com 経由の git clone は機能します)。(a) 有名であり、(b) 客観的で1行で修正可能な問題(デッドツール、見えない skills/ ディレクトリ、デッドフックイベント — 恥ずかしいだけのデザインではない)を持つリポジトリを選んでください。公開評価が公平であるためです(Lighthouseモデルは公開アーティファクトの公開評価です)。レポートを site/src/demo/reports/ にベイクし、FEATURED に配線してください。モデル層の評価結果はブラウザデモの外に留めておきます: ブラウザデモは設計上、決定論的なチェックのみを実行します(以下のブラウザ内デモの不変条件を参照)。そのため、それらのための誠実な表示面は LockedRow のティーザーであり、偽造された結果ではありません。
  • 名前を出すだけで説明しないのは、コピーライティングの最大の失敗要因です — すべての概念に注釈をつけるか、削除してください。 初めて訪れた訪問者は、「linter(リンター)」、「reference(リファレンス)」、「enforce(強制)」、「spec(スペック)」、またはカテゴリ名が何を意味するのか知りません。すべての概念は、最初に使用される際に平易な英語で説明されるか、削除されます。専門用語を羅列しないでください(以前のREADMEはこれを学びました — 「最初の使用時にハーネスを定義せよ」; サイトは退行し、再学習する必要がありました)。すべての文章を、vigiles を聞いたことのない冷めた Claude Code/Codex ユーザーの立場でテストしてください。
  • 説明をレポートに折り込み、スタンドアロンの説明カードを追加しないでください。 レポートこそが魅力です。ブラウザで表示できない概念(モデルゲートされたトリガーレート、ローカル設定が必要なリンターの相互参照)は、レポートフレームの下に浮かぶカードではなく、レポート内部の点線の CLI専用行(report-view/src/Report.tsx の LockedRow / CliRulesRow)として表示されます。サイトがレポートを2か所で説明している場合は、重複を削除してください(これが、Wedgeの5カテゴリストリップとスタンドアロンの「Your rules → enforced」カードが削除された理由です — レポートは既に両方を伝えています)。
  • 同時に表示する入力は1つだけ — パブリック/プライベートのタブで、スタックにしない。 ヒーロー入力は、入力 + 「public API」キャプション + プライベートコマンド受け渡し + プライバシーに関する一文がすべて積み重なっていました(ごちゃごちゃ)。現在は DemoAudit 内の Public | Private タブ になっています: Public = ライブのリポジトリ入力コンボボックス; Private = npx vigiles audit コマンドコピーです。一度に表示される入力は1つだけです。
  • 誠実なティーザーを心がけ、ぼかしや偽装はしないでください(古い「ぼかして表示」の注意書きは無効になります)。 モデルゲートされた行はemダッシュのプレースホルダー(recall — · precision —)を使用し、ぼかした偽の数字は使用しません。ぼかしはレンダリングバグのように見え、ペイウォールのダークパターンにもなり、数字の偽装は「測定するのであって、主張しない」という原則を破ります — これは、主張された数字を嘲笑するコピーの近くに置かれると二重に間違っています。より強力なティーザーが望まれる場合は、example ラベルを付けた実際の測定値を常に使用し、偽造またはぼかした値は決して使用しないでください。

UX要件

  • コマンドファースト。 npx vigiles audit は普遍的なアクションです(すべてのOS、すべてのターミナルで動作します)。これは主要なCTAです。他のすべては二次的です。
  • Claude Code ディープリンク(claude-cli://)はデスクトップ専用の拡張機能であり、主要なパスにしてはいけません — モバイル/CC Web/デスクトップ(CC未インストール)では無音で行き止まります。機能する場所でのみレンダリングし、何もしないボタンを絶対に出荷しないでください。
  • モバイルでは誠実に。 機能しないボタンを置かないでください。デスクトップ専用のアクションを実行できない場合は、その旨を明確に伝え、代わりに実際のアクション(コマンド)を提示してください。
  • 画面ごとに1つの主要アクション。 二次的なアクションは_控えめ_に — テキストリンクまたは薄いピル型ボタンで、主要なものと競合する2つ目の大きな全幅ボタンは避けてください。
  • ハーネスに依存しない。 「Claude Code や Codex」と言い、Claude Code を前面に出さないでください — それは実装の詳細であり、見出しではありません。内部構造を過度に説明しないでください。
  • 低摩擦で歓迎する。 ざっと見た人が、何ができるか、どう試すかを、文章の壁を読むことなく、1画面以内で理解できるようにする必要があります。

デザイン基準 — モダン&ミニマル(混雑を避けるルール)

Linear / Vercel / Raycast の雰囲気を参考にしてください: 自信に満ちたダーク、たっぷりとした余白、少ない言葉、セクションごとに1つの明確な焦点。機能を詰め込んだテンプレートではありません。

  • すべての要素はその場所に値する必要があります。 他の要素を言い換えているだけのもの(スクリーンショットを繰り返すキャプション、2回言われている信頼性の一文、冗長なサブヘッド)は削除してください。
  • 別の要素が既に暗示しているラベルは削除してください。 GitHub/スターのリンクが既にあるのに「free & open source」バッジは冗長です。「Grade a specific repo」という見出しの上に「AUDIT A SPECIFIC REPO」バッジを置くのは言い換えです。コンテキストが既に読者に伝えているなら、ラベルはノイズです。
  • すべてのリンク/CTAはアクション可能で具体的でなければなりません。 読者はクリックしたら何が起こるかを正確に知っている必要があります。曖昧で受動的な二次リンクは避けてください(「Have Claude Code?…」など)。二次的なパスが明確で具体的なアクションに値しないなら、削除するか(あるいはナビゲーションに移動してください。永続的なリンクは、たるんだ折り畳みリンクより優れています)。
  • セクションごとに1つの焦点。 目が最初に1つのものに留まるようにしてください。
  • ボックスより余白とタイポグラフィ。 3つ以上の全幅の枠線付きボックスを積み重ねないでください。その繰り返しがごちゃごちゃして見える原因です。境界線よりもタイポグラフィの階層と余白を優先してください。ただし、余白は_意図的_である必要があります — ほぼ空のビューポートの空白も避けてください。
  • 安心させる情報は1回、1行で。 信頼に関するコピー(「何もアップロードしません」)は、コンパクトに1回だけ表示されます — 3行の段落や、セクションごとの繰り返しは避けてください。
  • 結束性。 ヒーロー(バッジ + 見出し + サブ見出し + ビジュアル)は1つのアイデアとして読める必要があり、各部分が_新しい_情報を追加する必要があります。サブ見出しがスクリーンショットに既に示されていることをただ言い換えているだけなら、削除するか、より鋭くしてください。
  • 色と強調の抑制。 1つのアクセントカラー、常に_何か_を意味するセマンティックバンドカラー(評価バンド)。ポイントごとに1つのフレーズを太字にし、すべての節を太字にしないでください。装飾的な絵文字の紙吹雪は使わないでください。
  • 一貫したスペーシングスケール。 リズムを壊すような、1回限りのマージンを手動で調整しないでください。

アンチパターン(ここで過去に問題が発生したこと)

  • 入力 + 大きなボタン + 3行の信頼コピー + 区切り線 + コマンド + キャプション + 別のボタンを1つの折り畳みに詰め込む。(修正: 要素を約3つに抑え、残りを削除する。)
  • プロダクト画像の下のキャプションがプロダクト画像を言い換えている。
  • フローの再考ではなく、問題_ごとに_注意書きやボタンを追加する。
  • 階層のない、競合する2つの主要CTA(ディープリンク + コマンド)。
  • CCファーストのフレーミング(「あなた自身のClaude Codeで動作します…」)を見出しの安心材料として使う。
  • デスクトップ専用フロー(Claude Code claude-cli:// ディープリンク)をモバイルでも表示したままにし、別のセクションで既に表示されているコマンドを単に繰り返すフォールバックとして使う — スマートフォン上で連続するセクションに同じ npx vigiles audit ブロックが表示される。(修正: デスクトップ専用セクション全体を hidden sm:block にする; ヒーローとCTAが既にその役割を果たしている。)

ブラウザ内デモ(既に実装済み — 維持すべき不変条件)

ライブの「任意のリポジトリを評価」デモは構築済みです(DemoAudit.tsx + site/src/demo/ 内): 公開リポジトリを入力/ペーストするか、注目のチップをタップすると、クライアント側でハーネスファイルを取得し、CLIと同じコンパイル済みエンジンを実行します。以下のルールは現在では維持すべき不変条件であり、将来の方向性ではありません。

  • すべての結果は共有可能です(上記の共有可能性の目標を参照)。 完了した評価結果には、ワンタップ共有 + 安定した自動実行 ?repo= ディープリンクが含まれます。これはデモの必須要件であり、あれば良いというものではありません — これなしに結果画面を出荷しないでください。
  • ブラウザ内、ホスティングなし。 監査計算は完全にクライアントサイドで、訪問者のブラウザ内で実行されます(GitHub APIを介してリポジトリのファイルを取得し、純粋な検出器をJSで実行)→ 「あなたのマシンから何も出て行かない」ことを強化します; バックエンド/コストはゼロです。唯一の「ホスティング」は vigiles.sh での静的なファイル配信です。
  • 決定論的チェックのみ。 ブラウザデモは、モデルゲートされたチェック(トリガーレート、説明のフィッティングなど)を実行しません。モデルゲートされた結果は、CLI専用で「ロック」された行として表示されます。ブラウザデモでモデルゲートされた結果を出そうとしないでください。
  • 入力サニタイゼーション: GitHubのリポジタースラッグを検証します。無効な入力を拒否し、早い段階で明確なエラーメッセージを表示します。アクセス可能なエラー状態(aria-liveリージョン)。onSubmit はプロバイダー (auditProviders.ts) を通してルーティングされ、auditProviders.ts はエラーを捕捉し、表示用の AuditResult 状態を設定します。
  • レンダリングされるレポートは、CLIのJSON出力と同じエンジンを共有します。 site/src/demo/ のコードは、CLIの監査エンジンをインポートし、結果をレンダリングします。2つの異なるレンダラーを維持しないでください。reporter-react パッケージ(共有)がレンダリングを処理します。

発展(このスキルの歴史 — 決定事項の思い出しに)

あなたは今、最初の CLAUDE.md / スキルを見ています — 2025-04-02に書かれ、init 試行1で書かれました。site/ の助走期間(主に追加の連続)の後、『これは CLAUDE.md/スキルとして書くべきだ』という瞬間が訪れました。なぜなら、CLINE のようなツールを使って初めて訪れた訪問者は、私たちが経験したすべての失敗を経験するべきではないからです。これが、教訓を不変条件に変えた最初の文書です。

デザインによる引き算は、最も難しい部分として現れました — 何かを追加することは、私たちが_それがなくても機能する_ことを証明するよりもはるかに簡単です。作成者自身が、このスキルが書かれるまで、入力 + ボタン + 信頼コピー + 区切り線 + 別のCTAを積み重ねていることに気づいていました。同じ過ちを二度犯さないでください。

多くの部分が_重要_に思えます — それこそが罠です。

コピーライティングの声

  • 具体的かつ簡潔。 「Valid config. Broken agent.」は「'Valid' is not 'true.'」より優れています。
  • 誠実で透明性がある。 誇張や偽の数字はありません。「測定するのであって、主張しない」。
  • 親しみやすく、専門的。 過度にカジュアルでも、過度に堅苦しくもありません。
  • 対象者の言葉を話す。 エージェンティックコーディングツールに精通した開発者向けです。

私(Claude Code/Codex/Cursorのスキル)がこのスキルを使うべき時

コード生成前にこのスキルを読んでください:

  • site/ 内の任意のコンポーネントを作成または変更するとき。
  • マーケティングコピー(見出し、説明、CTA)を書くとき。
  • UXフロー(状態、エラー、トランジション、モバイルレイアウト)を実装するとき。
  • デモ機能(DemoAudit、レポート、共有)を構築するとき。
  • デザインの決定をレビューするとき(このスキルは唯一の情報源です)。

このスキルを読まなくても良い時:

  • docs/ を更新するとき(ただし、対象者は似ています — 簡潔で、専門用語を説明することを忘れないでください)。
  • コア vigiles CLIツール(src/)自体を変更するとき。
  • CI設定を変更するとき。

関連スキル