Skip to content

feat: コンテンツ投稿プラットフォーム向けにフォルダ構造を再設計する #14

@Tsubasasa1857

Description

@Tsubasasa1857

背景

このリポジトリを「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/ カテゴリ: 機能説明ではなく「実務でこう使う」という横断的な事例を集める場所

移行タスク

  • _templates/slides/_templates/article/ を作成
  • CONTRIBUTING.md に投稿手順・フォルダ命名規則を記載
  • 既存の 01-claude-code-intro/content/claude-code/intro/ に移動
  • index.html(一覧ページ)を新構造に対応させる

備考

content/ 配下のカテゴリは現時点では上記 4 つとするが、コンテンツが増えた段階で追加・見直しを行う。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions