基礎概念の理解から、Claude Code / Claude Desktop App / Antigravity の実習、企業導入戦略、ai-workspace-standards による独自バリアント構築まで
講師資料
このワークショップの内容、対象者、2日間のスケジュール構成、受講後に身につくスキルを一目で確認できる紹介資料です。
本ハンドブック全体を講義形式で進行する際の統合チェックリスト、セクション別時間配分、実習中のデモ専用区間の案内、チャプター別確認問題をまとめました。
実習に必要なツール(bun, git, gh, claude, agy)をOS別スクリプトで一括インストールし、インストールツール一覧とトラブルシューティングまでまとめました。
インストールスクリプトを実行する前に確認が必要なサブスクリプションプラン、アカウント、システム要件、Git/GitHub設定をチェックリストとしてまとめました。
入門コースを修了した受講者が重複学習なしにワークショップを活用できるよう、入門章と本ワークショップの章を対応付けるスキップマップとクイックスタートチェックリストを提供します。
1日目 概念 一般ユーザー -- 基礎概念の学習
なぜ今AIを学ぶべきなのか、AI活用の3段階(ユーザー→活用者→設計者)、ハーネスエンジニアリングの必要性、マルチエージェントの原理、実務での時間短縮事例、本ワークショップのロードマップを読んでモチベーションを確立する。
ハーネスエンジニアリングがなぜ必要なのか、単一エージェントの限界、オーケストレーター・スペシャリスト・ハンドオフ契約というマルチエージェントチームの骨組み、5つのオーケストレーションパターンを読んで理解する。
サブエージェントに何を許可し、何を制限するのか、リスク作業の3段階分類(読取/書込/破壊的)、最小権限の原則、人間承認ゲート、分離と監査ログを扱う。
バイブコーディングでテトリスを作り、単一プロンプトでパックマンに失敗した後、計画・開発・QAの3段階マルチエージェントで再挑戦し、「複雑さが高いほど役割分担の価値は指数関数的に増加する」ことを体験する。
1日目 設計基盤 デザインと多言語運用
1日目 実習 一般ユーザー -- エージェントチームを実際に稼働
サブエージェント(またはそれに相当する作業)の定義・呼び出し・並列実行・自動化を、Claude Code、Claude Desktop App、Antigravity CLI、Antigravity Desktop、Codex CLI、Codex Desktop Appの6つのツールで並べて参照する。
Claude Desktop App/Codeでのサブエージェント定義(.claude/agents)、Agent(Task)ツール呼び出し、Agent Teams並列実行、フック自動発火を扱う。
Antigravity Desktop/CLIでの動的サブエージェント生成、Agent Manager、/goal・/agentコマンド、セッション間並列実行を扱う。
Codex Desktop App/CLIにはネイティブなサブエージェントがない — PMがagents/<name>.mdを役割コンテキストとして読み込み順次役割を切り替える方式、セッション間並列、フックなしのプロンプト自己強制を扱う。
レビュアー・ライターサブエージェント、パイプライン、Agent Teams並列実行、モデルティア比較までClaude Desktop App/Codeで実際に体験する。
同じAGENTS.md仕様をAntigravity Desktop/CLIで自然言語ゴールで実装する実習。
同じAGENTS.md仕様をPMがagents/<name>.mdの役割コンテキストとして読み込み、順次役割を切り替える方式でCodex Desktop App/CLIで実践する実習。
バリアント開発ツール型モデルを実装するai-workspace-standardsリポジトリの構造、コアドキュメント5種、13のバリアント、セッション開始チェックリストとスキャフォールディングの流れを確認する。
ワークスペースクローン、bunインストール、new-project.tsの使い方、セッション開始チェックリストを素早く参照する。
co-consultで市場調査コンサルティングプロジェクトを進行し、co-deckでプレゼン資料を自動生成する。
2日目 概念 IT専門家 -- アーキテクチャ深化と戦略
全社サービスチケット型運用とバリアント開発ツール型運用を並べて比較し、それぞれの強みと限界を読む。
デプロイとSSOT(L0→L1→L2→L3の4階層)体系を扱う。
エージェント・スキル・スクリプトのライフサイクル管理手順を扱う。
AGENTS.mdの構造、作成ガイド、ツール別実装マッピングを扱う。
Layout Reconstruction、プラットフォームパリティなどアーキテクチャの実践動作を扱う。
未実装の高度化ロードマップを扱う。L3プロジェクトアップグレードは12章で独立して扱う。
様々なドメインで実際に使われているマルチエージェントワークフロー事例 -- コードレビュー・市場調査・プレゼンテーション・課題トリアージ・PR検証 -- とパターンカタログ、選択ガイドを扱う。
既存のL3プロジェクトを最新テンプレートにアップグレードする手順(upgrade-project.ts)とファイル処理5分類、安全装置を扱う。
2日目 実習 IT専門家 -- 新規作成と昇格
co-retailという新規バリアントをフェーズAプロトタイプとしてゼロから設計する。create-l3-scaffold.tsでエージェントチーム構成を作る過程を体験する。
co-retailプロトタイプを正式なtemplates/バリアントに昇格させるパイプラインをステップごとに追う。PROMOTION_CHECKLISTとreconcileプロセスを確認する。
variantテンプレートがステージ・RACI・判断ゲートをデータとして宣言する実行可能SOP構造(ADR-0083・0084)。4つの中核グループ、governed/core等級、検証コマンドを学ぶ。
自分が繰り返している実際の作業を一つ選び、概念からガードレール・サブエージェント実装・検証まで最初から最後まで自分で設計する仕上げ実習。
共通参考
同じルールをフック・プロンプト・スキルの三層に掛ける3層強制モデル、編集前のファクトを強制するGateGuard、検証スクリプト群とfail-closed vs warnの区別、プラットフォーム別の強制力の違いとブロック時の対処法。
Decision Recordと証拠台帳、スペックレジストリの関連性ゲートとE1–E5免除、gitで追跡されるガバナンスバックログチケット、リンクのないADRを捉える反映検証まで — 決定を一級資産として扱う全過程。
スキル・エージェント・ADRの関係を機械が読むグラフとして導出するシステム。データ原典、ノード/エッジのスキーマ、関係語彙10種、3層モデル、生成・検証パイプラインと実務ワークフローを詳しく扱う(ADR-0060)。
.hermes/skills/ミラー、AGENTS.mdの単一ソース、ユーザーが管理する信頼設定、運用前の検証を扱います。
L0〜L3の配布とアップグレード、バックポート、upstream要求、チケット、co-workspaceを一枚の図で読む方法を扱います。
同じマルチエージェントチーム概念が4つのツールでそれぞれどのように異なって実装されているか、フック・並列実行・分離方式の違いを比較する。
オーケストレーター・ハンドオフ・SSOT・ティア・L0/L1/L2・バリアント・スキャフォールディング・フォークモデルなど、ハンドブック全体で繰り返される用語を定義とともにまとめた。
実習中によく遭遇する問題(順次呼び出しの失敗、フック不発、認知的オーバーロード、スキャフォールディングエラー、コスト・タイムアウトなど)を症状別にまとめ、原因と解決策を紐付ける。