Learning Flow

learning-flow

段階的な学習プロジェクト（Phase/Task構成）の進行を支援する Claude Code プラグイン。

「勝手に進めず、解説 → 確認 → 実装 → 振り返り → 次へ」のサイクルを守りながら、学習ノート（教材・議論・振り返り）を自動で整理する。

設計思想: 教材は公式docsを一次資料として Claude が自動生成し、ユーザーは受動的に受け取る。ユーザーから出た疑問・議論は別ファイル（reference）に分離して残す。

提供スキル

スキル	種類	役割
learning-flow-rules	自動発動	学習プロジェクト検出時に基本ルールを適用
/learning-flow:init	スラッシュ	新規学習プロジェクトの初期化
/learning-flow:status	スラッシュ	現在の Phase/Task 進捗を表示
/learning-flow:material [<source>]	スラッシュ + 自動	公式docsから教材mdを章単位で一括自動生成
/learning-flow:lesson [<NN-name>]	スラッシュ	既存教材mdを対話形式で解説（Q&Aは自動で reference へ）
/learning-flow:reference [<theme>]	スラッシュ + 自動	議論・Q&A を保存（多くは lesson 中に自動発動）
/learning-flow:quiz	スラッシュ	振り返りクイズを main.md に生成
/learning-flow:grade	スラッシュ	クイズ採点 + 復習キュー追記 + 進捗更新 + 次Task土台作成

インストール

このプラグインは user scope のローカルプラグイン として配置されている想定。

設置パス: ~/.claude/plugins/local/learning-flow/

Claude Code の設定で local plugin を有効化している場合は、起動時に自動ロードされる。

使い方

1. 新規学習プロジェクトの初期化

学習したいテーマのディレクトリに移動してから:

/learning-flow:init

対話でテーマ・Phase 数・各 Phase の内容を聞かれる。完了すると以下が生成される:

• CLAUDE.md（プロジェクトコンテキスト）
• docs/LEARNING_CONTEXT.md（学習フロー全体像）
• plans/{theme}-learning-phases-design.md（Phase 設計書）
• docs/learning/（学習ノート置き場）

2. 学習サイクル（教材駆動）

[Task開始]
  ↓ ユーザーが公式docs URL を提示
[/learning-flow:material]   ← Claude が docs を読んで章単位で教材mdを一括生成
  ↓
[/learning-flow:lesson]     ← 1枚ずつ対話で解説。Q&Aは自動で reference へ
  ↓
[全教材lesson完了]
  ↓
[/learning-flow:quiz]       ← 振り返りクイズを main.md に生成
  ↓
[ユーザーが main.md に回答記入]
  ↓
[/learning-flow:grade]      ← 採点 + 復習キュー追記 + 進捗更新 + 次Task土台作成
  ↓
[次Task。再び material から]

3. 進捗確認

/learning-flow:status

ディレクトリ構造

プラグインが扱う学習プロジェクトのレイアウト:

project-root/
├── CLAUDE.md
├── plans/
│   └── {theme}-learning-phases-design.md
└── docs/
    ├── LEARNING_CONTEXT.md
    ├── review-queue.md             ← grade が誤答を蓄積、次回セッションで再出題
    └── learning/
        ├── phase1/
        │   ├── task1/
        │   │   ├── main.md         ← 目次 + 振り返りクイズ
        │   │   ├── 01-{topic}.md   ← 教材（公式docsの写し、material が生成）
        │   │   ├── 02-{topic}.md
        │   │   └── reference/
        │   │       └── {theme}.md  ← 議論・Q&A（reference が保存）
        │   └── task2/
        └── phase2/

設計方針

• 1 Phase = 新規概念 1〜2 個: 詰め込みすぎず、段階的に
• 教材は公式docs駆動: Claude が docs の章立てに従って自動生成。ユーザーは受動的に受け取る
• 議論は別ファイル: ユーザー固有の疑問・対話は reference/ 配下に分離
• コードにも docs リンク: 該当コード上に 1 行コメント + 学習ノートへのリンク
• 次Taskへの移行は2段階: quiz（生成）→ ユーザー回答 → grade（採点+進捗更新）

ライセンス

MIT