tech-learning-guide

Tech Learning Guide スキル

あらゆる技術トピックについて、完全で構造化された、明確な意見を持つ学習ガイドを生成します。ガイドは、そのトピックをこれまでに教えた経験のある熟練のシニアエンジニアが書いたかのように感じられるべきです — 実践的で、直接的で、何が最も重要かについて正直であること。

出力構造

ガイドをレンダリングされた成果物(.md ファイル)として、以下のセクションを順番に含めて作成します。 トーンは温かく、直接的で、技術的に自信のあるものにしてください — 冗長な飾りや水増しは避けてください。

---

セクション 1 — 概要とコンセプトマップ

その技術が何であり、なぜ今日のエコシステムにおいて重要であるかを説明する 2〜3 文で始めます。 次に、学習者が習得する必要のあるすべての主要な概念を、3 つの階層にグループ化して列挙します:

階層	ラベル	意味
🟢	Basics	初心者が最初に学ぶべき概念。その技術に関する事前知識は不要
🔵	Foundational	日々の実務知識を形成する中核的な概念
🔴	Advanced	深い内部構造、本番環境の懸念事項、パフォーマンス、またはエコシステム連携

表またはグループ化されたリストとしてフォーマットします。各階層につき 5〜8 個の概念(合計 15〜24 個)を目安にしますが、 技術の範囲に応じて自然に調整してください。人為的に水増ししないでください。

---

セクション 2 — 週ごとの学習スケジュール

現実的な週単位の学習計画を作成します。1 日 1〜2 時間、週 5 日を想定します。 構造:

• 第 N 週: [テーマ] — その週の焦点を説明する 2 文
  • 1〜5 日目: 具体的な日々の目標(それぞれ 1〜2 文)

スケジュール全体で 3 つの階層すべてをカバーします。まず Basics、次に Foundational、そして Advanced です。 典型的なスケジュールの長さ: 技術の広さに応じて 6〜10 週間。一部の週により多くの時間が必要な場合は正直に伝えてください(例: 「今週は密度が高いので、必要なら追加の時間を確保してください」)。

---

セクション 3 — ローカル開発環境のセットアップ

動作するローカル環境を構築するための、実用的でコピー&ペースト可能な手順を提供します。 以下を含めます:

• 前提条件(OS、必要なツール、バージョン)
• インストール手順(番号付き、シェルコマンドはコードブロック内に記載)
• 動作確認 — セットアップを確認するための最小限の「hello world」コマンドまたはスニペット
• 推奨 IDE / エディター(主要なプラグインや拡張機能を含む)
• 便利な開発ツール(リンター、フォーマッター、デバッガー、ローカルテストランナー)

明確な意見を持ってください。学習にとって明らかに優れているアプローチがある場合は、そう述べてください。

---

セクション 4 — 概念の詳細解説

セクション 1 に記載されたすべての概念について、専用のサブセクションを提供します:

### [Tier emoji] [Concept Name]

**What it is**: 2–3 sentence plain-language explanation.

**Why it matters**: 1–2 sentences on practical relevance.

**How it works**: Explanation with code example(s). For code-heavy concepts, show at least
one realistic example (not just "hello world"). For architectural concepts, use a short
diagram or analogy.

**Common pitfalls**: 1–3 bullet points of mistakes beginners make.

---
#### ✏️ Exercises

1. [Concrete, hands-on exercise — beginner friendly]
2. [Slightly harder exercise that builds on the first]
3. [Challenge exercise that combines this concept with a previous one]

概念をそれぞれの階層見出しの下にグループ化します: ## 🟢 Basics、## 🔵 Foundational、## 🔴 Advanced

---

セクション 5 — 人気のライブラリとエコシステム

簡潔なエコシステムマップを示します。その技術の周辺にある主要なライブラリまたはツールごとに:

• 名前 + それが何をするかの一言説明
• いつ使うか(2 文)
• 最もシンプルで有用な例を示すコードスニペット(該当する場合)

6〜10 項目を目安にします。エコシステムが大きい場合はカテゴリ別にグループ化します(例: 「Testing」、「HTTP」、「ORM」)。すべてを列挙しないでください — 実務家が実際に手を伸ばすものを列挙してください。

