背景
このリポジトリを「Claude Code などの AI ツールの使い方を学べる、みんなで作る教材プラットフォーム」として育てていくにあたり、現在のフラットな番号付き構造から、投稿・閲覧・AI 参照いずれにも適した構造に移行したい。
提案するフォルダ構造
/
├── content/ ← 全投稿はここ
│ ├── claude-code/ ← ツール別カテゴリ
│ │ ├── hooks/ ← 1投稿 = 1フォルダ
│ │ │ ├── index.html
│ │ │ ├── README.md ← メタデータ(著者・タグ・難易度)
│ │ │ └── _assets/
│ │ ├── mcp/
│ │ ├── memory/
│ │ ├── slash-commands/
│ │ └── settings/
│ ├── claude-api/
│ │ ├── tool-use/
│ │ └── prompt-caching/
│ ├── ai-workflows/ ← ツール横断・実務への応用
│ │ ├── code-review/
│ │ ├── documentation/
│ │ └── automation/
│ └── other-tools/ ← Cursor, Copilot など
│ ├── cursor/
│ └── github-copilot/
├── shared/ ← 共通 CSS・JS(現状維持)
├── _templates/ ← 投稿テンプレート
│ ├── slides/
│ │ ├── index.html
│ │ └── README.md
│ └── article/
├── index.html ← 一覧ページ
└── CONTRIBUTING.md ← PR の出し方ガイド
設計の意図
- ツール → 機能の 2 層構造: 投稿者が「どこに入れるか」を迷わない。パスだけで内容が確定するため AI も参照しやすい
- 1投稿 = 1フォルダ: 同トピックで記事が増えた場合は
hooks-basics/、hooks-advanced/ のように横展開する
_templates/ を整備: 誰が投稿しても構造・見た目が揃うようにする
ai-workflows/ カテゴリ: 機能説明ではなく「実務でこう使う」という横断的な事例を集める場所
移行タスク
備考
content/ 配下のカテゴリは現時点では上記 4 つとするが、コンテンツが増えた段階で追加・見直しを行う。
背景
このリポジトリを「Claude Code などの AI ツールの使い方を学べる、みんなで作る教材プラットフォーム」として育てていくにあたり、現在のフラットな番号付き構造から、投稿・閲覧・AI 参照いずれにも適した構造に移行したい。
提案するフォルダ構造
設計の意図
hooks-basics/、hooks-advanced/のように横展開する_templates/を整備: 誰が投稿しても構造・見た目が揃うようにするai-workflows/カテゴリ: 機能説明ではなく「実務でこう使う」という横断的な事例を集める場所移行タスク
_templates/slides/、_templates/article/を作成CONTRIBUTING.mdに投稿手順・フォルダ命名規則を記載01-claude-code-intro/をcontent/claude-code/intro/に移動index.html(一覧ページ)を新構造に対応させる備考
content/配下のカテゴリは現時点では上記 4 つとするが、コンテンツが増えた段階で追加・見直しを行う。