Master Vibe Coding with AI Coding Agents：Claude Code...
をテンプレートにして作成
[
トップ
] [
新規
|
一覧
|
単語検索
|
最終更新
|
ヘルプ
]
開始行:
「[[.NET 開発基盤部会 Wiki>http://dotnetdevelopmentinfras...
-戻る（[[テキスト生成系（Transformer系）]]、[[生成AIを活...
--[[LLM Engineering：Master AI、Large Language Models＆Ag...
--[[The Complete Agentic AI Engineering Course (2025)]]
--[[オリジナル・コンテンツ（イキナリLLMからスタートしたい...
--Master Vibe Coding with AI Coding Agents：Claude Code...
--[[オリジナル・コンテンツ（イキナリLLMコーディング・エー...
*目次 [#z69a6f26]
#contents
*概要 [#z2f51307]
**Week 1 [#bd9f2ba0]
Vibe Coding for fun and profit（バイブ・コーディング）
-Agentic Coding（エージェント型コーディング）
-Cursor、GitHub Copilotなどの主要ツールの紹介
-MVP（実用最小限の製品）開発などのプロジェクト
--コアスキル
---Agentic Coding Landscape~
全体像、基礎、コンテキストの理解。
---Foundations AGENTS.md Context~
エージェント型コーディング向けの専用コンテキストファイル...
--プロダクト
---Cursor
---GitHub Copilot
---Codex
---Antigravity
--プロジェクト
---Project 1：YOLO
---Project 2：Commercial MVP
***Day 1 [#aaa13429]
1-7日
+コースへようこそ：Cursor AIを使った3Dゲーム制作：
--Cursorで「矢印キーで移動し、スペースキーで発砲して、1台...
--すると自動でコード（index.html）を生成（Cursorは以前サ...
--ポイントは単純なコード作成に留まらず、ファイル生成や、N...
+Cursor AI Agentで一人称視点シューティングゲームを構築す...
--生成物を分析・動作確認し、プロンプトを修正し得て動作を...
--その中で「Zero-shot（ゼロ・ショット）」「Ralph Loop（ラ...
+Agentic Coding（エージェント型コーディング）のための欠か...
--コース誕生のきっかけ（カルパシー氏のポスト）、
--対象となる受講者
---すべての人向け、意欲あるエンジニア・初心者～シニア・ベ...
---コース修了後に得られる成果
---コースのスタンス（誇大広告（ハイプ）への警戒）について...
+講師紹介＆3週間AI Coderコースのロードマップ：
--講師（Ed Donner）の経歴と実績
--本コースの位置づけ「AI（エージェント）を使ってコードを...
--3週間のカリキュラム構造。
+Vibe Coding、Agentic Coder、そしてClaude Codeのようなコ...
--「バイブ・コーディング（Vibe Coding）」の誕生とこれまで...
--曖昧な用語の整理（Vibe Coder、Vibe Engineer、Agentic Co...
--3つの対話I/F（IDE型、エディタ拡張型、CLI型。
--結論と心構え（この分野の進化スピードは凄まじく、毎日膨...
+AIコーディングの8段階：ChatGPTからAgent Orchestrationま...
++AIをコーディングに活用するレベルは、初級から上級まで以...
---ステージ1：インテリセンス的スニペット生成：ChatGPTとの...
---ステージ2：ChatUIを用いたコード生成：IDEのサイドバーに...
---ステージ3：YOLOモード（エージェントの結果を一括受け入...
---ステージ4：エージェントへの委託＆検収１：意識の対象が...
---ステージ5：エージェントへの委託＆検収２：IDEからCLIに...
---ステージ6：マルチ・エージェント１：CLI上で複数のエージ...
---ステージ7：マルチ・エージェント２：10体以上のエージェ...
---ステージ8：マルチ・エージェント３：役割を持ったマルチ...
++ステージとアウトラインのマッピング
+++第1週：ステージ2〜4
+++第2週：ステージ5
+++第3週：ステージ6〜8
+++企業の開発における最適解はステージ5〜6
++利用コスト
+++コース自体は無料で完結可能
+++推奨されるプラン：初期はCursorの無料期間を利用し、第2...
+++自己責任の原則：費用の管理や解約の判断は必ず受講生自身...
+まとめ：これから始まる、あなただけのAgentic Coding Journey
++変化の激しい環境への心構え
++本コースha、全員が同じコードを実行して同じ結果を得るわ...
++講師によるサポートとコミュニティへの参加（Q&Aやメール、...
***Day 2 [#k6579d47]
8-13
+LLMの仕組み：トークン、メモリ、推論を解説：
--大規模言語モデル（LLM）の基本
--LLM単体 と LLMを組込んだAIアプリケーションの違い
--AIアプリケーションでインテリジェンスを疑似体験させるト...
---トリック1：記憶の錯覚（Ilusi Memori）：[[チャット履歴>...
---トリック2：推論・思考（Penalaran / Pemikiran）：[[Few-...
+ツール、ループ、そしてAI Agentの定義：
--AIアプリケーションでインテリジェンスを疑似体験させるト...
---トリック3：ツール（Tools / Tool Calling）
---トリック4：ループ（Loop）
--AIエージェントの最新の定義~
「目標を達成するために、ループ（繰り返し）の中でツールを...
+Context Engineering：System Prompt、Context Window、AGEN...
--コンテキストエンジニアリングとは以前は「プロンプトエン...
--入力コンテキストを構成する主要要素：システム・プロンプ...
--Contextウィンドウには最大サイズがあるのでコンパクション...
+AGENTS.mdを極める：コーディング・エージェントのためのCon...
--AGENTS.md とはコーディング・エージェント用のシステム、...
--配置ルールは、ルートとサブ・ディレクトリに配置できる。...
--効果的な記述のコツ：
---簡潔、明確、断定的に、プロジェクト全体目標と成功基準、...
---長文で冗長、過剰、防御的（数多くの例外ケース）
--2025年型アプローチ vs 2026年型アプローチ
---2026年型の思想（自律・手放し）：研究分野ではプログレッ...
---2025年型の思想（管理・最適化 ※推奨）：実用的な大規模プ...
+AIコーディング・ワークフローの進化：YOLOからRalph Loops...
--2025年のマインドセット（低い〜中程度の信頼度）：マイク...
--2026年のマインドセット（高い信頼度・自律駆動）：YOLO、...
--YOLOは元々は英語の古い格言的な表現（「人生は一度きり」...
--賢く見えないシンプソンズのキャラクター（[[Ralph Wiggum>...
+ハイプ（過度な期待）を超えてLLM（現在の主要モデル）を比...
--AI Coding Agentsのハイプ（過度な期待）に流されないこと...
--（Artificial Analysis（生成AI比較サイト））で冷静に主要...
--LLMエージェントのブレイクスルーは
---推論技術（Reasoning techniques）をベースにしたツール使...
---人手の[[Chain of Thought（CoT）等のPE>LLMのPE#ffa8b1bb...
***Day 3 [#kbc0aee4]
14-20
+Cursor、GitHub Copilot、Codex、そしてAgentic Vibe Coding...
--講義の目的と心構え（バイブ・コーディングの原則）
---ツールの選択は自由： 紹介するツールをすべて使う必要は...
---結果は人それぞれ： 使用するモデル（無料版や安価な版な...
---イライラしない（最も重要）： 的外れな出力には「焦らず...
--ハンズオン：環境構築とプロジェクトの準備
---Cursorの起動とNode.jsのインストール
---GitHubからのプロジェクト複製（Gitクローン）と切り替え
+AGENTS.mdファイルとVibe CodingのためのCursor設定を探索：
--Cursorの基本操作（ショートカットキー）
---左サイドバー（ファイルシステム）の開閉：Mac：Command +...
---右サイドバー（エージェントチャット）の開閉：Mac：Comma...
--AGENTS.md（要件定義書）ファイルの役割と構成
---ビジネス要件（Business Requirements）セクション~
・Webアプリとして動作するカンバンボードのMVP（最小限の試...
・機能はシンプルに洗練された美しいUIを最優先し、起動時に...
---技術的詳細（Technical Details）セクション~
・技術スタック：Next.js（frontend サブ・ディレクトリ内）。~
・データの永続化（保存）やユーザーログインは実装しない。
---カラースキーム（Color Scheme）：デザインに使用する好み...
---戦略（Strategy）：フェーズごとの計画策定、環境構築、UT...
---コーディング標準（Coding Standards）~
・最新バージョンのライブラリ使用、過剰な設計の禁止（シン...
・「絵文字は一切使用禁止（No emojis ever）」（エラーの原...
--AGENTS.md を作成・運用するコツ
---曖昧さを排除し、正確かつ肯定的な表現で明確に指示を出す。
---重要なポイント（「シンプルにする」など）は、複数のセク...
---最初は最小限の記述で実行し、AIの出力結果を見ながら、失...
--Cursorのエージェント設定（実行モードの選択）~
設定メニュー（Mac：Command + Shift + J / Windows：Ctrl + ...
---YOLOモード（Run everything unsandboxed）：すべての処理...
---安全モード（Auto run in sandbox / Ask every time）：フ...
+YOLOモードでCursor AI Agentを使ってKanbanアプリを構築：
--開発の準備とプランニング
---画面配置とモデル設定：作業スペースを広く確保するためエ...
---プランニングの実行：エージェントを「plan（計画）」モー...
---デフォルトで読み込まれる設定ファイル AGENTS.md を基に...
--自動ビルドの実行（YOLOモード）
---自動開発の開始：生成された計画書のレビューをスキップし...
---自律的な開発プロセス：AIがファイルの作成（.gitignore ...
---ユーザーはコンテキスト（メモリ）使用量が徐々に増えてい...
--アプリケーションの動作確認
---自動起動と初期機能：ビルド完了後、アプリ（Next.jsベー...
---初期状態の評価：タスクカードの追加、削除、列名の変更、...
---ただし、画面下部にNode関連のエラー（赤アイコン）が表示...
--フィードバックによる反復改善
---追加指示の提示：AIに対し、「エラーの修正」「ドラッグ＆...
---改善結果の確認：デザインに指定通りの紫と黄色が取り入れ...
+VS CodeでGitHub Copilotを使ってKanbanボードを構築：
--プロジェクトの準備とディレクトリの変更（既存の Kanban ...
--[[GitHub Copilot と VS Code の導入>GitHub#x1616130]]：G...
--GitHub アカウントと連携し、ショートカットキー（Mac：Com...
--実装の開始と進行：エージェントを「常に許可（YOLOモード...
--途中でサーバー起動のディレクトリを間違えるなどのバグが...
--手動でローカルサーバーを起動（npm run dev）してブラウザ...
---しかし、「カードの削除（Delete）機能」が動作しないとい...
---コーディング・エージェントの「原因を検証せず、勝手に推...
---「最初に問題を再現」「再現できたことを証明」「根本原因...
---AIエージェントにデバッグを依頼する際は、「直した」とい...
+OpenAI Codex VS Code拡張：ゼロショットでKanbanアプリを構...
--OpenAI CodexはCLIツールとしての側面を持つが、今回はIDE...
--「agent full access」（YOLOモード）、「GPT 5.5」、「rea...
--同様に、アプリケーションの動作確認（自動起動と初期機能...
+Antigravity IDEとGeminiでKanbanアプリを構築：
--開発環境の移行と準備：4つ目のツールである「Antigravity...
--Antigravityの概要と特徴：antigravity.google からダウン...
--利用モデル：デフォルトでは Gemini が提示されるが、Anthr...
--設定：Lintエラーの自動修正機能（Agent Autofix lints）を...
--設定ファイルの配置：Antigravityは業界標準になりつつある...
--ルールの移行：その中に strategy.md を作成し、中身のコン...
--実行結果と検証：AIはブラウザ自動化ツールの Playwright ...
--成果物の評価：完成したKanbanアプリは、デザインが新鮮か...
+Cursor vs GitHub Copilot vs Codex vs Antigravity：最終評...
--カード作成機能の改善をGemini（Google Antigravity環境下...
--「Codex」（Codex IDEで動作するモデル）をトップ（勝者）...
--主要なAIコードエディタ（エージェント）の共通点はどれもU...
***Day 4 [#x3f926f0]
21-26
+YOLOモード：IDEでのAgentic Codingに適したLLMの選び方：
--ツールそのもの（IDE）と、裏側で動くAIモデル（LLM）を区...
--各IDEはプランに応じてモデルを切り替えることが可能（推奨...
--Cursor：AnySphere/Composer、GitHub Copilot：Claude Haik...
--ツール（IDE）の使い心地の差はわずかであり「どのLLMに意...
--ただ、実際ヤッてみると既定のLLMも（頻繁に）更新されてい...
--小型モデルでのYOLOは破綻リスクが高い。ステップ毎に差分...
+Vibe Codingを成功させる5つの原則：
--「5大原則（Be the Boss）」：AIを自律的な意思決定者とし...
---AGENTS.md（指示書）の充実：「要件（仕様）」「スタイル...
---小さく始める：最初から複雑なアプリを狙わず、まずは最も...
---段階的に進める（インクリメンタル）：各ステップで常にテ...
---油断しない（怠けない）：初期にうまくいくとAIを過信しが...
---泥臭く検証する（異議申し立てと証拠の要求）：AIが「修正...
-- 混乱や失敗：「フラストレーションや壁にぶつかることもプ...
---AIに仕事を丸投げするとスキルが身につかず、将来のフラス...
---AIに質問を投げかけ、何が起きているかを理解してシニアへ...
---AIは時に的外れで、自信満々に間違え、根本解決ではなくパ...
---コードを書く喜びは減るが、苦手分野を克服し、システム全...
+責任あるYOLOコーディング：OpenRouterでAIプロジェクトをセ...
--YOLOモードには楽しさがある反面、大きなリスクやトレード...
---ジュニア開発者の学習への悪影響（Anthropicの調査）：AI...
---OSSコミュニティ（Jellyfin）のAI利用ポリシー：会話にお...
---AIをアシスタントとして使うのは自由だが、最終的なコード...
--制作プロジェクトの概要
---目標：AIエージェントを活用し、自分自身のキャリアに関す...
---開発のコツ：問題に直面した場合は、機能を削ぎ落として「...
--OpenRouter（APIプラットフォーム）のセットアップ
---複数のLLM APIを一つのアカウントで一元管理できるOpenRou...
---アカウント作成後、「Keys」メニューからAPIキーを発行、...
---無料：「https://openrouter.ai/settings/privacy」→「か...
---有料：「Credits」からチャージが可能。OpenRouterは最低2...
+YOLOモード：CursorでGPT Codexを使ってNext.jsウェブサイト...
CursorのYOLOモードを使用し、プロンプト一つでローカル環境...
--プロジェクトの初期設定
---フォルダ作成：Site という名前の新規プロジェクトフォル...
---環境変数ファイルの作成：.env ファイルを作成し、OpenRou...
---（このOpenRouter（またはOpenAI）は、Cursorのエージェン...
---Git対策：.gitignore ファイルを作成し、セキュリティのた...
--ソースデータの準備
---自身のLinkedInのプロフィールページをPDF（LinkedIn.pdf...
---プロジェクト・ディレクトリに配置する（PDF化できない場...
--Cursorの設定変更（YOLOモードの設定）
---Usage Summary：常に表示（Always）に設定し、モデルの使...
---Auto Run (YOLO設定)：ステップごとの承認を省くため、Run...
---モデルの選択：高品質な出力を得るため、より強力なモデル...
--エージェントへの指示とサイト構築
---以下の要件をプロンプトで指示し、エージェントに自動構築...
「Next.jsを使用し、LinkedIn.pdfを元に、エンタープライズ...
Please build me a Professional Website running locally. ...
--エラー対応と完成したサイトの確認
---エラー発生と修正：~
・ターミナルで npm run dev を実行し、ブラウザ（localhost:...
・エラー文をそのまま解説なしでCursorにペーストして再投入...
---完成したサイトのレビュー：~
・デザインは「エンタープライズ×エッジ」のテーマに沿った、...
・LinkedInから抽出された自己紹介や経歴タイムライン、ポー...
・プロフィールから自動取得した本物のメールアドレスへのリ...
・エージェントへのシンプルな指示（と1回のエラー修正）だけ...
+OpenRouterとVibe CodingでAI Digital Twinチャットを追加：
--バックアップとバージョン管理の重要性
---新たな機能実装（YOLOコーディング）を行う前に、進捗を失...
---本来は Git を使用して適切なcommitを行うべきであり、Git...
--AIエージェントへの機能追加指示
---AIエージェントに対し、経歴について回答できる「デジタル...
---技術的な仕様として、OpenRouter のAPI（APIキーは .env ...
--実装結果の検証と「バイブコーディング」の課題
---npm run dev でローカルサーバー（Localhost 3000）を起動...
---UIは一般的なチャット画面とは異なるユニークなデザインで...
---一方で、画面起動時に不自然にスクロールする挙動や、一部...
--今後のステップ（リファクタリングと改善）
---検証なしで進めるMVP（最小限の試作品）開発としては機能...
---ソースコード（src/app/api/chat/route.ts）から、現状の...
+チュートリアル、Opusによるコードレビュー、クロスモデルコ...
--チャットUIの改善とトラブルシューティング
---課題と解決策：チャットのスクロール問題やプロンプトの修...
いいえ、うまくいきません。別の方向性で進めませんか？この...
No it's not working. Please can we go a different direct...
---教訓：AI開発で泥沼にハマった（同じミスを繰り返す）時は...
--AIによるチュートリアル作成と学習
---ローカル環境（npm run dev）での動作確認後、初心者向け...
それでは、フロントエンドコーディングの完全な初心者向けに...
Please now write me a comprehensive tutorial in markdown...
---AI自身にコードを客観的に評価させると同時に、人間の開発...
--異なる複数のLLM（AIモデル）によるクロスレビュー
---アプローチ：開発を担当したCodexから、より強力なモデル...
---メリット：環境変数（.env）の扱いに関する潜在的なリスク...
--総括と次のステップ
---今回の手法は「YOLOコーディング（vibe coding）」に「チ...
---開発がうまくいかない時は「徹底的にシンプルにする（simp...
***Day 5 [#oe5ceb4f]
27-33
+Karpathyが語るVibe Codingと商用MVP構築のルール：
--「バイブコーディング（Vibe Coding）」をビジネスに活かし...
--元OpenAIの著名な研究者アンドレイ・カーパシー（Andrej Ka...
---バイブコーディング誕生：LLM（Cursor Composer や Claude...
---急激な進化への困惑：エージェント、プロンプト、MCP（Mod...
---カーパシー自身の開発スタイルも、かつての「手動補完80%...
--エージェント開発における重要な気づき
---過剰なハイプへの警戒（Watch it like a hawk）：「IDEは...
---不屈の精神と生産性の「拡大」：エージェントは疲弊せず、...
---面倒な定型業務やエラーの泥沼から解放されるため、コード...
---スキルの退化（Atrophy）と粗悪なコード（Slop）の氾濫に...
--バイブコーディングを成功させるための実践ルール
---開発者がジュニアであれシニアであれ、成功のために共通す...
---事前準備の徹底：AGENTS.md などのファイルに、仕様、開発...
---段階的な開発と検証：常にシンプルに始め、少しずつ機能を...
---怠惰にならない：AIの出力を鵜呑みにせず、常に根拠（エビ...
---フラストレーションの管理：AIが同じエラーを繰り返すなど...
--開発者の役割
---ジュニアエンジニア：AIを「知識はあるが先走って失敗する...
---シニアエンジニア：コーディングから解放された分、より大...
--結論
---YOLOに対する過度な期待は捨て、メリットとデメリットを正...
---タカのように監視し（Watch it like a hawk）、一歩一歩着...
+Webアプリ基礎：フロントエンド、バックエンド、API、Docker...
--フロントエンドとバックエンドの基本
---フロントエンド：~
・ユーザーのブラウザ（ChromeやSafariなど）側で動作する部...
・LLMやコーディングエージェントはフロントエンド構築が得意...
---バックエンド：~
・サーバー側で動作する部分。ビジネスロジック、データアク...
・LLM（大規模言語モデル）の呼び出し、API連携、パスワード...
---本日のプロジェクトでは、~
・フロントエンドにJavaScript、バックエンドにはLLM連携で最...
・ユーザーの操作結果を処理するフロントエンドはAPIコールを...
--Dockerの基礎
---Dockerは、PCの内部に隔離された仮想的なコンピュータ（環...
---主要な3つの概念：Dockerは、Dockerfileを使ってDocker Im...
---インストール：公式サイト（docker.com）から「Docker Des...
+GitHub CopilotとFastAPIでフルスタックプロジェクトをセッ...
--開発環境の準備（GitHub Copilot と VS Code）
---GitHub Copilot の利用：前回の「Cursor」に続き、今回は...
---ローカル環境のセットアップ：教材リソースにあるリポジト...
---VS Codeのターミナルで git clone を実行。Gitクローンし...
--既存リポジトリから開発を始める理由
---ゼロからの構築（Scaffolding）はAIエージェントにとって...
---今週前半に構築した「Kanban（カンバンボード）のフロント...
--プロジェクトの要件と実装ミッション
---既存のフロントエンド（純粋なデモ画面）に、バックエンド...
---コーディング・エージェントを活用するだけでなく、アプリ...
---MVPの制限事項：単一ユーザーのサインイン（ID/パスワード...
--技術選定とファイル構成
---フロントエンド：Next.js（既存のカンバンUIを流用）
---バックエンド：Python (FastAPI)
---パッケージマネージャー：uv
---データベース：SQLite（ローカル）
---AI API：OpenRouter（.env ファイルにAPIキーと使用モデル...
---インフラ：すべてをDockerコンテナにパッケージングする。
--プロジェクトのファイル構造
---frontend/：既存のKanban MVPが格納されている。
---backend/：空の状態（agents.mv のみ）。
---front scripts/：空の状態。
---.env / .gitignore: 環境変数（APIキー等）とGit除外設定。
---AGENTS.md：プロジェクトの要件、技術選定、コーディング...
---docs/plan.md: 次のステップで確認する、計画と実行のため...
+GitHub Copilotでステップバイステップ構築：計画と足場作り：
--全体方針と開発哲学
---計画と制約（ガードレール）の重要性：ハイレベルな計画を...
---段階的なcommitと検証：一気に10ステップを進める（YOLOモ...
--プロジェクトの10段階計画（ハイレベルプラン）
---計画（Plan）：本プランの具体化（チェックリスト、テスト...
---足場固め（Scaffolding）：Docker、FastAPI（バックエンド...
---フロントエンドの追加：デモ用のKanbanボードを表示・サー...
---ダミーのユーザー・サインイン機能の実装。
---DBモデリング：スキーマの構築、ドキュメント化、ユーザー...
---バックエンドAPIルートの追加：Kanbanの読み書きルート作...
---フロント・バックエンドの結合: フロントからバックエンド...
---AI接続：OpenRouter経由でAIを接続し「2 + 2」のような単...
---AI機能の拡張：Kanbanボードのデータと質問をAIに送り、回...
---チャット・ウィジェットの追加：フル機能のAIチャットを搭...
--実際の進行
---計画（Plan）~
・計画の具体化の実行：AI（GPT 5.2モデル）に対し、「まだ作...
AGENTS.mdと計画書をよく読んで、ご質問があればお知らせく...
Please revie AGENTS.md and the plan, and let me know if ...
・AIから確認があり、
AGENTS.mdとdocs/PLAN.mdを確認しました。作業開始前に質問...
Reviewed AGENTS.md and docs/PLAN.md. Questions before st...
1. PLAN.mdに詳細なチェックリスト、テスト、成功基準を追加...
1. Do you want me to enrich PLAN.md with detailed checkl...
2. フロントエンドのAGENTS.mdは、計画の充実化の一環として...
2. Should I create the frontend AGENTS.md as part of the...
3. 「包括的なテスト」に関して、最低限のカバレッジ目標や...
3. For "Comprehensive tests," do you have minimum covera...
・人間がそれを承認。
1. はい、PLAN.md を作成してください。
1. Yes entich PLAN.md
2. はい、フロントエンド用の AGENTS.md をすぐに作成してく...
2. Yes create. AGENTS.md for frontend right away
3. 単体テストのカバレッジは最低 80%、かつ堅牢な統合テス...
3. 80% unit test coverage minimum, and robust integratio...
パート 1 に進んでください。
Go ahead with Part 1
・AIは指示通り、各ステップにチェックボックスや成功基準を...
PLAN.mdには、各ステップ1-10にチェックリスト、テストリス...
・人間がレビューして承認。
確認済み。承認済み。ステップ2へ進みます。
confirmed. Approved. On to step 2
---足場固め（Scaffolding）~
・本フェーズの実行を許可したところ、AIは「実装完了」と報...
確認後、パート3に進みます。パート2はご自身でテストされま...
Confirm and I'll proceed to Part 3. did you test part 2 ...
・「自分でテストしたのか？」と問い詰め、サーバーを起動し...
徹底的にテストを実行してください。サーバーを起動し、正常...
please run tests thoroughly. Bring up the server, make s...
・過程で、uvではないPKGマネージャを使用するなど不信感を誘...
---結論（ユーザーへのアドバイス）~
・AIが提示する「できました」を鵜呑みにせず、立ち止まって...
・初心者にとっては、AIがどのように工程を進めているか観察...
+GitHub Copilot、Docker、FastAPIでKanbanアプリを構築：
--パート2の検証と完了
---環境構築の確認：AIがPKGマネージャのuvを使用せずpipを使...
requirements.txtが必要な理由を説明していただけますか？uv...
can you explain why you needed a requirements.txt -I tho...
uvには依然として依存関係リストが必要です。コンテナ内のuv...
uv still needs an input list of dependencies. I used req...
---動作確認：実行スクリプト（start_mac.sh）の権限エラーを...
この部分を自分でテストする方法を教えてください
please tell me how I test this part myself
（エージェントに依るテスト方法に関する回答）
---成功基準の評価：テストカバレッジ80%の達成や他OSでの検...
パート2が完了して良かったです。パート2の成功基準はすべて...
that's good part 2 is done. Are all the success criteria...
完全には達成されていません。コンテナの起動、ルーティング...
Not fully. We verified container start, routes, and test...
PC/Linuxについてはスキップしても構いません。すべてのルー...
I'm good to skip the PC/Linux - and I can confirm I've t...
--パート3：フロントエンド（カンバンボード）の実装
---カバレッジの罠：AIは「テストカバレッジ80%」という指示...
---画面の確認：カンバンボード（Kanban Studio）の静的フロ...
---指示の修正：パート4へ進む際、AIに対し「無意味なテスト...
承認済み - パート4へ進みます。ところで、今後は、テストカ...
approved - move to part 4. By the way, going forwards, p...
--パート4：認証機能の追加
---機能テスト：デモ用のユーザー名とパスワードでサインイン...
---差分（Diff）の承認：変更された多くのファイル差分（緑と...
--Gitによる進捗の保存と次への準備
---ローカルcommit：今後データベースを扱うパート5という「...
---開発者がAIエージェントの過剰なテスト作成癖をコントロー...
+GitHub CopilotでKanbanアプリ構築：ドラッグ＆ドロップのデ...
--データベース設計の承認とPart 5・6の完了
---Part 5：AIが提案したDB設計（DDL）を確認し、JSON保存よ...
---Part 6：バックエンドとフロントエンドの連携前の段階まで...
--フロント・バックエンドの連携と不具合修正（Part 7）
---開発における最も重要なフェーズ。AIがテストの失敗とリラ...
---動作確認とバグ：ローカルサーバー（localhost:8000）を起...
サーバーを起動し、ユーザーとしてログインし、ボードにいく...
I started the server, I logged in as the user, I made so...
あなたの理解は間違っていません。現在、フロントエンドはま...
You didn't misunderstand. Right now the frontend still u...
パーシステンスは機能していますが、ドラッグアンドドロップ...
the persistence is working, but the drag and drop seems ...
---AIによるデバッグ: バグ修正をAIに指示したところ、AIは30...
今テストしてみましたが、すべて正常に動作しています。素晴...
I've just tested it and everything is working. It's work...
承知いたしました。これで作業を終了いたします。ご希望であ...
Understood. I'll stop here. If you want, I can review th...
---ドラッグ＆ドロップとデータの永続化が完全に動作すること...
--Contextウィンドウ対策と次への準備（Part 8へ）
---コンテキストの肥大化問題：開発がPart 7まで進んだことで...
---チャットのリセット：効率的な開発を維持するため、現在の...
---事前にこれまでの設計方針や進捗を PLAN.md（計画ファイル...
PLAN.mdが、あなたが下した設計上の決定事項を含め、すべて...
please confirm that PLAN.md is up to date with all the l...
---Gitに最終commitを終えた後、新規チャット（New Chat）を...
+AIアシスタントKanbanアプリ完成：GitHub Copilot、OpenRout...
--開発プロセスの進捗（パート8〜10）~
---新しいチャットセッション（コンテキストがクリーンな状態...
チャットの会話をリセットしたことで最初はサーバーの起動方...
> パート8を開始する前に、まずAGENTS.mdを読んでからPLAN.m...
Please read AGENTS.md then read the PLAN.md and let me k...
AGENTS.mdと計画書を確認しました。パート8の前に質問があり...
I reviewed. AGENTS.md and the plan. Questions before Par...
1. パート8の「2+2」統合テストでは、完全にモック化（実際...
1. For the Part 8 "2+2" integration test, do you want it...
2. 新しいAIエンドポイントは、/api/ai、/api/chat（または...
2. Should the new Al endpoint be under /api/ai or /api/c...
3. OpenRouterのベースURLは、環境変数などで設定可能にする...
3. Do you want the OpenRouter base URL configurable (e.g...
> 1. 実際には、モック化せずにOpenRouterまでアクセスし、...
1. Actually I want it to go all the way to OpenRouter-no...
>サーバーの起動、停止、テストを効果的に行う方法について...
If seems you learned some details about how to start, st...
パート8のチェックリストのステータスを更新し、PLAN.mdにテ...
Updated Part 8 checklist status and added a testing note...
---パート8（OpenRouterの統合）：モック（擬似データ）を使...
この部分の会話の状況は共有されなかった。
---パート9（リアルデータのテスト）：AIが当初モックテスト...
この部分の会話の状況は共有されなかった。
---パート10（UIの実装と動作確認）：AIアシスタントのチャッ...
---実機デモの成功：（IDEではなくアプリの）チャットで「プ...
画面上のカンバンカードが自動で動き、そのデータがバックエ...
--現状の課題と今後の「課題（アサインメント）」
---アプリの最小限の機能（MVP）は完成したものの、コードの...
---メインコード（main.py）の肥大化：モジュール化、スパゲ...
---第1週目の課題: ベースアプリを元に拡張を各自で行う：リ...
--「バイブ・コーディング」の総括と今後の展望
---アンドレイ・カルパシー氏の言葉：「2024年12月頃を境に、...
---第1週目の振り返り：「楽しむためのバイブ・コーディング...
---第2週目の予告：単に雰囲気で書く「バイブ・コーディング...
**Week 2 [#z586823e]
Vibe Engineering as a professional（バイブ・エンジニアリ...
-Claude Code や Open Codeを使用したCLIコーディングの深掘...
-MCP（Model Context Protocol）、プラグイン、チーム開発、...
-SaaSプラットフォームを構築する大規模なプロジェクト。
-プロダクト
--Claude Code、Open Code、others（Codex、Cursor、GitHub C...
主に2025〜2026年に流行した端末ベースのAIコーディング・エ...
--Commands Checkpoints Ralph Loops~
Claude Codeを使った自律型AIエージェントのループ手法
-コアスキル
--エージェント単体
---MCP
---Skills
---Plugins
--マルチ・エージェント化
---Workflows
---Team Debugging
-プロジェクト
--Project 3：SaaS Platform
***Day 1 [#x8b66938]
34-39
+Pro Week へようこそ：Vibe Coding から Vibe Engineering へ
--プロ向けの2週の幕開けとコアツールの導入
---応用・発展フェーズへの移行：基礎的なスキルを習得した第...
---Claude Codeの導入：今週のプラットフォーム・プロダクト...
--AIコーディングの進化と今週のアプローチ
---進化のステージ：AIコーディングは、単なるChatGPTの利用...
---開発スタイルとマインドセット：ミッションクリティカルな...
---一方で、リスク許容度が高いMVP（最小限の試作品）やボイ...
---どのような手法であれ、コードの品質と動作に対する最終的...
--「バイブ・エンジニアリング（Vibe Engineering）」への昇華~
エンジニア・ライターのSimon Willison氏のブログ記事を引き...
---バイブ・コーディングとの違い：~
・「バイブ・コーディング（Vibe Coding）」：プロンプト主導...
・「バイブ・エンジニアリング（Vibe Engineering）」は、熟...
---プロのAIエンジニアリングに求められるスキル：~
・厳格なプロセス：事前の計画、綿密なドキュメント作成、自...
・高度なマネジメント・レビュー力：LLMに自身の成果物をレビ...
・切り分けの直感：AIに「任せられるタスク（フロントエンド...
・見積もりの罠への対処：AIはコードを瞬時に生成できる反面...
+Claude Code の台頭：歴史、セットアップ、VS Code へのイン...
--Claude Codeの歴史と進化
---誕生と普及：2024年末にAnthropicのエンジニア（Boris Che...
---V2へのアップデート（2025年9月）：チェックポインティン...
---性能の転換点（2025年11月）：超強力なモデル「Opus 4.5」...
---ビジネスと今後の展開：AnthropicはClaude CodeによりARR...
--料金プランと推奨設定
---プランの種類：無料プラン、Proプラン（月額20ドル）、高...
---推奨環境：無料モデルや安価なモデルをClaude Code経由で...
--インストールとセットアップ
---本体のインストール：code.claude.com から各OS（Mac/Wind...
---VS Code拡張機能：Anthropic公式のVS Code拡張機能（Claud...
--本コースにおける利用方法（ターミナル重視）
---Claude CodeをVS Codeで使うには「サイドバー（拡張機能）...
---ココではより高度な「バイブエンジニア（Vibe Engineer）...
+Claude Code CLI 入門：Init、Context、Testing~
VS Code上で前週のプロジェクトを開き、ターミナルからAnthro...
--プロジェクトの準備とClaude Codeの起動
---前週のプロジェクト（PM）を開き、Gitで未commitの変更を...
---新しいターミナルを開き、claude コマンドを入力して Clau...
---インタフェースは意図的にレトロなCLIスタイル（キャラク...
--ログインと初期設定（/init）
---初めて使用する場合は、/login コマンドでAnthropicアカウ...
---従来の拡張機能で使われていた AGENTS.md の代わりに、Cla...
---/init コマンドを実行すると、Claudeがディレクトリ構造を...
---注意: 最初はClaudeに下書きをさせても、最終的には人間の...
--操作方法とUIの特徴
---Claudeへの命令は通常入力で行い、コマンドを実行する場合...
---Claudeからの編集提案に対し、ユーザーはテンキーで応答（...
--コンテキスト管理（/context）
---/context コマンドを使用することで、20万トークンという...
---メーターには「メモリ（CLAUDE.mdなど）」「メッセージ（...
--ドキュメントの読み込みとテストの自動実行
---Claudeに docs/plan.md を読み込ませ、プロジェクトの構造...
---テストの実行を指示した際、PC再起動直後で Docker Deskto...
---バックエンドおよびフロントエンドの全テストが走り、すべ...
+Claude Code レビュー：ハルシネーションの修正とコードのリ...
開発者ツール「Claude Code」を使用して、リポジトリ全体の包...
--Claude Codeによるコードレビューと「幻覚（ハルシネーショ...
---Claude Codeの並列エージェント（バックエンド、フロント...
リポジトリ全体の包括的なコードレビューを実施し、docsフォ...
Please carry out a comprehensive code review of the enti...
---レビュー中、Claudeは「.envファイル（機密情報）がGitに...
---これを指摘すると、Claudeは誤りを認めて謝罪し、レポート...
.env は Git でどのように管理されているのでしょうか？ .gi...
how is env in git? It's clearly included in .gitignore, ...
おっしゃる通りです。確認してみます。...おっしゃる通りで...
You're right, let me verify. ... You're correct. .env is...
--指摘事項の修正とリファクタリング
---修正されたレポートには、バックエンド依存関係の未固定、...
---一括修正の指示：「重大・高・中」の課題の修正と再テスト...
承知いたしました。ありがとうございます。それでは、クリテ...
OK thank you, please go ahead and address all the Critic...
---自律的な判断と追加指示：ただし、Claudeはコスト対効果を...
これは良いのですが、実際にはモノリシックなPythonモジュー...
this is good, but actually I really want to rememdiate t...
--Gitコミットとコンテキストの整理 (/compact)
---変更された大量のファイル（ヘルスチェックが追加されたDo...
---コンテキスト・ウインドウ肥大化の対応として、/context ...
---（チャットUIではPLAN.md等を更新してから新しいチャット...
--現在のバージョン、使用しているモデル（最上位のOpus 4.5...
+Open Code：GLM 4.7 などの無料モデルを Claude Code の代替...
Claude Codeのオープンソースの競合ツールである「Open Code...
--Open Codeの特徴
---柔軟なモデル選択：独自の無料モデル（Open Code Zenなど...
---2つのモード：Tabキーで、行動を起こす前に思考させる「Pl...
---推論レベルの調整：Ctrl+Tで、モデルの推論レベル（Low〜E...
--インストールとセットアップ
---Macではcurlコマンド、Windowsではchocoやnpm（Node.js環...
---VS Codeのターミナルから open code コマンドを入力するだ...
---起動時に環境内の既存のサブスクリプション（OpenAIなど）...
--無料モデルでのコードレビュー検証
---中国のスタートアップZ.aiの「GLM 4.7」（非常に強力なOSS...
---Planモードでレビュー内容をじっくり考えさせた後、
プロジェクト全体をレビューし、コードレビューを実施して、...
please review the entire project, carry out a code revie...
---Buildモードに切り替えて docs/code_review.md へファイル...
docs/code_review.md にコードレビューを書いてください。た...
please go ahead and write the code review to docs/code_r...
---認証の脆弱性、TypeScriptの厳密さ、コードの重複、エラー...
---ただし、Claude 4.5 Opusほどの自律性や確実なリファクタ...
--プロバイダー接続とローカル実行
---/connect コマンドを使用することで、Anthropic、GitHub C...
---Ollama等を使ったローカル環境でのモデル実行にも対応して...
--プラットフォームの組織力やモデルの安定性から「Claude Co...
+Open Router と Ollama を使った AMP Code、Claude Code
--AMP（AMP Code）の概要と特徴
---概要：特定のプロバイダーに依存しないエージェント型コー...
---Freeプラン：画面上部に表示される広告を見ることで、毎日...
---仕様と機能：~
・バックグラウンドで最適なAIモデルが自動選択される（文脈...
・3つのモード（smart: 標準、deep: じっくり思考、rush: 高...
・実際にプロジェクトのコードレビューを実行し、ハードコー...
--Claude Code を Open Router 経由で動かす（Kimi K2の例）
---概要：Anthropic公式の推奨環境ではないが、環境変数を書...
---設定方法：Mac/PCで環境変数を設定し、ベースURLをOpen Ro...
---結果: プロジェクトの目的を正しく説明できたが、複雑なコ...
--Claude Code を Ollama でローカル実行する（GPT-OSS）
---概要：外部クラウドを使わず、自身のローカル・マシン（GP...
---設定方法：環境変数を変更し、接続先をローカルホスト（lo...
---結果：PCのGPUに高い負荷がかかり処理に時間は要したもの...
--AIコーディング環境は、幅広い選択肢と拡張性がある。
***Day 2 [#sc3340e9]
40-44
+Claude Code のコマンド、ショートカット、設定の徹底解説
--主要なSlashコマンド~
ツール内のみで実行され、Claudeへのプロンプトとしては送信...
---/↓、/help：使用可能なコマンドの一覧や簡単な説明、ショ...
---/init：プロジェクトを初期化し、CLAUDE.mdファイルを新規...
---/model：使用中のモデルを確認・変更（例：上位プランでの...
---/status：ステータス（進行状況）、コンフィグ（各種設定...
---/context：現在のメモリ（コンテキスト）状況をプリントア...
---/compact：会話履歴を圧縮してリセット。残したい情報の要...
---/clear：会話履歴を完全に消去し、初期状態（AGENTS.mdな...
---/permissions：Claude Codeが持つ実行権限の確認やルール...
--ショートカットキーとモード
---Ctrl + O：詳細なトランスクリプト（ログ）モードのオン/...
---Shift + Tab：「Plan Mode（計画優先）」「Accept Edits（...
ただしOpus等の進化により、現在はモデル自身が判断するためP...
--設定とファイル管理のテクニック
---権限管理（.claude ディレクトリ）：JSON ファイル（パー...
---シンタックスによるファイル参照：プロンプトや CLAUDE.md...
#CLAUDE.md
@AGENTS.md
## DETAILED PLAN
@docs/PLAN.md
---効率的な活用例（ファイルの共通化）~
・GitHub Copilot等の他ツールと設定を共通化したい場合、CLA...
・注意点: @ でディレクトリを指定した場合は、配下の全ファ...
+Sessions、Checkpoints、Git：Claude Code ワークフローの管理
--ワークフロー管理における3つの手段~
Claude Codeでの作業状態を管理・復元するには、粒度の異なる...
---セッション（Sessions：高粒度）~
・Claudeとの会話や文脈（コンテキスト）の完全な状態を記録...
・任意のタイミングでセッションに名前を付けて保存（rename...
※注意：復元されるのは「会話の文脈」のみであり、コードやリ...
---チェックポインティング（Checkpointing：低粒度）~
・現在のセッション内における、プロンプト（指示）ごとのス...
・時間を一歩ずつ遡る「巻き戻し（rewinding）」が可能。~
・会話だけでなく、Claudeが行ったコードの変更も元に戻せる。~
・ただし、Claudeの知らないスクリプト等によって変更された...
---Git（コード管理の標準ツール）~
・Claudeの文脈とは独立してコード全体の正確なスナップショ...
・コードを過去の特定の時点へ確実に復元するための「本命」...
--おすすめのワークフロー
---Gitの多用：コードの変更管理や過去への変更の巻き戻しに...
---Markdownファイルでの進捗管理：過去のセッションを復元し...
--セッション機能の実演（デモ）
---Claudeに「皮肉っぽく（snarky）応答して」と指示
今日の会話では、ぜひ機知に富んだ、皮肉の効いたやり取りを...
for our conversation today, I'd like you to be witty and...
---そのセッションを「snarky Claude」と命名して一度終了
> /rename snarky-claude
L Session renamed to: snarky-claude
---普通にClaudeを起動してプロジェクトの要約を求めると、ビ...
> please summarize the project
All 10 parts of the plan are complete the MVP is fully f...
---一度終了し、今度は claude --resume で再開して「snarky-...
> please summarize the project
Current state: All parts of the plan are complete. You'v...
The vibe: "Keep it simple, don't over-engineer, prove pr...
+Claude Code の Checkpoints、Rewind、YOLO Mode 解説~
Claude Codeを使用し、コードレビュー、シンキングプロセス確...
--コードレビューの実行とエラーの修正
---「プロジェクトの要約」と「コードレビュー」をClaudeに指...
> please do a code review and write results to review.md...
...
Do you want to make this edit to review.md?
1. Yes
> 2. Yes, allow all edits during this session (shift+tab)
3. No
--シンキングプロセスの可視化（ショートカットキー）
---Ctrl + O：エージェントの思考トレース（詳細な思考プロセ...
---Ctrl + E：すべてを表示し、もう一度押すと折りたたむ。
---Ctrl + B：コマンドをバックグラウンドで実行させ、自身は...
--Claudeは前回同様「.envファイルのAPIキーが露出している」...
gitignoreにあるとは言わず、「本当に露出しているか？」と促...
--チェックポイントとリワインドの仕組~
/rewind コマンドを使用することで、現在のセッション内の特...
---/rewindで、チェックポイント（過去の会話時点）を選択す...
- please summarize the project
No code changes
- please do a code review and write results to review.md...
review.md +263-0
- are you sure that the API key is exposed?
review.md +9-23
---会話履歴のみ（Chat）、コードの状態のみ（Code）、あるい...
> 1. Restore code and conversation
2. Restore conversation
3. Restore code
4. Never mind
---実演：巻き戻した結果、AIのチャット文脈だけでなく、revi...
are you sure that the API key is exposed?
...
1. Restore code and conversation
--セッション再開（Resume）との違い
---セッション再開（Resume）：過去のセッションからClaudeの...
---チェックポイント（Rewind）：現在のセッション内で、会話...
--次回の予告：
---最後に現在の変更をGitコミット（git commit -m "before Y...
---次回は、差分を自動承認して高速で開発を進める「YOLO（Yo...
+Claude Code YOLO Mode：権限をバイパスして自律コーディング
--「YOLOモード（危険モード）」でのClaudeの起動~
GUIからの実行でも同じだと思われるが、ココで初めて大きめの...
---概要：ユーザーの許可（パーミッション）を一切求めずに、...
---起動方法：コマンドラインで claude --dangerously-skip-p...
---リスクと注意点：破壊的なコマンド（rm -rf など）が実行...
---本来は、インターネットアクセスを制限し、簡単に復元でき...
--タスクの実行と結果
---依頼内容：プロジェクトのUI改善（削除ボタンのアイコン化...
please improve the UI of this project, particularly maki...
---実行プロセス：Claudeはユーザーの介入なしで完全に自律し...
---検証結果：~
・ローカルサーバー（localhost:8000）は問題なく起動。UIは...
・組み込まれているAIアシスタント機能（OpenRouter経由）も...
hi there
Hello! How can I help you with your board today?
please give all cards to the Done column
All non-Done cards have been moved to the Done column,
--結論と事後処理
---YOLOモードは、適切な指示を与えれば人間が目を離している...
---動作確認後、安全のためにすぐにGitコミット（git commit ...
+Claude Code の Ralph Loops：自律エージェントによるオート...
--Ralph loop（ラルフ・ループ）とは
---概要：オーストラリアのエンジニア、Geoffrey Huntley氏に...
---仕組み：AIが「タスクが完了した」と判断した際、文脈（コ...
---メリット：通常数分で終わるタスクを、何時間もかけて自律...
--実演と検証結果
---/plugin install でAnthropicの公式プラグインRalph loop...
> /plugin install ralph-loop@claude-plugins-official
L Plugin 'ralph-loop @claude-plugins-official' is alre...
---設定：max-iterations 10（最大10回反復）に設定し、既存...
> /ralph-loop "Please significantly improve this project...
---安全性：リスクを伴う「YOLOモード（権限確認スキップ）」...
---結果：約1時間で1,300行以上のコードが追加・変更され、以...
・サインアップ、サインイン/アウト~
・マイページ（ユーザー名表示）~
・複数のかんばんボードの作成・切り替え・カード移動・デー...
---動作確認の結果、いくつかの軽微な不具合を修正しただけで...
--Ralph loopの使い所と今後の展望
---使い所：短時間でプロトタイプやMVP（実用最小限の製品）...
---注意点：予測可能で信頼性の高い成果が必要な場合や、人が...
---今後のステップ：今回のRalph loopはあくまで前触れ（ティ...
***Day 3 [#v4145684]
45-51
+MCP、Skills、Plugins：Claude Code の3大構成要素
--Claude Codeの背後にある4つの大きなイノベーション
---トリック1：記憶の錯覚
私はエドです
>> こんにちは、エド
私は誰でしょう？
>> わかりません
私はエドです
>> こんにちは、エド
私はエドです。こんにちは、エド。私は誰でしょう？
>> あなたはエドです
---トリック3：ツール
ツール：次の質問にPythonコードで答えるには、次のように返...
質問：円周率の平方根は何ですか？
回答：>> PYTHON: math.sqrt(math.pi) → ツールが呼び出され...
---トリック2：推論／思考
質問：コインを2枚投げます。1枚は表です。もう1枚が裏にな...
推論：Step 1：サンプル空間を列挙（全件）、Step 2：「1枚...
---トリック4：ループ~
ステップ1：LLMに進行するように指示する~
ステップ2：目標が達成されたかどうかをテストする~
ステップ3：達成されていない場合は、ステップ1に戻る~
--AIを進化させる核心：ツール（Tools）の力
---単に次の単語を予測するだけのLLMを、自律的に動く「エー...
---AIはテキストを生成するだけでなく、ツールを実行するため...
---Claude Codeには、最初から「ToDoリスト管理」「ファイル...
--3つの拡張機能の概要
---[[MCP（Model Context Protocol）]]~
・概要: Anthropicが2024年末に発表した、AIアプリケーション...
・メリット：誰かが作ったツール（ネット閲覧、市場データ取...
・デメリット/注意点：MCPはあくまで接続のための「規格（プ...
・MCPサーバーを多く接続し過ぎると、Contextウィンドウを圧...
・（ツール定義による消費、ツール実行結果の蓄積、誤ったツ...
---Skills (スキル)~
・概要: MCPの後に登場した、AIに専門知識や機能を追加するた...
・特徴: MCPと競合・代替するような性質を持つが、MCPが抱え...
---Plugins (プラグイン)~
・概要: 最も高レベル（上位レイヤー）の概念です。~
・特徴: 複数のMCPやSkills、その他の要素を一つにまとめた「...
--まとめ
---これら3つは、すべて個別にインストールや有効化ができる...
---ベースにあるのは**「AIにツール（行動力）を与える」**と...
---これらを理解し適切に使い分けることで、Claude Codeの専...
+MCP Server 解説：Host、Client、Discovery（Claude Code）~
ヤヤコシイので、必要に応じて[[コチラ>MCP（Model Context P...
--MCPの基本概念と3つの要素
---MCPホスト (MCP Host)：ツールを呼び出すAIアプリケーショ...
---MCPクライアント (MCP Client)：ホスト内で動作し、各ツー...
---MCPサーバー (MCP Server)：実際に外部で開発されたツール...
--2つの実行モード「トランスポート」と「ローカル」の誤解~
ローカル実行のMCPサーバーは、（COMで言う所の）ローカル・...
---2つの方式：現在は「STDIO」が推奨方式で「SSE」は非推奨...
---ローカル実行：ローカルで動作。リモート実行：リモートで...
--MCP最大のメリット
---ターミナルで「わずか1行のコマンドを実行するだけ」で、A...
---この標準化された手軽さこそが、MCPが多くの開発者に支持...
--MCPサーバーの探索と「マーケットプレイス」の現状~
現在、誰もが1箇所に集まるような標準的な検索場所はなく「無...
---公式レジストリ（registry.modelcontextprotocol.io）：Li...
---AnthropicのGitHubリポジトリ：初期の参考サーバーやサー...
---外部マーケットプレイス（mcp.so や Glamour.ai）：1万数...
--信頼できるMCPサーバーの見極め方
---マーケットプレイスには「Context 7」（最新のAPI情報をLL...
---安全性を確認する最善の方法は、開発元のGitHubリポジトリ...
+Claude Code への MCP Server 追加：Context7 & Massive
--「Context7」MCPサーバーの追加と検証
---Context7とは、LLMに最新のライブラリやツールのドキュメ...
---追加手順：Claude Codeを一度終了し、コマンドラインからG...
> claude mcp add context7 npx -y @upstash/context7-mcp
---ツール機能：統合すると、ライブラリIDを特定するツールと...
MCP tools /mcp
L mcp_ide_getDiagnostics: 111 tokens
L mcp_ide_executeCode: 182 tokens
L mcp_context7_resolve-library-id: 492 tokens
L mcp_context7_query-docs: 401 tokens
---プロンプトのコツ：確実にMCPサーバーを使わせたい場合は...
（明示：）> use context7 to summarize for me the right w...
（自動：）> how do I turn off telemetry with CrewAI
--「Massive (旧 Polygon IO)」MCPサーバーの追加
---Massiveとは、市場データ（株価など）を取得するMCPサーバ...
---実演：追加後、Claudeに「Appleの現在の株価は？」と質問...
> claude mcp add massive e MASSIVE_API_KEY=your_api_key_...
> what's the current share price of AAPL?
AAPL (Apple Inc.) is currently trading at $270.01, up $9...
--Claude Codeの最適化（コンテキストの節約）
---大量のツールを提供する巨大なMCPサーバー（Massiveなど）...
---Claude Codeは近年のアップデートにより「今必要なツール...
---そのため、利用可能なツールが大量にあってもトークンを無...
--MCPサーバーの削除：追加時と同様に、コマンドラインから c...
+Skills vs MCP：Claude Code で能力を追加するよりシンプル...
--「[[Agent Skills]]（スキル）」とは？
---Skillsは、MCP（Model Context Protocol）の後に登場した...
---LLMエージェントに対しMarkdownファイルを使って指示を与...
---システム・プロンプトにSkillsの存在と利用方法が記述され...
--メリット（MCPとの比較）
---段階的開示：まずは最上部の「メタデータ（概要）」だけが...
---シンプルで軽量：Skillsは「フォルダとファイルの集まり」...
---シェルスクリプトの実行：Markdownだけでなく、シェルスク...
--デメリットと課題
---柔軟性とパワーの低下：Function Callingのパラメタ定義に...
---発見の難しさ：MCPに比べてまだ普及の歴史が浅く、どこで...
---呼び出しの曖昧さ：AIにSkillを使わせるトリガーがやや曖...
--Skillsの3段階構造（段階的開示の仕組み）
|階層|名称|内容|読み込みのタイミング|h
|第1階層|メタデータ|Skillの名前と概要説明|常に最初に読み...
|第2階層|指示|具体的なワークフローやガイドライン、コード...
|第3階層|リソースとコード|スクリプト（Python等）や、参照...
--実装方法（ファイルシステム・アーキテクチャ）~
Skillsは非常にシンプルで、特定のフォルダ構造を作るだけで...
---配置場所：~
・プロジェクト個別：各リポジトリの .claude/skills/ フォル...
・グローバル（PC全体）：ホームディレクトリの .claude/skil...
---構成:skillsフォルダの中に「Skillごとのサブフォルダ」を...
--総括：技術的な複雑さ（オーバーヘッド）が大きかったMCPに...
+Skills Marketplace：Claude Code に Agent Browser をイン...
--「Skills（スキル）」の概要とマーケットプレイス
---構造のシンプルさ：スキルはファイルとフォルダの集まりで...
---主な入手先：~
・[[Anthropic社のGitHubリポジトリ>https://github.com/anth...
・[[skills.sh (Vercel製)>https://www.skills.sh/]]：様々な...
--スキルのインストール手順（Agent Browserの例）
---前提：npm を使用して、ヘッドレスブラウザ（Agent Browse...
> npm install -g agent-browser
> agent-browser install
---追加：Vercelのユーティリティコマンド npx skills add [G...
> npx skills add https://github.com/vercel-labs/agent-br...
---設定：適用先として「Claude Code」を選択し、プロジェク...
---結果：スキルの組み込みは、プロジェクトの .claude/skill...
--実際の動作とメリット
---実演デモ：Claude Codeに「ニューヨークのレストランを検...
> Please interact with the browser to look for restauran...
（来週ニューヨーク市でレストランを探すには、ブラウザを操...
...I've searched both Resy and OpenTable for restaurant ...
...ResyとOpenTableの両方で、来週（2026年2月7日土曜日）の...
---チーム共有の容易さ：スキルはただのファイルで、Gitコミ...
+Claude Code Plugins：マーケットプレイス、インストール方...
--「[[Agent Plugins]]（プラグイン）」とは？
---概要：2025年10月に導入された最も新しい概念。MCP、Skill...
---目的：MCPやスキルの複雑な組み合わせをユーザーに意識さ...
---特徴：他のAI（ChatGPTなど）にはなく、Claude Code専用に...
--メリットとデメリット
---メリット（Pros）:~
・インストールするだけで使えてシンプル。~
・コマンドを明示的に入力して実行するため、曖昧さがなく、...
・迷ったら、MCPやスキルではなくプラグインから始めるのがお...
---デメリット・制限（Cons）:~
・Claude Codeでしか使えない。~
・パッケージとして一括導入されるため、細かいカスタマイズ...
--エコシステムとマーケットプレイス
---[[公式リポジトリ：GitHub上の anthropic/claude-plugins-...
---マーケットプレイスの追加：Claude Code内から直接アクセ...
--実際の操作と主なプラグイン
---操作方法：/plugin コマンドで管理画面（Discover / Insta...
・Discoverタブ：「マーケットプレイスのブラウザ」。登録済...
・Installedタブ：「インストール済みプラグインの管理画面」...
・Marketplacesタブ：「マーケットプレイス自体の管理」追加...
---人気のプラグイン例：~
・Front-end Design：高品質なUIを作る、最も人気のプラグイ...
・Context 7 / GitHub：面倒なMCPサーバーの設定を簡単に導入...
・Code Review：プルリクエストのコードレビューを行う公式プ...
・Code Simplifier：LLMが生成した複雑なコードをシンプルに...
・Ralph Loop: 前日にデモで使用した「/ralph-loop」コマンド...
+MCP vs Skills vs Plugins：Claude Code で最適な構成を選ぶ
--プラグイン（Code Simplifier）の検証
---導入：Anthropic製の「Code Simplifier」をインストール（...
前述の「Discoverタブ」から「code-simplifier」プラグインを...
---実行：自然言語で「コードベース全体を簡素化して」と指示...
> please use the code simplifier agent to simplify the e...
---結果：約6分間の処理で多くの変更とテストが実行された後...
--3つの拡張技術の比較
|技術|メリット|デメリット|h
|MCP (Model Context Protocol)|エコシステムが巨大、選択肢...
|Skills|コンテキスト効率が良い、設定が簡単、チーム間での...
|Plugins|MCPやSkills、エージェントなどを一括同梱可能。最...
--どの技術を選ぶべきか（結論）~
選択肢（MCP/Skills/Plugins）の中からでは「先ずはPluginsか...
---基本戦略：目的の機能を持つプラグインがあれば、それが最...
---MCPを選ぶケース：市場データの取得など、非常に専門的な...
---Skillsを選ぶケース: Vercelのブラウザエージェントのよう...
--総括と次へのステップ
---カリキュラム全体の折り返し地点（50%）を通過。
---翌日からは、これらを踏まえた実際のプロジェクトにおける...
***Day 4 [#hbd1f44c]
52-57
+Claude Code、Jira、MCP、Plugins を活用した開発ワークフロ...
前回学んだMCP、スキル、プラグインなどの知識を実際の行動に...
--3つの拡張機能の振り返りと比較
---MCP (Model Context Protocol): Anthropicが開発した規格。~
・プラス面: エコシステムが非常に膨大。~
・マイナス面: コンテキストを消費しやすく、時に扱いが難し...
---スキル (Skills): Markdownやスクリプトを組み合わせた軽...
・プラス面: 効率的かつシンプルで、良い結果が得られやすい...
・マイナス面: MCPほど強力・柔軟ではなく（認証機能など）、...
---プラグイン (Plugins): MCPやスキル、エージェントなどを...
・プラス面: 両者の良いとこ取りができる（現時点ではClaude ...
・マイナス面: 大量に入れすぎると、LLM（Opus）がどのツール...
---推奨されるアプローチ：~
・先ずはプラグインマーケットプレイスからプラグインを試す。~
・その上で、特定のエコシステムを活用したい場合は「MCP」を...
--開発実践：「自分で選ぶ冒険（Choose Your Own Adventure）...
以降はスライドを一切使わない実践形式で、全く同じ手順を踏...
---開発プロセスの出発点（Jiraのセットアップ）~
開発ライフサイクルの起点として、多くの企業で標準的に使わ...
・Jiraは、バグトラッキングや課題管理、プロジェクト管理な...
・Jiraのサインアップ：https://www.atlassian.com/software/...
・スペースの作成：「Kanban（カンバン）」テンプレートを使...
・詳しい手順：サインアップ、サインイン、サイト作成、カン...
---プロジェクトの題材：今回構築する製品の名前は「Pre-Lega...
・コンセプト：企業向けにNDAやクライアント契約書などの法的...
・目的：弁護士の置き換えではなく、弁護士や法律事務員が仕...
---最初のタスク作成：Jira上に「Pre-Legalの会社概要を説明...
+Claude Code と MCP Serverを用いたJira、GitHub連携~
ClaudeCodeとJIRA、GitHub連携で、プラグインやスキルを使用...
--Atlassian (Jira) MCPサーバーの連携とテスト
---MCPサーバーの追加：VS Codeのターミナルから claude mcp ...
> claude mcp add --transport http atlassian https://mcp....
> claude
---OAuth2.0による認証：/mcpコマンドで状況を確認後、認証を...
---トラブルシューティング：連携がハングした場合は認証が切...
---ツールの検証：
・「/context」で多数のJira用ツールが追加されたことを確認。
> /context
MCP tools /mcp
L mcp_atlassian_...
...
・事前にJira側で作成していたタスク「PL-1」についてClaude...
> please tell me about jira issue PL-1
Jira Issue PL-1
|Field |Value ...
|Summary |We need a simple website that describes the...
|Type |Task ...
|Project |Prelegal (PL) ...
|Status |To Do ...
|Assignee |Unassigned ...
|Description|None provided ...
Link: https://edwarddonner.atlassian.net/browse/PL-1
--GitHubの準備とFine-grained Access Tokenの発行~
---Fine-grained Access Tokenとは、スコープ制御できるAPIア...
---リポジトリの新規作成：GitHub上で「pre-legal」というプ...
---トークンの生成：ユーザーの「Settings」＞「Developer se...
---セキュリティの最小権限原則：有効期限を30日、アクセス権...
---注意点：生成されたトークンは一度しか表示されないため、...
--ローカル環境へのリポジトリのGitクローン
---ポジトリのHTTPS URLをコピーし、VS Codeでターミナルを開...
---Gitクローンした「pre-legal」ディレクトリ内に、GitHub上...
+GitHub MCP Server と Featured Dev Plugin のセットアップ
--GitHub MCPサーバーの導入と連携
---VS Codeで新しいプロジェクトを開き、ターミナルからGitHu...
> claude mcp add --transport http github https://api.git...
> claude
---接続完了後、Claude CodeがGitHub関連の多数のツールにア...
> /context
MCP tools /mcp
L mcp_github_...
...
--Claude CodeによるGitHub操作の実証
---Issueの作成：Claudeに指示を出し、READMEの更新に関するI...
> please write an issue to Github that the README needs ...
（GitHubのIssue上に）The README needs to be updated to r...
---Pull Request（PR）の作成とmerge：READMEにプロジェクト...
> please update the README to reflect that the project i...
（GitHubのPR上に）title：Update README with project stat...
---事後処理：Git操作の仕上げとして、作業用ブランチからメ...
> git status
On branch update-readme
Your branch is up to date with 'origin/update-readme'.
nothing to commit, working tree clean
> git checkout main
Switched to branch 'main'
Your branch is up to date with 'origin/main'.
> git status
On branch main
Your branch is up to date with 'origin/main'.
nothing to commit, working tree clean
--「FeatureDev」プラグインのインストール
---/plugin コマンドで、Discover画面のプラグイン一覧から、...
---コレは「コードベースの探索」「設計」「品質レビュー」等...
---チーム全体で共有できるよう、プロジェクト・スコープ（.c...
--プロジェクトの環境整備と最終確認
---Claudeに対し、Python (FastAPI) と JavaScript (Next.js)...
> please create a boilerplate .gitignore for this new pr...
---Claudeが自動でGit操作（PRのmerge分のpull、commit、push...
--結論：Jira（タスク管理）とGitHub（コード・Pull Request...
+Claude Code の自律性：Jira Issue から MCP Server 経由で...
--Jiraでの2つ目の課題を作成（タスク：PL-2）
---タスク内容：「Common Paper」が公開しているCreative Com...
Title：Create a dataset of legal document templates that...
Description：This task is a one-time data curation task ...
For context, the CommonPaper github account at Common Pa...
For this task, we need to browse these repos online to r...
Then put all the markdown files in our Protegal project ...
Additionally, make a new json file called catalog.json i...
Finally, add a text file in the "templates" directory to...
表題：システムが後でユーザー向けに修正できる法的文書テン...
説明：このタスクは、Prelegalプロジェクトのデータ準備のた...
背景として、Common PaperのGitHubアカウントには、CCライセ...
このタスクでは、これらのリポジトリをオンラインで閲覧し、...
次に、すべてのMarkdownファイルをPrelegalプロジェクトの「...
さらに、プロジェクトルートに「catalog.json」という新しい...
最後に、「templates」ディレクトリにテキストファイルを追...
---要件：templatesディレクトリへのMarkdownファイルの格納...
--Claude Codeの準備とMCP連携
---Atlassian（Jira）用のMCP（Model Context Protocol）サー...
> claude mcp add transport http atlassian https://mcp.at...
> claude
---Claude Codeに対し、「Jiraの課題PL-2を実行し、PRを上げ...
> please carry out jira issue PL-2 and raise a PR with y...
PR created. Let me also update the Jira issue status to ...
--Claude Codeによる自律的な問題解決（自律性の発揮）
---アプローチの最適化：~
・当初、Claude CodeはGitHubツールでファイルを1つずつ読み...
・途中で方針を切り替え、コマンドを実行してファイルを直接...
---成果物の生成：指示通りMarkdownファイル群、license.txt...
--Pull Request（PR）作成とJiraのステータス更新
---PRの作成：ローカルのGitHub CLIツールが未インストールだ...
---トラブルシューティング（Jiraの認証切れ）：~
・Jiraのステータスを「完了」にする際、Atlassianの認証切れ...
・/mcpコマンドから手動で再認証を行うことで、Claude Codeは...
> please try marking the jira issue complete again
--ローカルでのmergeと完了~
---PRをmergeして、ブランチをmainに切り替えてください。
> please go ahead and merge the PR, and also then switch...
---PRのmerge権限がないと判明すると、Claude Codeは「ローカ...
...
The GitHub token doesn't have merge permissions. Let me ...
...
Done. Merged to main and switched branches. You're now o...
--結論 / 考察
---AIのブレイクスルー：障害に直面した際、AIが自ら原因を理...
---MCPの現状：認証が切れやすいなどの「わずかな不安定さ（f...
+Claude Code が Jira チケットから Next.js アプリをフル構築
--タスクの起票と初期設定
---Jira上で「PL2」チケットの完了を確認後、3つ目の課題を作...
Title：Prototype of Mutual NDA creator
表題：相互秘密保持契約（NDA）作成プロトタイプ
---要件はあえて曖昧さを持たせたビジネス寄りの内容に設定。
Description：A web application to create a Mutual NDA Do...
The user enters in some key information in a form. The w...
The user can download the completed document locally.
説明：ユーザー向けに相互秘密保持契約（NDA）を作成するWeb...
ユーザーはフォームにいくつかの重要な情報を入力します。す...
ユーザーは完成した文書をローカルにダウンロードできます。
--Claude Codeによる開発の実行
---Claude Codeを再起動し、/contextコマンドでContextウィン...
---プラグイン（feature_dev）を使い「JiraのPL3をNext.js（f...
>/feature-dev: feature-dev please implement jira issue P...
I'll start by fetching the Jira issue PL-3 to understand...
---Claude（feature_dev）は7段階のプロセスに沿って動作を開...
Phase 3: Clarifying Questions
Before proceeding with architecture, I have some questio...
6 tasks ( done, 1 in progress, 5 open) ctrl+t to hide ta...
✓Implement Jira issue PL-3 with NextJS frontend
・Create NextJS project structure
・Build NDA form component
・Create NDA preview/display component
・Implement document download
--------------------------------------------------
・Download・Form UX・Preview・Design・Submit
Download：What download format should the completed NDA ...
> 1. PDF (Recommended)：Professional format, widely comp...
2. Markdown：Simple text format, matches source template
3. Both PDF and Markdown：Give users a choice
4. Type something.
5. Chat about this
Form UX：Should the app have a multi-step wizard or sing...
> 1. Single page (Recommended)：All fields visible at on...
2. Multi-step wizard：Guided step-by-step experience, ...
3. Type something.
4. Chat about this
Preview：How should the NDA preview be displayed?
1. Below the form (Recommended)：Live preview that upd...
2. Separate preview page：Navigate to see completed do...
> 3. Side-by-side：Form on left, preview on right
4. Type something.
5. Chat about this
Design：Should this be a simple prototype or include sty...
1. Functional prototype：Basic styling with Tailwind, ...
> 2. Polished design：Professional look with careful att...
3. Type something.
4. Chat about this
Submit：Review your answers
- What download format should the completed NDA be ava...
- Should the app have a multi-step wizard or single-pa...
- How should the NDA preview be displayed?：Side-by-side
- Should this be a simple prototype or include styling...
--アプリケーションの動作確認
---わずか数分でNext.jsのフロントエンドファイル群とGitHub...
---ローカル環境でアプリ（npm run dev）を起動したところ、...
Purpose：Evaluating whether to enter into a business rel...
---フォームに入力したデータ（会社名や準拠法など）が、右側...
Mutual Non-Disclosure Agreement
Common Paper Mutual NDA Standard Terms Version 1.0
Cover Page
PURPOSE：Evaluating whether to enter into a business rel...
...
---「PDFダウンロード」ボタンを押すと、カバーシート付きの...
--プロセスの検証とテストの追加要求
---/contextコマンドでContextウィンドウを確認、1/3 - 1/2ぐ...
---非常に完成度が高い一方、プロセス中に自動テストが実行さ...
> It's working great. Based on the process you followed,...
---Claudeは「ビルド確認は行ったが、自動テストやコードレビ...
Good question. Here's what was actually done:
Completed:
- Build verification: Ran npm run build successfully con...
Not done:
- No automated tests were written
- No manual testing I didn't run npm run dev and verify ...
- code-reviewer agents launched (Phase 6 from the featur...
- No PDF download testing didn't verify the generated PD...
The build passing gives some confidence that the code is...
- The form actually works and updates state correctly
- The preview renders properly
- PDF generation produces a valid desument
- The layout looks good on different screen sizes
Would you like me to:
1. Run the dev server and do manual testing?
2. Launch code-reviewer agents to check for bugs and cod...
3. Add some basic tests?
---これを受け、「自動テスト・手動テストの追加、およびコー...
> yes to all 3 please add extensive automated tests and ...
+Claude Code のデバッグ戦略：体系的なアプローチ
--開発タスクの進捗と成果
---成果物の完成：Claude Code を用いて、NDA（秘密保持契約...
---トラブルへの自動対応：サーバーの強制終了や、Contextウ...
---動作確認とデプロイ：localhost:3000 でアプリが正常に動...
---最終処理：/mcpコマンドでAtlassianの再認証を行い、ロー...
> please merge the PR (legally) and push to main and swi...
--推奨のデバッグ戦略（5つのステップ）~
今回はバグが発生しなかったため、次回以降に向けた実践的な...
---スナップショットの取得（Gitコミット）：AIが誤った方向...
---手軽なアプローチ（コピー＆ペースト）：単純なエラーであ...
---規律あるアプローチとドキュメント化（規律モード）~
・簡単な修正で解決しない場合は、Gitで元の状態に戻し、debu...
・注意点: AIがネット上の古い、または無関係な1件のトラブル...
---根本原因の証明と修正：AIに根本原因を証明させ、それを d...
---教訓の記録：会話のクリアやコンパクト化によってAIが過去...
--デバッグのプロの技（Hot Tips）
---別のLLM（エージェント）の活用：Claudeが行き詰まった場...
---デバッグスキルの活用：プラットフォーム内の「Systematic...
--まとめと次回への展望
---本日の振り返り：Jiraからの課題読み込み、Claude Code（F...
---現在の進捗：全行程の 60% を消化。AIを使いこなす技術が...
***Day 5 [#u9d73ed5]
58-63
+SaaS プラットフォーム構築：Claude Code Skills & CLAUDE.m...
前日から着手しているリーガル文書自動作成のSaaSプラットフ...
--Claudeの3つの拡張機能のまとめ~
Claudeに能力を付与する方法として、以下の3つの特徴とメリッ...
|機能|特徴|メリット|デメリット|h
|MCP|モデルとツールを結合するプロトコル|エコシステムが豊...
|スキル (Skills)|Markdown形式のテキストファイル|シンプル...
|プラグイン (Plug-ins)|上記の要素やエージェントをパッケー...
--スキル (Skills)の構造と仕組み
---コンテキスト節約のための3段階の読み込み：常にファイル...
---ファイル・システムによる実装：ホーム・ディレクトリ、ま...
--プロジェクトの整理とGit管理
---前日のPull Request（PR）作成時、Claude Codeは自動的に ...
---チーム共有のために手動で git add および git commit / p...
--ホーム・ディレクトリの CLAUDE.md の活用~
プロジェクト単位だけでなく、ユーザー自身のホーム・ディレ...
---目的：すべてのプロジェクトで共通して適用したい、ユーザ...
---コツ：すべての会話で読み込まれるため、トークン節約のた...
---注意：そして、ホーム・ディレクトリ（.claude/CLAUDE.md...
--具体的な設定例
---アプローチ：常にタスクは小さく、段階的（インクリメンタ...
---ツール指定：Pythonのパッケージ管理には pip ではなく、...
---コードスタイル：明確で簡潔なドキュメント文字列を好む。
---新規追加ルール：絵文字（emojis）はPCでの不具合の原因に...
---デバッグ：当てずっぽうで修正せず、必ず原因を特定し、1...
# VERY IMPORTANT
- Be simple. Approach tasks in a simple, incremental way.
- Work incrementally ALWAYS. Small, simple steps. Valida...
- Use LATEST apis as of NOW
# MANDATORY Code Style
- Do not overengineer. Do not program defensively. Use e...
- Identify root fause before fixing issues. Prove with e...
- Work increnfentally with small steps. Validate each in...
- Use latest library APIs.
- Use uv as Python package manager. Always uv run xxx ne...
- Favor clear, concise docstring comments. Be sparing wi...
- Favor short modules, short methods and functions. Name...
# Important - debugging and fixing
- When troubleshooting problems, ALWAYS identify root ca...
- PROVE THE PROBLEM FIRST - don't guess.
- Try one test at a time. Be methodical.
- Don't jump to conclusions. Don't apply workarounds.
+CLAUDE.md の作成と Cerebras 用カスタム Skill の構築
--Claude.md（開発指示書）の作成と設定~
プロジェクトの全体像や開発プロセスをAIに理解させるための...
https://github.com/ed-donner/prelegal/blob/main/CLAUDE.md
---プロジェクト概要（Pre-legal）：~
・テンプレートに基づいて法律契約書のドラフトを作成するSaa...
・ユーザーはチャットを通じて必要なドキュメントの特定やフ...
・利用可能なドキュメントはルートの catalog.json に定義（@...
・初期実装は「フロントエンドのみのプロトタイプ」とする。
---開発プロセス：~
Jiraから機能要件を読み取り、テスト（単元・結合）を徹底し...
・Atlassianツールを使用して、Jiraから機能の説明を読み取る...
・機能開発：機能開発の7ステッププロセスからどのステップも...
・単体テストと統合テストで機能を徹底的にテストし、問題が...
・GitHubツールを使用してプルリクエストを送信。~
---AIデザイン~
・Cerebrasスキルを活用し、OpenRouter経由でLiteLLMを使用し...
・結果を解釈し、法的文書のフィールドに入力できるように、...
・プロジェクトルートにある.envファイルにOPENROUTER_API_KE...
---技術設計（Technical Design）:~
・プロジェクト全体をDockerコンテナ化する。~
・バックエンド：backend/ ディレクトリ配下、Pythonの uv を...
・フロントエンド：frontend/ ディレクトリ配下。~
・データベース：SQLiteのコンテナ起動時に毎回作成（サイン...
・scripts/には以下のスクリプトが必要
# Mac
scripts/start-mac.sh # Start
scripts/stop-mac.sh # Stop
# Linux
scripts/start-linux.sh
scripts/stop-linux.sh
# Windows
scripts/start-windows.ps1
scripts/stop-windows.ps1
--Cerebrasを使用したカスタムSkillの追加~
LLMからのレスポンスを超高速にするため、特定のインファレン...
---https://github.com/ed-donner/prelegal/blob/main/.claud...
---構成：.claude/skills/cerebras/ ディレクトリを作成し、...
---skill.md の作成：厳密なフォーマットに則り、メタデータ...
・仕様：LightLLM と OpenRouter を経由し、インファレンス・...
・結果の解釈や契約書フィールドへの流し込みを容易にするた...
---
name: Cerebras Inference
description: Use this to write code to call an LLM using...
---
# Calling an LLM via Cerebras
These instructions allow you write code to call an LLM w...
This method uses LiteLLM and OpenRouter.
## Setup
The OPENROUTER_API_KEY must be set in the .env file and ...
The uv project must include litellm and pydantic.
`uv add litellm pydantic`
## Code snippets
Use code like these examples in order to use Cerebras.
### Imports and constants
```python
from litellm import completion
MODEL = "openrouter/openai/gpt-oss-120b"
EXTRA_BODY = {"provider": {"order": ["cerebras"]}}
```
### Code to call via Cerebras for a text response
```python
response = completion(model=MODEL, messages=messages, re...
result = response.choices[0].message.content
```
### Code to call via Cerebras for a Structured Outputs r...
```python
response = completion(model=MODEL, messages=messages, re...
result = response.choices[0].message.content
result_as_object = MyBaseModelSubclass.model_validate_js...
--開発開始前の最終準備~
開発（ビルド）をスタートする前の最終調整として、以下の環...
---Claude.mdのアップデート：AIデザインのセクションに、前...
---環境変数の設定：以前のプロジェクト（pm）から cp コマン...
+Claude Code で V1 製品を構築するための Jira チケット設定
--Jiraでのチケット作成・更新~
プロトタイプから製品のバージョン1（v1）への移行に向けて、...
---PL4: 基盤の構築（Build foundation of V1 product）
Description：Upgrade the prototype so that it is the pro...
プロトタイプをアップグレードして、フロントエンド、バック...
・内容: プロトタイプをフロントエンド、バックエンド、起動...
・補足: 機能自体はまだ更新しない。認証機能は含めず、モッ...
---PL5: AIチャット機能の追加（Add AI Chat but still just ...
Description：Now change the way the product interacts wi...
次に、製品とユーザーのやり取りの方法を変えてみましょう。...
・ユーザーとの対話方法を一連の質問形式から、AIとのフリー...
・AIが文書に関する質問をして、回答に基づき必要項目を埋め...
---PL6: 全法規文書タイプへの拡大（Expand to all supported...
Description：Now expand the functionality so that it sup...
次に、テンプレートが用意されているすべての法的文書タイプ...
---PL7: 複数ユーザー対応と最終仕上げ（Support multiple us...
Description：Add a proper sign in & sign up screen that ...
Store previously generated documents and allow the user ...
Also add polish to all the screens so that they look lik...
・サインイン・サインアップ機能を実装し、過去に生成した文...
・また、プロ仕様のSaaSアプリに見えるよう画面を洗練させ、...
--開発環境の準備と認証
---ContextとSkillsの確認：Claude Code側で /context コマン...
---Atlassianの再認証：Jiraとの連携を正常に動作させるため...
---Jiraボードの構築が完了し、通常であればエンジニアリング...
+Claude Code、Jira、FastAPI を用いた機能開発
--Jiraチケット「PL4」の拡張と実装
>/feature-dev: feature-dev implement jira ticket PL-4 an...
---要件定義と開発：JiraからPL4チケットの情報を取得し、開...
Auth scope・NDA data・Submit
Auth scope：The CLAUDE.md mentions sign up and sign in. ...
1. Functional auth (Recommended)
Implement working signup/signin with SQLite user st...
> 2. Placeholder only
Create auth routes and UI but no working implementa...
3. Type something.
4. Chat about this
NDA data：For the frontend-backend integration, should t...
> 1. Keep client-side (Recommended)
NDA form works as-is, no backend integration focus ...
2. Add backend persistence
Save NDA drafts to database, user can retrieve later
3. Type something.
4. Chat about this
Submit：Review your answers
- The CLAUDE.md mentions sign up and sign in. For this...
→ Placeholder only
- For the frontend-backend integration, should the cur...
→ Keep client-side (Recommended)
Ready to submit your answers?
> 1. Submit answers
2. Cancel
---設計レビュー：提示されたアーキテクチャを開発者がレビュ...
Does this architecture approach look good to proceed wit...
> 1. Yes, proceed
Implement the V1 foundation as described
2. Need changes
I have concerns or modifications to discuss
3. Type something.
4. Chat about this
---実装レビュー：モノリシックなコードにならず、適切な構造...
---テストと動作確認：自動生成された76個のテストがすべて合...
---ローカルでPL4のPRをmergeしてmainブランチへpushし、main...
> please merge the PR locally and push to main and switc...
--Contextのクリーンアップ（ベストプラクティス）
---次のチケット（PL5）に移る前に、/contextコマンドでConte...
> please add concise details to the end of CLAUDE.md wit...
---Contextが肥大化するとAIが自動圧縮を行い、重要な記憶を...
--Jiraチケット「PL5」の開始とトラブルシューティング
>/feature-dev: feature-dev implement jira ticket PL-4 an...
---認証エラーの解決：PL5の読み込み時に処理が停止したため...
---要件の確定（チャットUIの導入）：既存のフォームを完全に...
UI Approach・Preview updates・Conversation start・Comple...
UI Approach：Should the chat UI completely replace the f...
> 1. Replace form entirely
Chat is the only way to fill in the NDA. Simpler UX...
2. Both available
User can switch between chat and manual form. More ...
3. Chat primary, form read-only
Chat fills fields, form shows current values but is...
4. Type something.
5. Chat about this
Preview updates：Should the document preview update live...
> 1. Live updates (Recommended)
Preview updates immediately as AI extracts each fie...
2. Update after confirm
Preview only updates after user explicitly confirms...
3. Type something.
4. Chat about this
Conversation start：How should the AI conversation begin?
> 1. AI greets + asks first question
AI initiate by asking about the parties involved.
2. User types first
Blank chat where user starts by explaining what the...
3. Type something.
4. Chat about this
Completion behavior：When all required fields are filled...
> 1. AI confirms show download (Recommended)
AI summarize the NDA and prompts user to review and...
2. Auto-generate PDF
Automatically download PDF when all fields are comp...
3. Type something.
4. Chat about this
Submit：Review your answers
- Should the chat UI completely replace the form, or coe...
→ Replace form entirely
- Should the dosament preview update live as the AI extr...
→ Live updates (Recommended)
- How should the AI conversation begin?
→ AI greets + asks first question
- When all required fields are filled, what should happen?
→ AI confirms + show download (Recommended)
Ready to submit your answers?
> 1. Submit answers
2. Cancel
--PL5のアーキテクチャ議論
---AIから3つのアプローチ（Minimal, Clean, Pragmatic）が提...
Architecture：Which architecture approach would you like...
1. Pragmatic Balance (Recommended)
Streaming responses + parallel extraction. Good UX,...
2. Minimal Changes
Fewest new files, combined chit+extraction.
Fastest to implement.
3. Clean Architecture
Full session persistence, service layers. Most robu...
4. Type something.
> 5. Chat about this
---AIは「ストリーミング応答」を提案、選択式のように見え、...
What would you like to clarify about the architecture op...
> I'd like the pragmatic choice except I only want 1 LLM...
+Cerebras と Claude Code で AI Legal Doc Generator をテス...
--チケットPL5の実装と検証
---実装内容：Cerebras（LLM）と統合されたAIチャットインタ...
---検証：GitHubに自動生成されたPR（13ファイル、456行の変...
---ローカルテスト：ローカル環境で起動し、相互秘密保持契約...
Hello! I'll help you create a Mutual Non-Disclosure Ag...
> Yes I'm evaluating a business relationship
Great, evaluating a business relationship it is. When ...
> yes today
Sounds good-let's set the effective date to today, 202...
Next, how long should the overall MNDA last? You can c...
> 3 years please
Got it-the MNDA will expire after 3 years.
> OK what else do you need to know
Great. Next, how long should the confidential informat...
> 2 years
Got it-the MNDA will expire after 3 years and the conf...
> what else do you need to know
We're almost there! I just need a few more details:
1. Which state's laws should govern this agreement (e....
2. Where should any disputes be resolved (city and sta...
3. Party 1-the name of your company, the signatory's f...
4. Party 2- the same information for the other side. W...
> 1. new York 2. New York 3. Just put default company na...
Perfect-I'll use New York law and New York as the disp...
**Party 1**
- Company: Company A
- Signatory: John Doe
- Title: CEO
- Notice address: john.doe@companya.com
- Signature date: 2026-02-05
**Party 2**
- Company: Company B
- Signatory: Jane Smith
- Title: President
- Notice address: jane.smith@companyb.com
- Signature date: 2026-02-05
If you'd like to change any of these later, just let m...
> yes finalize it
Excellent! Here's a summary of the Mutual Non-Disclosu...
**Purpose:** Evaluating a business relationship
**Effective Date:** 2026-02-05
**MNDA Term:** Expires after 3 years (2029-02-05)
**Confidentiality Term:** 2 years (until 2028-02-05)
**Governing Law:** New York
**Jurisdiction:** New York
**Party 1**
- Company: Company A
- Signatory: John Doe
- Title: CEO
- Notice address (email): john.doe@companya.com
- Signature date: 2026-02-05
**Party 2**
- Company: Company B
- Signatory: Jane Smith
- Title: President
- Notice address (email): jane.smith@companyb.com
- Signature date: 2026-02-05
If everything looks good, this draft is complete and r...
Let me know if you need any final tweaks or a formatte...
---課題の発見：~
（１）AIが次の質問を継続して投げかけないため、会話が途切...
（２）入力後にテキストフィールドへのフォーカスが自動で戻...
--次のステップへの移行（Contextのクリーンアップ）
---ローカルでPL5のPRをmergeしてmainブランチへpushし、main...
> yes please merge the PR locally and push and switch to...
---プロジェクトのステータス管理ファイル（CLAUDE.md）の更...
> please check CLAUDE.md is up to date with project status
---Contextウィンドウの容量が限界に達したため（/context）...
--チケットPL6の実装と機能向上
---追加の指示：Jiraチケット「PL6」に「PL5」の残件（「AIが...
>/feature-dev: feature-dev implement jira ticket PL-6.
「Also please make a couple of fixes. Ensure that after ...
And ensure that the AI always asks a follow-on question ...
then make a PR
---結果：AIがタスクを完了し、PL6のPR（16ファイル、2500行...
---最終テスト：~
・クラウドSaaS契約の生成をテスト。AIが質問を繰り返し、右...
Hello! I'll help you create a legal agreement. What ty...
- An NDA to protect confidential information?
- A Cloud Service Agreement for SaaS products?
- A Pilot Agreement to trial a product?
- Something else?
Just tell me what you're trying to accomplish and I'll...
> A cloud SaaS agreement
Great, a Cloud Service Agreement it is! Let's start ga...
First, could you tell me the name of the SaaS provider...
And what's a brief description of the cloud service yo...
> Please use invented placeholder names for both compani...
Sure, I'll use placeholder names. Let's call the provi...
Next, what start date would you like for the agreement...
> today please
Got it the effective date will be today (2026-02-05). ...
> New York, New York please
Great! I've noted the effective date as 2026-02-05, go...
Now we'll need a few more details:
1. How long is the subscription period (e.g., "1 year"...
2. What level of technical support will be provided (e...
> 1 year, business hours phone support
Got ita 1-year subscription with business-hours phone ...
Next, could you let me know the pricing structure (e.g...
> $10,000 per annum, net 30
Thanks for the details! Here's a summary of what we ha...
Cloud Service Agreement:
- Provider: Acme Cloud Solutions, Inc.
- Customer: Beta Enterprises, LLC
- Service: Al Assistant
- Effective Date: 2026-02-05
- Governing Law: New York
- Jurisdiction: New York, NY
- Subscription Period: 1 year
- Technical Support: business-hours phone support
- Fees: $10,000 per annum
- Payment Terms: Net 30
We have captured all required information, so the agre...
・ブランドカラーの適用や、最終的なPDFダウンロード機能を含...
+最終 PR merge、SaaS 完全デモ & Claude Code Week 2 勝利
--最終チケット（PL7）の実装と検証
---ローカルでPL6のPRをmergeしてmainブランチへpushし、main...
> please go ahead and merge the PR locally, and push, an...
---プロジェクトのステータス管理ファイル（CLAUDE.md）の更...
> please update CLAUDE.md to reflect the latest project ...
---プロセスの実行：Contextをクリアにした後（/clear）、Jir...
>/feature-dev: feature-dev implement jira ticket PL-7. T...
---動作確認（デモ）：サーバを再起動し、未ログイン状態での...
---評価と課題：~
・見栄えが非常に洗練されており、期待を大きく超える成果（...
・ただし、JIRAで指定した「法的免責事項」が記載されていな...
--GitHubへの反映と勝利宣言
---コードベースの規模：生成されたプルリクエスト（PR）を確...
---完了手続き：
・ClaudeにローカルでのPRのmerge、push、mainブランチへの切...
> please merge the PR locally and then push and then swi...
・およびプロジェクトの最新ステータスを反映した CLAUDE.md ...
> please update CLAUDE.md with latest project status
---技術的要素：JIRA/Gitのシームレスな統合に加え、裏側では...
--課題とコミュニティへのお願い
---課題：JIRAやGitHub Issuesにチケットを切り、Claude Code...
---成果の共有： 成果はLinkedInなどでハッシュタグや講師へ...
--次週（第3週）への展望
---プログラム全体の3分の2（67%）を終えたマイルストーンを...
---次週（最終週）は「さらにクレイジーでワイルドな内容」と...
**Week 3 [#w105632f]
Vibe Engineering as an expert（エキスパート向け）
-「コントロールされたカオス（Controlled Chaos）」をテーマ...
--マルチ・エージェント、サンドボックス環境の活用。
--大規模なコードベースへの対応、エージェント・スウォーム...
--最終的な集大成となるキャップストーン・プロジェクト。
-プロダクト
--Multi-Agents Sub-Agents Hooks
--Sandboxing
-コアスキル
--Large Codebase Workflow
--Swarms Orchestrators
-プロジェクト~
Project 4：Capstone
***Day 1 [#x55124a0]
65-71
+Claude Code Pro: サブ・エージェント、フック、スウォーム...
--日替わりスケジュール
---1日目（今日）：プロ向け機能の概観（カスタムコマンド、...
---2日目：サンドボックシング（環境の隔離と再現性の確保）
---3日目：大規模なコードベースにおけるデバッグと開発の成...
---4日目：スウォーム（群画）やオーケストレーターを用いた...
--核心概念：カオスとコントロールのバランス
---開発者は、AIがもたらす「爆発的な推進力（カオス）」と「...
---ゴールは「コントロールされたカオス」：まずは「コントロ...
|分類|特徴・具体的なアプローチ|主な技術・概念|h
|カオス (Chaos)|推進力の最大化|正のフィードバック。信頼し...
|コントロール (Control)|安全性と品質の担保|負のフィードバ...
--本日（1日目）学習するプロ向け機能~
本日、リポジトリを使って実際に手を動かしながら学ぶ機能は...
---カスタムSlashコマンド：独自のSlashコマンド（/command）...
---マルチ・エージェント vs サブ・エージェント：複数のClau...
---エージェントチーム：チームとしての協調（4日目に本格実...
---フック (Hooks)：Ralphループなどを実現するための仕組み
---独自プラグインの作成：チーム内での共有やマーケットプレ...
+FiNALLYプロジェクトのセットアップ：私たちのマルチ・エー...
--プロジェクトの概要
---今週の課題は、コースの集大成（キャップストーン・プロジ...
---複数のAIエージェント（マルチ・エージェント）を協調・制...
--アプリケーションの機能とビジョン
---AI搭載のトレーディング・ワークステーション：見た目や操...
---余談：「ブルームバーグ端末に手を出すな」（WSJ）では「...
---ライブ市場データのストリーミング：SSE（Server-Sent Eve...
---シミュレーション取引：ユーザーは仮想ポートフォリオで取...
---LLMアシスタントの統合：ポートフォリオの分析や取引の代...
--技術スタックとアーキテクチャ
---データベース：シンプルさを維持するため、前回同様にSQLi...
---デプロイ：複雑化を避けるため指示により単一のDockerコン...
--開発の進め方と初期リポジトリの構成~
指定のリポジトリ（https://github.com/ed-donner/finally）...
> git clone https://github.com/ed-donner/finally.git
---Claude.md：すべてのコーディング・エージェントがこの pl...
---配置場所を明示する目的で、空のディレクトリ群（backend...
---planning/PLAN.md：https://github.com/ed-donner/finally...
・ビジネス要件やアーキテクチャが定義された最重要書類（冒...
・全エージェントが planning/PLAN.md に準拠してプロジェク...
+Claude CodeでのカスタムSlashコマンドの作成~
※ ココで新規作成したリポジトリに存在しないカスタムSlashコ...
--Slashコマンドの概要と作成方法~
開発ツール（Claude Code）において、独自の「Slashコマンド...
---方法①：commands フォルダを使用する（従来の標準的な方法...
・手順：プロジェクト内（またはホームディレクトリ内）の .c...
・定義方法：その中に、作成したいコマンド名（小文字＋ハイ...
例：Review the documentation file in the planning folde...
・引数の利用：プロンプト内で $ARGUMENTS（すべて大文字）と...
・メリット：YAML形式のメタデータ（フロントマター）を書く...
---方法②：skills フォルダを使用する（現代の主流）~
・もう1つの方法は「スキル（Skills）」として定義する方法~
・.claude 内の skills フォルダに定義を追加するだけで、そ...
・現在の開発においては、この「Skills」としてSlashコマンド...
・以前実装したSkillsのnameをSlashコマンドで使用できるよう...
・https://raw.githubusercontent.com/ed-donner/prelegal/...
・https://raw.githubusercontent.com/ed-donner/finally/r...
--実践：ドキュメントレビュー（doc-review）コマンドの実行~
計画書ファイル（PLAN.md）のレビューを行うコマンドを実際に...
> /doc-review PLAN.md
---人間の監視と裁量の重要性：~
・AI（Claude Opus 4.6）は指示通り「質問・明確化・修正点」...
・しかし、AIが提案した「簡素化」の多くは、システムの将来...
・同意できる（以下の）1点のみを残して却下。AIの提案を鵜呑...
システム設計（データベースやAPIなど）における数量（quant...
・指摘の内容現状：positions/trades（ポジションや取引）の...
・懸念点：もし「単元株（整数）」のみを扱うのであれば、IN...
・提案：REAL が意図的なのであれば、バリデーション（入力...
・回答：はい、端数株（fractional shares）をサポートすべ...
・レビューの指摘に対するフィードバックに基づきPLAN.mdを更...
> I've updated the comments at the end of PLAN.md with m...
---通常のコマンドとサブ・エージェントの違い：~
・今回のような通常のコマンドやスキルは、すべてメイン・チ...
・一方で、今後学ぶ「サブ・エージェント」は別のLLMコールを...
--まとめ
---どちらの方法で作成した場合も、.claude ディレクトリに保...
---今週の講義では、このようなレビューや開発のプロセスをさ...
+Claude CodeとCodex CLIを使ったエージェント＆サブ・エージ...
※ ココで新規作成したリポジトリに存在しないサブ・エージェ...
--マルチ・エージェントの基本と課題
---マルチ・エージェントの単純なアプローチ：ターミナルのタ...
---現状の課題：開発計画の連携や境界線が十分に定義されてい...
--異なるCLIエージェント（Codex）との連携
---講義内の実験として、Claude Codeとは異なるAIエージェン...
> npm i-g @openai/codex
> codex
---codex exec コマンドを使用し、シェル（ターミナル）経由...
> codex exec "ase review the file planning/PLAN.md and w...
---これにより、複数の異なるAIモデルを別々のエージェントと...
--サブ・エージェントの作成とメリット
---サブ・エージェントとは：メインのClaude Codeから特定の...
---主なメリット：~
・コンテキストの分離: メインエージェントのトークン（記憶...
・コストと速度の最適化: 処理に応じて「Haiku」のような軽量...
・並行処理: 複数のタスクを同時に実行できる。
--カスタム・サブ・エージェントの構築：
---プロジェクト内の .claude/agents/ フォルダに reviewer.m...
---
name: reviewer
description: carry out a comprehensive review when reque...
---
You review the file planning/PLAN.md and write your feed...
---他にも以下のような属性を設定できるらしい（必須は name ...
tools: Read, Glob, Grep
model: opus
...disallowedTools, permissionMode, maxTurns, skills, mc...
---Slashコマンドではなくプロンプトで指示を出すことで、メ...
> Use the reviewer agent to carry out a reivew
--なお、/agentsコマンドで以下の項目を確認・実行できる。
---Create new agent：平易な英語の説明文から、Project or P...
・.claude/agents/ → プロジェクト固有（チームで共有可能）~
・~/.claude/agents/ → 全プロジェクト共通（個人用）エージ...
---Project agents：定義したプロジェクト・チーム用エージェ...
---Personal agents：定義した個人用エージェント
---Plugin agents：Slashコマンド、サブ・エージェント、MCP...
---Built-in agents：Explore（ファイルの読み取りはできるが...
+Claude Codeにおけるサブ・エージェント vs エージェント・...
※ ココで新規作成したリポジトリに存在しないサブ・エージェ...
--Claude Codeにおけるサブ・エージェントの活用（異種LLMの...
---.claude/agents/codex-reviewer.md に、以下のようにシェ...
---
name: codex-reviewer
description: carry out a comprehensive review of PLAN.md...
---
You are using a different AI Agent to carry out a review...
You MUST execute the following shell command to carry ou...
*codex exec "Please review the file planning/PLAN.md and...
This will run the review process and save the results. D...
---サブ・エージェントを起動し、メインの文脈（コンテキスト...
> Use your codex-reviewer subagent to carry out a review...
---.claude/agents/change-reviewer.mdに、以下のように特定...
---
name: change-reviewer
description: carry out a compehensive review of all chan...
---
This subagent reviews all changes since the last commit ...
IMPORTANT: You should not review the changes yourself, b...
Run this shell command:
codex exec "Please review all changes since the last com...
This will run the review process and save the results. D...
---サブ・エージェントを起動し、メインの文脈（コンテキスト...
> use the change-reviewer subagent to review changes sin...
---サブ・エージェント、外部LLM（Codex）とのやり取りは独立...
--「サブエージェント」と「エージェントチーム」の違い
|機能|特徴・役割|h
|サブ・エージェント（Sub-agents）|メインのClaude Codeから...
|エージェント・チーム（Agent teams）※実験的機能|複数のCla...
+Claude Code Hooks：イベント＆コマンドによる自動レビュー...
--Claude Code の「フック（Hooks）」機能の概要~
日常的でない特定の状況（イベント）において自動で特定の処...
---仕組み: 特定の「イベント」が発生した際、あらかじめ設定...
---イベントの例：~
・ツール実行の前（Pre tool use） / 後（Post tool use）~
・ユーザーへの権限確認時（例：確認時にスマホへ通知を飛ば...
・Claude が作業を終了・停止する時（Stop / Session end）な...
---トリガーできる3つの処理~
・Command（シェル・コマンドの実行）: 最も確実でバグが起き...
・Prompt（Claudeへのプロンプト指示）: 新たな指示を Claude...
・Agent（サブ・エージェントの起動）: コンテキストを汚さず...
--実装例：作業終了時に自動コードレビューを行う~
Claude が作業を終えたタイミング（stop イベント）で、自動...
---設定場所：プロジェクト内の .claude/settings.json（また...
{
"hooks": {
"Stop": [{
"hooks":[
"type":"command",
"command": "codex exec \"codex exer "Review chan...
]
}]
}
}
---設定方法：~
・/hookコマンドでStopを選択し、
/hooks
Hooks
6 hooks
1. PreToolUse Before tool execution -
2. PostToolUse After tool execution
3. PostToolUseFailure After tool execution fails
4. Notification -When notifications are sent
5. UserPromptSubmit When the user submits a prompt
6. SessionStart When a new session is started
> 7. Stop Right before Claude concludes its response
8. SubagentStart When a subagent (Task tool call) is s...
9. SubagentStop - Right before a subagent (Task tool c...
10. PreCompact Before conversation compaction
11. SessionEnd When a session is ending
12. PermissionRequest - When a permission dialog is di...
13. Setup Repo setup hooks for init and maintenance
14. TeammateIdle When a teammate is about to go idle
15. TaskCompleted When a task is being marked as compl...
16. Disable all hooks
・定義したフックを選択する。
Stop
Exit code 0 stdout/stderr not shown
Exit code 2 show stderr to model and continue conversation
Other exit codes show stderr to user only
1. + Add new hook...
> 2. codex exec "Review changes since last commit and wr...
---動作の流れ：~
・事前に、ココまでで作成した、カスタムSlashコマンドやサブ...
・ユーザーが Claude に「README.md を作成して」と指示。Cla...
> please make a concise README.md for the project
- Let me check the current project state first.
- Searched for 1 pattern, read 2 files (ctrl+o to expand)
- Both backend/ and frontend/ are empty the project is i...
- Write (README.md)
Done. The README covers the essentials what the project ...
・フックが発動し、バックグラウンドで codex exec コマンド...
・Claude 自身は裏でレビューが動いたことを認識していないが...
--まとめ、注意点とアドバイス
---フックは開発プロセスを高度に自動化できる強力なツールだ...
---最初から無理に覚えようとせず、「こういうことができる」...
+カスタムClaude Codeプラグインとマーケット・プレイスの構築
--独自プラグインとマーケット・プレイスの作成・導入~
Claude Codeにおける独自プラグイン（例: 変更点を自動レビュ...
---プラグインの作成手順~
・フォルダの作成：任意の場所にプラグイン用の新規フォルダ...
・設定フォルダとマニフェスト：その中に .claude-plugin と...
{
"name": "independent-reviewer",
"description": "Carry out an independent review of all...
"version": "1.0.0"
}
・機能の追加：役割に応じて、プラグイン・フォルダ内に以下...
commands、skills、agents、hooks ... ココでは先ほど定義...
{
"hooks": {
"Stop": [{
"hooks":[
"type":"command",
"command": "codex exec \"codex exer "Review chan...
]
}]
}
}
---マーケット・プレイスによる共有とインストール~
・マーケット・プレイスの定義：リポジトリのルートに .claud...
{
"name": "ed-tools",
"owner": {
"name": "Ed",
"email": "ed@edwarddonner.com"
},
"plugins": [{
"name": "independent-reviewer",
"source": "./independent-reviewer",
"description": "Carry out an independent review of a...
"version": "1.0.0",
"author": {
"name": "Ed"
}
}]
}
・Claude Codeへの導入：/plugin コマンドを実行し、Marketpl...
・ローカルパス（./）やGitHubのURLを指定してマーケット・プ...
・Discoverメニューからマーケット・プレイスに追加したプラ...
・意図した指示を出してプラグインを動作確認する。
> please write a concise project README.md
- Let me read the current README and check project state...
- Read 4 files (ctrl+o to expand)
- The project is still early no Dockerfile or scripts ye...
- Write (README.md)
Done. The README covers the project vision, features, ar...
--特定のタスクをメインのClaude Codeから切り離して並行処理...
|メリット|デメリット|h
|並行処理と自己修正：複数のサブ・エージェントが協調し、相...
|コンテキストの節約：メインのClaude Codeのコンテキスト（...
|タスクの特化：1つのタスクに特化させることで、プロンプト...
--次回の予告
---翌日は、さらに重要なテーマである「サンドボックス化（Sa...
---今回触れられなかった「MCPサーバー」や「LSPとの組み合わ...
---現在全体の「73%」完了、ここからさらに実践的で難易度の...
***Day 2 [#w85c3fa2]
72-77
+Claude Codeのサンドボックス化とクラウド実行の徹底解説
--前日の復習：Claude Codeのプロ機能（Slashコマンド、サブ...
---フォーカスの絞り込み：Slashコマンド: 現在はほぼ「スキ...
---フック/プラグイン：特定の課題解決やチーム共有には便利...
---今後の中心：自身やチームのレポジトリで活用できる「スキ...
---汎用的なスキル：これらの機能（特にスキル）はAnthropic...
---プラグインの高度な構成ファイル：~
・.mcp.json: プラグインに含まれる[[MCP（Model Context Pro...
・.lsp.json: [[LSP（Language Server Protocol）>https://te...
--サブ・エージェントのメリット・デメリット
---メリット: 処理をサブエージェントに委譲することで、メイ...
---デメリット：コンテキストの分離特性に起因。詳細な使い分...
--本日の主要テーマ：サンドボックス化（Sandboxing）~
セキュリティ面の強化だけでなく、開発の生産性を劇的に向上...
---リソースの隔離（リングフェンス）：ファイルの読み書きを...
---「YOLO（一か八か）」な生産性の実現：安全な環境が担保さ...
---「承認疲れ（Approval Fatigue）」の解消：~
・サンドボックス化されていない環境では、AIの行動に対して...
・しかし、人間は慣れてくると内容を確認せずにボタンを連打...
+Claude Code on the Webでのリモート実行＆クラウド・サンド...
主流だったコンテナ環境構築から一歩進んだ「コーディング・...
（開発のスタイルがコーディング・エージェントを「自分のPC...
--ローカル・ネイティブ・サンドボックス（Local Native Sand...
---特徴：自分のパソコン（ローカル）上で動かす軽量なサンド...
---使い方：/sandboxコマンドで起動。環境内でのAIの操作が自...
---注意点：MacやLinuxユーザーは簡単に使えるが、Windowsユ...
--マネージド・クラウド・サンドボックス（Claude Code on th...
---特徴：Anthropic社側のクラウド上でClaude Codeを立ち上げ...
---主な機能・使い方：~
・手軽な呼び出し: 命令の先頭に &（アンパサンド）を付ける...
・GitHub連携：GitHubの「Claude GitHub App」を導入すると、...
・テレポートとタスク管理：/tasks コマンドで実行中の複数タ...
--3rd party による外部サンドボックス（3rd party Claude Sa...
---特徴：Anthropic社公式ではなく、別の企業が提供する「AI...
---具体例：Fly.ioのチームが手がける Sprites.dev というサ...
---メリット：Claude Codeだけでなく、ユーザーが選んだあら...
+Claude CodeサンドボックスとGitHub連携のセットアップ~
Claude Codeにおける2つの主要なサンドボックス設定手順（①ロ...
--ローカルでのサンドボックスモードの設定
---概要：.claude 設定内の不要なファイルを整理した状態から...
---設定方法：Claude Code 内で /sandbox コマンドを実行し、...
Sandbox: Mode Overrides Config
（Mode）Configure Mode:
> 1. Sandbox BashTool, with auto-allow
2. Sandbox BashTool, with regular permissions
3. No Sandbox (current)
（Overrides）Configure Overrides:
> 1. Allow unsandboxed fallback (current)
2. Strict sandbox mode
- Allow unsandboxed fallback: When a command fails due t...
- Strict sandbox mode: All bash commands invoked by the ...
Learn more: code.claude.com/docs/en/sandboxing#configure...
（Config）
Excluded Commands:
None
Filesystem Write Restrictions:
- Allowed: /dev/stdout, /dev/stderr, /dev/null, /dev/tty...
- Denied within allowed: /Users/ed/.claude/settings.json...
---メリット：Claude が承認なしで自由に Bash スクリプトの...
---実演：市場データAPIの調査やシミュレータのドキュメント...
> Please carry out comprehensive research and write 3 do...
write documentation with code examples in MASSIVE_API.md...
document this in MARKET_INTERFACE.md. Finally, document ...
---注意点：詳細な設定やセキュリティに関する注意点は公式ド...
--Web版 Claude（GitHub連携）のセットアップ
---概要：ブラウザ（claude.ai/code）および GitHub リポジト...
---手順：~
・https://claude.ai/code （Web）にアクセスし、LLMにやりた...
・GitHub側の連携画面が表示されるので認可を行い、Claude側...
・Claude CLIを起動し「/install-github-app」と入力して表示...
・Claude CLIを再起動し「/install-github-app」と入力してリ...
・問題なければ、CLI側をEnterで進め「インストールするGitHu...
・「Create a long-lived token with your Claude subss@ipti...
・「Claude Codeは、あなたのClaudeチャット・アカウントに接...
・PRをマージしてpullすると、.github/workflowsフォルダに「...
・Claude CLIを再起動し「/install-github-app」と入力すると...
・「> hey what's 2 + 2」を「& hey what's 2 + 2」や「claud...
・また、https://claude.ai/code （Web）のChatウィンドウか...
Please read all the documents in the planning directory....
---結果：リポジトリ内に .github/workflows フォルダと設定...
+Claude Codeをリモートで実行する5つの方法：「&」「--remot...
--① ローカルセッション内でのコマンド実行
---方法：ローカルで起動しているClaude Codeのセッション内...
>& hey what's 2 + 2
---特徴：~
・コマンドはローカルではなくクラウド上のサンドボックス環...
・これまでの会話の文脈（フルコンテキスト）がすべてクラウ...
--② ターミナルからの直接実行
---方法：ターミナル（コマンドライン）で claude --remote [...
> claude -remote "what is 2+2"
---特徴：1と同様にクラウド側で処理が実行される。
--③ Webブラウザ（https://claude.ai/code）の利用
---方法：ブラウザで専用UIを開き、クラウド環境をセットアッ...
Please read all the documents in the planning directory....
---特徴：ローカルマシンのリソースを一切消費しない。~
・「設計ドキュメントの作成」を指示し、10分ほどで1490行の...
・GitHubへpushされるのでPRしてmergeする。※プレビュー版の...
--④ モバイルアプリの利用
---方法：スマホのClaude公式アプリから「Code」ナビゲーショ...
---特徴：Webブラウザ版と全く同じI/F。出先などPCがない環境...
--⑤ GitHub Issueとの連携（Claude Bot）
---方法：自身のGitHubリポジトリで新しいIssue（課題）を作...
Title：Build complete Market Data backend #3
Content：@claude
Read all the documents in the planning directory, then b...
1. The Massive API interface
2. The unified market data interface
3. The market data simulator
Include full unit tests
---特徴：~
・投稿すると自動的にバックエンドでClaude Codeのインスタン...
・Jiraのチケットを割り振るように、複数のIssueを作ってClau...
--全体のまとめ
---Claude Codeをクラウドで実行することにより、ローカルマ...
---特にGitHub Issueとの連携（5つ目の方法）は、タスク管理...
+3rd party クラウド・サンドボックス：Sprites.devでのClaud...
--GitHub連携による自動プルリクエスト
---AIエージェントにタスクを指示したところ、わずか数分で90...
---AIが作成したブランチからGitHub上でプルリクエスト（PR）...
---この手法を使えば、開発者はGitHubのIssue（課題）を次々...
--リモート実行における3つのアプローチ
講義の中でカバーしている「AIコードの実行環境」に関する3つ...
---ネイティブのサンドボックス環境（/sandbox）を使用し、承...
---Web上のサンドボックスでClaudeを実行する5つの手法（モバ...
---3rd partyのクラウド・サンドボックスを利用する手法（オ...
--Sprites.devの導入と実践（≒ この辺 https://docs.sprites....
---概要：fly.ioが開発して話題の「Sprites.dev」を紹介。こ...
---登録：https://sprites.dev/ からクレカ登録（無料枠あり...
---起動：sprite create <名前> コマンドを叩くと、わずか0.6...
> sprite create finally-worker
---実演：
・立ち上がった環境でGitHubリポジトリをクローン
> sprite@sprite:~# git clone https/github.com/ed-donner/...
> sprite@sprite:~# cd finally
> sprite@sprite:~/finally# ls
backend CLAUDE.md LICENSE planning README.md
・プリインストールされている「Claude Code」を起動。
> sprite@sprite:~/finally# claude
・認証して、立ち上がった環境で「Claude Code」を実行。
Claude Code can be used with your Claude subscription or...
Select login method:
> 1. Claude account with subscription Pro, Max, Team, or...
2. Anthropic Console account API usa af billing
3. 3rd-party platform Amazon Bedrock, Microsoft Foundr...
---利点：ローカルPCを一切汚さず、YOLOの重いタスクをサンド...
> Please read all the documentation in the planning fold...
+クラウド・サンドボックス総まとめ：Sprites.devとGitHub PR...
--Claude Codeを用いたGitHub連携のワークフロー
---トラブルと解決：Claude CodeにGitHubへの変更プッシュを...
ARGUMENTS: I need to push a git branch to GitHub but gh ...
...
Once you provide a GitHub token or authenticate via gh a...
> OK. I've logged you in to github please try now
---成果：Claudeは自動的にbranchを作成してGitHubへpush、PR...
> OK I've merged please switch to main and do a pull. Th...
--リモート・サンドボックス（sprites.dev）での自律的な開発
---効率的なデバッグ：開発環境を sprites.dev（Fly.io提供の...
---安全性と生産性の両立：完全なサンドボックス化でローカル...
--本日紹介された3つのサンドボックス手法のまとめ
---内蔵サンドボックス：ローカルPC上で動作する、Dockerコン...
---Anthropicの遠隔実行環境：Anthropicが提供するリモート環...
---3rd partyのクラウド・サンドボックス（sprites.dev）：VS...
--次回（明日以降）の予告
---コースの80%が終了。
---次回（明日）：多くの開発者が懸念する「大規模なコードベ...
---次々回（明後日）：現在トレンドとなっている「スウォーム...
***Day 3 [#me0cab02]
78-82
+大規模コードベースでのClaude Code、Codex、Sprites.dev活用~
大規模なコードベース、大開発チーム、そして「Claude Code」...
--これまでの機能の振り返り（Pro機能・サンドボックス）
---SlashコマンドとSkills：Claude Codeでのコマンド実行や機...
---マルチ/サブ・エージェント：~
・（単純な）マルチ・エージェント：複数のClaudeを同時に走...
・サブ・エージェント：特定のタスク（大量のファイルを探索...
---プラグイン：Skillsやサブエージェントなどをパッケージ化...
---サンドボックス（セキュリティ対策）：安全にコードやシェ...
・コマンドの前に「&」を付けることで、会話コンテキストをリ...
・Sprites.dev：状態が保存され、起動が非常に速いサードパー...
--リモート環境を用いたゼロショット開発の実証デモ
---前日の講義後、リモートのSprite環境（サンドボックス）で...
---ローカル環境にその成果物を git pull して実行したところ...
>git pull
Already up to date.
---株価ティッカー、価格変更（赤と緑の色分け表示）、テキス...
>cd backend
>uv run market_data_demo.py
|FinAlly Market Data Simulator | 17.7s elapsed | 42.3s r...
|---------------------------------------- Live Prices --...
|Ticker | Price | Change | Chg % | | Sparkline|
| AAPL | $189.97 | +0.01 | +0.01% | | |
| GOOGL | $174.93 | -0.01 | -0.01% |
| MSFT | $420.17 | -0.02 | -0.00% |
| AMZN | $184.99 | -0.01 | -0.01% |
| TSLA | $249.85 | -0.05 | -0.02% |
| NVDA | $799.76 | -0.06 | -0.01% |
| META | 5500.03 | +0.01 | +0.00% |...
+大規模チームのコードベースでClaude Codeを使うためのベス...
大規模なチームや大規模なコードベースにおいて、高度なコー...
--適切なドキュメント管理（agents.md の活用）
---階層的な記述：各サブディレクトリに agents.md や cloud....
---適切なコンテキスト制御：大きな文書を直接 @ タグで読み...
--チーム内での一貫したワークフローとプラグインの導入
---プロセスの統一：GitHubでのClaudeのタグ付けや、JIRAによ...
---プラグインとスキルの活用：FeatureDev などの「プラグイ...
--テスト駆動開発（TDD）の戦略
---網羅率（カバレッジ）に固執しない：AIは網羅率を上げるた...
---意味のあるテストの要求：リファクタリングで壊れず、ロジ...
--人間の責任（レビュー文化）と「小分け」にした開発
---人間が最終責任を持つ：AIが生成する冗長で防衛的なコード...
---タスクの細分化：大規模プロジェクトにおいて「コードベー...
--推奨される練習（課題）~
大規模なOSSプロジェクトをクローンし、何が有効で何が機能し...
---ディレクトリ全体に agents.md を整備し、AIに「TODO」を...
---アンチパターン：全体の一括リファクタリングをラルフルー...
+Claude Agent SDKによるClaude Codeのプログラム的制御~
「Claude Agent SDK」を用いて、コード（Python）経由で「Cla...
--Claude Agent SDKの概要
---誤解の解消：名前は「Claude Agent SDK」だが、所謂、一般...
---本質：ターミナルから対話的に使う「Claude Code」の強力...
---旧称：以前は Claude Code SDK と呼ばれており、現在は「A...
---ユースケース：日常的ではないが、Claudeのプラグインやエ...
--デモの準備と環境構築
---VS Code上の完全に空のディレクトリから開発をスタート
---プロジェクト管理：~
・高速なPythonパッケージ管理ツール uv を使用。~
・uv init --bare で空のプロジェクトを作成。
> uv init -bare
Initialized project 'space
・使用Pythonバージョン：3.13~
> uv python pin 3.13
Pinned python-version to 3.13
---インストールした主要ライブラリ：~
・python-dotenv：APIキーなどの環境変数管理用。~
・requests：HTTPリクエスト用。~
・claude-agent-sdk：本デモの核となるSDK。
> uv add python-dotenv requests claude-agent-sdk
--実装コードのポイント (main.py)~
プログラムからClaude Codeを動かすための主要な処理は以下の...
---ファイルの作成：main.py、.env、.gitignore
---main.pyに以下を実装
import asyncio
from dotenv import load_dotenv
from claude_agent_sdk import query, ClaudeAgentOptions
load_dotenv(override=True)
PROMPT = ""
TOOLS = []
async def main():
---プロンプトの設定：
PROMPT = """
Make a vanilla HTML+JS+CSS website for a game of Space I...
"""
（現在のディレクトリに index.html を含む、素HTML/JS/CSS ...
---ツールの付与：Claudeに対し、read、write、editファイル...
TOOLS = ["Read", "Write", "Edit", "Bash", "Glob", "Grep"...
---モデルの指定：デモ用に贅沢に Claude Opus 4.6 を指定（※...
---実行ルーチン：async for message in query(...) を使い、...
async def main():
options = ClaudeAgentOptions(allowed_tools TOOLS, mode...
async for message in query(prompt=PROMPT, options=opti...
print(message)
asyncio.run(main())
--実行結果と成果物~
コードを実行すると、プログラムから呼び出されたClaudeが自...
> uv run main.py
---成果物：完全に動作する index.html。
---ゲームのクオリティ：~
・効果音（サウンド）が実装されている。~
・キーボードの矢印キーで自機を操作できる。~
・スコア機能や、最上部を移動するUFO（インベーダー）も再現...
・チープなものではなく、カラーや挙動も含めて非常に完成度...
---考察：~
・トレーニングデータ（学習データ）に類似のコードが含まれ...
・Pythonスクリプトを1度実行しただけでここまでのゲームが自...
+Claude Cowork：日常業務向けエージェントAIデモ~
Anthropic社の強力なエージェント機能を、日常的な事務・ビジ...
--主な特徴と機能
---対象ユーザー：エンジニアだけでなく、一般のビジネスパー...
---利用方法：https://claude.com/product/cowork から「Clau...
---出来ること：画面のスクリーンショットの整理、週のスケジ...
--デモの内容（経費精算書の自動作成）
---共有：「Work in folder」から「receipts（領収書）」フォ...
---指示：「これらの領収書をレビューして、Excelファイル（e...
In the folder that I've shared with you, there are a bun...
---処理：Claude CoWorkが自動で処理を開始。PDFを画像として...
---結果：指定したフォルダ内に、綺麗にフォーマットされたEx...
--結論：エンジニアにとって非常に役立つ「Claude Code」の魔...
+OpenClaw：Telegram＆WhatsAppで使えるパーソナルAIサイドキ...
--OpenClaw（オープンクロー）の概要
---位置付け：現在非常に注目（ハイプ）されている個人向けの...
---名称の変遷：ClaudeBot（Anthropicから手紙を受け取った）...
---特徴：~
・コーディング・エージェント（Claude Codeなど）の思想を、...
・PCに直接インストールし、ローカル環境のファイル、ブラウ...
・ユーザーは主に TelegramやWhatsAppなどのチャットアプリ ...
--セキュリティとリスク
---高いリスク：PCの全権限を握るため、悪意あるプロンプト（...
---利用の前提：セキュリティ専門家からも懸念されており、導...
--インストールとセットアップ手順（デモ内容）
---手順：~
・ターミナルからワンライナー（1行のコマンド）でインストー...
・モデル認証プロバイダーの選択：デモでは OpenAI の ChatGP...
・デフォルト・モデル：Keep current (openai-codex/gpt-5.3-...
・チャネル：連携チャットツール（Telegram）の設定（BotFath...
・スキル（プラグイン）の導入（デモではnpmを選択し、音声認...
・AIの名前やキャラクター（バイブス、絵文字）を設定。
--実際の動作デモ
---指示内容：~
・Telegramを使用して指示~
・「テスラの株価を調べて、今日上がっていれば陽気な曲を、...
---AIの自律的な挙動：~
・ウェブ検索でテスラの株価が上昇したことを確認。~
・「陽気な曲」という条件から、ダイアナ・ロスの「Upside Do...
・PC上の Spotifyアプリを勝手に起動・操作 して音楽を再生し...
--本セッションのまとめと次回予告
---本日のまとめ：大規模リポジトリへのアプローチ方法を学ん...
---次回予告: 明日は「スワーム（Swarms）」やチーム開発、複...
***Day 4 [#v4c23692]
83-88
※ 前提：[[（本格的な）マルチ・エージェント>LLMエージェン...
+Claude Codeエージェントチーム：スウォームとオーケストレ...
AIエージェントの大量運用における「スウォーム（群れ・混沌...
--スウォーム（Swarms）とオーケストレーション（Orchestrati...
---段階的進化：Steve Yegge氏のチャートにおけるステージ7（...
---連続性：これらは二者択一ではなく、自由な混沌から厳密な...
--「Claude Agent Teams」とは~
複数のClaude Codeインスタンスを連携させて1つの目標を達成...
---役割分担：「チームリード（全体管理・タスク割り当て）」...
---サブ・エージェントとの違い：~
・サブ・エージェント：メインのClaudeの補助として一時的に...
・エージェント・チーム：各自が独立したフル文脈（Context W...
・サブエージェントとの比較：どちらも並列処理を可能にする...
||サブエージェント|エージェントチーム|h
|コンテキスト|独自のContextウィンドウを持ち、結果は呼び出...
|通信|結果をメイン・エージェントにのみ報告|チームメンバー...
|連携|メイン・エージェントがすべての作業を管理|自己連携機...
|最適な用途|結果のみが重要な集中型タスク|議論とコラボレー...
|トークンコスト|低：結果はメインコンテキストに要約されて...
|選択基準|迅速かつ集中して作業を行い、結果を報告してくれ...
---主なユースケース：~
・複数ソース（WikipediaやStack Overflowなど）の並行リサー...
・システムの独立したモジュールごとの並行開発。~
・開発レイヤー（フロントエンド、バックエンドなど）に応じ...
--実装の5ステップと操作方法
---設定の変更：settings.json で experimental agent teams ...
---モード選択：~
・全プラットフォーム対応の画面切り替えモード（in process...
・なお、画面分割モード（tmux）は、ターミナル画面を分割で...
---チームの起動：Claudeに対して「〇〇のためのエージェント...
---操作と制御：
・Shift + Tab で委譲モードにし、リードが勝手に作業しない...
・Shift + ↑ / ↓ で表示するエージェントを切り替え。
---終了処理：
・個別にシャットダウンを命じるか、
・全体をクリーンアップするコマンドを送る。
--実践における3つの留意点
---CLAUD.md の活用：全エージェントの文脈に読み込まれるた...
---高コストへの覚悟：トークン消費が激しいため、無料モデル...
---試行錯誤の前提：非常に実験的で予測不能な動きをすること...
+フルスタック開発のためのClaude Codeエージェントチームの...
--開発環境のクリーンアップと現状確認
---VS Code環境の確認：~
・.cloud フォルダ内のエージェント、コマンド、設定、MCPサ...
・制御不能に陥る可能性があるため、特に、サブ・エージェン...
---既存スキルの維持：唯一存在している Cerebras inference...
--プラグインのインストールとドキュメント整備
---プラグインの追加：制御不能になるサブエージェントを生成...
・front-end design：プロダクション品質のフロントエンドを...
・context7：LLMに最新のライブラリやツールのドキュメント情...
・playwright：ブラウザを起動してテストを実行できるように...
---設定の反映：プラグインを有効化するため、一度Claude cod...
---CLAUDE.md の更新：必要な時だけドキュメント（PLANNED.md...
# FinAlly Project the Finance Ally
All project documentation is in the `planning` directory.
The key document is PLAN.md included in full below; the ...
@planning/PLAN.md
--「エージェント・チーム」機能の有効化と設定
---Gitブランチの作成：いつでも戻れるように agent teams と...
---settings.json の変更：環境変数 Claude code experimenta...
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
"teammateMode": "in-process"
}
---動作確認：Claude（Opus 4.6）を起動。トークン使用量（/u...
--チームの結成とタスクの実行
---エージェント構成の指示: フロントエンド、バックエンド、...
> Create an Agent Team to complete the project as defined.
Team-members: a Front-end engineer to work on the fronte...
While all team-members should work on unit tests, there ...
Finally, a Devops engineer for the Docker container and ...
プロジェクトを規定どおりに完了させるためのエージェントチ...
チームメンバーは、フロントエンドを担当するフロントエンド...
すべてのチームメンバーは単体テストに取り組む必要がありま...
最後に、Dockerコンテナとスクリプトを担当するDevOpsエンジ...
注記：チャットのノイズが増えるのを防ぐため、コード・レビ...
---実行と進捗：~
・Shift + Tabで計画 → 実行モードに切り替え、プロンプトを...
- I'll start by exploring the current project state, the...
- Explore (Explore current project state)
- ...
- Now let me set up the task dependencies.
- Good. Now let me spawn the team members. Tasks 1 (Data...
- Task(Database Engineer agent)
- Symbioting... (7m 54s 31.8k tokens thought for 385)
- Build SQLite database layer
- Build Next.js frontend application
- Build FastAPI application and REST API endpoints blo...
- Build LLM integration with OpenRouter/Cerebras > blo...
- Build Docker container and deployment scripts blocke...
- Build Playwright E2E test suite blocked by #2, #3, #...
・データベースエンジニア（SQLite構築）とフロントエンドエ...
|Role|Agent|Task|Status|h
|Database Engineer|db-engineer|#1 SQLite database layer|I...
|Frontend Engineer|frontend-engineer|#3 Next.js frontend|...
|Backend API Engineer|(waiting)|#2 FastAPI endpoints|Bloc...
|LLM Engineer|(waiting)|#4 LLM integration|Blocked by #1,...
|DevOps Engineer|(waiting)|#5 Docker & scripts|Blocked by...
|Integration Tester|(waiting)|#6 E2E Playwright2tests|Blo...
The Database Engineer and Frontend Engineer are working ...
- Building SQLite database layer... (8m 15s 66.5k tokens...
- Build SQLite database layer (@db-engineer)
Running Add aiosqlite dependency...
- Build Next.js frontend application (@frontend-engine...
Reading 2 files......
- Build FastAPI application and REST API endpoints blo...
- Build LLM integration with OpenRouter/Cerebras block...
- Build Docker container and deployment scripts blocke...
- Build Playwright E2E test suite blocked by #2, #3, #...
---UIの操作：ターミナル上で「Shift + ↑ / ↓」を押すことで...
+マルチ・エージェント・チーム構築：Claude Opusによるライ...
AIエージェントチーム（マルチエージェントシステム）を活用...
--エージェントの協調動作と開発プロセス~
開発はチームリード（AI）の統率のもと、複数の専門エージェ...
---前半のフロー：データベースエンジニアによるSQLセットア...
---後半のフロー：その後、LLMエンジニア、フロントエンドエ...
---進捗管理：ユーザーは手動でアクセス権限（chmodなど）やD...
--テストとバグ修正~
すべての開発タスクが完了した後、最終エージェントであるイ...
---11分間に及ぶテストの結果、フロントエンドのクラッシュを...
---元のフロントエンド開発者が修正するのではなく、インテグ...
---CSSのレイヤーオーバーラップという軽微な未解決事象はあ...
--アプリケーションの動作検証（ゼロショットの成果）
---ユーザーはローカル環境（Mac用起動スクリプトを実行）で...
> scripts/start_mac.sh
---UI/UX：左側にリアルタイムで点滅するマーケットデータウ...
---AIアシスタント機能：チャットUIから「SPYをウォッチリス...
> Please add SPY to the watch list
SPY has been added to your watchlist.
Watchlist: add SPY
> please buy 1 share of V
Executed purchase of 1 share of V at market price.
Executed: BUY 1 V8 279.96
> please give me some trading advice
Your portfolio is cash-heavy (～$9k) with small position...
Consider rebalancing: sell the under-performing JPM posi...
> please do this for me
Sold your 2 shares of JPM at market price to free cash f...
Executed: SELL 2 JPM 187.57
---課題・不満点：画面内の一部の株価チャートが表示（描画）...
--クリーンアップと次のステップ
---検証後、アプリケーションを停止し、Gitを用いたソースコ...
> scripts/stop_mac.sh
> git add .
> git status
---生成されたコードに不要なモジュールや環境変数ファイル（...
> git status
---新たに作成したブランチ（agent-teams）に成果物をcommit...
> git commit -m "Agent Teams v1"
> git push origin agent-teams
> git checkout main
---この後、frontendフォルダを削除して、settings.json の変...
+GSD：仕様駆動設計とマルチ・エージェント・オーケストレー...
開発ツール（ClaudeやCloud Codeなど）における新しいオーケ...
--紹介：
---Vibe codingは評判が良くありません。欲しいものを説明す...
---GSDはそれを解決します。GSDはContextエンジニアリング・...
---対象者：欲しいものを説明し、それを正しく構築したい人。...
--概要：これまで行ってきた仕様駆動設計（SDD（Spec-Driven ...
--GSDの概要：https://github.com/gsd-build/get-shit-done →...
---Claude Code、OpenCode、Gemini CLI、Kimi CLI、Kilo、Cod...
---中心的な成果物はテキスト・Markdownベースのファイル群（...
---「"I've done SpecKit, OpenSpec and Taskmaster - this h...
--GSDの特徴
---コンテキスト管理の最適化：開発が進むにつれてContextウ...
---ドキュメント管理の自動化：固定された構造のMarkdownファ...
---マルチエージェントの最適化：プロンプトの質にこだわり、...
---高い信頼性：いわゆる「雰囲気でのコーディング（Vibe cod...
--5段階のフェーズ・ループ：
---Discuss：計画前に実装上の決定を捉える。
---Plan：リサーチ・分解し、計画が新しいContextウィンドウ...
---Execute：並列ウェーブで200K tokenのContextから計画を実...
---Verify：構築したものを確認し、完了宣言前に診断・修正す...
---Ship：PRを作成し、フェーズをアーカイブし、次のフェーズ...
--主な手順とコマンドの流れ
---環境のクリーンアップ：以前のバージョンとの混同を防ぐた...
> git checkout -b finally-gsd
---GSDのインストール：インストールは「npx」から行う（ラン...
インタラクティブにランタイム（Claude Code、OpenCode、Gemi...
> npx @opengsd/gsd-core@latest
> git add .
> git commit -m 'Start of GSD process'
---ファイル操作毎に承認のための一時停止をしないように、YO...
> claude --dangerously-skip-permissions
---プロジェクトの初期化：コードベースをマッピングするため...
> /gsd:new-project
Existing Code
I detected existing code in this directory. Would you li...
> 1. Map codebase first
Run/gsd:map-codebase to understand existing archite...
2. Skip mapping
Proceed with project initialization
3. Type something.
4. Chat about this
Use skill "gsd:map-codebase"?
Claude may use instructions, code, or files from this Sk...
Analyze codebase with parallel mapper agents to produc...
Do you want to proceed?
> 1. Yes
2. Yes, and don't ask again for gsd:map-codebase in /U...
3. No
---設定のカスタマイズ：フェアな検証を行うため、デフォルト...
> /gsd:settings
Model Research Plan Check Verifier Submit
（Model）Which model profile for agents?
> 1. Quality
Opus everywhere except verification (highest cost)
2. Balanced (Recommended)
Opus for a Manning, Sonnet for execution/verification
3. Budget
Sonnet for writing, Haiku for research/verification...
4. Type something.
5. Chat about this
（Research）Spawn Plan Researcher? (researches domain be...
> 1. Yes
Research phase goals before planning
2. No
Skip research, plan directly
3. Type something.
4. Chat about this
（Plan Check ）Spawn Plan Checker? (verifies plans befor...
> 1. Yes
Verify plans meet phase goals
2. No
Skip plan verification
3. Type something.
4. Chat about this
（Verifier）Spawn Execution Verifier? (verifies phase co...
> 1. Yes
Verify must-haves after execution
2. No
Skip postExecution verification
3. Type something.
4. Chat about this
（Submit）Review your answers
- Which model profile for agents?
→ Quality
- Spawn Plan Researcher? (researches domain before plann...
→ Yes
- Spawn Plan Checker? (verifies plans before execution)
→ Yes
- Spawn Execution Verifier? (verifies phase completion)
→ Yes
Ready to submit your answers?
> 1. Submit answers
2. Cancel
---今後のプロセス：今後は discuss（議論） → plan（計画） ...
+Claude GSDによる取引プラットフォーム構築（5時間かかった）~
AI開発エージェントツール（GSDモード）を使用してトレーディ...
--プロジェクトの開始と要件定義
---指示と明確化：ユーザーは planning/plan.md に記載された...
> please build the entire project everything as describe...
Polish level LLM default Docker Submit
（Polish level）The market data backend is done. What re...
1. Demo-ready
Looks great on screen, works for live demo, doesn't...
> 2. Production-quality
Robust error handling, responsive, polished UX thro...
3. Type something.
4. Chat about this
（LLM default）For the LLM chat the plan says Cerebras v...
1. Mock by default
Works without API key using mock responses, real LL...
> 2. Key required
Chat feature requires OPENROUTER_API_KEY, disabled/...
3. Type something.
4. Chat about this
（Docker）should I build the Dockerfile and start/stop s...
> 1. Include Docker
Full Dockerfile, docker-compose, start/stop scripts
2. App first
Build the app, add Docker later
3. Type something.
4. Chat about this
（Submit）Review your answers
- The market data backend is done. What remains is: data...
→ Production-quality
- For the LLM chat the plan says Cerebras via OpenRouter...
→ Key required
- Docker should I build the Dockerfile and start/stop sc...
→ Include Docker
Ready to submit your answers?
> 1. Submit answers
2. Cancel
---要件定義の承認：約20分後、AIはデータベース、API、フロ...
Requirements
56 v1 requirements covering database, Arts, full fronten...
> 1. Approve
Commit and proceed to roadmap
2. Adjust
I want to change some requirements
3. Type something.
4. Chat about this
--ロードマップの策定と進行
---10段階のロードマップ：AIはUI構築を後回しにし、データベ...
10 phases | 62 requirements mapped | All v1 requirements...
|#|Phase|Goal|Requirements|Success Criteria|h
|1|Database Foundation|Async SQLite with lazy init, schem...
|2|Portfolio & Trade Execution|Trade at market prices, po...
|3|Watchlist API|RUD endpoints synced with market data so...
|4|App Assembly|FastAPI lifespan, route mounting, static ...
|5|LLM Chat Integration|AI with structured outputs, auto-...
|6|Frontend Foundation|Dark terminal shell, SSE connectio...
|7|Watchlist & Price Display|Live watchlist, flash animat...
|8|Portfolio Viz & Trading|Heatmap, P&L chart, positions ...
|9|Chat Interface|Chat panel with inline action confirmat...
|10|Packaging & Testing|Docker, scripts, Playwright E2E|P...
（Roadmap）Does this roadmap structure work for you?
> 1. Approve
Commit and continue
2. Adjust phases
Tell me what to change
3. Review full file
Show raw ROADMAP.md
4. Type something.
5. Chat about this
---フェーズの実行：~
・ユーザーは議論フェーズをスキップし、ダイレクトに「フェ...
Next Up
Phase 1: Database Foundation** SQLite with lazy init, sc...
/gsd:discuss-phase 1 gather context and clarify approach
<sub>'/clear first fresh context window</sub>
Also available:
/gsd:plan-phase 1 skip discussion, plan directly
> gsd:plan-phase 1
・その後、並行処理が可能であったため「フェーズ2と3の同時...
Next Up
Phase 2: Portfolio & Trade Execution Trade at market pri...
/gsd:plan-phase 2
<sub>'/clear first fresh context window</sub>
Also available:
/gsd:plan-phase 3 Watchlist API (can run in parallel wit...
>/gsd:plan-phase 2 and 3
--ツール特性（トークン消費と速度）~
トークンとコンテキストの逼迫：
---フェーズ1の段階でContextウィンドウの消費率が8%から18%...
---「トークンを大量に消費し、動作がかなり遅い」という特性...
--5時間後の結果と最終評価
---長時間の処理：プロジェクトが100%完了するまでに、ユーザ...
---終了間際のトラブルと自律修正：プロジェクト完了をマーク...
---Claude Teamsとの比較：以前使用した「Claude Agent Teams...
---総評：非常に時間がかかり、フェーズ分けが細かすぎた反省...
+GSD vs Claude Agent Teams：UI比較と総括
2つの異なるAIツール（Claudeの「Agent Teams」と「GSD」）を...
--5時間かけて作成したUI（GSD製）の動作検証
---初期起動：ローカルのデータベースから前回のデータが正常...
---取引機能：AppleやMetaの株式購入がスムーズに反映され、...
---AIアシスタント機能：~
・Cerebras（およびLightLLM）を使用したチャット機能をテス...
・IBMをウォッチリストに追加したり、指示通りに売買を実行さ...
Hello! How can I assist you with your portfolio today?
> I'd like to add IBM to the watch List
IBM has been added to your watchlist.
+ IBM added to watchlist
> i'd like to buy 1 share of IBM and sell 5 shares of META
Executed purchase of 1 share of IBM and sale of 5 shares...
BUY 1 IBM @ $186.28 $186.28
SELL 5 META @ $500.14= $2500.78
---改善点：~
・ヒートマップの配色（色分け）が機能していない点や、チャ...
・また、コード内では当初提案した（LLM呼び出しの）Cerebras...
---Git管理：テスト・ディレクトリの node_modules が .gitig...
--2つのUIの比較（Claude Agent Teams vs GSD）
---両方のUIを画面に並べて比較レビュー。
|評価項目|① Claude Agent Teams（前半で作成）|② GSD（今回...
|開発時間|わずか30分|5時間（丸1日）|
|UIの印象|非常に洗練されており、プロフェッショナルなデザ...
|バグ・品質|ウォッチリスト外の銘柄価格を取得できないバグ...
---結論: 多少の欠陥はあるものの、わずか30分で完成した「Cl...
--総括と次回の予告
---ツールの特性：~
・Claude Agent Teams: 非常にダイナミックで素早い開発が可...
・GSD: 厳格かつ徹底的なオーケストレーションが特徴。テスト...
--現在の進捗：全行程の93%が完了。翌日の最終回（残り7%）で...
***Day 5 [#c70a4301]
89-95
+Gas Town：Claude Codeエージェントのスウォームをオーケス...
--講義の振り返り：エージェントのオーケストレーション~
前日の講義では、複数のエージェントを連携させる2つのアプロ...
---Claude agent teams（クロード・エージェント・チームズ）：
高速で多くの処理をこなせるが、結果の予測が難しく、いくつ...
---GSD：
仕様駆動型の設計。計画・実行・検証を繰り返すステップ・バ...
--新しいツールの導入：Gas Town（ガスタウン）
---本日は、Steve Yaggy氏のブログ記事（エージェント開発の8...
---これは、規律正しいGSDとは対照的に、20〜30もの多数のエ...
---Gas Townの操作は非常にカオスで難解なため、受講生にとっ...
---AIの高度なオーケストレーションの可能性を体感してもらう...
--Gas Townの基本用語（独自用語）
---Crew（クルー）：使い捨てではない持続型のワーカー（人間...
---Mayor（メイヤー/市長）：ユーザーと対話する全体をコーデ...
---Beads（ビーズ）：システムの基盤となるインフラ。Gitのイ...
---Convoy（コンボイ）：1つのPolcatに割り当てられるタスク...
---Polecats（ポールキャット）：Mayorから派遣される使い捨...
---Refinery（リファイナリ）：各ワーカーの成果物をマージ（...
---Witness（ウィットネス）：Rigごとに存在し、Rig内のPolec...
---Rig（リグ）：プロジェクト固有のGitリポジトリ。各Rigは...
---Deacon（ディーコン）：町（Rigを束ねる）レベルのパトロ...
--セットアップとデモの開始~
Gas Townのセットアップは、Macなら brew install gastown、W...
---gt（Gas Townのコマンド）を初期化し、Gitを使用する設定...
---gt rig add Fin [GitHubのURL] で「Fin」という新しいプロ...
---gt crew add Ed --rig Fin で、Finリグの中に「Ed」という...
---作成されたディレクトリ（Fin/crew/Ed）に移動する。
---gt mayor attach コマンドを実行し、司令塔となるClaude C...
+Gas TownのParallel Polecats：Claude Codeエージェントがカ...
--自然言語による指示（spec.md に記載された仕様）をもとに...
--開発は段階的（フェーズ制）に進められ、スピーカーは「流...
--Rust、Chrome、Nitro、Guzzle、Shiny、Furyなど最大8つのワ...
--開発のプロセスと並行処理
---フェーズ1：10個のイシュー（Beads）が発行され、基礎的な...
---フェーズ2：フェーズ1の完了に伴いロックが解除され、6つ...
---フロントエンド、バックエンド（ポートフォリオ、LLMチャ...
--運用・管理とトラブルシューティング
---画面の確認：ツール内では tmux が裏で動いており、Ctrl+B...
---エラー対応：途中で「Deconcessionが維持できない」といっ...
--開発の完了と評価
---マージ・コンフリクトの解消：多数のワーカーが同時に同じ...
---結果：最終的にすべてのタスクのコードがmainブランチ（fi...
--結論（他の手法との比較）
---昨日行った「GSD」という開発手法（一歩ずつ慎重に、トリ...
---今回の「Gas Town」は「カオスだが破壊的で、すべてのタス...
---AIが自律的にコンフリクトを解決しながら完全にゼロから仕...
+Gas Town vs Claude Agent Teams vs GSD：マルチ・エージェ...
--Gas Townによるアプリケーション構築と検証
---ゼロからの構築：過去のビルドとは異なり、既存のデータ基...
---トラブルと自己修復：最初の実行ではWebページが表示され...
---内部プロセス：Poll cats、Refinery、Witnessなどが動作し...
---動作確認：ポート「8002」で起動に成功。ヒートマップやチ...
--3つのエージェントパターンの比較~
これまでに検証した3つの手法を「統制されたもの」から「混沌...
|パターン名|特徴|構築時間|評価|h
|GSD (Get Done)|設計書駆動。計画・レビュー・実行・検証・...
|Claude Agent Teams|Claude Codeに組み込まれた実験的機能。...
|Gas Town|プリセットされた構造で大量の並列処理を行う。今...
--Codex Subagentsのデモ（予告）
---別のコーディングエージェントである「Codex」の実験的機...
---リモート環境（fly.io上のSprite）へ接続し、YOLOモード（...
---結果：これまでの実験の中で最速の約15分でビルドが完了。...
+Codexの勝利：ライブ市場データ付き最終トレーダー用ワーク...
--各AIエージェントの成果比較と「Codex」の勝利~
過去のプロトタイプ：5時間かけて作成した「GSD」、デザイン...
---Codex 5.3の台頭：わずか15分の開発時間でありながら、洗...
---リアルタイムデータの統合：Polygon APIを用いた本物の市...
--複数AIエージェントによる強力な開発体制（マルチエージェ...
---tmuxによる4画面運用：クラウド環境でtmuxを使用し、4つの...
---人間の役割：コードを一切書かず、指示出しと進捗管理に専...
--AI開発における生産性の現実
---生産性の波：開発初期は「10倍の速度（10x）」に感じられ...
---マインドセット：足止めを食らったとしても、最終的には自...
--最終成果物：『Finally Trader Workstation』~
数時間のエージェント間連携によって完成した、現代的なBloom...
---主な機能：60銘柄のセクター別ウォッチリスト、リアルタイ...
---デザイン：Claudeが追加したワンクリックでの「ライトモー...
---総評：従来であれば1〜2ヶ月のハードな開発期間と多額の費...
+最終デプロイ、コース総括＆コーディング・エージェントのベ...
プロジェクトの性質に応じたツールの使い分け、コンテキスト...
--実践と成果
---15分での高速デプロイ：Codexとの対話を通じてスクリプト...
---おすすめのツール：開発者のお気に入りは「Cloud Agent Te...
--プロジェクトの性質に応じた戦略の使い分け~
プロジェクトの成熟度やリスク許容度に応じて、アプローチを...
---ミッションクリティカル / 大規模コード / 最先端技術（上...
・仕様駆動設計（SDD）: GSD（Get Shit Done）のような規律あ...
・ドキュメント重視: 多くのMarkdownファイルを管理し、イン...
・マインドセット: 「Trust but verify（信頼せよ、されど確...
---MVP / 新規構築 / ボイラープレート（リスク許容度・大）~
・YOLOモード: サンドボックス（Sprite.dev等）やWeb版Claude...
・ラフ・ループ（Ralph Loops）＆マルチエージェント: 自律的...
--AI時代の必須アクション＆マインドセット
---実験者としてのマインドセットを持つ：AI開発に「唯一の正...
---コンテキスト管理の徹底：AIのコンテキストが肥大化・圧縮...
---コードの品質（所有権）は自分が握る：AIに無駄なコードや...
--総括（アンドレイ・カーパシー氏の言葉を引用して）
---AIによってプログラマーの職業自体が再構築（リファクタリ...
---変化が激しく困惑する状況だからこそ、プラグインやスキル...
+コース総復習：Vibe Codingからエージェントエンジニアへ
--講座の振り返りとステップアップ~
3週間にわたる講座を通じて、受講生は計6つのプロジェクト（...
---第1週（Vibe Coding / 楽しさと利益）~
各種IDE（Cursor, Copilot, Codex, Antigravityなど）やプラ...
初のYOLO体験、コマーシャルMVPの作成、FPSやスペースインベ...
---第2週（Vibe Engineering / プロフェッショナル）~
・Claw Code、OpenCode、AMPの活用、Slashコマンドやループ処...
・JiraワークフローからGit push、リーガルSaaSプラットフォ...
---第3週（Agentic Engineering / 最終到達点）~
・マルチ/サブ・エージェント、フック、サンドボックス（Spri...
・オーケストレーター（GSD、Clawed Agent Teams、Gas Town）...
--講師からのメッセージと今後のアクション
---成果の共有と繋がり：LinkedInなどのSNSで修了証や学んだ...
---最も重要なこと（構築し続けること）：提供した知識（Andr...
+ボーナス講義 - あなた専用の限定リンク集
--技術経験の有無を問わず、幅広い層
---AIビルダー：n8nでエージェント、音声エージェント、自動...
コードを一行も書かずに、ビジネス向けのエージェントと音声...
---AIコーダー：クロードコードとエージェントコーディングコ...
Claude Codeのようなコーディングエージェントを使って、驚異...
---AIリーダー：リーダーと創業者のための生成型AIとエージェ...
スタートアップ企業からフォーチュン500企業まで、AIを活用し...
--技術者または技術者を目指す方
---AIエンジニア コアトラック：LLMエンジニアリング、RAG、Q...
実世界のビジネス課題を解決するために、LLMを選択、適用、最...
---AIエンジニア エージェントトラック：エージェントとMCP完...
コアトラックと同様ですが、自律型AIエージェントを使用しま...
--既に技術者であるか、他のコースを修了している方
---AIエンジニア プロダクショントラック：LLMとエージェント...
クラウド上でLLMとエージェントを大規模に展開し、回復力、可...
*詳細 [#if128223]
手順をメモ
**様々なツールのYOLOを試す [#r43166d1]
VS Code（GitHub Copilot、OpenAI Codex）、Cursor、Antigrav...
-Cursor（、Antigravity IDE）はIDEと言われているが、実体は...
-一方で、GitHub Copilot、OpenAI Codexは、VS Code拡張と言...
--GitHub Copilotは企業向け導入が多いこともあり、YOLO的な...
-エディタ拡張系の使用感は
--どれも同じで、暗黙の業界標準がある模様（コレから外れる...
--AGENTS.mdが業界標準になりつつあるのは良い。ただ設定イン...
-CLI系の使用感は...
--GUIと大差無しだが、コマンド指示ができるので、より細かな...
--[[そう言えば、GitHub CopilotにもSlashコマンドってあった...
--ただ、アレは、CLIが実行されるのではなく、Copilot Chat ...
--...よくよく考えると、Claude Code の Slashコマンドも、イ...
-安全モード・YOLOモード
--「抽象的な指示を実行させる場合」
---安全モードは手間なダケな（価値の作り込みや、高リスク問...
---ずーっと、意味のないプロンプト・フローのログを読んで、...
--「段階的に指示を実行させる場合」
---完了までの時間も短縮されるので、安全モードの手間は感じ...
---都度確認による手間も、やり直しが減るので全体として時間...
---また、承認の度、以降の再承認が不要になるモノが積み上が...
-その他、思った事。
--Nodeのサーバプロセスが残留して他をブロックすることがあ...
--一応、プロンプト出力自体が進捗には成っているが、全体計...
--コチラのアクション（承認とか起動とか）がボタン化される...
***Cursor [#f79ec290]
-紹介ページ（https://github.com/daisukenishino2）のWebサ...
--webフォルダを作成し、ソコに、紹介ページを印刷してPDF化...
--CursorのワークスペースをwebフォルダにしてAGENTS.md 無し...
Please build me a Professional Website running locally. ...
--計画中のチャットで、PDFが読み込めずURLを直接渡した。ま...
--We're experiencing high demand for the selected model r...
-Kanbanアプリ（https://github.com/ed-donner/kanban）
README.md、AGENTS.mdを確認しつつ、Gitクローンして、Window...
--WindowsのCursorで「Ctrl + Shift + J」→「agents」→「auto...
--作業スペースを広く確保するためエージェント画面を左に広...
--デフォルトで読み込まれる設定ファイル AGENTS.md を基に、...
--生成された計画書のレビューをスキップし「build」ボタンを...
--ビルド完了後、アプリ（Next.jsベース）が自動起動し、ロー...
--引き続きプロンプトに「フィードバック」（任意、以下に例...
概ね問題なく動作していますが、Next.jsでエラーが1つ発生し...
it's mostly working nicely, but NextJS is showing that t...
#ref(1.png,left,nowrap,1,60%)
>※ ブラウザ翻訳で日本語になっているが、元々は英語表記。
-前述の、「紹介ページのWebサイト」に「経歴について回答で...
--webフォルダに「OPENROUTER_API_KEY」を記載した.envと、.e...
--CursorのワークスペースをwebフォルダにしてAGENTS.md 無し...
素晴らしいですね。では、私のキャリアに関する質問に答えて...
That's great. Please now add the ability to have an Al c...
--実際に使用するモデル名は、https://openrouter.ai/models ...
--計画の立案が終わったところで「Build」を実行し、出来上が...
***VS Code + GitHub Copilot [#fcd5be3e]
-[[GitHub Copilot と VS Code の導入>GitHub#x1616130]]を参...
-プロジェクトを準備（既存の Kanban ディレクトリの名前を C...
-ショートカットキー（Mac：Command + Shift + I / PC：Ctrl ...
-作業スペースを広く確保するためエージェント画面を左に広げ...
-実行プランが生成された趣旨の出力があり、「Planから続行」...
-「次に実行するコマンド（ローカル端末で）」（cd frontend ...
-「npm install」でエラーが出たのでエラー出力をプロンプト...
-アプリ（Next.jsベース）が起動し、ローカルサーバー（http:...
-引き続きプロンプトに「フィードバック」（任意、以下に例を...
--カード削除機能以外はすべて正常に動作しているようです。
everything seems to be working well, except the delete c...
--それでは解決しません。まず問題を再現し、再現できたこと...
That didn't fix it. Please first reproduce the problem, ...
#ref(2.png,left,nowrap,2,60%)
***VS Code + OpenAI Codex [#nbe9f27a]
-VS Code拡張（Ctrl + Shift + X）から「Codex – OpenAI’s co...
-プロジェクトを準備（既存の Kanban ディレクトリの名前を C...
-ショートカットキー（Mac：Command + Shift + I / PC：Ctrl ...
-「Agentフルアクセス」（YOLOモード）、「GPT-5.5」、「推論...
-（実行前にサンドボックスの設定を要求されたので許可する。...
-（[[Codex Windows版入門 — ネイティブサンドボックスで安全...
-カナリ長時間考え、出来上がった結果は過去一良い。ChatGPT...
#ref(3.png,left,nowrap,3,60%)
***Antigravity IDE [#gae3dcbc]
-プロジェクトを準備（既存の Kanban ディレクトリの名前を C...
-AntigravityではなくAntigravity IDEを既定値でインストール...
-Antigravity - Settingsから：「Lintエラーの自動修正機能（...
-Antigravity IDEは、標準になりつつあるAGENTS.mdを使用しな...
-モデル推論を「Gemini 3.5 Flash (High)」に設定し「Please ...
-出来上がった結果、色使いが若干独特（笑）引き続きプロンプ...
#ref(4.png,left,nowrap,4,60%)
***Claude Code [#d3a40a57]
-プロジェクトを準備（https://github.com/ed-donner/pmをGit...
-claude コマンドを入力して Claude Code CLI を起動、初めて...
-その後、YOLOモードにするには、一旦 claude を抜けて「clau...
-Tabキーで、「Plan（計画）モード」から「Build（構築）モー...
please improve the UI of this project, particularly maki...
**10段階計画 [#g55c7ab4]
***VS Code + GitHub Copilot [#d3b15258]
1週、5日目の内容
**... [#f570cf06]
***... [#hfe941aa]
*参考 [#rbad62ee]
-https://www.udemy.com/course/ai-coder-from-vibe-coder-to...
-https://edwarddonner.com/faq/
-AI Coder：Vibe Coder to Agentic Engineer – RESOURCES~
https://edwarddonner.com/2026/02/17/ai-coder-vibe-coder-t...
**コード [#h84c1018]
github.com/ed-donner
-kanban（kanban MVPの雛形）~
https://github.com/ed-donner/kanban
-pm（kanban MVPを製品化する...的な）~
https://github.com/ed-donner/pm
-prelegal（PreLegalプロジェクトのJiraチケットをClaude Cod...
https://github.com/ed-donner/prelegal
-finally（第三週の内容に従いをClaude Codeで処理した結果）~
https://github.com/ed-donner/finally
**スライド [#y2bb6fbd]
https://drive.google.com/drive/folders/1vvp15mK3ZXDfY8HE4...
-Al Coder Week 1
-Al Coder Week 2
-Al Coder Week 3
**その他 [#x5433744]
***プロダクト関連 [#h49b5065]
-LLM関連
--LLM利用
---Ollama~
https://ollama.com/
---Free Models Router - API Pricing & Providers | OpenRou...
https://openrouter.ai/openrouter/free
--LLMコーディング
---Cursor：The best coding agent~
https://cursor.com/ja
---Visual Studio Code - The open source AI code editor | ...
https://code.visualstudio.com/
---GitHub Copilot · 個々の方法に対応できるよう構築されたA...
https://github.com/features/copilot/ai-code-editor?locale...
---Cursor Agent - Turn your ideas into code（人間が主導し...
https://cursor.com/ja/agents
---Codex | OpenAI の AI コーディングパートナー | OpenAI~
https://openai.com/ja-JP/codex/
---Google Antigravity（自律的に計画・実行・検証を行う次世...
https://antigravity.google/
---Amp（Ampは、最先端のコーディングエージェント）~
https://ampcode.com/
---OpenCode | オープンソースのAIコーディングエージェント~
https://opencode.ai/
---Codex CLI~
https://developers.openai.com/codex/cli/
---Claude Code~
・https://claude.ai/code~
・https://code.claude.com/docs/en/sub-agents
---（生成コードを動かす）サンドボックス~
https://sprites.dev/
---GSDとは「Get Shit Done」（またはGet Stuff Done）~
AI（特にClaude）を使った開発を効率化するためのOSSのフレー...
https://github.com/gsd-build/get-shit-done
--その他LLMエージェント関連
---MCP~
・https://glama.ai~
・https://mcp.so~
・https://smithery.ai~
・https://www.skills.sh/
---エージェントSDK~
・https://platform.claude.com/docs/en/agent-sdk/overview~
・https://code.claude.com/docs/en/agent-teams
---ローカルで動く、LLMエージェントのチャットUI~
https://openclaw.ai/
---LLMエージェントによるデスクトップ操作~
https://claude.com/product/cowork
-その他
--Git - Install~
https://git-scm.com/install/
--Node.js — Download Node.js®~
https://nodejs.org/en/download
--Get Docker | Docker Docs~
https://docs.docker.com/get-started/get-docker/
--Jira | Project Management for the AI Era | Atlassian~
https://www.atlassian.com/software/jira
-参考
--Making Claude Code Free and Fast：Hooking up to Qwen & ...
（Claude Codeを無料かつ高速に動作させる方法：Claude Code ...
https://www.youtube.com/watch?v=FYXBYq3Y9YE
***論文関係 [#p56eac60]
-How AI assistance impacts the formation of coding skills~
AI支援がコーディングスキルの形成に及ぼす影響 \ Anthropic~
https://www.anthropic.com/research/AI-assistance-coding-s...
-LLM/"AI" Policies | Jellyfin（Jellyfin LLM/「AI」政策）~
https://jellyfin.org/docs/general/contributing/llm-polici...
-Vibe engineering（バイブ・エンジニアリング）~
https://simonwillison.net/2025/Oct/7/vibe-engineering/
終了行:
「[[.NET 開発基盤部会 Wiki>http://dotnetdevelopmentinfras...
-戻る（[[テキスト生成系（Transformer系）]]、[[生成AIを活...
--[[LLM Engineering：Master AI、Large Language Models＆Ag...
--[[The Complete Agentic AI Engineering Course (2025)]]
--[[オリジナル・コンテンツ（イキナリLLMからスタートしたい...
--Master Vibe Coding with AI Coding Agents：Claude Code...
--[[オリジナル・コンテンツ（イキナリLLMコーディング・エー...
*目次 [#z69a6f26]
#contents
*概要 [#z2f51307]
**Week 1 [#bd9f2ba0]
Vibe Coding for fun and profit（バイブ・コーディング）
-Agentic Coding（エージェント型コーディング）
-Cursor、GitHub Copilotなどの主要ツールの紹介
-MVP（実用最小限の製品）開発などのプロジェクト
--コアスキル
---Agentic Coding Landscape~
全体像、基礎、コンテキストの理解。
---Foundations AGENTS.md Context~
エージェント型コーディング向けの専用コンテキストファイル...
--プロダクト
---Cursor
---GitHub Copilot
---Codex
---Antigravity
--プロジェクト
---Project 1：YOLO
---Project 2：Commercial MVP
***Day 1 [#aaa13429]
1-7日
+コースへようこそ：Cursor AIを使った3Dゲーム制作：
--Cursorで「矢印キーで移動し、スペースキーで発砲して、1台...
--すると自動でコード（index.html）を生成（Cursorは以前サ...
--ポイントは単純なコード作成に留まらず、ファイル生成や、N...
+Cursor AI Agentで一人称視点シューティングゲームを構築す...
--生成物を分析・動作確認し、プロンプトを修正し得て動作を...
--その中で「Zero-shot（ゼロ・ショット）」「Ralph Loop（ラ...
+Agentic Coding（エージェント型コーディング）のための欠か...
--コース誕生のきっかけ（カルパシー氏のポスト）、
--対象となる受講者
---すべての人向け、意欲あるエンジニア・初心者～シニア・ベ...
---コース修了後に得られる成果
---コースのスタンス（誇大広告（ハイプ）への警戒）について...
+講師紹介＆3週間AI Coderコースのロードマップ：
--講師（Ed Donner）の経歴と実績
--本コースの位置づけ「AI（エージェント）を使ってコードを...
--3週間のカリキュラム構造。
+Vibe Coding、Agentic Coder、そしてClaude Codeのようなコ...
--「バイブ・コーディング（Vibe Coding）」の誕生とこれまで...
--曖昧な用語の整理（Vibe Coder、Vibe Engineer、Agentic Co...
--3つの対話I/F（IDE型、エディタ拡張型、CLI型。
--結論と心構え（この分野の進化スピードは凄まじく、毎日膨...
+AIコーディングの8段階：ChatGPTからAgent Orchestrationま...
++AIをコーディングに活用するレベルは、初級から上級まで以...
---ステージ1：インテリセンス的スニペット生成：ChatGPTとの...
---ステージ2：ChatUIを用いたコード生成：IDEのサイドバーに...
---ステージ3：YOLOモード（エージェントの結果を一括受け入...
---ステージ4：エージェントへの委託＆検収１：意識の対象が...
---ステージ5：エージェントへの委託＆検収２：IDEからCLIに...
---ステージ6：マルチ・エージェント１：CLI上で複数のエージ...
---ステージ7：マルチ・エージェント２：10体以上のエージェ...
---ステージ8：マルチ・エージェント３：役割を持ったマルチ...
++ステージとアウトラインのマッピング
+++第1週：ステージ2〜4
+++第2週：ステージ5
+++第3週：ステージ6〜8
+++企業の開発における最適解はステージ5〜6
++利用コスト
+++コース自体は無料で完結可能
+++推奨されるプラン：初期はCursorの無料期間を利用し、第2...
+++自己責任の原則：費用の管理や解約の判断は必ず受講生自身...
+まとめ：これから始まる、あなただけのAgentic Coding Journey
++変化の激しい環境への心構え
++本コースha、全員が同じコードを実行して同じ結果を得るわ...
++講師によるサポートとコミュニティへの参加（Q&Aやメール、...
***Day 2 [#k6579d47]
8-13
+LLMの仕組み：トークン、メモリ、推論を解説：
--大規模言語モデル（LLM）の基本
--LLM単体 と LLMを組込んだAIアプリケーションの違い
--AIアプリケーションでインテリジェンスを疑似体験させるト...
---トリック1：記憶の錯覚（Ilusi Memori）：[[チャット履歴>...
---トリック2：推論・思考（Penalaran / Pemikiran）：[[Few-...
+ツール、ループ、そしてAI Agentの定義：
--AIアプリケーションでインテリジェンスを疑似体験させるト...
---トリック3：ツール（Tools / Tool Calling）
---トリック4：ループ（Loop）
--AIエージェントの最新の定義~
「目標を達成するために、ループ（繰り返し）の中でツールを...
+Context Engineering：System Prompt、Context Window、AGEN...
--コンテキストエンジニアリングとは以前は「プロンプトエン...
--入力コンテキストを構成する主要要素：システム・プロンプ...
--Contextウィンドウには最大サイズがあるのでコンパクション...
+AGENTS.mdを極める：コーディング・エージェントのためのCon...
--AGENTS.md とはコーディング・エージェント用のシステム、...
--配置ルールは、ルートとサブ・ディレクトリに配置できる。...
--効果的な記述のコツ：
---簡潔、明確、断定的に、プロジェクト全体目標と成功基準、...
---長文で冗長、過剰、防御的（数多くの例外ケース）
--2025年型アプローチ vs 2026年型アプローチ
---2026年型の思想（自律・手放し）：研究分野ではプログレッ...
---2025年型の思想（管理・最適化 ※推奨）：実用的な大規模プ...
+AIコーディング・ワークフローの進化：YOLOからRalph Loops...
--2025年のマインドセット（低い〜中程度の信頼度）：マイク...
--2026年のマインドセット（高い信頼度・自律駆動）：YOLO、...
--YOLOは元々は英語の古い格言的な表現（「人生は一度きり」...
--賢く見えないシンプソンズのキャラクター（[[Ralph Wiggum>...
+ハイプ（過度な期待）を超えてLLM（現在の主要モデル）を比...
--AI Coding Agentsのハイプ（過度な期待）に流されないこと...
--（Artificial Analysis（生成AI比較サイト））で冷静に主要...
--LLMエージェントのブレイクスルーは
---推論技術（Reasoning techniques）をベースにしたツール使...
---人手の[[Chain of Thought（CoT）等のPE>LLMのPE#ffa8b1bb...
***Day 3 [#kbc0aee4]
14-20
+Cursor、GitHub Copilot、Codex、そしてAgentic Vibe Coding...
--講義の目的と心構え（バイブ・コーディングの原則）
---ツールの選択は自由： 紹介するツールをすべて使う必要は...
---結果は人それぞれ： 使用するモデル（無料版や安価な版な...
---イライラしない（最も重要）： 的外れな出力には「焦らず...
--ハンズオン：環境構築とプロジェクトの準備
---Cursorの起動とNode.jsのインストール
---GitHubからのプロジェクト複製（Gitクローン）と切り替え
+AGENTS.mdファイルとVibe CodingのためのCursor設定を探索：
--Cursorの基本操作（ショートカットキー）
---左サイドバー（ファイルシステム）の開閉：Mac：Command +...
---右サイドバー（エージェントチャット）の開閉：Mac：Comma...
--AGENTS.md（要件定義書）ファイルの役割と構成
---ビジネス要件（Business Requirements）セクション~
・Webアプリとして動作するカンバンボードのMVP（最小限の試...
・機能はシンプルに洗練された美しいUIを最優先し、起動時に...
---技術的詳細（Technical Details）セクション~
・技術スタック：Next.js（frontend サブ・ディレクトリ内）。~
・データの永続化（保存）やユーザーログインは実装しない。
---カラースキーム（Color Scheme）：デザインに使用する好み...
---戦略（Strategy）：フェーズごとの計画策定、環境構築、UT...
---コーディング標準（Coding Standards）~
・最新バージョンのライブラリ使用、過剰な設計の禁止（シン...
・「絵文字は一切使用禁止（No emojis ever）」（エラーの原...
--AGENTS.md を作成・運用するコツ
---曖昧さを排除し、正確かつ肯定的な表現で明確に指示を出す。
---重要なポイント（「シンプルにする」など）は、複数のセク...
---最初は最小限の記述で実行し、AIの出力結果を見ながら、失...
--Cursorのエージェント設定（実行モードの選択）~
設定メニュー（Mac：Command + Shift + J / Windows：Ctrl + ...
---YOLOモード（Run everything unsandboxed）：すべての処理...
---安全モード（Auto run in sandbox / Ask every time）：フ...
+YOLOモードでCursor AI Agentを使ってKanbanアプリを構築：
--開発の準備とプランニング
---画面配置とモデル設定：作業スペースを広く確保するためエ...
---プランニングの実行：エージェントを「plan（計画）」モー...
---デフォルトで読み込まれる設定ファイル AGENTS.md を基に...
--自動ビルドの実行（YOLOモード）
---自動開発の開始：生成された計画書のレビューをスキップし...
---自律的な開発プロセス：AIがファイルの作成（.gitignore ...
---ユーザーはコンテキスト（メモリ）使用量が徐々に増えてい...
--アプリケーションの動作確認
---自動起動と初期機能：ビルド完了後、アプリ（Next.jsベー...
---初期状態の評価：タスクカードの追加、削除、列名の変更、...
---ただし、画面下部にNode関連のエラー（赤アイコン）が表示...
--フィードバックによる反復改善
---追加指示の提示：AIに対し、「エラーの修正」「ドラッグ＆...
---改善結果の確認：デザインに指定通りの紫と黄色が取り入れ...
+VS CodeでGitHub Copilotを使ってKanbanボードを構築：
--プロジェクトの準備とディレクトリの変更（既存の Kanban ...
--[[GitHub Copilot と VS Code の導入>GitHub#x1616130]]：G...
--GitHub アカウントと連携し、ショートカットキー（Mac：Com...
--実装の開始と進行：エージェントを「常に許可（YOLOモード...
--途中でサーバー起動のディレクトリを間違えるなどのバグが...
--手動でローカルサーバーを起動（npm run dev）してブラウザ...
---しかし、「カードの削除（Delete）機能」が動作しないとい...
---コーディング・エージェントの「原因を検証せず、勝手に推...
---「最初に問題を再現」「再現できたことを証明」「根本原因...
---AIエージェントにデバッグを依頼する際は、「直した」とい...
+OpenAI Codex VS Code拡張：ゼロショットでKanbanアプリを構...
--OpenAI CodexはCLIツールとしての側面を持つが、今回はIDE...
--「agent full access」（YOLOモード）、「GPT 5.5」、「rea...
--同様に、アプリケーションの動作確認（自動起動と初期機能...
+Antigravity IDEとGeminiでKanbanアプリを構築：
--開発環境の移行と準備：4つ目のツールである「Antigravity...
--Antigravityの概要と特徴：antigravity.google からダウン...
--利用モデル：デフォルトでは Gemini が提示されるが、Anthr...
--設定：Lintエラーの自動修正機能（Agent Autofix lints）を...
--設定ファイルの配置：Antigravityは業界標準になりつつある...
--ルールの移行：その中に strategy.md を作成し、中身のコン...
--実行結果と検証：AIはブラウザ自動化ツールの Playwright ...
--成果物の評価：完成したKanbanアプリは、デザインが新鮮か...
+Cursor vs GitHub Copilot vs Codex vs Antigravity：最終評...
--カード作成機能の改善をGemini（Google Antigravity環境下...
--「Codex」（Codex IDEで動作するモデル）をトップ（勝者）...
--主要なAIコードエディタ（エージェント）の共通点はどれもU...
***Day 4 [#x3f926f0]
21-26
+YOLOモード：IDEでのAgentic Codingに適したLLMの選び方：
--ツールそのもの（IDE）と、裏側で動くAIモデル（LLM）を区...
--各IDEはプランに応じてモデルを切り替えることが可能（推奨...
--Cursor：AnySphere/Composer、GitHub Copilot：Claude Haik...
--ツール（IDE）の使い心地の差はわずかであり「どのLLMに意...
--ただ、実際ヤッてみると既定のLLMも（頻繁に）更新されてい...
--小型モデルでのYOLOは破綻リスクが高い。ステップ毎に差分...
+Vibe Codingを成功させる5つの原則：
--「5大原則（Be the Boss）」：AIを自律的な意思決定者とし...
---AGENTS.md（指示書）の充実：「要件（仕様）」「スタイル...
---小さく始める：最初から複雑なアプリを狙わず、まずは最も...
---段階的に進める（インクリメンタル）：各ステップで常にテ...
---油断しない（怠けない）：初期にうまくいくとAIを過信しが...
---泥臭く検証する（異議申し立てと証拠の要求）：AIが「修正...
-- 混乱や失敗：「フラストレーションや壁にぶつかることもプ...
---AIに仕事を丸投げするとスキルが身につかず、将来のフラス...
---AIに質問を投げかけ、何が起きているかを理解してシニアへ...
---AIは時に的外れで、自信満々に間違え、根本解決ではなくパ...
---コードを書く喜びは減るが、苦手分野を克服し、システム全...
+責任あるYOLOコーディング：OpenRouterでAIプロジェクトをセ...
--YOLOモードには楽しさがある反面、大きなリスクやトレード...
---ジュニア開発者の学習への悪影響（Anthropicの調査）：AI...
---OSSコミュニティ（Jellyfin）のAI利用ポリシー：会話にお...
---AIをアシスタントとして使うのは自由だが、最終的なコード...
--制作プロジェクトの概要
---目標：AIエージェントを活用し、自分自身のキャリアに関す...
---開発のコツ：問題に直面した場合は、機能を削ぎ落として「...
--OpenRouter（APIプラットフォーム）のセットアップ
---複数のLLM APIを一つのアカウントで一元管理できるOpenRou...
---アカウント作成後、「Keys」メニューからAPIキーを発行、...
---無料：「https://openrouter.ai/settings/privacy」→「か...
---有料：「Credits」からチャージが可能。OpenRouterは最低2...
+YOLOモード：CursorでGPT Codexを使ってNext.jsウェブサイト...
CursorのYOLOモードを使用し、プロンプト一つでローカル環境...
--プロジェクトの初期設定
---フォルダ作成：Site という名前の新規プロジェクトフォル...
---環境変数ファイルの作成：.env ファイルを作成し、OpenRou...
---（このOpenRouter（またはOpenAI）は、Cursorのエージェン...
---Git対策：.gitignore ファイルを作成し、セキュリティのた...
--ソースデータの準備
---自身のLinkedInのプロフィールページをPDF（LinkedIn.pdf...
---プロジェクト・ディレクトリに配置する（PDF化できない場...
--Cursorの設定変更（YOLOモードの設定）
---Usage Summary：常に表示（Always）に設定し、モデルの使...
---Auto Run (YOLO設定)：ステップごとの承認を省くため、Run...
---モデルの選択：高品質な出力を得るため、より強力なモデル...
--エージェントへの指示とサイト構築
---以下の要件をプロンプトで指示し、エージェントに自動構築...
「Next.jsを使用し、LinkedIn.pdfを元に、エンタープライズ...
Please build me a Professional Website running locally. ...
--エラー対応と完成したサイトの確認
---エラー発生と修正：~
・ターミナルで npm run dev を実行し、ブラウザ（localhost:...
・エラー文をそのまま解説なしでCursorにペーストして再投入...
---完成したサイトのレビュー：~
・デザインは「エンタープライズ×エッジ」のテーマに沿った、...
・LinkedInから抽出された自己紹介や経歴タイムライン、ポー...
・プロフィールから自動取得した本物のメールアドレスへのリ...
・エージェントへのシンプルな指示（と1回のエラー修正）だけ...
+OpenRouterとVibe CodingでAI Digital Twinチャットを追加：
--バックアップとバージョン管理の重要性
---新たな機能実装（YOLOコーディング）を行う前に、進捗を失...
---本来は Git を使用して適切なcommitを行うべきであり、Git...
--AIエージェントへの機能追加指示
---AIエージェントに対し、経歴について回答できる「デジタル...
---技術的な仕様として、OpenRouter のAPI（APIキーは .env ...
--実装結果の検証と「バイブコーディング」の課題
---npm run dev でローカルサーバー（Localhost 3000）を起動...
---UIは一般的なチャット画面とは異なるユニークなデザインで...
---一方で、画面起動時に不自然にスクロールする挙動や、一部...
--今後のステップ（リファクタリングと改善）
---検証なしで進めるMVP（最小限の試作品）開発としては機能...
---ソースコード（src/app/api/chat/route.ts）から、現状の...
+チュートリアル、Opusによるコードレビュー、クロスモデルコ...
--チャットUIの改善とトラブルシューティング
---課題と解決策：チャットのスクロール問題やプロンプトの修...
いいえ、うまくいきません。別の方向性で進めませんか？この...
No it's not working. Please can we go a different direct...
---教訓：AI開発で泥沼にハマった（同じミスを繰り返す）時は...
--AIによるチュートリアル作成と学習
---ローカル環境（npm run dev）での動作確認後、初心者向け...
それでは、フロントエンドコーディングの完全な初心者向けに...
Please now write me a comprehensive tutorial in markdown...
---AI自身にコードを客観的に評価させると同時に、人間の開発...
--異なる複数のLLM（AIモデル）によるクロスレビュー
---アプローチ：開発を担当したCodexから、より強力なモデル...
---メリット：環境変数（.env）の扱いに関する潜在的なリスク...
--総括と次のステップ
---今回の手法は「YOLOコーディング（vibe coding）」に「チ...
---開発がうまくいかない時は「徹底的にシンプルにする（simp...
***Day 5 [#oe5ceb4f]
27-33
+Karpathyが語るVibe Codingと商用MVP構築のルール：
--「バイブコーディング（Vibe Coding）」をビジネスに活かし...
--元OpenAIの著名な研究者アンドレイ・カーパシー（Andrej Ka...
---バイブコーディング誕生：LLM（Cursor Composer や Claude...
---急激な進化への困惑：エージェント、プロンプト、MCP（Mod...
---カーパシー自身の開発スタイルも、かつての「手動補完80%...
--エージェント開発における重要な気づき
---過剰なハイプへの警戒（Watch it like a hawk）：「IDEは...
---不屈の精神と生産性の「拡大」：エージェントは疲弊せず、...
---面倒な定型業務やエラーの泥沼から解放されるため、コード...
---スキルの退化（Atrophy）と粗悪なコード（Slop）の氾濫に...
--バイブコーディングを成功させるための実践ルール
---開発者がジュニアであれシニアであれ、成功のために共通す...
---事前準備の徹底：AGENTS.md などのファイルに、仕様、開発...
---段階的な開発と検証：常にシンプルに始め、少しずつ機能を...
---怠惰にならない：AIの出力を鵜呑みにせず、常に根拠（エビ...
---フラストレーションの管理：AIが同じエラーを繰り返すなど...
--開発者の役割
---ジュニアエンジニア：AIを「知識はあるが先走って失敗する...
---シニアエンジニア：コーディングから解放された分、より大...
--結論
---YOLOに対する過度な期待は捨て、メリットとデメリットを正...
---タカのように監視し（Watch it like a hawk）、一歩一歩着...
+Webアプリ基礎：フロントエンド、バックエンド、API、Docker...
--フロントエンドとバックエンドの基本
---フロントエンド：~
・ユーザーのブラウザ（ChromeやSafariなど）側で動作する部...
・LLMやコーディングエージェントはフロントエンド構築が得意...
---バックエンド：~
・サーバー側で動作する部分。ビジネスロジック、データアク...
・LLM（大規模言語モデル）の呼び出し、API連携、パスワード...
---本日のプロジェクトでは、~
・フロントエンドにJavaScript、バックエンドにはLLM連携で最...
・ユーザーの操作結果を処理するフロントエンドはAPIコールを...
--Dockerの基礎
---Dockerは、PCの内部に隔離された仮想的なコンピュータ（環...
---主要な3つの概念：Dockerは、Dockerfileを使ってDocker Im...
---インストール：公式サイト（docker.com）から「Docker Des...
+GitHub CopilotとFastAPIでフルスタックプロジェクトをセッ...
--開発環境の準備（GitHub Copilot と VS Code）
---GitHub Copilot の利用：前回の「Cursor」に続き、今回は...
---ローカル環境のセットアップ：教材リソースにあるリポジト...
---VS Codeのターミナルで git clone を実行。Gitクローンし...
--既存リポジトリから開発を始める理由
---ゼロからの構築（Scaffolding）はAIエージェントにとって...
---今週前半に構築した「Kanban（カンバンボード）のフロント...
--プロジェクトの要件と実装ミッション
---既存のフロントエンド（純粋なデモ画面）に、バックエンド...
---コーディング・エージェントを活用するだけでなく、アプリ...
---MVPの制限事項：単一ユーザーのサインイン（ID/パスワード...
--技術選定とファイル構成
---フロントエンド：Next.js（既存のカンバンUIを流用）
---バックエンド：Python (FastAPI)
---パッケージマネージャー：uv
---データベース：SQLite（ローカル）
---AI API：OpenRouter（.env ファイルにAPIキーと使用モデル...
---インフラ：すべてをDockerコンテナにパッケージングする。
--プロジェクトのファイル構造
---frontend/：既存のKanban MVPが格納されている。
---backend/：空の状態（agents.mv のみ）。
---front scripts/：空の状態。
---.env / .gitignore: 環境変数（APIキー等）とGit除外設定。
---AGENTS.md：プロジェクトの要件、技術選定、コーディング...
---docs/plan.md: 次のステップで確認する、計画と実行のため...
+GitHub Copilotでステップバイステップ構築：計画と足場作り：
--全体方針と開発哲学
---計画と制約（ガードレール）の重要性：ハイレベルな計画を...
---段階的なcommitと検証：一気に10ステップを進める（YOLOモ...
--プロジェクトの10段階計画（ハイレベルプラン）
---計画（Plan）：本プランの具体化（チェックリスト、テスト...
---足場固め（Scaffolding）：Docker、FastAPI（バックエンド...
---フロントエンドの追加：デモ用のKanbanボードを表示・サー...
---ダミーのユーザー・サインイン機能の実装。
---DBモデリング：スキーマの構築、ドキュメント化、ユーザー...
---バックエンドAPIルートの追加：Kanbanの読み書きルート作...
---フロント・バックエンドの結合: フロントからバックエンド...
---AI接続：OpenRouter経由でAIを接続し「2 + 2」のような単...
---AI機能の拡張：Kanbanボードのデータと質問をAIに送り、回...
---チャット・ウィジェットの追加：フル機能のAIチャットを搭...
--実際の進行
---計画（Plan）~
・計画の具体化の実行：AI（GPT 5.2モデル）に対し、「まだ作...
AGENTS.mdと計画書をよく読んで、ご質問があればお知らせく...
Please revie AGENTS.md and the plan, and let me know if ...
・AIから確認があり、
AGENTS.mdとdocs/PLAN.mdを確認しました。作業開始前に質問...
Reviewed AGENTS.md and docs/PLAN.md. Questions before st...
1. PLAN.mdに詳細なチェックリスト、テスト、成功基準を追加...
1. Do you want me to enrich PLAN.md with detailed checkl...
2. フロントエンドのAGENTS.mdは、計画の充実化の一環として...
2. Should I create the frontend AGENTS.md as part of the...
3. 「包括的なテスト」に関して、最低限のカバレッジ目標や...
3. For "Comprehensive tests," do you have minimum covera...
・人間がそれを承認。
1. はい、PLAN.md を作成してください。
1. Yes entich PLAN.md
2. はい、フロントエンド用の AGENTS.md をすぐに作成してく...
2. Yes create. AGENTS.md for frontend right away
3. 単体テストのカバレッジは最低 80%、かつ堅牢な統合テス...
3. 80% unit test coverage minimum, and robust integratio...
パート 1 に進んでください。
Go ahead with Part 1
・AIは指示通り、各ステップにチェックボックスや成功基準を...
PLAN.mdには、各ステップ1-10にチェックリスト、テストリス...
・人間がレビューして承認。
確認済み。承認済み。ステップ2へ進みます。
confirmed. Approved. On to step 2
---足場固め（Scaffolding）~
・本フェーズの実行を許可したところ、AIは「実装完了」と報...
確認後、パート3に進みます。パート2はご自身でテストされま...
Confirm and I'll proceed to Part 3. did you test part 2 ...
・「自分でテストしたのか？」と問い詰め、サーバーを起動し...
徹底的にテストを実行してください。サーバーを起動し、正常...
please run tests thoroughly. Bring up the server, make s...
・過程で、uvではないPKGマネージャを使用するなど不信感を誘...
---結論（ユーザーへのアドバイス）~
・AIが提示する「できました」を鵜呑みにせず、立ち止まって...
・初心者にとっては、AIがどのように工程を進めているか観察...
+GitHub Copilot、Docker、FastAPIでKanbanアプリを構築：
--パート2の検証と完了
---環境構築の確認：AIがPKGマネージャのuvを使用せずpipを使...
requirements.txtが必要な理由を説明していただけますか？uv...
can you explain why you needed a requirements.txt -I tho...
uvには依然として依存関係リストが必要です。コンテナ内のuv...
uv still needs an input list of dependencies. I used req...
---動作確認：実行スクリプト（start_mac.sh）の権限エラーを...
この部分を自分でテストする方法を教えてください
please tell me how I test this part myself
（エージェントに依るテスト方法に関する回答）
---成功基準の評価：テストカバレッジ80%の達成や他OSでの検...
パート2が完了して良かったです。パート2の成功基準はすべて...
that's good part 2 is done. Are all the success criteria...
完全には達成されていません。コンテナの起動、ルーティング...
Not fully. We verified container start, routes, and test...
PC/Linuxについてはスキップしても構いません。すべてのルー...
I'm good to skip the PC/Linux - and I can confirm I've t...
--パート3：フロントエンド（カンバンボード）の実装
---カバレッジの罠：AIは「テストカバレッジ80%」という指示...
---画面の確認：カンバンボード（Kanban Studio）の静的フロ...
---指示の修正：パート4へ進む際、AIに対し「無意味なテスト...
承認済み - パート4へ進みます。ところで、今後は、テストカ...
approved - move to part 4. By the way, going forwards, p...
--パート4：認証機能の追加
---機能テスト：デモ用のユーザー名とパスワードでサインイン...
---差分（Diff）の承認：変更された多くのファイル差分（緑と...
--Gitによる進捗の保存と次への準備
---ローカルcommit：今後データベースを扱うパート5という「...
---開発者がAIエージェントの過剰なテスト作成癖をコントロー...
+GitHub CopilotでKanbanアプリ構築：ドラッグ＆ドロップのデ...
--データベース設計の承認とPart 5・6の完了
---Part 5：AIが提案したDB設計（DDL）を確認し、JSON保存よ...
---Part 6：バックエンドとフロントエンドの連携前の段階まで...
--フロント・バックエンドの連携と不具合修正（Part 7）
---開発における最も重要なフェーズ。AIがテストの失敗とリラ...
---動作確認とバグ：ローカルサーバー（localhost:8000）を起...
サーバーを起動し、ユーザーとしてログインし、ボードにいく...
I started the server, I logged in as the user, I made so...
あなたの理解は間違っていません。現在、フロントエンドはま...
You didn't misunderstand. Right now the frontend still u...
パーシステンスは機能していますが、ドラッグアンドドロップ...
the persistence is working, but the drag and drop seems ...
---AIによるデバッグ: バグ修正をAIに指示したところ、AIは30...
今テストしてみましたが、すべて正常に動作しています。素晴...
I've just tested it and everything is working. It's work...
承知いたしました。これで作業を終了いたします。ご希望であ...
Understood. I'll stop here. If you want, I can review th...
---ドラッグ＆ドロップとデータの永続化が完全に動作すること...
--Contextウィンドウ対策と次への準備（Part 8へ）
---コンテキストの肥大化問題：開発がPart 7まで進んだことで...
---チャットのリセット：効率的な開発を維持するため、現在の...
---事前にこれまでの設計方針や進捗を PLAN.md（計画ファイル...
PLAN.mdが、あなたが下した設計上の決定事項を含め、すべて...
please confirm that PLAN.md is up to date with all the l...
---Gitに最終commitを終えた後、新規チャット（New Chat）を...
+AIアシスタントKanbanアプリ完成：GitHub Copilot、OpenRout...
--開発プロセスの進捗（パート8〜10）~
---新しいチャットセッション（コンテキストがクリーンな状態...
チャットの会話をリセットしたことで最初はサーバーの起動方...
> パート8を開始する前に、まずAGENTS.mdを読んでからPLAN.m...
Please read AGENTS.md then read the PLAN.md and let me k...
AGENTS.mdと計画書を確認しました。パート8の前に質問があり...
I reviewed. AGENTS.md and the plan. Questions before Par...
1. パート8の「2+2」統合テストでは、完全にモック化（実際...
1. For the Part 8 "2+2" integration test, do you want it...
2. 新しいAIエンドポイントは、/api/ai、/api/chat（または...
2. Should the new Al endpoint be under /api/ai or /api/c...
3. OpenRouterのベースURLは、環境変数などで設定可能にする...
3. Do you want the OpenRouter base URL configurable (e.g...
> 1. 実際には、モック化せずにOpenRouterまでアクセスし、...
1. Actually I want it to go all the way to OpenRouter-no...
>サーバーの起動、停止、テストを効果的に行う方法について...
If seems you learned some details about how to start, st...
パート8のチェックリストのステータスを更新し、PLAN.mdにテ...
Updated Part 8 checklist status and added a testing note...
---パート8（OpenRouterの統合）：モック（擬似データ）を使...
この部分の会話の状況は共有されなかった。
---パート9（リアルデータのテスト）：AIが当初モックテスト...
この部分の会話の状況は共有されなかった。
---パート10（UIの実装と動作確認）：AIアシスタントのチャッ...
---実機デモの成功：（IDEではなくアプリの）チャットで「プ...
画面上のカンバンカードが自動で動き、そのデータがバックエ...
--現状の課題と今後の「課題（アサインメント）」
---アプリの最小限の機能（MVP）は完成したものの、コードの...
---メインコード（main.py）の肥大化：モジュール化、スパゲ...
---第1週目の課題: ベースアプリを元に拡張を各自で行う：リ...
--「バイブ・コーディング」の総括と今後の展望
---アンドレイ・カルパシー氏の言葉：「2024年12月頃を境に、...
---第1週目の振り返り：「楽しむためのバイブ・コーディング...
---第2週目の予告：単に雰囲気で書く「バイブ・コーディング...
**Week 2 [#z586823e]
Vibe Engineering as a professional（バイブ・エンジニアリ...
-Claude Code や Open Codeを使用したCLIコーディングの深掘...
-MCP（Model Context Protocol）、プラグイン、チーム開発、...
-SaaSプラットフォームを構築する大規模なプロジェクト。
-プロダクト
--Claude Code、Open Code、others（Codex、Cursor、GitHub C...
主に2025〜2026年に流行した端末ベースのAIコーディング・エ...
--Commands Checkpoints Ralph Loops~
Claude Codeを使った自律型AIエージェントのループ手法
-コアスキル
--エージェント単体
---MCP
---Skills
---Plugins
--マルチ・エージェント化
---Workflows
---Team Debugging
-プロジェクト
--Project 3：SaaS Platform
***Day 1 [#x8b66938]
34-39
+Pro Week へようこそ：Vibe Coding から Vibe Engineering へ
--プロ向けの2週の幕開けとコアツールの導入
---応用・発展フェーズへの移行：基礎的なスキルを習得した第...
---Claude Codeの導入：今週のプラットフォーム・プロダクト...
--AIコーディングの進化と今週のアプローチ
---進化のステージ：AIコーディングは、単なるChatGPTの利用...
---開発スタイルとマインドセット：ミッションクリティカルな...
---一方で、リスク許容度が高いMVP（最小限の試作品）やボイ...
---どのような手法であれ、コードの品質と動作に対する最終的...
--「バイブ・エンジニアリング（Vibe Engineering）」への昇華~
エンジニア・ライターのSimon Willison氏のブログ記事を引き...
---バイブ・コーディングとの違い：~
・「バイブ・コーディング（Vibe Coding）」：プロンプト主導...
・「バイブ・エンジニアリング（Vibe Engineering）」は、熟...
---プロのAIエンジニアリングに求められるスキル：~
・厳格なプロセス：事前の計画、綿密なドキュメント作成、自...
・高度なマネジメント・レビュー力：LLMに自身の成果物をレビ...
・切り分けの直感：AIに「任せられるタスク（フロントエンド...
・見積もりの罠への対処：AIはコードを瞬時に生成できる反面...
+Claude Code の台頭：歴史、セットアップ、VS Code へのイン...
--Claude Codeの歴史と進化
---誕生と普及：2024年末にAnthropicのエンジニア（Boris Che...
---V2へのアップデート（2025年9月）：チェックポインティン...
---性能の転換点（2025年11月）：超強力なモデル「Opus 4.5」...
---ビジネスと今後の展開：AnthropicはClaude CodeによりARR...
--料金プランと推奨設定
---プランの種類：無料プラン、Proプラン（月額20ドル）、高...
---推奨環境：無料モデルや安価なモデルをClaude Code経由で...
--インストールとセットアップ
---本体のインストール：code.claude.com から各OS（Mac/Wind...
---VS Code拡張機能：Anthropic公式のVS Code拡張機能（Claud...
--本コースにおける利用方法（ターミナル重視）
---Claude CodeをVS Codeで使うには「サイドバー（拡張機能）...
---ココではより高度な「バイブエンジニア（Vibe Engineer）...
+Claude Code CLI 入門：Init、Context、Testing~
VS Code上で前週のプロジェクトを開き、ターミナルからAnthro...
--プロジェクトの準備とClaude Codeの起動
---前週のプロジェクト（PM）を開き、Gitで未commitの変更を...
---新しいターミナルを開き、claude コマンドを入力して Clau...
---インタフェースは意図的にレトロなCLIスタイル（キャラク...
--ログインと初期設定（/init）
---初めて使用する場合は、/login コマンドでAnthropicアカウ...
---従来の拡張機能で使われていた AGENTS.md の代わりに、Cla...
---/init コマンドを実行すると、Claudeがディレクトリ構造を...
---注意: 最初はClaudeに下書きをさせても、最終的には人間の...
--操作方法とUIの特徴
---Claudeへの命令は通常入力で行い、コマンドを実行する場合...
---Claudeからの編集提案に対し、ユーザーはテンキーで応答（...
--コンテキスト管理（/context）
---/context コマンドを使用することで、20万トークンという...
---メーターには「メモリ（CLAUDE.mdなど）」「メッセージ（...
--ドキュメントの読み込みとテストの自動実行
---Claudeに docs/plan.md を読み込ませ、プロジェクトの構造...
---テストの実行を指示した際、PC再起動直後で Docker Deskto...
---バックエンドおよびフロントエンドの全テストが走り、すべ...
+Claude Code レビュー：ハルシネーションの修正とコードのリ...
開発者ツール「Claude Code」を使用して、リポジトリ全体の包...
--Claude Codeによるコードレビューと「幻覚（ハルシネーショ...
---Claude Codeの並列エージェント（バックエンド、フロント...
リポジトリ全体の包括的なコードレビューを実施し、docsフォ...
Please carry out a comprehensive code review of the enti...
---レビュー中、Claudeは「.envファイル（機密情報）がGitに...
---これを指摘すると、Claudeは誤りを認めて謝罪し、レポート...
.env は Git でどのように管理されているのでしょうか？ .gi...
how is env in git? It's clearly included in .gitignore, ...
おっしゃる通りです。確認してみます。...おっしゃる通りで...
You're right, let me verify. ... You're correct. .env is...
--指摘事項の修正とリファクタリング
---修正されたレポートには、バックエンド依存関係の未固定、...
---一括修正の指示：「重大・高・中」の課題の修正と再テスト...
承知いたしました。ありがとうございます。それでは、クリテ...
OK thank you, please go ahead and address all the Critic...
---自律的な判断と追加指示：ただし、Claudeはコスト対効果を...
これは良いのですが、実際にはモノリシックなPythonモジュー...
this is good, but actually I really want to rememdiate t...
--Gitコミットとコンテキストの整理 (/compact)
---変更された大量のファイル（ヘルスチェックが追加されたDo...
---コンテキスト・ウインドウ肥大化の対応として、/context ...
---（チャットUIではPLAN.md等を更新してから新しいチャット...
--現在のバージョン、使用しているモデル（最上位のOpus 4.5...
+Open Code：GLM 4.7 などの無料モデルを Claude Code の代替...
Claude Codeのオープンソースの競合ツールである「Open Code...
--Open Codeの特徴
---柔軟なモデル選択：独自の無料モデル（Open Code Zenなど...
---2つのモード：Tabキーで、行動を起こす前に思考させる「Pl...
---推論レベルの調整：Ctrl+Tで、モデルの推論レベル（Low〜E...
--インストールとセットアップ
---Macではcurlコマンド、Windowsではchocoやnpm（Node.js環...
---VS Codeのターミナルから open code コマンドを入力するだ...
---起動時に環境内の既存のサブスクリプション（OpenAIなど）...
--無料モデルでのコードレビュー検証
---中国のスタートアップZ.aiの「GLM 4.7」（非常に強力なOSS...
---Planモードでレビュー内容をじっくり考えさせた後、
プロジェクト全体をレビューし、コードレビューを実施して、...
please review the entire project, carry out a code revie...
---Buildモードに切り替えて docs/code_review.md へファイル...
docs/code_review.md にコードレビューを書いてください。た...
please go ahead and write the code review to docs/code_r...
---認証の脆弱性、TypeScriptの厳密さ、コードの重複、エラー...
---ただし、Claude 4.5 Opusほどの自律性や確実なリファクタ...
--プロバイダー接続とローカル実行
---/connect コマンドを使用することで、Anthropic、GitHub C...
---Ollama等を使ったローカル環境でのモデル実行にも対応して...
--プラットフォームの組織力やモデルの安定性から「Claude Co...
+Open Router と Ollama を使った AMP Code、Claude Code
--AMP（AMP Code）の概要と特徴
---概要：特定のプロバイダーに依存しないエージェント型コー...
---Freeプラン：画面上部に表示される広告を見ることで、毎日...
---仕様と機能：~
・バックグラウンドで最適なAIモデルが自動選択される（文脈...
・3つのモード（smart: 標準、deep: じっくり思考、rush: 高...
・実際にプロジェクトのコードレビューを実行し、ハードコー...
--Claude Code を Open Router 経由で動かす（Kimi K2の例）
---概要：Anthropic公式の推奨環境ではないが、環境変数を書...
---設定方法：Mac/PCで環境変数を設定し、ベースURLをOpen Ro...
---結果: プロジェクトの目的を正しく説明できたが、複雑なコ...
--Claude Code を Ollama でローカル実行する（GPT-OSS）
---概要：外部クラウドを使わず、自身のローカル・マシン（GP...
---設定方法：環境変数を変更し、接続先をローカルホスト（lo...
---結果：PCのGPUに高い負荷がかかり処理に時間は要したもの...
--AIコーディング環境は、幅広い選択肢と拡張性がある。
***Day 2 [#sc3340e9]
40-44
+Claude Code のコマンド、ショートカット、設定の徹底解説
--主要なSlashコマンド~
ツール内のみで実行され、Claudeへのプロンプトとしては送信...
---/↓、/help：使用可能なコマンドの一覧や簡単な説明、ショ...
---/init：プロジェクトを初期化し、CLAUDE.mdファイルを新規...
---/model：使用中のモデルを確認・変更（例：上位プランでの...
---/status：ステータス（進行状況）、コンフィグ（各種設定...
---/context：現在のメモリ（コンテキスト）状況をプリントア...
---/compact：会話履歴を圧縮してリセット。残したい情報の要...
---/clear：会話履歴を完全に消去し、初期状態（AGENTS.mdな...
---/permissions：Claude Codeが持つ実行権限の確認やルール...
--ショートカットキーとモード
---Ctrl + O：詳細なトランスクリプト（ログ）モードのオン/...
---Shift + Tab：「Plan Mode（計画優先）」「Accept Edits（...
ただしOpus等の進化により、現在はモデル自身が判断するためP...
--設定とファイル管理のテクニック
---権限管理（.claude ディレクトリ）：JSON ファイル（パー...
---シンタックスによるファイル参照：プロンプトや CLAUDE.md...
#CLAUDE.md
@AGENTS.md
## DETAILED PLAN
@docs/PLAN.md
---効率的な活用例（ファイルの共通化）~
・GitHub Copilot等の他ツールと設定を共通化したい場合、CLA...
・注意点: @ でディレクトリを指定した場合は、配下の全ファ...
+Sessions、Checkpoints、Git：Claude Code ワークフローの管理
--ワークフロー管理における3つの手段~
Claude Codeでの作業状態を管理・復元するには、粒度の異なる...
---セッション（Sessions：高粒度）~
・Claudeとの会話や文脈（コンテキスト）の完全な状態を記録...
・任意のタイミングでセッションに名前を付けて保存（rename...
※注意：復元されるのは「会話の文脈」のみであり、コードやリ...
---チェックポインティング（Checkpointing：低粒度）~
・現在のセッション内における、プロンプト（指示）ごとのス...
・時間を一歩ずつ遡る「巻き戻し（rewinding）」が可能。~
・会話だけでなく、Claudeが行ったコードの変更も元に戻せる。~
・ただし、Claudeの知らないスクリプト等によって変更された...
---Git（コード管理の標準ツール）~
・Claudeの文脈とは独立してコード全体の正確なスナップショ...
・コードを過去の特定の時点へ確実に復元するための「本命」...
--おすすめのワークフロー
---Gitの多用：コードの変更管理や過去への変更の巻き戻しに...
---Markdownファイルでの進捗管理：過去のセッションを復元し...
--セッション機能の実演（デモ）
---Claudeに「皮肉っぽく（snarky）応答して」と指示
今日の会話では、ぜひ機知に富んだ、皮肉の効いたやり取りを...
for our conversation today, I'd like you to be witty and...
---そのセッションを「snarky Claude」と命名して一度終了
> /rename snarky-claude
L Session renamed to: snarky-claude
---普通にClaudeを起動してプロジェクトの要約を求めると、ビ...
> please summarize the project
All 10 parts of the plan are complete the MVP is fully f...
---一度終了し、今度は claude --resume で再開して「snarky-...
> please summarize the project
Current state: All parts of the plan are complete. You'v...
The vibe: "Keep it simple, don't over-engineer, prove pr...
+Claude Code の Checkpoints、Rewind、YOLO Mode 解説~
Claude Codeを使用し、コードレビュー、シンキングプロセス確...
--コードレビューの実行とエラーの修正
---「プロジェクトの要約」と「コードレビュー」をClaudeに指...
> please do a code review and write results to review.md...
...
Do you want to make this edit to review.md?
1. Yes
> 2. Yes, allow all edits during this session (shift+tab)
3. No
--シンキングプロセスの可視化（ショートカットキー）
---Ctrl + O：エージェントの思考トレース（詳細な思考プロセ...
---Ctrl + E：すべてを表示し、もう一度押すと折りたたむ。
---Ctrl + B：コマンドをバックグラウンドで実行させ、自身は...
--Claudeは前回同様「.envファイルのAPIキーが露出している」...
gitignoreにあるとは言わず、「本当に露出しているか？」と促...
--チェックポイントとリワインドの仕組~
/rewind コマンドを使用することで、現在のセッション内の特...
---/rewindで、チェックポイント（過去の会話時点）を選択す...
- please summarize the project
No code changes
- please do a code review and write results to review.md...
review.md +263-0
- are you sure that the API key is exposed?
review.md +9-23
---会話履歴のみ（Chat）、コードの状態のみ（Code）、あるい...
> 1. Restore code and conversation
2. Restore conversation
3. Restore code
4. Never mind
---実演：巻き戻した結果、AIのチャット文脈だけでなく、revi...
are you sure that the API key is exposed?
...
1. Restore code and conversation
--セッション再開（Resume）との違い
---セッション再開（Resume）：過去のセッションからClaudeの...
---チェックポイント（Rewind）：現在のセッション内で、会話...
--次回の予告：
---最後に現在の変更をGitコミット（git commit -m "before Y...
---次回は、差分を自動承認して高速で開発を進める「YOLO（Yo...
+Claude Code YOLO Mode：権限をバイパスして自律コーディング
--「YOLOモード（危険モード）」でのClaudeの起動~
GUIからの実行でも同じだと思われるが、ココで初めて大きめの...
---概要：ユーザーの許可（パーミッション）を一切求めずに、...
---起動方法：コマンドラインで claude --dangerously-skip-p...
---リスクと注意点：破壊的なコマンド（rm -rf など）が実行...
---本来は、インターネットアクセスを制限し、簡単に復元でき...
--タスクの実行と結果
---依頼内容：プロジェクトのUI改善（削除ボタンのアイコン化...
please improve the UI of this project, particularly maki...
---実行プロセス：Claudeはユーザーの介入なしで完全に自律し...
---検証結果：~
・ローカルサーバー（localhost:8000）は問題なく起動。UIは...
・組み込まれているAIアシスタント機能（OpenRouter経由）も...
hi there
Hello! How can I help you with your board today?
please give all cards to the Done column
All non-Done cards have been moved to the Done column,
--結論と事後処理
---YOLOモードは、適切な指示を与えれば人間が目を離している...
---動作確認後、安全のためにすぐにGitコミット（git commit ...
+Claude Code の Ralph Loops：自律エージェントによるオート...
--Ralph loop（ラルフ・ループ）とは
---概要：オーストラリアのエンジニア、Geoffrey Huntley氏に...
---仕組み：AIが「タスクが完了した」と判断した際、文脈（コ...
---メリット：通常数分で終わるタスクを、何時間もかけて自律...
--実演と検証結果
---/plugin install でAnthropicの公式プラグインRalph loop...
> /plugin install ralph-loop@claude-plugins-official
L Plugin 'ralph-loop @claude-plugins-official' is alre...
---設定：max-iterations 10（最大10回反復）に設定し、既存...
> /ralph-loop "Please significantly improve this project...
---安全性：リスクを伴う「YOLOモード（権限確認スキップ）」...
---結果：約1時間で1,300行以上のコードが追加・変更され、以...
・サインアップ、サインイン/アウト~
・マイページ（ユーザー名表示）~
・複数のかんばんボードの作成・切り替え・カード移動・デー...
---動作確認の結果、いくつかの軽微な不具合を修正しただけで...
--Ralph loopの使い所と今後の展望
---使い所：短時間でプロトタイプやMVP（実用最小限の製品）...
---注意点：予測可能で信頼性の高い成果が必要な場合や、人が...
---今後のステップ：今回のRalph loopはあくまで前触れ（ティ...
***Day 3 [#v4145684]
45-51
+MCP、Skills、Plugins：Claude Code の3大構成要素
--Claude Codeの背後にある4つの大きなイノベーション
---トリック1：記憶の錯覚
私はエドです
>> こんにちは、エド
私は誰でしょう？
>> わかりません
私はエドです
>> こんにちは、エド
私はエドです。こんにちは、エド。私は誰でしょう？
>> あなたはエドです
---トリック3：ツール
ツール：次の質問にPythonコードで答えるには、次のように返...
質問：円周率の平方根は何ですか？
回答：>> PYTHON: math.sqrt(math.pi) → ツールが呼び出され...
---トリック2：推論／思考
質問：コインを2枚投げます。1枚は表です。もう1枚が裏にな...
推論：Step 1：サンプル空間を列挙（全件）、Step 2：「1枚...
---トリック4：ループ~
ステップ1：LLMに進行するように指示する~
ステップ2：目標が達成されたかどうかをテストする~
ステップ3：達成されていない場合は、ステップ1に戻る~
--AIを進化させる核心：ツール（Tools）の力
---単に次の単語を予測するだけのLLMを、自律的に動く「エー...
---AIはテキストを生成するだけでなく、ツールを実行するため...
---Claude Codeには、最初から「ToDoリスト管理」「ファイル...
--3つの拡張機能の概要
---[[MCP（Model Context Protocol）]]~
・概要: Anthropicが2024年末に発表した、AIアプリケーション...
・メリット：誰かが作ったツール（ネット閲覧、市場データ取...
・デメリット/注意点：MCPはあくまで接続のための「規格（プ...
・MCPサーバーを多く接続し過ぎると、Contextウィンドウを圧...
・（ツール定義による消費、ツール実行結果の蓄積、誤ったツ...
---Skills (スキル)~
・概要: MCPの後に登場した、AIに専門知識や機能を追加するた...
・特徴: MCPと競合・代替するような性質を持つが、MCPが抱え...
---Plugins (プラグイン)~
・概要: 最も高レベル（上位レイヤー）の概念です。~
・特徴: 複数のMCPやSkills、その他の要素を一つにまとめた「...
--まとめ
---これら3つは、すべて個別にインストールや有効化ができる...
---ベースにあるのは**「AIにツール（行動力）を与える」**と...
---これらを理解し適切に使い分けることで、Claude Codeの専...
+MCP Server 解説：Host、Client、Discovery（Claude Code）~
ヤヤコシイので、必要に応じて[[コチラ>MCP（Model Context P...
--MCPの基本概念と3つの要素
---MCPホスト (MCP Host)：ツールを呼び出すAIアプリケーショ...
---MCPクライアント (MCP Client)：ホスト内で動作し、各ツー...
---MCPサーバー (MCP Server)：実際に外部で開発されたツール...
--2つの実行モード「トランスポート」と「ローカル」の誤解~
ローカル実行のMCPサーバーは、（COMで言う所の）ローカル・...
---2つの方式：現在は「STDIO」が推奨方式で「SSE」は非推奨...
---ローカル実行：ローカルで動作。リモート実行：リモートで...
--MCP最大のメリット
---ターミナルで「わずか1行のコマンドを実行するだけ」で、A...
---この標準化された手軽さこそが、MCPが多くの開発者に支持...
--MCPサーバーの探索と「マーケットプレイス」の現状~
現在、誰もが1箇所に集まるような標準的な検索場所はなく「無...
---公式レジストリ（registry.modelcontextprotocol.io）：Li...
---AnthropicのGitHubリポジトリ：初期の参考サーバーやサー...
---外部マーケットプレイス（mcp.so や Glamour.ai）：1万数...
--信頼できるMCPサーバーの見極め方
---マーケットプレイスには「Context 7」（最新のAPI情報をLL...
---安全性を確認する最善の方法は、開発元のGitHubリポジトリ...
+Claude Code への MCP Server 追加：Context7 & Massive
--「Context7」MCPサーバーの追加と検証
---Context7とは、LLMに最新のライブラリやツールのドキュメ...
---追加手順：Claude Codeを一度終了し、コマンドラインからG...
> claude mcp add context7 npx -y @upstash/context7-mcp
---ツール機能：統合すると、ライブラリIDを特定するツールと...
MCP tools /mcp
L mcp_ide_getDiagnostics: 111 tokens
L mcp_ide_executeCode: 182 tokens
L mcp_context7_resolve-library-id: 492 tokens
L mcp_context7_query-docs: 401 tokens
---プロンプトのコツ：確実にMCPサーバーを使わせたい場合は...
（明示：）> use context7 to summarize for me the right w...
（自動：）> how do I turn off telemetry with CrewAI
--「Massive (旧 Polygon IO)」MCPサーバーの追加
---Massiveとは、市場データ（株価など）を取得するMCPサーバ...
---実演：追加後、Claudeに「Appleの現在の株価は？」と質問...
> claude mcp add massive e MASSIVE_API_KEY=your_api_key_...
> what's the current share price of AAPL?
AAPL (Apple Inc.) is currently trading at $270.01, up $9...
--Claude Codeの最適化（コンテキストの節約）
---大量のツールを提供する巨大なMCPサーバー（Massiveなど）...
---Claude Codeは近年のアップデートにより「今必要なツール...
---そのため、利用可能なツールが大量にあってもトークンを無...
--MCPサーバーの削除：追加時と同様に、コマンドラインから c...
+Skills vs MCP：Claude Code で能力を追加するよりシンプル...
--「[[Agent Skills]]（スキル）」とは？
---Skillsは、MCP（Model Context Protocol）の後に登場した...
---LLMエージェントに対しMarkdownファイルを使って指示を与...
---システム・プロンプトにSkillsの存在と利用方法が記述され...
--メリット（MCPとの比較）
---段階的開示：まずは最上部の「メタデータ（概要）」だけが...
---シンプルで軽量：Skillsは「フォルダとファイルの集まり」...
---シェルスクリプトの実行：Markdownだけでなく、シェルスク...
--デメリットと課題
---柔軟性とパワーの低下：Function Callingのパラメタ定義に...
---発見の難しさ：MCPに比べてまだ普及の歴史が浅く、どこで...
---呼び出しの曖昧さ：AIにSkillを使わせるトリガーがやや曖...
--Skillsの3段階構造（段階的開示の仕組み）
|階層|名称|内容|読み込みのタイミング|h
|第1階層|メタデータ|Skillの名前と概要説明|常に最初に読み...
|第2階層|指示|具体的なワークフローやガイドライン、コード...
|第3階層|リソースとコード|スクリプト（Python等）や、参照...
--実装方法（ファイルシステム・アーキテクチャ）~
Skillsは非常にシンプルで、特定のフォルダ構造を作るだけで...
---配置場所：~
・プロジェクト個別：各リポジトリの .claude/skills/ フォル...
・グローバル（PC全体）：ホームディレクトリの .claude/skil...
---構成:skillsフォルダの中に「Skillごとのサブフォルダ」を...
--総括：技術的な複雑さ（オーバーヘッド）が大きかったMCPに...
+Skills Marketplace：Claude Code に Agent Browser をイン...
--「Skills（スキル）」の概要とマーケットプレイス
---構造のシンプルさ：スキルはファイルとフォルダの集まりで...
---主な入手先：~
・[[Anthropic社のGitHubリポジトリ>https://github.com/anth...
・[[skills.sh (Vercel製)>https://www.skills.sh/]]：様々な...
--スキルのインストール手順（Agent Browserの例）
---前提：npm を使用して、ヘッドレスブラウザ（Agent Browse...
> npm install -g agent-browser
> agent-browser install
---追加：Vercelのユーティリティコマンド npx skills add [G...
> npx skills add https://github.com/vercel-labs/agent-br...
---設定：適用先として「Claude Code」を選択し、プロジェク...
---結果：スキルの組み込みは、プロジェクトの .claude/skill...
--実際の動作とメリット
---実演デモ：Claude Codeに「ニューヨークのレストランを検...
> Please interact with the browser to look for restauran...
（来週ニューヨーク市でレストランを探すには、ブラウザを操...
...I've searched both Resy and OpenTable for restaurant ...
...ResyとOpenTableの両方で、来週（2026年2月7日土曜日）の...
---チーム共有の容易さ：スキルはただのファイルで、Gitコミ...
+Claude Code Plugins：マーケットプレイス、インストール方...
--「[[Agent Plugins]]（プラグイン）」とは？
---概要：2025年10月に導入された最も新しい概念。MCP、Skill...
---目的：MCPやスキルの複雑な組み合わせをユーザーに意識さ...
---特徴：他のAI（ChatGPTなど）にはなく、Claude Code専用に...
--メリットとデメリット
---メリット（Pros）:~
・インストールするだけで使えてシンプル。~
・コマンドを明示的に入力して実行するため、曖昧さがなく、...
・迷ったら、MCPやスキルではなくプラグインから始めるのがお...
---デメリット・制限（Cons）:~
・Claude Codeでしか使えない。~
・パッケージとして一括導入されるため、細かいカスタマイズ...
--エコシステムとマーケットプレイス
---[[公式リポジトリ：GitHub上の anthropic/claude-plugins-...
---マーケットプレイスの追加：Claude Code内から直接アクセ...
--実際の操作と主なプラグイン
---操作方法：/plugin コマンドで管理画面（Discover / Insta...
・Discoverタブ：「マーケットプレイスのブラウザ」。登録済...
・Installedタブ：「インストール済みプラグインの管理画面」...
・Marketplacesタブ：「マーケットプレイス自体の管理」追加...
---人気のプラグイン例：~
・Front-end Design：高品質なUIを作る、最も人気のプラグイ...
・Context 7 / GitHub：面倒なMCPサーバーの設定を簡単に導入...
・Code Review：プルリクエストのコードレビューを行う公式プ...
・Code Simplifier：LLMが生成した複雑なコードをシンプルに...
・Ralph Loop: 前日にデモで使用した「/ralph-loop」コマンド...
+MCP vs Skills vs Plugins：Claude Code で最適な構成を選ぶ
--プラグイン（Code Simplifier）の検証
---導入：Anthropic製の「Code Simplifier」をインストール（...
前述の「Discoverタブ」から「code-simplifier」プラグインを...
---実行：自然言語で「コードベース全体を簡素化して」と指示...
> please use the code simplifier agent to simplify the e...
---結果：約6分間の処理で多くの変更とテストが実行された後...
--3つの拡張技術の比較
|技術|メリット|デメリット|h
|MCP (Model Context Protocol)|エコシステムが巨大、選択肢...
|Skills|コンテキスト効率が良い、設定が簡単、チーム間での...
|Plugins|MCPやSkills、エージェントなどを一括同梱可能。最...
--どの技術を選ぶべきか（結論）~
選択肢（MCP/Skills/Plugins）の中からでは「先ずはPluginsか...
---基本戦略：目的の機能を持つプラグインがあれば、それが最...
---MCPを選ぶケース：市場データの取得など、非常に専門的な...
---Skillsを選ぶケース: Vercelのブラウザエージェントのよう...
--総括と次へのステップ
---カリキュラム全体の折り返し地点（50%）を通過。
---翌日からは、これらを踏まえた実際のプロジェクトにおける...
***Day 4 [#hbd1f44c]
52-57
+Claude Code、Jira、MCP、Plugins を活用した開発ワークフロ...
前回学んだMCP、スキル、プラグインなどの知識を実際の行動に...
--3つの拡張機能の振り返りと比較
---MCP (Model Context Protocol): Anthropicが開発した規格。~
・プラス面: エコシステムが非常に膨大。~
・マイナス面: コンテキストを消費しやすく、時に扱いが難し...
---スキル (Skills): Markdownやスクリプトを組み合わせた軽...
・プラス面: 効率的かつシンプルで、良い結果が得られやすい...
・マイナス面: MCPほど強力・柔軟ではなく（認証機能など）、...
---プラグイン (Plugins): MCPやスキル、エージェントなどを...
・プラス面: 両者の良いとこ取りができる（現時点ではClaude ...
・マイナス面: 大量に入れすぎると、LLM（Opus）がどのツール...
---推奨されるアプローチ：~
・先ずはプラグインマーケットプレイスからプラグインを試す。~
・その上で、特定のエコシステムを活用したい場合は「MCP」を...
--開発実践：「自分で選ぶ冒険（Choose Your Own Adventure）...
以降はスライドを一切使わない実践形式で、全く同じ手順を踏...
---開発プロセスの出発点（Jiraのセットアップ）~
開発ライフサイクルの起点として、多くの企業で標準的に使わ...
・Jiraは、バグトラッキングや課題管理、プロジェクト管理な...
・Jiraのサインアップ：https://www.atlassian.com/software/...
・スペースの作成：「Kanban（カンバン）」テンプレートを使...
・詳しい手順：サインアップ、サインイン、サイト作成、カン...
---プロジェクトの題材：今回構築する製品の名前は「Pre-Lega...
・コンセプト：企業向けにNDAやクライアント契約書などの法的...
・目的：弁護士の置き換えではなく、弁護士や法律事務員が仕...
---最初のタスク作成：Jira上に「Pre-Legalの会社概要を説明...
+Claude Code と MCP Serverを用いたJira、GitHub連携~
ClaudeCodeとJIRA、GitHub連携で、プラグインやスキルを使用...
--Atlassian (Jira) MCPサーバーの連携とテスト
---MCPサーバーの追加：VS Codeのターミナルから claude mcp ...
> claude mcp add --transport http atlassian https://mcp....
> claude
---OAuth2.0による認証：/mcpコマンドで状況を確認後、認証を...
---トラブルシューティング：連携がハングした場合は認証が切...
---ツールの検証：
・「/context」で多数のJira用ツールが追加されたことを確認。
> /context
MCP tools /mcp
L mcp_atlassian_...
...
・事前にJira側で作成していたタスク「PL-1」についてClaude...
> please tell me about jira issue PL-1
Jira Issue PL-1
|Field |Value ...
|Summary |We need a simple website that describes the...
|Type |Task ...
|Project |Prelegal (PL) ...
|Status |To Do ...
|Assignee |Unassigned ...
|Description|None provided ...
Link: https://edwarddonner.atlassian.net/browse/PL-1
--GitHubの準備とFine-grained Access Tokenの発行~
---Fine-grained Access Tokenとは、スコープ制御できるAPIア...
---リポジトリの新規作成：GitHub上で「pre-legal」というプ...
---トークンの生成：ユーザーの「Settings」＞「Developer se...
---セキュリティの最小権限原則：有効期限を30日、アクセス権...
---注意点：生成されたトークンは一度しか表示されないため、...
--ローカル環境へのリポジトリのGitクローン
---ポジトリのHTTPS URLをコピーし、VS Codeでターミナルを開...
---Gitクローンした「pre-legal」ディレクトリ内に、GitHub上...
+GitHub MCP Server と Featured Dev Plugin のセットアップ
--GitHub MCPサーバーの導入と連携
---VS Codeで新しいプロジェクトを開き、ターミナルからGitHu...
> claude mcp add --transport http github https://api.git...
> claude
---接続完了後、Claude CodeがGitHub関連の多数のツールにア...
> /context
MCP tools /mcp
L mcp_github_...
...
--Claude CodeによるGitHub操作の実証
---Issueの作成：Claudeに指示を出し、READMEの更新に関するI...
> please write an issue to Github that the README needs ...
（GitHubのIssue上に）The README needs to be updated to r...
---Pull Request（PR）の作成とmerge：READMEにプロジェクト...
> please update the README to reflect that the project i...
（GitHubのPR上に）title：Update README with project stat...
---事後処理：Git操作の仕上げとして、作業用ブランチからメ...
> git status
On branch update-readme
Your branch is up to date with 'origin/update-readme'.
nothing to commit, working tree clean
> git checkout main
Switched to branch 'main'
Your branch is up to date with 'origin/main'.
> git status
On branch main
Your branch is up to date with 'origin/main'.
nothing to commit, working tree clean
--「FeatureDev」プラグインのインストール
---/plugin コマンドで、Discover画面のプラグイン一覧から、...
---コレは「コードベースの探索」「設計」「品質レビュー」等...
---チーム全体で共有できるよう、プロジェクト・スコープ（.c...
--プロジェクトの環境整備と最終確認
---Claudeに対し、Python (FastAPI) と JavaScript (Next.js)...
> please create a boilerplate .gitignore for this new pr...
---Claudeが自動でGit操作（PRのmerge分のpull、commit、push...
--結論：Jira（タスク管理）とGitHub（コード・Pull Request...
+Claude Code の自律性：Jira Issue から MCP Server 経由で...
--Jiraでの2つ目の課題を作成（タスク：PL-2）
---タスク内容：「Common Paper」が公開しているCreative Com...
Title：Create a dataset of legal document templates that...
Description：This task is a one-time data curation task ...
For context, the CommonPaper github account at Common Pa...
For this task, we need to browse these repos online to r...
Then put all the markdown files in our Protegal project ...
Additionally, make a new json file called catalog.json i...
Finally, add a text file in the "templates" directory to...
表題：システムが後でユーザー向けに修正できる法的文書テン...
説明：このタスクは、Prelegalプロジェクトのデータ準備のた...
背景として、Common PaperのGitHubアカウントには、CCライセ...
このタスクでは、これらのリポジトリをオンラインで閲覧し、...
次に、すべてのMarkdownファイルをPrelegalプロジェクトの「...
さらに、プロジェクトルートに「catalog.json」という新しい...
最後に、「templates」ディレクトリにテキストファイルを追...
---要件：templatesディレクトリへのMarkdownファイルの格納...
--Claude Codeの準備とMCP連携
---Atlassian（Jira）用のMCP（Model Context Protocol）サー...
> claude mcp add transport http atlassian https://mcp.at...
> claude
---Claude Codeに対し、「Jiraの課題PL-2を実行し、PRを上げ...
> please carry out jira issue PL-2 and raise a PR with y...
PR created. Let me also update the Jira issue status to ...
--Claude Codeによる自律的な問題解決（自律性の発揮）
---アプローチの最適化：~
・当初、Claude CodeはGitHubツールでファイルを1つずつ読み...
・途中で方針を切り替え、コマンドを実行してファイルを直接...
---成果物の生成：指示通りMarkdownファイル群、license.txt...
--Pull Request（PR）作成とJiraのステータス更新
---PRの作成：ローカルのGitHub CLIツールが未インストールだ...
---トラブルシューティング（Jiraの認証切れ）：~
・Jiraのステータスを「完了」にする際、Atlassianの認証切れ...
・/mcpコマンドから手動で再認証を行うことで、Claude Codeは...
> please try marking the jira issue complete again
--ローカルでのmergeと完了~
---PRをmergeして、ブランチをmainに切り替えてください。
> please go ahead and merge the PR, and also then switch...
---PRのmerge権限がないと判明すると、Claude Codeは「ローカ...
...
The GitHub token doesn't have merge permissions. Let me ...
...
Done. Merged to main and switched branches. You're now o...
--結論 / 考察
---AIのブレイクスルー：障害に直面した際、AIが自ら原因を理...
---MCPの現状：認証が切れやすいなどの「わずかな不安定さ（f...
+Claude Code が Jira チケットから Next.js アプリをフル構築
--タスクの起票と初期設定
---Jira上で「PL2」チケットの完了を確認後、3つ目の課題を作...
Title：Prototype of Mutual NDA creator
表題：相互秘密保持契約（NDA）作成プロトタイプ
---要件はあえて曖昧さを持たせたビジネス寄りの内容に設定。
Description：A web application to create a Mutual NDA Do...
The user enters in some key information in a form. The w...
The user can download the completed document locally.
説明：ユーザー向けに相互秘密保持契約（NDA）を作成するWeb...
ユーザーはフォームにいくつかの重要な情報を入力します。す...
ユーザーは完成した文書をローカルにダウンロードできます。
--Claude Codeによる開発の実行
---Claude Codeを再起動し、/contextコマンドでContextウィン...
---プラグイン（feature_dev）を使い「JiraのPL3をNext.js（f...
>/feature-dev: feature-dev please implement jira issue P...
I'll start by fetching the Jira issue PL-3 to understand...
---Claude（feature_dev）は7段階のプロセスに沿って動作を開...
Phase 3: Clarifying Questions
Before proceeding with architecture, I have some questio...
6 tasks ( done, 1 in progress, 5 open) ctrl+t to hide ta...
✓Implement Jira issue PL-3 with NextJS frontend
・Create NextJS project structure
・Build NDA form component
・Create NDA preview/display component
・Implement document download
--------------------------------------------------
・Download・Form UX・Preview・Design・Submit
Download：What download format should the completed NDA ...
> 1. PDF (Recommended)：Professional format, widely comp...
2. Markdown：Simple text format, matches source template
3. Both PDF and Markdown：Give users a choice
4. Type something.
5. Chat about this
Form UX：Should the app have a multi-step wizard or sing...
> 1. Single page (Recommended)：All fields visible at on...
2. Multi-step wizard：Guided step-by-step experience, ...
3. Type something.
4. Chat about this
Preview：How should the NDA preview be displayed?
1. Below the form (Recommended)：Live preview that upd...
2. Separate preview page：Navigate to see completed do...
> 3. Side-by-side：Form on left, preview on right
4. Type something.
5. Chat about this
Design：Should this be a simple prototype or include sty...
1. Functional prototype：Basic styling with Tailwind, ...
> 2. Polished design：Professional look with careful att...
3. Type something.
4. Chat about this
Submit：Review your answers
- What download format should the completed NDA be ava...
- Should the app have a multi-step wizard or single-pa...
- How should the NDA preview be displayed?：Side-by-side
- Should this be a simple prototype or include styling...
--アプリケーションの動作確認
---わずか数分でNext.jsのフロントエンドファイル群とGitHub...
---ローカル環境でアプリ（npm run dev）を起動したところ、...
Purpose：Evaluating whether to enter into a business rel...
---フォームに入力したデータ（会社名や準拠法など）が、右側...
Mutual Non-Disclosure Agreement
Common Paper Mutual NDA Standard Terms Version 1.0
Cover Page
PURPOSE：Evaluating whether to enter into a business rel...
...
---「PDFダウンロード」ボタンを押すと、カバーシート付きの...
--プロセスの検証とテストの追加要求
---/contextコマンドでContextウィンドウを確認、1/3 - 1/2ぐ...
---非常に完成度が高い一方、プロセス中に自動テストが実行さ...
> It's working great. Based on the process you followed,...
---Claudeは「ビルド確認は行ったが、自動テストやコードレビ...
Good question. Here's what was actually done:
Completed:
- Build verification: Ran npm run build successfully con...
Not done:
- No automated tests were written
- No manual testing I didn't run npm run dev and verify ...
- code-reviewer agents launched (Phase 6 from the featur...
- No PDF download testing didn't verify the generated PD...
The build passing gives some confidence that the code is...
- The form actually works and updates state correctly
- The preview renders properly
- PDF generation produces a valid desument
- The layout looks good on different screen sizes
Would you like me to:
1. Run the dev server and do manual testing?
2. Launch code-reviewer agents to check for bugs and cod...
3. Add some basic tests?
---これを受け、「自動テスト・手動テストの追加、およびコー...
> yes to all 3 please add extensive automated tests and ...
+Claude Code のデバッグ戦略：体系的なアプローチ
--開発タスクの進捗と成果
---成果物の完成：Claude Code を用いて、NDA（秘密保持契約...
---トラブルへの自動対応：サーバーの強制終了や、Contextウ...
---動作確認とデプロイ：localhost:3000 でアプリが正常に動...
---最終処理：/mcpコマンドでAtlassianの再認証を行い、ロー...
> please merge the PR (legally) and push to main and swi...
--推奨のデバッグ戦略（5つのステップ）~
今回はバグが発生しなかったため、次回以降に向けた実践的な...
---スナップショットの取得（Gitコミット）：AIが誤った方向...
---手軽なアプローチ（コピー＆ペースト）：単純なエラーであ...
---規律あるアプローチとドキュメント化（規律モード）~
・簡単な修正で解決しない場合は、Gitで元の状態に戻し、debu...
・注意点: AIがネット上の古い、または無関係な1件のトラブル...
---根本原因の証明と修正：AIに根本原因を証明させ、それを d...
---教訓の記録：会話のクリアやコンパクト化によってAIが過去...
--デバッグのプロの技（Hot Tips）
---別のLLM（エージェント）の活用：Claudeが行き詰まった場...
---デバッグスキルの活用：プラットフォーム内の「Systematic...
--まとめと次回への展望
---本日の振り返り：Jiraからの課題読み込み、Claude Code（F...
---現在の進捗：全行程の 60% を消化。AIを使いこなす技術が...
***Day 5 [#u9d73ed5]
58-63
+SaaS プラットフォーム構築：Claude Code Skills & CLAUDE.m...
前日から着手しているリーガル文書自動作成のSaaSプラットフ...
--Claudeの3つの拡張機能のまとめ~
Claudeに能力を付与する方法として、以下の3つの特徴とメリッ...
|機能|特徴|メリット|デメリット|h
|MCP|モデルとツールを結合するプロトコル|エコシステムが豊...
|スキル (Skills)|Markdown形式のテキストファイル|シンプル...
|プラグイン (Plug-ins)|上記の要素やエージェントをパッケー...
--スキル (Skills)の構造と仕組み
---コンテキスト節約のための3段階の読み込み：常にファイル...
---ファイル・システムによる実装：ホーム・ディレクトリ、ま...
--プロジェクトの整理とGit管理
---前日のPull Request（PR）作成時、Claude Codeは自動的に ...
---チーム共有のために手動で git add および git commit / p...
--ホーム・ディレクトリの CLAUDE.md の活用~
プロジェクト単位だけでなく、ユーザー自身のホーム・ディレ...
---目的：すべてのプロジェクトで共通して適用したい、ユーザ...
---コツ：すべての会話で読み込まれるため、トークン節約のた...
---注意：そして、ホーム・ディレクトリ（.claude/CLAUDE.md...
--具体的な設定例
---アプローチ：常にタスクは小さく、段階的（インクリメンタ...
---ツール指定：Pythonのパッケージ管理には pip ではなく、...
---コードスタイル：明確で簡潔なドキュメント文字列を好む。
---新規追加ルール：絵文字（emojis）はPCでの不具合の原因に...
---デバッグ：当てずっぽうで修正せず、必ず原因を特定し、1...
# VERY IMPORTANT
- Be simple. Approach tasks in a simple, incremental way.
- Work incrementally ALWAYS. Small, simple steps. Valida...
- Use LATEST apis as of NOW
# MANDATORY Code Style
- Do not overengineer. Do not program defensively. Use e...
- Identify root fause before fixing issues. Prove with e...
- Work increnfentally with small steps. Validate each in...
- Use latest library APIs.
- Use uv as Python package manager. Always uv run xxx ne...
- Favor clear, concise docstring comments. Be sparing wi...
- Favor short modules, short methods and functions. Name...
# Important - debugging and fixing
- When troubleshooting problems, ALWAYS identify root ca...
- PROVE THE PROBLEM FIRST - don't guess.
- Try one test at a time. Be methodical.
- Don't jump to conclusions. Don't apply workarounds.
+CLAUDE.md の作成と Cerebras 用カスタム Skill の構築
--Claude.md（開発指示書）の作成と設定~
プロジェクトの全体像や開発プロセスをAIに理解させるための...
https://github.com/ed-donner/prelegal/blob/main/CLAUDE.md
---プロジェクト概要（Pre-legal）：~
・テンプレートに基づいて法律契約書のドラフトを作成するSaa...
・ユーザーはチャットを通じて必要なドキュメントの特定やフ...
・利用可能なドキュメントはルートの catalog.json に定義（@...
・初期実装は「フロントエンドのみのプロトタイプ」とする。
---開発プロセス：~
Jiraから機能要件を読み取り、テスト（単元・結合）を徹底し...
・Atlassianツールを使用して、Jiraから機能の説明を読み取る...
・機能開発：機能開発の7ステッププロセスからどのステップも...
・単体テストと統合テストで機能を徹底的にテストし、問題が...
・GitHubツールを使用してプルリクエストを送信。~
---AIデザイン~
・Cerebrasスキルを活用し、OpenRouter経由でLiteLLMを使用し...
・結果を解釈し、法的文書のフィールドに入力できるように、...
・プロジェクトルートにある.envファイルにOPENROUTER_API_KE...
---技術設計（Technical Design）:~
・プロジェクト全体をDockerコンテナ化する。~
・バックエンド：backend/ ディレクトリ配下、Pythonの uv を...
・フロントエンド：frontend/ ディレクトリ配下。~
・データベース：SQLiteのコンテナ起動時に毎回作成（サイン...
・scripts/には以下のスクリプトが必要
# Mac
scripts/start-mac.sh # Start
scripts/stop-mac.sh # Stop
# Linux
scripts/start-linux.sh
scripts/stop-linux.sh
# Windows
scripts/start-windows.ps1
scripts/stop-windows.ps1
--Cerebrasを使用したカスタムSkillの追加~
LLMからのレスポンスを超高速にするため、特定のインファレン...
---https://github.com/ed-donner/prelegal/blob/main/.claud...
---構成：.claude/skills/cerebras/ ディレクトリを作成し、...
---skill.md の作成：厳密なフォーマットに則り、メタデータ...
・仕様：LightLLM と OpenRouter を経由し、インファレンス・...
・結果の解釈や契約書フィールドへの流し込みを容易にするた...
---
name: Cerebras Inference
description: Use this to write code to call an LLM using...
---
# Calling an LLM via Cerebras
These instructions allow you write code to call an LLM w...
This method uses LiteLLM and OpenRouter.
## Setup
The OPENROUTER_API_KEY must be set in the .env file and ...
The uv project must include litellm and pydantic.
`uv add litellm pydantic`
## Code snippets
Use code like these examples in order to use Cerebras.
### Imports and constants
```python
from litellm import completion
MODEL = "openrouter/openai/gpt-oss-120b"
EXTRA_BODY = {"provider": {"order": ["cerebras"]}}
```
### Code to call via Cerebras for a text response
```python
response = completion(model=MODEL, messages=messages, re...
result = response.choices[0].message.content
```
### Code to call via Cerebras for a Structured Outputs r...
```python
response = completion(model=MODEL, messages=messages, re...
result = response.choices[0].message.content
result_as_object = MyBaseModelSubclass.model_validate_js...
--開発開始前の最終準備~
開発（ビルド）をスタートする前の最終調整として、以下の環...
---Claude.mdのアップデート：AIデザインのセクションに、前...
---環境変数の設定：以前のプロジェクト（pm）から cp コマン...
+Claude Code で V1 製品を構築するための Jira チケット設定
--Jiraでのチケット作成・更新~
プロトタイプから製品のバージョン1（v1）への移行に向けて、...
---PL4: 基盤の構築（Build foundation of V1 product）
Description：Upgrade the prototype so that it is the pro...
プロトタイプをアップグレードして、フロントエンド、バック...
・内容: プロトタイプをフロントエンド、バックエンド、起動...
・補足: 機能自体はまだ更新しない。認証機能は含めず、モッ...
---PL5: AIチャット機能の追加（Add AI Chat but still just ...
Description：Now change the way the product interacts wi...
次に、製品とユーザーのやり取りの方法を変えてみましょう。...
・ユーザーとの対話方法を一連の質問形式から、AIとのフリー...
・AIが文書に関する質問をして、回答に基づき必要項目を埋め...
---PL6: 全法規文書タイプへの拡大（Expand to all supported...
Description：Now expand the functionality so that it sup...
次に、テンプレートが用意されているすべての法的文書タイプ...
---PL7: 複数ユーザー対応と最終仕上げ（Support multiple us...
Description：Add a proper sign in & sign up screen that ...
Store previously generated documents and allow the user ...
Also add polish to all the screens so that they look lik...
・サインイン・サインアップ機能を実装し、過去に生成した文...
・また、プロ仕様のSaaSアプリに見えるよう画面を洗練させ、...
--開発環境の準備と認証
---ContextとSkillsの確認：Claude Code側で /context コマン...
---Atlassianの再認証：Jiraとの連携を正常に動作させるため...
---Jiraボードの構築が完了し、通常であればエンジニアリング...
+Claude Code、Jira、FastAPI を用いた機能開発
--Jiraチケット「PL4」の拡張と実装
>/feature-dev: feature-dev implement jira ticket PL-4 an...
---要件定義と開発：JiraからPL4チケットの情報を取得し、開...
Auth scope・NDA data・Submit
Auth scope：The CLAUDE.md mentions sign up and sign in. ...
1. Functional auth (Recommended)
Implement working signup/signin with SQLite user st...
> 2. Placeholder only
Create auth routes and UI but no working implementa...
3. Type something.
4. Chat about this
NDA data：For the frontend-backend integration, should t...
> 1. Keep client-side (Recommended)
NDA form works as-is, no backend integration focus ...
2. Add backend persistence
Save NDA drafts to database, user can retrieve later
3. Type something.
4. Chat about this
Submit：Review your answers
- The CLAUDE.md mentions sign up and sign in. For this...
→ Placeholder only
- For the frontend-backend integration, should the cur...
→ Keep client-side (Recommended)
Ready to submit your answers?
> 1. Submit answers
2. Cancel
---設計レビュー：提示されたアーキテクチャを開発者がレビュ...
Does this architecture approach look good to proceed wit...
> 1. Yes, proceed
Implement the V1 foundation as described
2. Need changes
I have concerns or modifications to discuss
3. Type something.
4. Chat about this
---実装レビュー：モノリシックなコードにならず、適切な構造...
---テストと動作確認：自動生成された76個のテストがすべて合...
---ローカルでPL4のPRをmergeしてmainブランチへpushし、main...
> please merge the PR locally and push to main and switc...
--Contextのクリーンアップ（ベストプラクティス）
---次のチケット（PL5）に移る前に、/contextコマンドでConte...
> please add concise details to the end of CLAUDE.md wit...
---Contextが肥大化するとAIが自動圧縮を行い、重要な記憶を...
--Jiraチケット「PL5」の開始とトラブルシューティング
>/feature-dev: feature-dev implement jira ticket PL-4 an...
---認証エラーの解決：PL5の読み込み時に処理が停止したため...
---要件の確定（チャットUIの導入）：既存のフォームを完全に...
UI Approach・Preview updates・Conversation start・Comple...
UI Approach：Should the chat UI completely replace the f...
> 1. Replace form entirely
Chat is the only way to fill in the NDA. Simpler UX...
2. Both available
User can switch between chat and manual form. More ...
3. Chat primary, form read-only
Chat fills fields, form shows current values but is...
4. Type something.
5. Chat about this
Preview updates：Should the document preview update live...
> 1. Live updates (Recommended)
Preview updates immediately as AI extracts each fie...
2. Update after confirm
Preview only updates after user explicitly confirms...
3. Type something.
4. Chat about this
Conversation start：How should the AI conversation begin?
> 1. AI greets + asks first question
AI initiate by asking about the parties involved.
2. User types first
Blank chat where user starts by explaining what the...
3. Type something.
4. Chat about this
Completion behavior：When all required fields are filled...
> 1. AI confirms show download (Recommended)
AI summarize the NDA and prompts user to review and...
2. Auto-generate PDF
Automatically download PDF when all fields are comp...
3. Type something.
4. Chat about this
Submit：Review your answers
- Should the chat UI completely replace the form, or coe...
→ Replace form entirely
- Should the dosament preview update live as the AI extr...
→ Live updates (Recommended)
- How should the AI conversation begin?
→ AI greets + asks first question
- When all required fields are filled, what should happen?
→ AI confirms + show download (Recommended)
Ready to submit your answers?
> 1. Submit answers
2. Cancel
--PL5のアーキテクチャ議論
---AIから3つのアプローチ（Minimal, Clean, Pragmatic）が提...
Architecture：Which architecture approach would you like...
1. Pragmatic Balance (Recommended)
Streaming responses + parallel extraction. Good UX,...
2. Minimal Changes
Fewest new files, combined chit+extraction.
Fastest to implement.
3. Clean Architecture
Full session persistence, service layers. Most robu...
4. Type something.
> 5. Chat about this
---AIは「ストリーミング応答」を提案、選択式のように見え、...
What would you like to clarify about the architecture op...
> I'd like the pragmatic choice except I only want 1 LLM...
+Cerebras と Claude Code で AI Legal Doc Generator をテス...
--チケットPL5の実装と検証
---実装内容：Cerebras（LLM）と統合されたAIチャットインタ...
---検証：GitHubに自動生成されたPR（13ファイル、456行の変...
---ローカルテスト：ローカル環境で起動し、相互秘密保持契約...
Hello! I'll help you create a Mutual Non-Disclosure Ag...
> Yes I'm evaluating a business relationship
Great, evaluating a business relationship it is. When ...
> yes today
Sounds good-let's set the effective date to today, 202...
Next, how long should the overall MNDA last? You can c...
> 3 years please
Got it-the MNDA will expire after 3 years.
> OK what else do you need to know
Great. Next, how long should the confidential informat...
> 2 years
Got it-the MNDA will expire after 3 years and the conf...
> what else do you need to know
We're almost there! I just need a few more details:
1. Which state's laws should govern this agreement (e....
2. Where should any disputes be resolved (city and sta...
3. Party 1-the name of your company, the signatory's f...
4. Party 2- the same information for the other side. W...
> 1. new York 2. New York 3. Just put default company na...
Perfect-I'll use New York law and New York as the disp...
**Party 1**
- Company: Company A
- Signatory: John Doe
- Title: CEO
- Notice address: john.doe@companya.com
- Signature date: 2026-02-05
**Party 2**
- Company: Company B
- Signatory: Jane Smith
- Title: President
- Notice address: jane.smith@companyb.com
- Signature date: 2026-02-05
If you'd like to change any of these later, just let m...
> yes finalize it
Excellent! Here's a summary of the Mutual Non-Disclosu...
**Purpose:** Evaluating a business relationship
**Effective Date:** 2026-02-05
**MNDA Term:** Expires after 3 years (2029-02-05)
**Confidentiality Term:** 2 years (until 2028-02-05)
**Governing Law:** New York
**Jurisdiction:** New York
**Party 1**
- Company: Company A
- Signatory: John Doe
- Title: CEO
- Notice address (email): john.doe@companya.com
- Signature date: 2026-02-05
**Party 2**
- Company: Company B
- Signatory: Jane Smith
- Title: President
- Notice address (email): jane.smith@companyb.com
- Signature date: 2026-02-05
If everything looks good, this draft is complete and r...
Let me know if you need any final tweaks or a formatte...
---課題の発見：~
（１）AIが次の質問を継続して投げかけないため、会話が途切...
（２）入力後にテキストフィールドへのフォーカスが自動で戻...
--次のステップへの移行（Contextのクリーンアップ）
---ローカルでPL5のPRをmergeしてmainブランチへpushし、main...
> yes please merge the PR locally and push and switch to...
---プロジェクトのステータス管理ファイル（CLAUDE.md）の更...
> please check CLAUDE.md is up to date with project status
---Contextウィンドウの容量が限界に達したため（/context）...
--チケットPL6の実装と機能向上
---追加の指示：Jiraチケット「PL6」に「PL5」の残件（「AIが...
>/feature-dev: feature-dev implement jira ticket PL-6.
「Also please make a couple of fixes. Ensure that after ...
And ensure that the AI always asks a follow-on question ...
then make a PR
---結果：AIがタスクを完了し、PL6のPR（16ファイル、2500行...
---最終テスト：~
・クラウドSaaS契約の生成をテスト。AIが質問を繰り返し、右...
Hello! I'll help you create a legal agreement. What ty...
- An NDA to protect confidential information?
- A Cloud Service Agreement for SaaS products?
- A Pilot Agreement to trial a product?
- Something else?
Just tell me what you're trying to accomplish and I'll...
> A cloud SaaS agreement
Great, a Cloud Service Agreement it is! Let's start ga...
First, could you tell me the name of the SaaS provider...
And what's a brief description of the cloud service yo...
> Please use invented placeholder names for both compani...
Sure, I'll use placeholder names. Let's call the provi...
Next, what start date would you like for the agreement...
> today please
Got it the effective date will be today (2026-02-05). ...
> New York, New York please
Great! I've noted the effective date as 2026-02-05, go...
Now we'll need a few more details:
1. How long is the subscription period (e.g., "1 year"...
2. What level of technical support will be provided (e...
> 1 year, business hours phone support
Got ita 1-year subscription with business-hours phone ...
Next, could you let me know the pricing structure (e.g...
> $10,000 per annum, net 30
Thanks for the details! Here's a summary of what we ha...
Cloud Service Agreement:
- Provider: Acme Cloud Solutions, Inc.
- Customer: Beta Enterprises, LLC
- Service: Al Assistant
- Effective Date: 2026-02-05
- Governing Law: New York
- Jurisdiction: New York, NY
- Subscription Period: 1 year
- Technical Support: business-hours phone support
- Fees: $10,000 per annum
- Payment Terms: Net 30
We have captured all required information, so the agre...
・ブランドカラーの適用や、最終的なPDFダウンロード機能を含...
+最終 PR merge、SaaS 完全デモ & Claude Code Week 2 勝利
--最終チケット（PL7）の実装と検証
---ローカルでPL6のPRをmergeしてmainブランチへpushし、main...
> please go ahead and merge the PR locally, and push, an...
---プロジェクトのステータス管理ファイル（CLAUDE.md）の更...
> please update CLAUDE.md to reflect the latest project ...
---プロセスの実行：Contextをクリアにした後（/clear）、Jir...
>/feature-dev: feature-dev implement jira ticket PL-7. T...
---動作確認（デモ）：サーバを再起動し、未ログイン状態での...
---評価と課題：~
・見栄えが非常に洗練されており、期待を大きく超える成果（...
・ただし、JIRAで指定した「法的免責事項」が記載されていな...
--GitHubへの反映と勝利宣言
---コードベースの規模：生成されたプルリクエスト（PR）を確...
---完了手続き：
・ClaudeにローカルでのPRのmerge、push、mainブランチへの切...
> please merge the PR locally and then push and then swi...
・およびプロジェクトの最新ステータスを反映した CLAUDE.md ...
> please update CLAUDE.md with latest project status
---技術的要素：JIRA/Gitのシームレスな統合に加え、裏側では...
--課題とコミュニティへのお願い
---課題：JIRAやGitHub Issuesにチケットを切り、Claude Code...
---成果の共有： 成果はLinkedInなどでハッシュタグや講師へ...
--次週（第3週）への展望
---プログラム全体の3分の2（67%）を終えたマイルストーンを...
---次週（最終週）は「さらにクレイジーでワイルドな内容」と...
**Week 3 [#w105632f]
Vibe Engineering as an expert（エキスパート向け）
-「コントロールされたカオス（Controlled Chaos）」をテーマ...
--マルチ・エージェント、サンドボックス環境の活用。
--大規模なコードベースへの対応、エージェント・スウォーム...
--最終的な集大成となるキャップストーン・プロジェクト。
-プロダクト
--Multi-Agents Sub-Agents Hooks
--Sandboxing
-コアスキル
--Large Codebase Workflow
--Swarms Orchestrators
-プロジェクト~
Project 4：Capstone
***Day 1 [#x55124a0]
65-71
+Claude Code Pro: サブ・エージェント、フック、スウォーム...
--日替わりスケジュール
---1日目（今日）：プロ向け機能の概観（カスタムコマンド、...
---2日目：サンドボックシング（環境の隔離と再現性の確保）
---3日目：大規模なコードベースにおけるデバッグと開発の成...
---4日目：スウォーム（群画）やオーケストレーターを用いた...
--核心概念：カオスとコントロールのバランス
---開発者は、AIがもたらす「爆発的な推進力（カオス）」と「...
---ゴールは「コントロールされたカオス」：まずは「コントロ...
|分類|特徴・具体的なアプローチ|主な技術・概念|h
|カオス (Chaos)|推進力の最大化|正のフィードバック。信頼し...
|コントロール (Control)|安全性と品質の担保|負のフィードバ...
--本日（1日目）学習するプロ向け機能~
本日、リポジトリを使って実際に手を動かしながら学ぶ機能は...
---カスタムSlashコマンド：独自のSlashコマンド（/command）...
---マルチ・エージェント vs サブ・エージェント：複数のClau...
---エージェントチーム：チームとしての協調（4日目に本格実...
---フック (Hooks)：Ralphループなどを実現するための仕組み
---独自プラグインの作成：チーム内での共有やマーケットプレ...
+FiNALLYプロジェクトのセットアップ：私たちのマルチ・エー...
--プロジェクトの概要
---今週の課題は、コースの集大成（キャップストーン・プロジ...
---複数のAIエージェント（マルチ・エージェント）を協調・制...
--アプリケーションの機能とビジョン
---AI搭載のトレーディング・ワークステーション：見た目や操...
---余談：「ブルームバーグ端末に手を出すな」（WSJ）では「...
---ライブ市場データのストリーミング：SSE（Server-Sent Eve...
---シミュレーション取引：ユーザーは仮想ポートフォリオで取...
---LLMアシスタントの統合：ポートフォリオの分析や取引の代...
--技術スタックとアーキテクチャ
---データベース：シンプルさを維持するため、前回同様にSQLi...
---デプロイ：複雑化を避けるため指示により単一のDockerコン...
--開発の進め方と初期リポジトリの構成~
指定のリポジトリ（https://github.com/ed-donner/finally）...
> git clone https://github.com/ed-donner/finally.git
---Claude.md：すべてのコーディング・エージェントがこの pl...
---配置場所を明示する目的で、空のディレクトリ群（backend...
---planning/PLAN.md：https://github.com/ed-donner/finally...
・ビジネス要件やアーキテクチャが定義された最重要書類（冒...
・全エージェントが planning/PLAN.md に準拠してプロジェク...
+Claude CodeでのカスタムSlashコマンドの作成~
※ ココで新規作成したリポジトリに存在しないカスタムSlashコ...
--Slashコマンドの概要と作成方法~
開発ツール（Claude Code）において、独自の「Slashコマンド...
---方法①：commands フォルダを使用する（従来の標準的な方法...
・手順：プロジェクト内（またはホームディレクトリ内）の .c...
・定義方法：その中に、作成したいコマンド名（小文字＋ハイ...
例：Review the documentation file in the planning folde...
・引数の利用：プロンプト内で $ARGUMENTS（すべて大文字）と...
・メリット：YAML形式のメタデータ（フロントマター）を書く...
---方法②：skills フォルダを使用する（現代の主流）~
・もう1つの方法は「スキル（Skills）」として定義する方法~
・.claude 内の skills フォルダに定義を追加するだけで、そ...
・現在の開発においては、この「Skills」としてSlashコマンド...
・以前実装したSkillsのnameをSlashコマンドで使用できるよう...
・https://raw.githubusercontent.com/ed-donner/prelegal/...
・https://raw.githubusercontent.com/ed-donner/finally/r...
--実践：ドキュメントレビュー（doc-review）コマンドの実行~
計画書ファイル（PLAN.md）のレビューを行うコマンドを実際に...
> /doc-review PLAN.md
---人間の監視と裁量の重要性：~
・AI（Claude Opus 4.6）は指示通り「質問・明確化・修正点」...
・しかし、AIが提案した「簡素化」の多くは、システムの将来...
・同意できる（以下の）1点のみを残して却下。AIの提案を鵜呑...
システム設計（データベースやAPIなど）における数量（quant...
・指摘の内容現状：positions/trades（ポジションや取引）の...
・懸念点：もし「単元株（整数）」のみを扱うのであれば、IN...
・提案：REAL が意図的なのであれば、バリデーション（入力...
・回答：はい、端数株（fractional shares）をサポートすべ...
・レビューの指摘に対するフィードバックに基づきPLAN.mdを更...
> I've updated the comments at the end of PLAN.md with m...
---通常のコマンドとサブ・エージェントの違い：~
・今回のような通常のコマンドやスキルは、すべてメイン・チ...
・一方で、今後学ぶ「サブ・エージェント」は別のLLMコールを...
--まとめ
---どちらの方法で作成した場合も、.claude ディレクトリに保...
---今週の講義では、このようなレビューや開発のプロセスをさ...
+Claude CodeとCodex CLIを使ったエージェント＆サブ・エージ...
※ ココで新規作成したリポジトリに存在しないサブ・エージェ...
--マルチ・エージェントの基本と課題
---マルチ・エージェントの単純なアプローチ：ターミナルのタ...
---現状の課題：開発計画の連携や境界線が十分に定義されてい...
--異なるCLIエージェント（Codex）との連携
---講義内の実験として、Claude Codeとは異なるAIエージェン...
> npm i-g @openai/codex
> codex
---codex exec コマンドを使用し、シェル（ターミナル）経由...
> codex exec "ase review the file planning/PLAN.md and w...
---これにより、複数の異なるAIモデルを別々のエージェントと...
--サブ・エージェントの作成とメリット
---サブ・エージェントとは：メインのClaude Codeから特定の...
---主なメリット：~
・コンテキストの分離: メインエージェントのトークン（記憶...
・コストと速度の最適化: 処理に応じて「Haiku」のような軽量...
・並行処理: 複数のタスクを同時に実行できる。
--カスタム・サブ・エージェントの構築：
---プロジェクト内の .claude/agents/ フォルダに reviewer.m...
---
name: reviewer
description: carry out a comprehensive review when reque...
---
You review the file planning/PLAN.md and write your feed...
---他にも以下のような属性を設定できるらしい（必須は name ...
tools: Read, Glob, Grep
model: opus
...disallowedTools, permissionMode, maxTurns, skills, mc...
---Slashコマンドではなくプロンプトで指示を出すことで、メ...
> Use the reviewer agent to carry out a reivew
--なお、/agentsコマンドで以下の項目を確認・実行できる。
---Create new agent：平易な英語の説明文から、Project or P...
・.claude/agents/ → プロジェクト固有（チームで共有可能）~
・~/.claude/agents/ → 全プロジェクト共通（個人用）エージ...
---Project agents：定義したプロジェクト・チーム用エージェ...
---Personal agents：定義した個人用エージェント
---Plugin agents：Slashコマンド、サブ・エージェント、MCP...
---Built-in agents：Explore（ファイルの読み取りはできるが...
+Claude Codeにおけるサブ・エージェント vs エージェント・...
※ ココで新規作成したリポジトリに存在しないサブ・エージェ...
--Claude Codeにおけるサブ・エージェントの活用（異種LLMの...
---.claude/agents/codex-reviewer.md に、以下のようにシェ...
---
name: codex-reviewer
description: carry out a comprehensive review of PLAN.md...
---
You are using a different AI Agent to carry out a review...
You MUST execute the following shell command to carry ou...
*codex exec "Please review the file planning/PLAN.md and...
This will run the review process and save the results. D...
---サブ・エージェントを起動し、メインの文脈（コンテキスト...
> Use your codex-reviewer subagent to carry out a review...
---.claude/agents/change-reviewer.mdに、以下のように特定...
---
name: change-reviewer
description: carry out a compehensive review of all chan...
---
This subagent reviews all changes since the last commit ...
IMPORTANT: You should not review the changes yourself, b...
Run this shell command:
codex exec "Please review all changes since the last com...
This will run the review process and save the results. D...
---サブ・エージェントを起動し、メインの文脈（コンテキスト...
> use the change-reviewer subagent to review changes sin...
---サブ・エージェント、外部LLM（Codex）とのやり取りは独立...
--「サブエージェント」と「エージェントチーム」の違い
|機能|特徴・役割|h
|サブ・エージェント（Sub-agents）|メインのClaude Codeから...
|エージェント・チーム（Agent teams）※実験的機能|複数のCla...
+Claude Code Hooks：イベント＆コマンドによる自動レビュー...
--Claude Code の「フック（Hooks）」機能の概要~
日常的でない特定の状況（イベント）において自動で特定の処...
---仕組み: 特定の「イベント」が発生した際、あらかじめ設定...
---イベントの例：~
・ツール実行の前（Pre tool use） / 後（Post tool use）~
・ユーザーへの権限確認時（例：確認時にスマホへ通知を飛ば...
・Claude が作業を終了・停止する時（Stop / Session end）な...
---トリガーできる3つの処理~
・Command（シェル・コマンドの実行）: 最も確実でバグが起き...
・Prompt（Claudeへのプロンプト指示）: 新たな指示を Claude...
・Agent（サブ・エージェントの起動）: コンテキストを汚さず...
--実装例：作業終了時に自動コードレビューを行う~
Claude が作業を終えたタイミング（stop イベント）で、自動...
---設定場所：プロジェクト内の .claude/settings.json（また...
{
"hooks": {
"Stop": [{
"hooks":[
"type":"command",
"command": "codex exec \"codex exer "Review chan...
]
}]
}
}
---設定方法：~
・/hookコマンドでStopを選択し、
/hooks
Hooks
6 hooks
1. PreToolUse Before tool execution -
2. PostToolUse After tool execution
3. PostToolUseFailure After tool execution fails
4. Notification -When notifications are sent
5. UserPromptSubmit When the user submits a prompt
6. SessionStart When a new session is started
> 7. Stop Right before Claude concludes its response
8. SubagentStart When a subagent (Task tool call) is s...
9. SubagentStop - Right before a subagent (Task tool c...
10. PreCompact Before conversation compaction
11. SessionEnd When a session is ending
12. PermissionRequest - When a permission dialog is di...
13. Setup Repo setup hooks for init and maintenance
14. TeammateIdle When a teammate is about to go idle
15. TaskCompleted When a task is being marked as compl...
16. Disable all hooks
・定義したフックを選択する。
Stop
Exit code 0 stdout/stderr not shown
Exit code 2 show stderr to model and continue conversation
Other exit codes show stderr to user only
1. + Add new hook...
> 2. codex exec "Review changes since last commit and wr...
---動作の流れ：~
・事前に、ココまでで作成した、カスタムSlashコマンドやサブ...
・ユーザーが Claude に「README.md を作成して」と指示。Cla...
> please make a concise README.md for the project
- Let me check the current project state first.
- Searched for 1 pattern, read 2 files (ctrl+o to expand)
- Both backend/ and frontend/ are empty the project is i...
- Write (README.md)
Done. The README covers the essentials what the project ...
・フックが発動し、バックグラウンドで codex exec コマンド...
・Claude 自身は裏でレビューが動いたことを認識していないが...
--まとめ、注意点とアドバイス
---フックは開発プロセスを高度に自動化できる強力なツールだ...
---最初から無理に覚えようとせず、「こういうことができる」...
+カスタムClaude Codeプラグインとマーケット・プレイスの構築
--独自プラグインとマーケット・プレイスの作成・導入~
Claude Codeにおける独自プラグイン（例: 変更点を自動レビュ...
---プラグインの作成手順~
・フォルダの作成：任意の場所にプラグイン用の新規フォルダ...
・設定フォルダとマニフェスト：その中に .claude-plugin と...
{
"name": "independent-reviewer",
"description": "Carry out an independent review of all...
"version": "1.0.0"
}
・機能の追加：役割に応じて、プラグイン・フォルダ内に以下...
commands、skills、agents、hooks ... ココでは先ほど定義...
{
"hooks": {
"Stop": [{
"hooks":[
"type":"command",
"command": "codex exec \"codex exer "Review chan...
]
}]
}
}
---マーケット・プレイスによる共有とインストール~
・マーケット・プレイスの定義：リポジトリのルートに .claud...
{
"name": "ed-tools",
"owner": {
"name": "Ed",
"email": "ed@edwarddonner.com"
},
"plugins": [{
"name": "independent-reviewer",
"source": "./independent-reviewer",
"description": "Carry out an independent review of a...
"version": "1.0.0",
"author": {
"name": "Ed"
}
}]
}
・Claude Codeへの導入：/plugin コマンドを実行し、Marketpl...
・ローカルパス（./）やGitHubのURLを指定してマーケット・プ...
・Discoverメニューからマーケット・プレイスに追加したプラ...
・意図した指示を出してプラグインを動作確認する。
> please write a concise project README.md
- Let me read the current README and check project state...
- Read 4 files (ctrl+o to expand)
- The project is still early no Dockerfile or scripts ye...
- Write (README.md)
Done. The README covers the project vision, features, ar...
--特定のタスクをメインのClaude Codeから切り離して並行処理...
|メリット|デメリット|h
|並行処理と自己修正：複数のサブ・エージェントが協調し、相...
|コンテキストの節約：メインのClaude Codeのコンテキスト（...
|タスクの特化：1つのタスクに特化させることで、プロンプト...
--次回の予告
---翌日は、さらに重要なテーマである「サンドボックス化（Sa...
---今回触れられなかった「MCPサーバー」や「LSPとの組み合わ...
---現在全体の「73%」完了、ここからさらに実践的で難易度の...
***Day 2 [#w85c3fa2]
72-77
+Claude Codeのサンドボックス化とクラウド実行の徹底解説
--前日の復習：Claude Codeのプロ機能（Slashコマンド、サブ...
---フォーカスの絞り込み：Slashコマンド: 現在はほぼ「スキ...
---フック/プラグイン：特定の課題解決やチーム共有には便利...
---今後の中心：自身やチームのレポジトリで活用できる「スキ...
---汎用的なスキル：これらの機能（特にスキル）はAnthropic...
---プラグインの高度な構成ファイル：~
・.mcp.json: プラグインに含まれる[[MCP（Model Context Pro...
・.lsp.json: [[LSP（Language Server Protocol）>https://te...
--サブ・エージェントのメリット・デメリット
---メリット: 処理をサブエージェントに委譲することで、メイ...
---デメリット：コンテキストの分離特性に起因。詳細な使い分...
--本日の主要テーマ：サンドボックス化（Sandboxing）~
セキュリティ面の強化だけでなく、開発の生産性を劇的に向上...
---リソースの隔離（リングフェンス）：ファイルの読み書きを...
---「YOLO（一か八か）」な生産性の実現：安全な環境が担保さ...
---「承認疲れ（Approval Fatigue）」の解消：~
・サンドボックス化されていない環境では、AIの行動に対して...
・しかし、人間は慣れてくると内容を確認せずにボタンを連打...
+Claude Code on the Webでのリモート実行＆クラウド・サンド...
主流だったコンテナ環境構築から一歩進んだ「コーディング・...
（開発のスタイルがコーディング・エージェントを「自分のPC...
--ローカル・ネイティブ・サンドボックス（Local Native Sand...
---特徴：自分のパソコン（ローカル）上で動かす軽量なサンド...
---使い方：/sandboxコマンドで起動。環境内でのAIの操作が自...
---注意点：MacやLinuxユーザーは簡単に使えるが、Windowsユ...
--マネージド・クラウド・サンドボックス（Claude Code on th...
---特徴：Anthropic社側のクラウド上でClaude Codeを立ち上げ...
---主な機能・使い方：~
・手軽な呼び出し: 命令の先頭に &（アンパサンド）を付ける...
・GitHub連携：GitHubの「Claude GitHub App」を導入すると、...
・テレポートとタスク管理：/tasks コマンドで実行中の複数タ...
--3rd party による外部サンドボックス（3rd party Claude Sa...
---特徴：Anthropic社公式ではなく、別の企業が提供する「AI...
---具体例：Fly.ioのチームが手がける Sprites.dev というサ...
---メリット：Claude Codeだけでなく、ユーザーが選んだあら...
+Claude CodeサンドボックスとGitHub連携のセットアップ~
Claude Codeにおける2つの主要なサンドボックス設定手順（①ロ...
--ローカルでのサンドボックスモードの設定
---概要：.claude 設定内の不要なファイルを整理した状態から...
---設定方法：Claude Code 内で /sandbox コマンドを実行し、...
Sandbox: Mode Overrides Config
（Mode）Configure Mode:
> 1. Sandbox BashTool, with auto-allow
2. Sandbox BashTool, with regular permissions
3. No Sandbox (current)
（Overrides）Configure Overrides:
> 1. Allow unsandboxed fallback (current)
2. Strict sandbox mode
- Allow unsandboxed fallback: When a command fails due t...
- Strict sandbox mode: All bash commands invoked by the ...
Learn more: code.claude.com/docs/en/sandboxing#configure...
（Config）
Excluded Commands:
None
Filesystem Write Restrictions:
- Allowed: /dev/stdout, /dev/stderr, /dev/null, /dev/tty...
- Denied within allowed: /Users/ed/.claude/settings.json...
---メリット：Claude が承認なしで自由に Bash スクリプトの...
---実演：市場データAPIの調査やシミュレータのドキュメント...
> Please carry out comprehensive research and write 3 do...
write documentation with code examples in MASSIVE_API.md...
document this in MARKET_INTERFACE.md. Finally, document ...
---注意点：詳細な設定やセキュリティに関する注意点は公式ド...
--Web版 Claude（GitHub連携）のセットアップ
---概要：ブラウザ（claude.ai/code）および GitHub リポジト...
---手順：~
・https://claude.ai/code （Web）にアクセスし、LLMにやりた...
・GitHub側の連携画面が表示されるので認可を行い、Claude側...
・Claude CLIを起動し「/install-github-app」と入力して表示...
・Claude CLIを再起動し「/install-github-app」と入力してリ...
・問題なければ、CLI側をEnterで進め「インストールするGitHu...
・「Create a long-lived token with your Claude subss@ipti...
・「Claude Codeは、あなたのClaudeチャット・アカウントに接...
・PRをマージしてpullすると、.github/workflowsフォルダに「...
・Claude CLIを再起動し「/install-github-app」と入力すると...
・「> hey what's 2 + 2」を「& hey what's 2 + 2」や「claud...
・また、https://claude.ai/code （Web）のChatウィンドウか...
Please read all the documents in the planning directory....
---結果：リポジトリ内に .github/workflows フォルダと設定...
+Claude Codeをリモートで実行する5つの方法：「&」「--remot...
--① ローカルセッション内でのコマンド実行
---方法：ローカルで起動しているClaude Codeのセッション内...
>& hey what's 2 + 2
---特徴：~
・コマンドはローカルではなくクラウド上のサンドボックス環...
・これまでの会話の文脈（フルコンテキスト）がすべてクラウ...
--② ターミナルからの直接実行
---方法：ターミナル（コマンドライン）で claude --remote [...
> claude -remote "what is 2+2"
---特徴：1と同様にクラウド側で処理が実行される。
--③ Webブラウザ（https://claude.ai/code）の利用
---方法：ブラウザで専用UIを開き、クラウド環境をセットアッ...
Please read all the documents in the planning directory....
---特徴：ローカルマシンのリソースを一切消費しない。~
・「設計ドキュメントの作成」を指示し、10分ほどで1490行の...
・GitHubへpushされるのでPRしてmergeする。※プレビュー版の...
--④ モバイルアプリの利用
---方法：スマホのClaude公式アプリから「Code」ナビゲーショ...
---特徴：Webブラウザ版と全く同じI/F。出先などPCがない環境...
--⑤ GitHub Issueとの連携（Claude Bot）
---方法：自身のGitHubリポジトリで新しいIssue（課題）を作...
Title：Build complete Market Data backend #3
Content：@claude
Read all the documents in the planning directory, then b...
1. The Massive API interface
2. The unified market data interface
3. The market data simulator
Include full unit tests
---特徴：~
・投稿すると自動的にバックエンドでClaude Codeのインスタン...
・Jiraのチケットを割り振るように、複数のIssueを作ってClau...
--全体のまとめ
---Claude Codeをクラウドで実行することにより、ローカルマ...
---特にGitHub Issueとの連携（5つ目の方法）は、タスク管理...
+3rd party クラウド・サンドボックス：Sprites.devでのClaud...
--GitHub連携による自動プルリクエスト
---AIエージェントにタスクを指示したところ、わずか数分で90...
---AIが作成したブランチからGitHub上でプルリクエスト（PR）...
---この手法を使えば、開発者はGitHubのIssue（課題）を次々...
--リモート実行における3つのアプローチ
講義の中でカバーしている「AIコードの実行環境」に関する3つ...
---ネイティブのサンドボックス環境（/sandbox）を使用し、承...
---Web上のサンドボックスでClaudeを実行する5つの手法（モバ...
---3rd partyのクラウド・サンドボックスを利用する手法（オ...
--Sprites.devの導入と実践（≒ この辺 https://docs.sprites....
---概要：fly.ioが開発して話題の「Sprites.dev」を紹介。こ...
---登録：https://sprites.dev/ からクレカ登録（無料枠あり...
---起動：sprite create <名前> コマンドを叩くと、わずか0.6...
> sprite create finally-worker
---実演：
・立ち上がった環境でGitHubリポジトリをクローン
> sprite@sprite:~# git clone https/github.com/ed-donner/...
> sprite@sprite:~# cd finally
> sprite@sprite:~/finally# ls
backend CLAUDE.md LICENSE planning README.md
・プリインストールされている「Claude Code」を起動。
> sprite@sprite:~/finally# claude
・認証して、立ち上がった環境で「Claude Code」を実行。
Claude Code can be used with your Claude subscription or...
Select login method:
> 1. Claude account with subscription Pro, Max, Team, or...
2. Anthropic Console account API usa af billing
3. 3rd-party platform Amazon Bedrock, Microsoft Foundr...
---利点：ローカルPCを一切汚さず、YOLOの重いタスクをサンド...
> Please read all the documentation in the planning fold...
+クラウド・サンドボックス総まとめ：Sprites.devとGitHub PR...
--Claude Codeを用いたGitHub連携のワークフロー
---トラブルと解決：Claude CodeにGitHubへの変更プッシュを...
ARGUMENTS: I need to push a git branch to GitHub but gh ...
...
Once you provide a GitHub token or authenticate via gh a...
> OK. I've logged you in to github please try now
---成果：Claudeは自動的にbranchを作成してGitHubへpush、PR...
> OK I've merged please switch to main and do a pull. Th...
--リモート・サンドボックス（sprites.dev）での自律的な開発
---効率的なデバッグ：開発環境を sprites.dev（Fly.io提供の...
---安全性と生産性の両立：完全なサンドボックス化でローカル...
--本日紹介された3つのサンドボックス手法のまとめ
---内蔵サンドボックス：ローカルPC上で動作する、Dockerコン...
---Anthropicの遠隔実行環境：Anthropicが提供するリモート環...
---3rd partyのクラウド・サンドボックス（sprites.dev）：VS...
--次回（明日以降）の予告
---コースの80%が終了。
---次回（明日）：多くの開発者が懸念する「大規模なコードベ...
---次々回（明後日）：現在トレンドとなっている「スウォーム...
***Day 3 [#me0cab02]
78-82
+大規模コードベースでのClaude Code、Codex、Sprites.dev活用~
大規模なコードベース、大開発チーム、そして「Claude Code」...
--これまでの機能の振り返り（Pro機能・サンドボックス）
---SlashコマンドとSkills：Claude Codeでのコマンド実行や機...
---マルチ/サブ・エージェント：~
・（単純な）マルチ・エージェント：複数のClaudeを同時に走...
・サブ・エージェント：特定のタスク（大量のファイルを探索...
---プラグイン：Skillsやサブエージェントなどをパッケージ化...
---サンドボックス（セキュリティ対策）：安全にコードやシェ...
・コマンドの前に「&」を付けることで、会話コンテキストをリ...
・Sprites.dev：状態が保存され、起動が非常に速いサードパー...
--リモート環境を用いたゼロショット開発の実証デモ
---前日の講義後、リモートのSprite環境（サンドボックス）で...
---ローカル環境にその成果物を git pull して実行したところ...
>git pull
Already up to date.
---株価ティッカー、価格変更（赤と緑の色分け表示）、テキス...
>cd backend
>uv run market_data_demo.py
|FinAlly Market Data Simulator | 17.7s elapsed | 42.3s r...
|---------------------------------------- Live Prices --...
|Ticker | Price | Change | Chg % | | Sparkline|
| AAPL | $189.97 | +0.01 | +0.01% | | |
| GOOGL | $174.93 | -0.01 | -0.01% |
| MSFT | $420.17 | -0.02 | -0.00% |
| AMZN | $184.99 | -0.01 | -0.01% |
| TSLA | $249.85 | -0.05 | -0.02% |
| NVDA | $799.76 | -0.06 | -0.01% |
| META | 5500.03 | +0.01 | +0.00% |...
+大規模チームのコードベースでClaude Codeを使うためのベス...
大規模なチームや大規模なコードベースにおいて、高度なコー...
--適切なドキュメント管理（agents.md の活用）
---階層的な記述：各サブディレクトリに agents.md や cloud....
---適切なコンテキスト制御：大きな文書を直接 @ タグで読み...
--チーム内での一貫したワークフローとプラグインの導入
---プロセスの統一：GitHubでのClaudeのタグ付けや、JIRAによ...
---プラグインとスキルの活用：FeatureDev などの「プラグイ...
--テスト駆動開発（TDD）の戦略
---網羅率（カバレッジ）に固執しない：AIは網羅率を上げるた...
---意味のあるテストの要求：リファクタリングで壊れず、ロジ...
--人間の責任（レビュー文化）と「小分け」にした開発
---人間が最終責任を持つ：AIが生成する冗長で防衛的なコード...
---タスクの細分化：大規模プロジェクトにおいて「コードベー...
--推奨される練習（課題）~
大規模なOSSプロジェクトをクローンし、何が有効で何が機能し...
---ディレクトリ全体に agents.md を整備し、AIに「TODO」を...
---アンチパターン：全体の一括リファクタリングをラルフルー...
+Claude Agent SDKによるClaude Codeのプログラム的制御~
「Claude Agent SDK」を用いて、コード（Python）経由で「Cla...
--Claude Agent SDKの概要
---誤解の解消：名前は「Claude Agent SDK」だが、所謂、一般...
---本質：ターミナルから対話的に使う「Claude Code」の強力...
---旧称：以前は Claude Code SDK と呼ばれており、現在は「A...
---ユースケース：日常的ではないが、Claudeのプラグインやエ...
--デモの準備と環境構築
---VS Code上の完全に空のディレクトリから開発をスタート
---プロジェクト管理：~
・高速なPythonパッケージ管理ツール uv を使用。~
・uv init --bare で空のプロジェクトを作成。
> uv init -bare
Initialized project 'space
・使用Pythonバージョン：3.13~
> uv python pin 3.13
Pinned python-version to 3.13
---インストールした主要ライブラリ：~
・python-dotenv：APIキーなどの環境変数管理用。~
・requests：HTTPリクエスト用。~
・claude-agent-sdk：本デモの核となるSDK。
> uv add python-dotenv requests claude-agent-sdk
--実装コードのポイント (main.py)~
プログラムからClaude Codeを動かすための主要な処理は以下の...
---ファイルの作成：main.py、.env、.gitignore
---main.pyに以下を実装
import asyncio
from dotenv import load_dotenv
from claude_agent_sdk import query, ClaudeAgentOptions
load_dotenv(override=True)
PROMPT = ""
TOOLS = []
async def main():
---プロンプトの設定：
PROMPT = """
Make a vanilla HTML+JS+CSS website for a game of Space I...
"""
（現在のディレクトリに index.html を含む、素HTML/JS/CSS ...
---ツールの付与：Claudeに対し、read、write、editファイル...
TOOLS = ["Read", "Write", "Edit", "Bash", "Glob", "Grep"...
---モデルの指定：デモ用に贅沢に Claude Opus 4.6 を指定（※...
---実行ルーチン：async for message in query(...) を使い、...
async def main():
options = ClaudeAgentOptions(allowed_tools TOOLS, mode...
async for message in query(prompt=PROMPT, options=opti...
print(message)
asyncio.run(main())
--実行結果と成果物~
コードを実行すると、プログラムから呼び出されたClaudeが自...
> uv run main.py
---成果物：完全に動作する index.html。
---ゲームのクオリティ：~
・効果音（サウンド）が実装されている。~
・キーボードの矢印キーで自機を操作できる。~
・スコア機能や、最上部を移動するUFO（インベーダー）も再現...
・チープなものではなく、カラーや挙動も含めて非常に完成度...
---考察：~
・トレーニングデータ（学習データ）に類似のコードが含まれ...
・Pythonスクリプトを1度実行しただけでここまでのゲームが自...
+Claude Cowork：日常業務向けエージェントAIデモ~
Anthropic社の強力なエージェント機能を、日常的な事務・ビジ...
--主な特徴と機能
---対象ユーザー：エンジニアだけでなく、一般のビジネスパー...
---利用方法：https://claude.com/product/cowork から「Clau...
---出来ること：画面のスクリーンショットの整理、週のスケジ...
--デモの内容（経費精算書の自動作成）
---共有：「Work in folder」から「receipts（領収書）」フォ...
---指示：「これらの領収書をレビューして、Excelファイル（e...
In the folder that I've shared with you, there are a bun...
---処理：Claude CoWorkが自動で処理を開始。PDFを画像として...
---結果：指定したフォルダ内に、綺麗にフォーマットされたEx...
--結論：エンジニアにとって非常に役立つ「Claude Code」の魔...
+OpenClaw：Telegram＆WhatsAppで使えるパーソナルAIサイドキ...
--OpenClaw（オープンクロー）の概要
---位置付け：現在非常に注目（ハイプ）されている個人向けの...
---名称の変遷：ClaudeBot（Anthropicから手紙を受け取った）...
---特徴：~
・コーディング・エージェント（Claude Codeなど）の思想を、...
・PCに直接インストールし、ローカル環境のファイル、ブラウ...
・ユーザーは主に TelegramやWhatsAppなどのチャットアプリ ...
--セキュリティとリスク
---高いリスク：PCの全権限を握るため、悪意あるプロンプト（...
---利用の前提：セキュリティ専門家からも懸念されており、導...
--インストールとセットアップ手順（デモ内容）
---手順：~
・ターミナルからワンライナー（1行のコマンド）でインストー...
・モデル認証プロバイダーの選択：デモでは OpenAI の ChatGP...
・デフォルト・モデル：Keep current (openai-codex/gpt-5.3-...
・チャネル：連携チャットツール（Telegram）の設定（BotFath...
・スキル（プラグイン）の導入（デモではnpmを選択し、音声認...
・AIの名前やキャラクター（バイブス、絵文字）を設定。
--実際の動作デモ
---指示内容：~
・Telegramを使用して指示~
・「テスラの株価を調べて、今日上がっていれば陽気な曲を、...
---AIの自律的な挙動：~
・ウェブ検索でテスラの株価が上昇したことを確認。~
・「陽気な曲」という条件から、ダイアナ・ロスの「Upside Do...
・PC上の Spotifyアプリを勝手に起動・操作 して音楽を再生し...
--本セッションのまとめと次回予告
---本日のまとめ：大規模リポジトリへのアプローチ方法を学ん...
---次回予告: 明日は「スワーム（Swarms）」やチーム開発、複...
***Day 4 [#v4c23692]
83-88
※ 前提：[[（本格的な）マルチ・エージェント>LLMエージェン...
+Claude Codeエージェントチーム：スウォームとオーケストレ...
AIエージェントの大量運用における「スウォーム（群れ・混沌...
--スウォーム（Swarms）とオーケストレーション（Orchestrati...
---段階的進化：Steve Yegge氏のチャートにおけるステージ7（...
---連続性：これらは二者択一ではなく、自由な混沌から厳密な...
--「Claude Agent Teams」とは~
複数のClaude Codeインスタンスを連携させて1つの目標を達成...
---役割分担：「チームリード（全体管理・タスク割り当て）」...
---サブ・エージェントとの違い：~
・サブ・エージェント：メインのClaudeの補助として一時的に...
・エージェント・チーム：各自が独立したフル文脈（Context W...
・サブエージェントとの比較：どちらも並列処理を可能にする...
||サブエージェント|エージェントチーム|h
|コンテキスト|独自のContextウィンドウを持ち、結果は呼び出...
|通信|結果をメイン・エージェントにのみ報告|チームメンバー...
|連携|メイン・エージェントがすべての作業を管理|自己連携機...
|最適な用途|結果のみが重要な集中型タスク|議論とコラボレー...
|トークンコスト|低：結果はメインコンテキストに要約されて...
|選択基準|迅速かつ集中して作業を行い、結果を報告してくれ...
---主なユースケース：~
・複数ソース（WikipediaやStack Overflowなど）の並行リサー...
・システムの独立したモジュールごとの並行開発。~
・開発レイヤー（フロントエンド、バックエンドなど）に応じ...
--実装の5ステップと操作方法
---設定の変更：settings.json で experimental agent teams ...
---モード選択：~
・全プラットフォーム対応の画面切り替えモード（in process...
・なお、画面分割モード（tmux）は、ターミナル画面を分割で...
---チームの起動：Claudeに対して「〇〇のためのエージェント...
---操作と制御：
・Shift + Tab で委譲モードにし、リードが勝手に作業しない...
・Shift + ↑ / ↓ で表示するエージェントを切り替え。
---終了処理：
・個別にシャットダウンを命じるか、
・全体をクリーンアップするコマンドを送る。
--実践における3つの留意点
---CLAUD.md の活用：全エージェントの文脈に読み込まれるた...
---高コストへの覚悟：トークン消費が激しいため、無料モデル...
---試行錯誤の前提：非常に実験的で予測不能な動きをすること...
+フルスタック開発のためのClaude Codeエージェントチームの...
--開発環境のクリーンアップと現状確認
---VS Code環境の確認：~
・.cloud フォルダ内のエージェント、コマンド、設定、MCPサ...
・制御不能に陥る可能性があるため、特に、サブ・エージェン...
---既存スキルの維持：唯一存在している Cerebras inference...
--プラグインのインストールとドキュメント整備
---プラグインの追加：制御不能になるサブエージェントを生成...
・front-end design：プロダクション品質のフロントエンドを...
・context7：LLMに最新のライブラリやツールのドキュメント情...
・playwright：ブラウザを起動してテストを実行できるように...
---設定の反映：プラグインを有効化するため、一度Claude cod...
---CLAUDE.md の更新：必要な時だけドキュメント（PLANNED.md...
# FinAlly Project the Finance Ally
All project documentation is in the `planning` directory.
The key document is PLAN.md included in full below; the ...
@planning/PLAN.md
--「エージェント・チーム」機能の有効化と設定
---Gitブランチの作成：いつでも戻れるように agent teams と...
---settings.json の変更：環境変数 Claude code experimenta...
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
"teammateMode": "in-process"
}
---動作確認：Claude（Opus 4.6）を起動。トークン使用量（/u...
--チームの結成とタスクの実行
---エージェント構成の指示: フロントエンド、バックエンド、...
> Create an Agent Team to complete the project as defined.
Team-members: a Front-end engineer to work on the fronte...
While all team-members should work on unit tests, there ...
Finally, a Devops engineer for the Docker container and ...
プロジェクトを規定どおりに完了させるためのエージェントチ...
チームメンバーは、フロントエンドを担当するフロントエンド...
すべてのチームメンバーは単体テストに取り組む必要がありま...
最後に、Dockerコンテナとスクリプトを担当するDevOpsエンジ...
注記：チャットのノイズが増えるのを防ぐため、コード・レビ...
---実行と進捗：~
・Shift + Tabで計画 → 実行モードに切り替え、プロンプトを...
- I'll start by exploring the current project state, the...
- Explore (Explore current project state)
- ...
- Now let me set up the task dependencies.
- Good. Now let me spawn the team members. Tasks 1 (Data...
- Task(Database Engineer agent)
- Symbioting... (7m 54s 31.8k tokens thought for 385)
- Build SQLite database layer
- Build Next.js frontend application
- Build FastAPI application and REST API endpoints blo...
- Build LLM integration with OpenRouter/Cerebras > blo...
- Build Docker container and deployment scripts blocke...
- Build Playwright E2E test suite blocked by #2, #3, #...
・データベースエンジニア（SQLite構築）とフロントエンドエ...
|Role|Agent|Task|Status|h
|Database Engineer|db-engineer|#1 SQLite database layer|I...
|Frontend Engineer|frontend-engineer|#3 Next.js frontend|...
|Backend API Engineer|(waiting)|#2 FastAPI endpoints|Bloc...
|LLM Engineer|(waiting)|#4 LLM integration|Blocked by #1,...
|DevOps Engineer|(waiting)|#5 Docker & scripts|Blocked by...
|Integration Tester|(waiting)|#6 E2E Playwright2tests|Blo...
The Database Engineer and Frontend Engineer are working ...
- Building SQLite database layer... (8m 15s 66.5k tokens...
- Build SQLite database layer (@db-engineer)
Running Add aiosqlite dependency...
- Build Next.js frontend application (@frontend-engine...
Reading 2 files......
- Build FastAPI application and REST API endpoints blo...
- Build LLM integration with OpenRouter/Cerebras block...
- Build Docker container and deployment scripts blocke...
- Build Playwright E2E test suite blocked by #2, #3, #...
---UIの操作：ターミナル上で「Shift + ↑ / ↓」を押すことで...
+マルチ・エージェント・チーム構築：Claude Opusによるライ...
AIエージェントチーム（マルチエージェントシステム）を活用...
--エージェントの協調動作と開発プロセス~
開発はチームリード（AI）の統率のもと、複数の専門エージェ...
---前半のフロー：データベースエンジニアによるSQLセットア...
---後半のフロー：その後、LLMエンジニア、フロントエンドエ...
---進捗管理：ユーザーは手動でアクセス権限（chmodなど）やD...
--テストとバグ修正~
すべての開発タスクが完了した後、最終エージェントであるイ...
---11分間に及ぶテストの結果、フロントエンドのクラッシュを...
---元のフロントエンド開発者が修正するのではなく、インテグ...
---CSSのレイヤーオーバーラップという軽微な未解決事象はあ...
--アプリケーションの動作検証（ゼロショットの成果）
---ユーザーはローカル環境（Mac用起動スクリプトを実行）で...
> scripts/start_mac.sh
---UI/UX：左側にリアルタイムで点滅するマーケットデータウ...
---AIアシスタント機能：チャットUIから「SPYをウォッチリス...
> Please add SPY to the watch list
SPY has been added to your watchlist.
Watchlist: add SPY
> please buy 1 share of V
Executed purchase of 1 share of V at market price.
Executed: BUY 1 V8 279.96
> please give me some trading advice
Your portfolio is cash-heavy (～$9k) with small position...
Consider rebalancing: sell the under-performing JPM posi...
> please do this for me
Sold your 2 shares of JPM at market price to free cash f...
Executed: SELL 2 JPM 187.57
---課題・不満点：画面内の一部の株価チャートが表示（描画）...
--クリーンアップと次のステップ
---検証後、アプリケーションを停止し、Gitを用いたソースコ...
> scripts/stop_mac.sh
> git add .
> git status
---生成されたコードに不要なモジュールや環境変数ファイル（...
> git status
---新たに作成したブランチ（agent-teams）に成果物をcommit...
> git commit -m "Agent Teams v1"
> git push origin agent-teams
> git checkout main
---この後、frontendフォルダを削除して、settings.json の変...
+GSD：仕様駆動設計とマルチ・エージェント・オーケストレー...
開発ツール（ClaudeやCloud Codeなど）における新しいオーケ...
--紹介：
---Vibe codingは評判が良くありません。欲しいものを説明す...
---GSDはそれを解決します。GSDはContextエンジニアリング・...
---対象者：欲しいものを説明し、それを正しく構築したい人。...
--概要：これまで行ってきた仕様駆動設計（SDD（Spec-Driven ...
--GSDの概要：https://github.com/gsd-build/get-shit-done →...
---Claude Code、OpenCode、Gemini CLI、Kimi CLI、Kilo、Cod...
---中心的な成果物はテキスト・Markdownベースのファイル群（...
---「"I've done SpecKit, OpenSpec and Taskmaster - this h...
--GSDの特徴
---コンテキスト管理の最適化：開発が進むにつれてContextウ...
---ドキュメント管理の自動化：固定された構造のMarkdownファ...
---マルチエージェントの最適化：プロンプトの質にこだわり、...
---高い信頼性：いわゆる「雰囲気でのコーディング（Vibe cod...
--5段階のフェーズ・ループ：
---Discuss：計画前に実装上の決定を捉える。
---Plan：リサーチ・分解し、計画が新しいContextウィンドウ...
---Execute：並列ウェーブで200K tokenのContextから計画を実...
---Verify：構築したものを確認し、完了宣言前に診断・修正す...
---Ship：PRを作成し、フェーズをアーカイブし、次のフェーズ...
--主な手順とコマンドの流れ
---環境のクリーンアップ：以前のバージョンとの混同を防ぐた...
> git checkout -b finally-gsd
---GSDのインストール：インストールは「npx」から行う（ラン...
インタラクティブにランタイム（Claude Code、OpenCode、Gemi...
> npx @opengsd/gsd-core@latest
> git add .
> git commit -m 'Start of GSD process'
---ファイル操作毎に承認のための一時停止をしないように、YO...
> claude --dangerously-skip-permissions
---プロジェクトの初期化：コードベースをマッピングするため...
> /gsd:new-project
Existing Code
I detected existing code in this directory. Would you li...
> 1. Map codebase first
Run/gsd:map-codebase to understand existing archite...
2. Skip mapping
Proceed with project initialization
3. Type something.
4. Chat about this
Use skill "gsd:map-codebase"?
Claude may use instructions, code, or files from this Sk...
Analyze codebase with parallel mapper agents to produc...
Do you want to proceed?
> 1. Yes
2. Yes, and don't ask again for gsd:map-codebase in /U...
3. No
---設定のカスタマイズ：フェアな検証を行うため、デフォルト...
> /gsd:settings
Model Research Plan Check Verifier Submit
（Model）Which model profile for agents?
> 1. Quality
Opus everywhere except verification (highest cost)
2. Balanced (Recommended)
Opus for a Manning, Sonnet for execution/verification
3. Budget
Sonnet for writing, Haiku for research/verification...
4. Type something.
5. Chat about this
（Research）Spawn Plan Researcher? (researches domain be...
> 1. Yes
Research phase goals before planning
2. No
Skip research, plan directly
3. Type something.
4. Chat about this
（Plan Check ）Spawn Plan Checker? (verifies plans befor...
> 1. Yes
Verify plans meet phase goals
2. No
Skip plan verification
3. Type something.
4. Chat about this
（Verifier）Spawn Execution Verifier? (verifies phase co...
> 1. Yes
Verify must-haves after execution
2. No
Skip postExecution verification
3. Type something.
4. Chat about this
（Submit）Review your answers
- Which model profile for agents?
→ Quality
- Spawn Plan Researcher? (researches domain before plann...
→ Yes
- Spawn Plan Checker? (verifies plans before execution)
→ Yes
- Spawn Execution Verifier? (verifies phase completion)
→ Yes
Ready to submit your answers?
> 1. Submit answers
2. Cancel
---今後のプロセス：今後は discuss（議論） → plan（計画） ...
+Claude GSDによる取引プラットフォーム構築（5時間かかった）~
AI開発エージェントツール（GSDモード）を使用してトレーディ...
--プロジェクトの開始と要件定義
---指示と明確化：ユーザーは planning/plan.md に記載された...
> please build the entire project everything as describe...
Polish level LLM default Docker Submit
（Polish level）The market data backend is done. What re...
1. Demo-ready
Looks great on screen, works for live demo, doesn't...
> 2. Production-quality
Robust error handling, responsive, polished UX thro...
3. Type something.
4. Chat about this
（LLM default）For the LLM chat the plan says Cerebras v...
1. Mock by default
Works without API key using mock responses, real LL...
> 2. Key required
Chat feature requires OPENROUTER_API_KEY, disabled/...
3. Type something.
4. Chat about this
（Docker）should I build the Dockerfile and start/stop s...
> 1. Include Docker
Full Dockerfile, docker-compose, start/stop scripts
2. App first
Build the app, add Docker later
3. Type something.
4. Chat about this
（Submit）Review your answers
- The market data backend is done. What remains is: data...
→ Production-quality
- For the LLM chat the plan says Cerebras via OpenRouter...
→ Key required
- Docker should I build the Dockerfile and start/stop sc...
→ Include Docker
Ready to submit your answers?
> 1. Submit answers
2. Cancel
---要件定義の承認：約20分後、AIはデータベース、API、フロ...
Requirements
56 v1 requirements covering database, Arts, full fronten...
> 1. Approve
Commit and proceed to roadmap
2. Adjust
I want to change some requirements
3. Type something.
4. Chat about this
--ロードマップの策定と進行
---10段階のロードマップ：AIはUI構築を後回しにし、データベ...
10 phases | 62 requirements mapped | All v1 requirements...
|#|Phase|Goal|Requirements|Success Criteria|h
|1|Database Foundation|Async SQLite with lazy init, schem...
|2|Portfolio & Trade Execution|Trade at market prices, po...
|3|Watchlist API|RUD endpoints synced with market data so...
|4|App Assembly|FastAPI lifespan, route mounting, static ...
|5|LLM Chat Integration|AI with structured outputs, auto-...
|6|Frontend Foundation|Dark terminal shell, SSE connectio...
|7|Watchlist & Price Display|Live watchlist, flash animat...
|8|Portfolio Viz & Trading|Heatmap, P&L chart, positions ...
|9|Chat Interface|Chat panel with inline action confirmat...
|10|Packaging & Testing|Docker, scripts, Playwright E2E|P...
（Roadmap）Does this roadmap structure work for you?
> 1. Approve
Commit and continue
2. Adjust phases
Tell me what to change
3. Review full file
Show raw ROADMAP.md
4. Type something.
5. Chat about this
---フェーズの実行：~
・ユーザーは議論フェーズをスキップし、ダイレクトに「フェ...
Next Up
Phase 1: Database Foundation** SQLite with lazy init, sc...
/gsd:discuss-phase 1 gather context and clarify approach
<sub>'/clear first fresh context window</sub>
Also available:
/gsd:plan-phase 1 skip discussion, plan directly
> gsd:plan-phase 1
・その後、並行処理が可能であったため「フェーズ2と3の同時...
Next Up
Phase 2: Portfolio & Trade Execution Trade at market pri...
/gsd:plan-phase 2
<sub>'/clear first fresh context window</sub>
Also available:
/gsd:plan-phase 3 Watchlist API (can run in parallel wit...
>/gsd:plan-phase 2 and 3
--ツール特性（トークン消費と速度）~
トークンとコンテキストの逼迫：
---フェーズ1の段階でContextウィンドウの消費率が8%から18%...
---「トークンを大量に消費し、動作がかなり遅い」という特性...
--5時間後の結果と最終評価
---長時間の処理：プロジェクトが100%完了するまでに、ユーザ...
---終了間際のトラブルと自律修正：プロジェクト完了をマーク...
---Claude Teamsとの比較：以前使用した「Claude Agent Teams...
---総評：非常に時間がかかり、フェーズ分けが細かすぎた反省...
+GSD vs Claude Agent Teams：UI比較と総括
2つの異なるAIツール（Claudeの「Agent Teams」と「GSD」）を...
--5時間かけて作成したUI（GSD製）の動作検証
---初期起動：ローカルのデータベースから前回のデータが正常...
---取引機能：AppleやMetaの株式購入がスムーズに反映され、...
---AIアシスタント機能：~
・Cerebras（およびLightLLM）を使用したチャット機能をテス...
・IBMをウォッチリストに追加したり、指示通りに売買を実行さ...
Hello! How can I assist you with your portfolio today?
> I'd like to add IBM to the watch List
IBM has been added to your watchlist.
+ IBM added to watchlist
> i'd like to buy 1 share of IBM and sell 5 shares of META
Executed purchase of 1 share of IBM and sale of 5 shares...
BUY 1 IBM @ $186.28 $186.28
SELL 5 META @ $500.14= $2500.78
---改善点：~
・ヒートマップの配色（色分け）が機能していない点や、チャ...
・また、コード内では当初提案した（LLM呼び出しの）Cerebras...
---Git管理：テスト・ディレクトリの node_modules が .gitig...
--2つのUIの比較（Claude Agent Teams vs GSD）
---両方のUIを画面に並べて比較レビュー。
|評価項目|① Claude Agent Teams（前半で作成）|② GSD（今回...
|開発時間|わずか30分|5時間（丸1日）|
|UIの印象|非常に洗練されており、プロフェッショナルなデザ...
|バグ・品質|ウォッチリスト外の銘柄価格を取得できないバグ...
---結論: 多少の欠陥はあるものの、わずか30分で完成した「Cl...
--総括と次回の予告
---ツールの特性：~
・Claude Agent Teams: 非常にダイナミックで素早い開発が可...
・GSD: 厳格かつ徹底的なオーケストレーションが特徴。テスト...
--現在の進捗：全行程の93%が完了。翌日の最終回（残り7%）で...
***Day 5 [#c70a4301]
89-95
+Gas Town：Claude Codeエージェントのスウォームをオーケス...
--講義の振り返り：エージェントのオーケストレーション~
前日の講義では、複数のエージェントを連携させる2つのアプロ...
---Claude agent teams（クロード・エージェント・チームズ）：
高速で多くの処理をこなせるが、結果の予測が難しく、いくつ...
---GSD：
仕様駆動型の設計。計画・実行・検証を繰り返すステップ・バ...
--新しいツールの導入：Gas Town（ガスタウン）
---本日は、Steve Yaggy氏のブログ記事（エージェント開発の8...
---これは、規律正しいGSDとは対照的に、20〜30もの多数のエ...
---Gas Townの操作は非常にカオスで難解なため、受講生にとっ...
---AIの高度なオーケストレーションの可能性を体感してもらう...
--Gas Townの基本用語（独自用語）
---Crew（クルー）：使い捨てではない持続型のワーカー（人間...
---Mayor（メイヤー/市長）：ユーザーと対話する全体をコーデ...
---Beads（ビーズ）：システムの基盤となるインフラ。Gitのイ...
---Convoy（コンボイ）：1つのPolcatに割り当てられるタスク...
---Polecats（ポールキャット）：Mayorから派遣される使い捨...
---Refinery（リファイナリ）：各ワーカーの成果物をマージ（...
---Witness（ウィットネス）：Rigごとに存在し、Rig内のPolec...
---Rig（リグ）：プロジェクト固有のGitリポジトリ。各Rigは...
---Deacon（ディーコン）：町（Rigを束ねる）レベルのパトロ...
--セットアップとデモの開始~
Gas Townのセットアップは、Macなら brew install gastown、W...
---gt（Gas Townのコマンド）を初期化し、Gitを使用する設定...
---gt rig add Fin [GitHubのURL] で「Fin」という新しいプロ...
---gt crew add Ed --rig Fin で、Finリグの中に「Ed」という...
---作成されたディレクトリ（Fin/crew/Ed）に移動する。
---gt mayor attach コマンドを実行し、司令塔となるClaude C...
+Gas TownのParallel Polecats：Claude Codeエージェントがカ...
--自然言語による指示（spec.md に記載された仕様）をもとに...
--開発は段階的（フェーズ制）に進められ、スピーカーは「流...
--Rust、Chrome、Nitro、Guzzle、Shiny、Furyなど最大8つのワ...
--開発のプロセスと並行処理
---フェーズ1：10個のイシュー（Beads）が発行され、基礎的な...
---フェーズ2：フェーズ1の完了に伴いロックが解除され、6つ...
---フロントエンド、バックエンド（ポートフォリオ、LLMチャ...
--運用・管理とトラブルシューティング
---画面の確認：ツール内では tmux が裏で動いており、Ctrl+B...
---エラー対応：途中で「Deconcessionが維持できない」といっ...
--開発の完了と評価
---マージ・コンフリクトの解消：多数のワーカーが同時に同じ...
---結果：最終的にすべてのタスクのコードがmainブランチ（fi...
--結論（他の手法との比較）
---昨日行った「GSD」という開発手法（一歩ずつ慎重に、トリ...
---今回の「Gas Town」は「カオスだが破壊的で、すべてのタス...
---AIが自律的にコンフリクトを解決しながら完全にゼロから仕...
+Gas Town vs Claude Agent Teams vs GSD：マルチ・エージェ...
--Gas Townによるアプリケーション構築と検証
---ゼロからの構築：過去のビルドとは異なり、既存のデータ基...
---トラブルと自己修復：最初の実行ではWebページが表示され...
---内部プロセス：Poll cats、Refinery、Witnessなどが動作し...
---動作確認：ポート「8002」で起動に成功。ヒートマップやチ...
--3つのエージェントパターンの比較~
これまでに検証した3つの手法を「統制されたもの」から「混沌...
|パターン名|特徴|構築時間|評価|h
|GSD (Get Done)|設計書駆動。計画・レビュー・実行・検証・...
|Claude Agent Teams|Claude Codeに組み込まれた実験的機能。...
|Gas Town|プリセットされた構造で大量の並列処理を行う。今...
--Codex Subagentsのデモ（予告）
---別のコーディングエージェントである「Codex」の実験的機...
---リモート環境（fly.io上のSprite）へ接続し、YOLOモード（...
---結果：これまでの実験の中で最速の約15分でビルドが完了。...
+Codexの勝利：ライブ市場データ付き最終トレーダー用ワーク...
--各AIエージェントの成果比較と「Codex」の勝利~
過去のプロトタイプ：5時間かけて作成した「GSD」、デザイン...
---Codex 5.3の台頭：わずか15分の開発時間でありながら、洗...
---リアルタイムデータの統合：Polygon APIを用いた本物の市...
--複数AIエージェントによる強力な開発体制（マルチエージェ...
---tmuxによる4画面運用：クラウド環境でtmuxを使用し、4つの...
---人間の役割：コードを一切書かず、指示出しと進捗管理に専...
--AI開発における生産性の現実
---生産性の波：開発初期は「10倍の速度（10x）」に感じられ...
---マインドセット：足止めを食らったとしても、最終的には自...
--最終成果物：『Finally Trader Workstation』~
数時間のエージェント間連携によって完成した、現代的なBloom...
---主な機能：60銘柄のセクター別ウォッチリスト、リアルタイ...
---デザイン：Claudeが追加したワンクリックでの「ライトモー...
---総評：従来であれば1〜2ヶ月のハードな開発期間と多額の費...
+最終デプロイ、コース総括＆コーディング・エージェントのベ...
プロジェクトの性質に応じたツールの使い分け、コンテキスト...
--実践と成果
---15分での高速デプロイ：Codexとの対話を通じてスクリプト...
---おすすめのツール：開発者のお気に入りは「Cloud Agent Te...
--プロジェクトの性質に応じた戦略の使い分け~
プロジェクトの成熟度やリスク許容度に応じて、アプローチを...
---ミッションクリティカル / 大規模コード / 最先端技術（上...
・仕様駆動設計（SDD）: GSD（Get Shit Done）のような規律あ...
・ドキュメント重視: 多くのMarkdownファイルを管理し、イン...
・マインドセット: 「Trust but verify（信頼せよ、されど確...
---MVP / 新規構築 / ボイラープレート（リスク許容度・大）~
・YOLOモード: サンドボックス（Sprite.dev等）やWeb版Claude...
・ラフ・ループ（Ralph Loops）＆マルチエージェント: 自律的...
--AI時代の必須アクション＆マインドセット
---実験者としてのマインドセットを持つ：AI開発に「唯一の正...
---コンテキスト管理の徹底：AIのコンテキストが肥大化・圧縮...
---コードの品質（所有権）は自分が握る：AIに無駄なコードや...
--総括（アンドレイ・カーパシー氏の言葉を引用して）
---AIによってプログラマーの職業自体が再構築（リファクタリ...
---変化が激しく困惑する状況だからこそ、プラグインやスキル...
+コース総復習：Vibe Codingからエージェントエンジニアへ
--講座の振り返りとステップアップ~
3週間にわたる講座を通じて、受講生は計6つのプロジェクト（...
---第1週（Vibe Coding / 楽しさと利益）~
各種IDE（Cursor, Copilot, Codex, Antigravityなど）やプラ...
初のYOLO体験、コマーシャルMVPの作成、FPSやスペースインベ...
---第2週（Vibe Engineering / プロフェッショナル）~
・Claw Code、OpenCode、AMPの活用、Slashコマンドやループ処...
・JiraワークフローからGit push、リーガルSaaSプラットフォ...
---第3週（Agentic Engineering / 最終到達点）~
・マルチ/サブ・エージェント、フック、サンドボックス（Spri...
・オーケストレーター（GSD、Clawed Agent Teams、Gas Town）...
--講師からのメッセージと今後のアクション
---成果の共有と繋がり：LinkedInなどのSNSで修了証や学んだ...
---最も重要なこと（構築し続けること）：提供した知識（Andr...
+ボーナス講義 - あなた専用の限定リンク集
--技術経験の有無を問わず、幅広い層
---AIビルダー：n8nでエージェント、音声エージェント、自動...
コードを一行も書かずに、ビジネス向けのエージェントと音声...
---AIコーダー：クロードコードとエージェントコーディングコ...
Claude Codeのようなコーディングエージェントを使って、驚異...
---AIリーダー：リーダーと創業者のための生成型AIとエージェ...
スタートアップ企業からフォーチュン500企業まで、AIを活用し...
--技術者または技術者を目指す方
---AIエンジニア コアトラック：LLMエンジニアリング、RAG、Q...
実世界のビジネス課題を解決するために、LLMを選択、適用、最...
---AIエンジニア エージェントトラック：エージェントとMCP完...
コアトラックと同様ですが、自律型AIエージェントを使用しま...
--既に技術者であるか、他のコースを修了している方
---AIエンジニア プロダクショントラック：LLMとエージェント...
クラウド上でLLMとエージェントを大規模に展開し、回復力、可...
*詳細 [#if128223]
手順をメモ
**様々なツールのYOLOを試す [#r43166d1]
VS Code（GitHub Copilot、OpenAI Codex）、Cursor、Antigrav...
-Cursor（、Antigravity IDE）はIDEと言われているが、実体は...
-一方で、GitHub Copilot、OpenAI Codexは、VS Code拡張と言...
--GitHub Copilotは企業向け導入が多いこともあり、YOLO的な...
-エディタ拡張系の使用感は
--どれも同じで、暗黙の業界標準がある模様（コレから外れる...
--AGENTS.mdが業界標準になりつつあるのは良い。ただ設定イン...
-CLI系の使用感は...
--GUIと大差無しだが、コマンド指示ができるので、より細かな...
--[[そう言えば、GitHub CopilotにもSlashコマンドってあった...
--ただ、アレは、CLIが実行されるのではなく、Copilot Chat ...
--...よくよく考えると、Claude Code の Slashコマンドも、イ...
-安全モード・YOLOモード
--「抽象的な指示を実行させる場合」
---安全モードは手間なダケな（価値の作り込みや、高リスク問...
---ずーっと、意味のないプロンプト・フローのログを読んで、...
--「段階的に指示を実行させる場合」
---完了までの時間も短縮されるので、安全モードの手間は感じ...
---都度確認による手間も、やり直しが減るので全体として時間...
---また、承認の度、以降の再承認が不要になるモノが積み上が...
-その他、思った事。
--Nodeのサーバプロセスが残留して他をブロックすることがあ...
--一応、プロンプト出力自体が進捗には成っているが、全体計...
--コチラのアクション（承認とか起動とか）がボタン化される...
***Cursor [#f79ec290]
-紹介ページ（https://github.com/daisukenishino2）のWebサ...
--webフォルダを作成し、ソコに、紹介ページを印刷してPDF化...
--CursorのワークスペースをwebフォルダにしてAGENTS.md 無し...
Please build me a Professional Website running locally. ...
--計画中のチャットで、PDFが読み込めずURLを直接渡した。ま...
--We're experiencing high demand for the selected model r...
-Kanbanアプリ（https://github.com/ed-donner/kanban）
README.md、AGENTS.mdを確認しつつ、Gitクローンして、Window...
--WindowsのCursorで「Ctrl + Shift + J」→「agents」→「auto...
--作業スペースを広く確保するためエージェント画面を左に広...
--デフォルトで読み込まれる設定ファイル AGENTS.md を基に、...
--生成された計画書のレビューをスキップし「build」ボタンを...
--ビルド完了後、アプリ（Next.jsベース）が自動起動し、ロー...
--引き続きプロンプトに「フィードバック」（任意、以下に例...
概ね問題なく動作していますが、Next.jsでエラーが1つ発生し...
it's mostly working nicely, but NextJS is showing that t...
#ref(1.png,left,nowrap,1,60%)
>※ ブラウザ翻訳で日本語になっているが、元々は英語表記。
-前述の、「紹介ページのWebサイト」に「経歴について回答で...
--webフォルダに「OPENROUTER_API_KEY」を記載した.envと、.e...
--CursorのワークスペースをwebフォルダにしてAGENTS.md 無し...
素晴らしいですね。では、私のキャリアに関する質問に答えて...
That's great. Please now add the ability to have an Al c...
--実際に使用するモデル名は、https://openrouter.ai/models ...
--計画の立案が終わったところで「Build」を実行し、出来上が...
***VS Code + GitHub Copilot [#fcd5be3e]
-[[GitHub Copilot と VS Code の導入>GitHub#x1616130]]を参...
-プロジェクトを準備（既存の Kanban ディレクトリの名前を C...
-ショートカットキー（Mac：Command + Shift + I / PC：Ctrl ...
-作業スペースを広く確保するためエージェント画面を左に広げ...
-実行プランが生成された趣旨の出力があり、「Planから続行」...
-「次に実行するコマンド（ローカル端末で）」（cd frontend ...
-「npm install」でエラーが出たのでエラー出力をプロンプト...
-アプリ（Next.jsベース）が起動し、ローカルサーバー（http:...
-引き続きプロンプトに「フィードバック」（任意、以下に例を...
--カード削除機能以外はすべて正常に動作しているようです。
everything seems to be working well, except the delete c...
--それでは解決しません。まず問題を再現し、再現できたこと...
That didn't fix it. Please first reproduce the problem, ...
#ref(2.png,left,nowrap,2,60%)
***VS Code + OpenAI Codex [#nbe9f27a]
-VS Code拡張（Ctrl + Shift + X）から「Codex – OpenAI’s co...
-プロジェクトを準備（既存の Kanban ディレクトリの名前を C...
-ショートカットキー（Mac：Command + Shift + I / PC：Ctrl ...
-「Agentフルアクセス」（YOLOモード）、「GPT-5.5」、「推論...
-（実行前にサンドボックスの設定を要求されたので許可する。...
-（[[Codex Windows版入門 — ネイティブサンドボックスで安全...
-カナリ長時間考え、出来上がった結果は過去一良い。ChatGPT...
#ref(3.png,left,nowrap,3,60%)
***Antigravity IDE [#gae3dcbc]
-プロジェクトを準備（既存の Kanban ディレクトリの名前を C...
-AntigravityではなくAntigravity IDEを既定値でインストール...
-Antigravity - Settingsから：「Lintエラーの自動修正機能（...
-Antigravity IDEは、標準になりつつあるAGENTS.mdを使用しな...
-モデル推論を「Gemini 3.5 Flash (High)」に設定し「Please ...
-出来上がった結果、色使いが若干独特（笑）引き続きプロンプ...
#ref(4.png,left,nowrap,4,60%)
***Claude Code [#d3a40a57]
-プロジェクトを準備（https://github.com/ed-donner/pmをGit...
-claude コマンドを入力して Claude Code CLI を起動、初めて...
-その後、YOLOモードにするには、一旦 claude を抜けて「clau...
-Tabキーで、「Plan（計画）モード」から「Build（構築）モー...
please improve the UI of this project, particularly maki...
**10段階計画 [#g55c7ab4]
***VS Code + GitHub Copilot [#d3b15258]
1週、5日目の内容
**... [#f570cf06]
***... [#hfe941aa]
*参考 [#rbad62ee]
-https://www.udemy.com/course/ai-coder-from-vibe-coder-to...
-https://edwarddonner.com/faq/
-AI Coder：Vibe Coder to Agentic Engineer – RESOURCES~
https://edwarddonner.com/2026/02/17/ai-coder-vibe-coder-t...
**コード [#h84c1018]
github.com/ed-donner
-kanban（kanban MVPの雛形）~
https://github.com/ed-donner/kanban
-pm（kanban MVPを製品化する...的な）~
https://github.com/ed-donner/pm
-prelegal（PreLegalプロジェクトのJiraチケットをClaude Cod...
https://github.com/ed-donner/prelegal
-finally（第三週の内容に従いをClaude Codeで処理した結果）~
https://github.com/ed-donner/finally
**スライド [#y2bb6fbd]
https://drive.google.com/drive/folders/1vvp15mK3ZXDfY8HE4...
-Al Coder Week 1
-Al Coder Week 2
-Al Coder Week 3
**その他 [#x5433744]
***プロダクト関連 [#h49b5065]
-LLM関連
--LLM利用
---Ollama~
https://ollama.com/
---Free Models Router - API Pricing & Providers | OpenRou...
https://openrouter.ai/openrouter/free
--LLMコーディング
---Cursor：The best coding agent~
https://cursor.com/ja
---Visual Studio Code - The open source AI code editor | ...
https://code.visualstudio.com/
---GitHub Copilot · 個々の方法に対応できるよう構築されたA...
https://github.com/features/copilot/ai-code-editor?locale...
---Cursor Agent - Turn your ideas into code（人間が主導し...
https://cursor.com/ja/agents
---Codex | OpenAI の AI コーディングパートナー | OpenAI~
https://openai.com/ja-JP/codex/
---Google Antigravity（自律的に計画・実行・検証を行う次世...
https://antigravity.google/
---Amp（Ampは、最先端のコーディングエージェント）~
https://ampcode.com/
---OpenCode | オープンソースのAIコーディングエージェント~
https://opencode.ai/
---Codex CLI~
https://developers.openai.com/codex/cli/
---Claude Code~
・https://claude.ai/code~
・https://code.claude.com/docs/en/sub-agents
---（生成コードを動かす）サンドボックス~
https://sprites.dev/
---GSDとは「Get Shit Done」（またはGet Stuff Done）~
AI（特にClaude）を使った開発を効率化するためのOSSのフレー...
https://github.com/gsd-build/get-shit-done
--その他LLMエージェント関連
---MCP~
・https://glama.ai~
・https://mcp.so~
・https://smithery.ai~
・https://www.skills.sh/
---エージェントSDK~
・https://platform.claude.com/docs/en/agent-sdk/overview~
・https://code.claude.com/docs/en/agent-teams
---ローカルで動く、LLMエージェントのチャットUI~
https://openclaw.ai/
---LLMエージェントによるデスクトップ操作~
https://claude.com/product/cowork
-その他
--Git - Install~
https://git-scm.com/install/
--Node.js — Download Node.js®~
https://nodejs.org/en/download
--Get Docker | Docker Docs~
https://docs.docker.com/get-started/get-docker/
--Jira | Project Management for the AI Era | Atlassian~
https://www.atlassian.com/software/jira
-参考
--Making Claude Code Free and Fast：Hooking up to Qwen & ...
（Claude Codeを無料かつ高速に動作させる方法：Claude Code ...
https://www.youtube.com/watch?v=FYXBYq3Y9YE
***論文関係 [#p56eac60]
-How AI assistance impacts the formation of coding skills~
AI支援がコーディングスキルの形成に及ぼす影響 \ Anthropic~
https://www.anthropic.com/research/AI-assistance-coding-s...
-LLM/"AI" Policies | Jellyfin（Jellyfin LLM/「AI」政策）~
https://jellyfin.org/docs/general/contributing/llm-polici...
-Vibe engineering（バイブ・エンジニアリング）~
https://simonwillison.net/2025/Oct/7/vibe-engineering/
ページ名:
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
