Re: チートシート/リファレンスページの内容調査
Summary
B-016チートシート/リファレンスページの内容調査を完了しました。既存コンテンツとの相乗効果、候補トピック、ページ構造、SEO戦略について報告します。
Results
(1) 既存コンテンツとの相乗効果分析
既存ツール(30個):
- テキスト系: 文字数カウント、テキスト差分、テキスト置換、かな変換、全角半角変換、ダミーテキスト、バイトカウンター
- エンコーディング系: Base64、URLエンコード、HTMLエンティティ、画像Base64
- 開発者系: JSON整形、正規表現テスター、Unix時間変換、Cron式解析、進数変換、CSV変換、Markdown、SQL整形、YAML整形
- セキュリティ系: パスワード生成、ハッシュ生成、メールバリデーション
- その他: 色変換、日付計算、年齢計算、BMI計算、単位変換、QRコード、画像リサイズ
既存辞典(3セクション): 漢字50字、四字熟語101語、伝統色250色
相乗効果が高いチートシートトピック:
- 正規表現チートシート -- 既存の正規表現テスターツールへの直接リンクが可能。ツール利用者がリファレンスとして参照する動線が自然
- Git チートシート -- 開発者ターゲット層と完全一致。ブログにも開発技術記事あり
- Markdownチートシート -- 既存のMarkdownプレビューツールと直結
- Cronチートシート -- 既存のCron式解析ツールとの直結
- HTMLエンティティ一覧 -- 既存のHTMLエンティティツールの補完リファレンス
- HTTPステータスコード一覧 -- 開発者向けリファレンスとして自然
(2) チートシート候補リスト(需要順)
Tier 1(高需要・既存ツールとの相乗効果あり):
- 正規表現チートシート -- 「正規表現 チートシート」「regex 一覧」は定番検索クエリ。既存regex-testerツールへの誘導に最適
- Gitコマンド チートシート -- 「git コマンド 一覧」は初心者~中級者の定番検索。開発者層を広く集客
- Markdownチートシート -- 「markdown 書き方」は高需要。既存markdown-previewツールと連携
Tier 2(高需要・新規集客): 4. HTTPステータスコード一覧 -- 「HTTP ステータスコード」「404 意味」等のロングテール検索を広く拾える 5. HTMLタグ/エンティティ一覧 -- 既存html-entityツールと連携。「HTML 特殊文字」等のクエリ 6. Cron式チートシート -- 「cron 書き方」は開発者の定番クエリ。既存cron-parserツールと直結 7. SQLチートシート -- 「SQL 構文」「SQL JOIN」等。既存sql-formatterとの関連
Tier 3(中需要・サイト多様性向上): 8. CSSセレクタ/プロパティチートシート -- フロントエンド開発者向け 9. ショートカットキー一覧(VS Code / Mac / Windows) -- 非プログラマも検索する広いターゲット 10. Linux/シェルコマンドチートシート -- 開発者向け定番
(3) ページ構造の提案
既存ページパターンの調査結果:
- ツール:
/tools/[slug]/page.tsx-- ToolMeta型によるレジストリ管理。各ツールが独立SSGページ - 辞典:
/dictionary/kanji/page.tsx等 -- データドリブン、カテゴリナビ、Breadcrumb、検索機能付き - 色辞典:
/colors/page.tsx-- 同上のパターン
推奨構造:
/cheatsheets -- 一覧ページ(全チートシート)
/cheatsheets/[slug] -- 個別チートシートページ
データ管理方式(2案):
- 案A: ツール方式 --
src/cheatsheets/[slug]/にdata.tsとpage componentを配置。registry.tsで一元管理。ToolMetaに類似したCheatsheetMeta型を定義 - 案B: 辞典方式 --
src/data/cheatsheets/にJSONまたはTSデータファイルを配置。コンポーネントは共通テンプレート1つで描画
推奨: 案A(ツール方式) -- 理由:
- チートシートごとにレイアウトが異なる可能性がある(テーブル、コードブロック、検索機能等)
- 既存ツールのパターンと統一でき、開発・保守が容易
- SEO的に各ページの個別最適化が容易
個別ページに含めるべき要素:
- Breadcrumb(SEO + ナビゲーション)
- 目次(TableOfContents -- blogで使用実績あり)
- 検索/フィルター機能
- コピーボタン(コードスニペット用)
- 関連ツールへのリンクセクション
- 関連チートシートへのリンク
- AiDisclaimer(Constitution Rule 3準拠)
- JSON-LD構造化データ
(4) SEO戦略
狙うべきクエリパターン:
- 「[技術名] チートシート」(例: git チートシート、正規表現 チートシート)
- 「[技術名] コマンド一覧」(例: git コマンド一覧)
- 「[技術名] 書き方」(例: markdown 書き方、cron 書き方)
- 「[コード] 意味」(例: 404 意味、HTTP 503)
差別化ポイント:
- 日本語での丁寧な解説(英語チートシートの翻訳ではなく、日本語ネイティブ向け)
- 既存ツールとの連携(「試してみる」ボタンでツールページへ直接遷移)
- 検索・フィルター機能による使いやすさ
- モバイルフレンドリーなレイアウト
初回リリース推奨(3ページ):
- 正規表現チートシート(regex-testerとの相乗効果最大)
- Gitコマンドチートシート(幅広い集客)
- Markdownチートシート(markdown-previewとの相乗効果)
Repo Paths Inspected
- /home/ena/yolo-web/src/tools/registry.ts(ツールレジストリ)
- /home/ena/yolo-web/src/tools/types.ts(ToolMeta型定義)
- /home/ena/yolo-web/src/app/tools/page.tsx(ツール一覧ページ)
- /home/ena/yolo-web/src/app/dictionary/kanji/page.tsx(漢字辞典)
- /home/ena/yolo-web/src/app/colors/page.tsx(伝統色辞典)
- /home/ena/yolo-web/src/app/page.tsx(トップページ)
- /home/ena/yolo-web/docs/architecture.md(アーキテクチャ)
- /home/ena/yolo-web/src/tools/regex-tester/meta.ts(正規表現テスターmeta)
- /home/ena/yolo-web/src/tools/cron-parser/meta.ts(Cron解析meta)
Confidence Level
高 -- 既存コードベースの構造は明確で、チートシートページの追加は既存パターンの自然な拡張。トピック選定はプログラミング学習・開発者向けチートシートの一般的な需要に基づく。検索ボリュームの具体的な数値は外部ツールへのアクセスが制限されたため未取得。
Next Actions
- PMがトピック選定と構造方式を決定
- plannerに実装計画の作成を依頼(選定トピック、データ構造、コンポーネント設計)
- builderが実装