---

セクション 6 — プロジェクトのアイデア

複雑さが段階的に増す、ちょうど 3 つのプロジェクトアイデアを提供します:

1. [Small] プロジェクト名 — 1〜2 週間。何を構築するか、どの概念を練習するか、 なぜそれが良い学習手段になるのか。
2. [Medium] プロジェクト名 — 3〜5 週間。同じ形式。より多くの Foundational な概念を導入します。
3. [Stretch] プロジェクト名 — 終わりのないもの。Advanced な概念と実世界の 懸念事項(認証、永続化、デプロイ、パフォーマンス)を取り入れます。

各プロジェクトについて、以下を含めます:

• 簡単な機能リスト(3〜5 個の箇条書き)
• 練習する主要な概念
• 任意: 組み合わせることを提案する技術スタック

---

セクション 7 — 次のステップ

このガイドの内容をすべてマスターした後、学習者はどこへ進むべきでしょうか。以下を示します。

• 探求すべき隣接技術を 2〜3 個（それぞれ 1 文の根拠付き）
• その技術自体の中でカバーされなかった発展的なトピックを 2〜3 個
• 最新情報を追い続けるためのコミュニティリソースを 1〜2 個（カンファレンス、ニュースレター、フォーラム）

これは正直な「卒業」として位置づけてください。基礎は学びました。ここからが地平線です。

---

セクション 8 — リソース

厳選された参考リスト。カテゴリ別に整理します。

• 公式ドキュメント — リンク + 1 文の説明
• 書籍 — タイトル、著者、推奨理由
• オンラインコース — プラットフォーム + コース名、どの学習者レベルに最適か
• ブログ / サイト — 名称 + どのようなコンテンツを発信しているか
• YouTube / 動画 — チャンネルまたは特定のシリーズ、視聴する価値がある理由
• コミュニティ — Discord、Slack、フォーラム、subreddit

簡潔に保ってください。各カテゴリ最大 3〜5 項目まで。すべての項目が掲載されるに値するものであるべきです。

---

品質ガイドライン

• 具体的に: 「たくさん練習する」のような曖昧なアドバイスは避けます。何を、どのように練習するのかを述べてください。
• 正直に: 概念が本当に難しい場合や、よくつまずくポイントである場合は、そう伝えてください。
• 例は実行可能に: コードスニペットは最小限でありながら、実際に実行できる、または単体で理解できる程度に完全であるべきです。
• 技術に応じて深さを調整: Bash スクリプトと分散システムのガイドでは、深さと広さの印象が異なるべきです。
• 存在しないリソースをでっち上げない: 存在を確信している書籍、コース、リンクのみを含めてください。特定の URL に自信がない場合は、推測するのではなく、リンクなしでリソース名を記載してください。
• デベロッパーアドボケイトのトーン: 教科書ではなく、知識豊富な仲間として書いてください。一人称の補足は問題ありません（「私は Y より先に X から始めます。なぜなら…」）。

---

広範なトピックと狭いトピックの扱い

• 非常に広範なトピック（例: 「クラウドコンピューティング」「Web 開発」）: イントロで範囲を絞ってください。どの角度を扱うのか、その理由を伝えてください。隣接領域については追加ガイドを依頼するよう提案してください。
• 非常に狭いトピック（例: 単一のライブラリメソッドやニッチなツール）: それに応じて縮小してください。Array.prototype.reduce に 10 週間のスケジュールは馬鹿げています。判断力を働かせてください。
• バージョンに敏感な技術: ガイドが対象とするバージョンを冒頭で言及してください。古いバージョンで大きく異なる領域があれば指摘してください。

---

参照

• references/schedule-templates.md — さまざまな技術スコープ（言語、フレームワーク、ツール、概念）向けのスケジュールパターン例。スケジュールの長さや密度の調整が必要な場合に読んでください。
• references/concept-tiers.md — 一般的な技術カテゴリにおいて、概念を基礎 / 土台 / 発展に分類する方法に関するガイダンス。