講義ガイド
本ハンドブック(第1〜13章+付録A/B/C)を教える講師向け資料。
前提条件チェックリスト(統合版)
セットアップドキュメントに散在する項目をまとめました(第3章・ラボ環境の構築参照)。コース開始前にすべてを確認できます。受講者には授業の少なくとも1日前にこのリストを通知し、当日のセットアップ問題で時間を無駄にしないようにしてください。
C:\git\project\setup事前インストールスクリプトフォルダの準備(推奨)git clone https://github.com/5throck/ai-workspace-standards.git全体時間配分表
時間配分には受講者がコマンドを入力(またはコピー&ペースト)するハンズオン時間が含まれています。休憩は別枠です。
| セクション | 内容 | 形式 | 時間 |
|---|---|---|---|
| 導入 | コースの目標、全体ロードマップ、前提条件確認 | 講義 | 10分 |
| 第1章 | AIの潮流、単一AI vs エージェントチーム、ハーネス概念、期待される成果 | 講義+確認 | 25分 |
| 第2章 | Claude Desktop Appのインストール、サブスクリプションプラン、最初の会話、プロジェクト、アーティファクト | ハンズオン | 30分 |
| 第3章 | 前提条件チェックリスト、OS別セットアップスクリプト、インストール確認 | ハンズオン | 30分 |
| 第4章 | エージェント、スキル、ワークフロー、PMオーケストレーション、3-Tier、PM Gateway、ディスパッチフロー | 講義+確認 | 40分 |
| 第5章 | ai-workspace-standards構造、AGENTS.md/CLAUDE.mdの役割、バリアント概念 | 講義 | 30分 |
| 第6章 | co-consult市場分析ラボ、7フェーズワークフロー、成果物確認 | ハンズオン | 40分 |
| 第7章 | co-deckミニデッキラボ、11ステージパイプライン、ゲート承認 | ハンズオン | 40分 |
| 第8章 | co-consult + co-deck統合パイプライン、結果の共有 | ハンズオン+共有 | 30分 |
| 第9章 | エージェントファイル形式、フロントマター、agent-lifecycle-manager、スペシャリストエージェントの作成 | ハンズオン | 35分 |
| 第10章 | スキルファイル形式、トリガー、skill-lifecycle-manager + skill-creator、カスタムスキルの作成 | ハンズオン | 35分 |
| 第11章 | team-builder 5ステップ、自ドメイン向けエージェントチーム提案 | ハンズオン | 30分 |
| 第12章 | /sync、Git/GitHub PR、フック、CI/CD、dev-sync.ts | 講義 | 25分 |
| 第13章 | 学習ロードマップ、コミュニティ、応用シナリオ、FAQ、全体振り返り | ディスカッション | 20分 |
| 1日合計 | 約6時間40分(休憩除く) | ||
章別講師ノート
第1章: なぜAIエージェントチームなのか?(導入)
本章は、第4章の技術概念に先立って「なぜ複数のAIがチームとして働くべきか」の動機付けを確立します。単一AI vs エージェントチームの比較表を使って違いを実感させ、ハーネス概念を「AIチームを動かすためのフレームワーク」として軽く紹介します。
期待される成果のセクションは、受講者が第6〜8章のラボで体験することのプレビューです。ここで「感覚」を伝え、技術詳細は第4章に委ねます。
受講者アクティビティ 手を挙げて尋ねてください:「AIを単独で使っているとき、複数のAIが仕事を分担してくれたらいいなと思ったことはありますか?」これで第4章への好奇心が高まります。第2章: Claude Desktop Appを始めよう
本ハンドブックのデフォルトツールなので、最も重要なのは受講者が実際にインストールして最初の会話を開始することです。すでにインストール済みの受講者は、サブスクリプション比較とプロジェクト作成ラボに集中できます。
Linuxユーザーにはデスクトップアプリがないため、付録B(Claude Code CLI)を案内してください。この章ではCLI自体は扱いません。
受講者アクティビティ 受講者に「AI学習」プロジェクトを作成させ、このカスタム指示を入力させてください:「韓国語で答えて。初心者に分かりやすく説明して。」このプロジェクトはハンドブック全体で使い続けます。第3章: ラボ環境の構築
まず前提条件チェックリストを確認し、OS別セットアップスクリプトを実行し、インストールを確認します。macOS/Windows/Linuxがすべてカバーされているため、自分のOSで一度デモを行い、他の受講者は一致するスクリプトに従うようにします。
確認ステップ(bun setup-common.ts)が通ることを確認してください。ここで時間を節約すると、第6〜8章のラボがスムーズに進みます。
第4章: マルチエージェントハーネスの概念
本章は以降で使用されるすべての用語(エージェント、スキル、ワークフロー、PM、3-Tier、PM Gateway)のリファレンスポイントなので、ゆっくり進める価値があります。「エージェント=役割を持つ従業員、スキル=再利用可能な手順書」といったアナロジーはホワイトボードでうまく機能します。
受講者アクティビティ ディスパッチフローのSVGを見せ、受講者に隣の人と1分間「PMオーケストレーションを自分たちのチームの仕事にどう適用できるか」について話し合わせます。第5章: ai-workspace-standardsを探索する
L0→L1→L2階層とバリアント概念を伝えてください。初心者には「標準リポジトリからプロジェクトを量産するテンプレートシステム」というアナロジーが効果的です。AGENTS.mdとCLAUDE.mdの異なる役割を表で明確にしてください。
第6章: co-consult — AIコンサルティングの実践(午後のコアラボ)
本章は既存バリアントを使用することに専念します。受講者はPMエージェントとの対話を通じて市場分析プロジェクトを実行します。7フェーズワークフローの各フェーズが自動的に進行する様子と、ゲート2と5でユーザー承認が求められることを強調します。
成果物(deliverables/reports/)が実際に生成されたことを確認させ、「AIは単独ではこれを行いませんでした——エージェントが役割を分担して協力しました」と強調します。
第7章: co-deck — AIプレゼンテーションの実践
11ステージパイプラインでミニプレゼンテーションを構築:テーマ/スタイル選択、ゲート2と5の承認、HTML+PDF成果物。第6章とは異なり、明確な「プレゼンテーション」出力が現れるため、受講者は満足感を得られます。
受講者アクティビティ 受講者に完成したスライドを1枚画面共有させ、比較してテーマ/スタイルの選択が結果にどう影響するかを感じさせます。第8章: co-consult + co-deck統合パイプライン
第6章のレポートを第7章の入力に渡す統合ラボです。「トピック入力→30〜45分で完成デッキ」という全フローを見せ、2つのシステムのエージェント構成を比較させます。
受講者アクティビティ 受講者に第6章のレポートを第7章のco-deckに直接渡して、統合の価値を直接体験させます。第9章: エージェントの作成と修正
エージェントファイル形式(フロントマター、役割定義、Tier)をカバーし、agent-lifecycle-managerを使ってシンプルなスペシャリストエージェントを作成、登録、検証します。初心者には「履歴書(フロントマター)+業務マニュアル(本文)」のアナロジーが効果的です。
受講者アクティビティ 受講者がラボで作成したagents/my-analyst.mdをAGENTS.mdに登録し、bun scripts/agent-lifecycle-audit.tsで検証させます。
第10章: スキルの作成と修正
スキルファイル形式(フロントマター、トリガー、ステップ)をカバーし、skill-lifecycle-manager + skill-creatorでカスタムスキルを作成・テストします。エージェントとスキルの関係には「料理のレシピ」のアナロジーを使用します。
受講者アクティビティ 受講者がラボで作成したskills/my-reviewer/SKILL.mdを登録し、呼び出して動作を確認させます。
第11章: 自分のエージェントチームを構築する
team-builderのAI層5ステップワークフロー(要件インタビュー→ベンチマーク→現状チーム診断→提案生成→承認)とスクリプト層(bun scripts/team-builder.ts)をカバーします。
受講者が事前にドメインを決めていると、インタビューが早く進みます。提案をレビューし、承認を完了させます(必須ゲート)。
受講者アクティビティ 受講者に自分のドメイン(マーケティング、教育、研究など)向けのカスタムエージェントチーム提案を取得させ、承認ステップを完了させます。第12章: ワークフローと自動化を理解する
/sync、Git/GitHub PR自動化、フック、CI/CDの基本、dev-sync.tsの仕組みを説明します。初心者には「自動化=反復作業をシステムに委任する」というアナロジーで始めます。
本章はハンズオンラボではなく概念認識/フォローアップ学習モジュールとして位置付けてください。概念に焦点を当て、CLIに慣れている受講者には付録Bでより深い資料を案内します。興味のある受講者には、任意の課外演習(/syncでサンプルプロジェクトをコミットし、フックの動作を確認する)を提供し、自動化を自己学習の次のステップとして強調します。
第13章: 次のステップ+まとめ
学習ロードマップ、コミュニティ、応用シナリオ、FAQでまとめます。1日全体を振り返り、第1〜12章で構築したもの(プロジェクト、ラボ成果物、エージェント、スキル、チーム提案)をすべて繋げます。
受講者アクティビティ 受講者に第11章のチーム提案を発表させ、「次にこのチームを実際に構築してみたいですか?」と尋ね、継続学習の動機付けを強化します。章別理解度確認問題
各章の終わりに以下の質問をして理解度を確認してください。目標は正解を得ることではなく——受講者が自分の言葉で説明することです。
- 単一AIとマルチエージェントチームの最大の違いは何ですか?(コンテキスト、役割、並列性)
- 「ハーネス」をどう定義しますか?
- 複数のAIが協力することで何が可能になりますか?
- Claude Desktop AppとClaude.aiウェブ版の違いは何ですか?
- Projects機能はなぜ便利ですか?
- Artifactsで何が作れますか?
- 自分のOS用のセットアップスクリプトを実行しましたか?
- インストール成功を確認するコマンドは何ですか?
- なぜ事前インストールが必要ですか?
- エージェント、スキル、ワークフローの違いをそれぞれ1文で説明してください。
- PM(プロジェクトマネージャー)エージェントの役割は何ですか?
- なぜ3-Tier戦略(High/Medium/Low)が必要ですか?
- AGENTS.mdとCLAUDE.mdはそれぞれどのような役割を持ちますか?
- L0→L1→L2階層とは何ですか?
- バリアントとは何ですか?
- co-consultの7フェーズワークフローにおけるゲート2と5は何ですか?
- 4つのチーム編成シナリオの違いは何ですか?
- 成果物はどこに保存されますか?
- co-deckの11ステージパイプラインで、テーマ/スタイルを選ぶのはどのステージですか?
- ゲート2(コンテンツ)とゲート5(サンプルPDF)はそれぞれ何を承認しますか?
- HTMLとPDFの成果物はどのように生成されますか?
- co-consultレポートをco-deckの入力として渡すにはどうしますか?
- 2つのシステムのエージェント構成が異なるのはなぜですか?
- 統合パイプラインの全フローを説明してください。
- エージェントファイルのフロントマターには何が含まれますか?
- Tier(High/Medium/Low)は何を決定しますか?
- agent-lifecycle-managerの5ステップは何ですか?
- スキルファイルのmetadata.triggersの役割は何ですか?
- エージェントとスキルの関係は何ですか?
- skill-lifecycle-managerの6ステップは何ですか?
- team-builderのAI層の5ステップを順に挙げてください。
- なぜ提案承認は必須ゲートですか?
- スクリプト層(
bun scripts/team-builder.ts)は何をしますか?
- /syncコマンドは一度で何を処理しますか?
- なぜGit/GitHubでPR(Pull Request)が必要ですか?
- フックとは何ですか?
- 今日構築したもの(プロジェクト、成果物、エージェント、スキル、チーム提案)をそれぞれ1文で要約してください。
- 次は何を学びますか?
- 自分の仕事に何を最初に応用しますか?