AI書斎

AI書房

本でAIを読む

金京鎮弁護士のAI・法律・産業・歴史・政治・文化をテーマにしたオンライン書籍を収録しています。各書きは目次・序文・章・エピローグで構成され、連続読書が可能です。

EU人工知能法 解説書 cover

目次

EU人工知能法 解説書

金炅鎭 弁護士

韓国企業のための実務対応ガイド

2026年8月2日から、板橋(パンギョ)のあるゲーム会社のチャットボットや、釜山のある医療機器の読影ソフトウェアは、欧州に事務所が一つもなくても、欧州連合人工知能法第50条の規律を受け始めます。本書は条文の要約ではなく、執行機関の視点から、域外適用、透明性義務、汎用AIモデル、高リスクシステム、そして韓国人工知能基本法と重なる二重規制を読み解きます。ソウルに本社を置く企業が、何を、いつ、どのように準備すべきかを実務の現場から説明する一冊です。

中国AIの父たち cover

目次

中国AIの父たち

金京鎮弁護士

中国AIを動かした十人の評伝

本書は、李開復、李彦宏、唐傑、梁文鋒、楊植麟、閻俊傑、王小川、周靖人、姚順雨、呉永輝の歩みを通じて、中国AIを形づくった研究室、企業、モデル、政策環境をたどる人物評伝です。

中国政府のAI規制 cover

目次

中国政府のAI規制

金京鎮弁護士

中国語原文、翻訳、用語、公布機関、施行日、行政解釈、司法資料

中国のAI関連法律、行政法規、軍事法規、部門規章、政策文書、国家標準を効力の順に並べました。各項目には中国語原文、日本語訳または解説、法令用語、公布機関、施行日、行政解釈、司法資料を入れています。

中国の病院にAIはどこまで入ったのか cover

目次

中国の病院にAIはどこまで入ったのか

金京鎮弁護士

診察室、画像読影室、病院事務室で進む静かな転換

本書は、中国の病院に人工知能が入っていく過程を、中国語・英語資料と中国の規定原文をもとに追った一冊です。国家政策、医療大規模モデル、臨床意思決定支援、画像読影、病院情報部門、中医学、AIネイティブ病院、患者体験、ハルシネーションと責任、規制と費用を扱います。最後の章には、中国の主要指針と衛生健康業界84件のAI応用シナリオの原文、翻訳、要約を収めました。

アンドリュー・ング伝 cover

目次

アンドリュー・ング伝

金京鎮弁護士

AI教育と大衆化の中心人物

本書は、ロンドン、香港、シンガポール、カーネギーメロン、MIT、バークレー、スタンフォードから、Google Brain、Coursera、Baidu、DeepLearning.AI、Landing AI、AI Fund、Amazonまで、アンドリュー・ングの歩みをたどります。研究、教育、起業、そしてAIを現実の現場で使う姿勢を軸にした伝記です。

中国共産党中央軍事委員会科学技術委員会 cover

目次

中国共産党中央軍事委員会科学技術委員会

金京鎮弁護士

STC、軍民融合、中国軍事技術革新の内部地図

中央軍事委員会科学技術委員会、装備発展部、軍民融合、智能化戦争、新興技術競争、そして中国の軍事イノベーション制度の限界を追う日本語AI書斎版です。

中国共産党党校 cover

目次

中国共産党党校

金京鎮弁護士

権力はどこで育てられるのか

瑞金と延安の戦時幹部学校から中央党校、国家行政学院、省、市、県の党校、中青年幹部訓練班、蔡奇体制、ニエレレ指導者学校までをたどり、中国共産党が人を選び、思想を訓練する仕組みを読む本です。

中国人民解放軍 cover

目次

中国人民解放軍

金京鎮弁護士

組織、現代化、戦争準備の実際

党国家体制と中央軍事委員会、2015年改革、粛清、智能化戦争、宇宙、サイバー、電子戦、台湾海峡、南シナ海、朝鮮半島への波及までを追い、中国人民解放軍の力と弱点を同時に読む本です。

中国のAI先導企業と政府機構 cover

目次

中国のAI先導企業と政府機構

金京鎮弁護士

政策、企業、データ、ハードウェアがかみ合う知能経済の現場

2017年の次世代AI計画からAI+、第15次五カ年計画まで続く中国の政策の流れを追います。国務院、国家発展改革委員会、国家インターネット情報弁公室、工業情報化部、国家標準化管理委員会の役割、DeepSeekとAIタイガーズ、アリババ、テンセント、百度、ByteDance、iFLYTEK、Huawei Ascend、東数西算、製造、教育、消費、ヒューマノイドまでを一冊にまとめました。

ウクライナ・ドローン戦争の主役、ミハイロ・フェドロフ cover

目次

ウクライナ・ドローン戦争の主役、ミハイロ・フェドロフ

キム・ギョンジン

スマートフォンの中の国家からドローン戦争の国防省へ

Diia、IT Army、Starlink、UNITED24、Brave1、無人システム軍、ドローン調達、戦場データをたどりながら、ミハイロ・フェドロフが戦時ウクライナで技術と国家権力をどう結びつけたのかを読む本です。

DARPA、米国の国防科学研究所 cover

目次

DARPA、米国の国防科学研究所

金景珍(キム・ギョンジン)

本書は、DARPAの2026年の組織改編、予算の流れ、AIxCC、AI Forge、RACER、LongShot、量子コンピューティング、宇宙ロボットサービス、戦場医療、戦略物資プログラムを公式資料に沿って読みます。

スパイダーウェブ cover

目次

スパイダーウェブ

金景珍(キム・ギョンジン)

戦争の構図を変えたウクライナのドローン革命

2025年6月1日のスパイダーウェブ作戦を軸に、ウクライナのドローンがロシア本土深部へ届き、軍、情報、安保秩序を書き換えた過程を追います。

2026 米中衝突の地図 cover

目次

2026 米中衝突の地図

金景珍(キム・ギョンジン)

釜山で結び、北京で解けなかった一年

関税、半導体、レアアース、台湾、海上交通路、そして米中の間に立つ韓国の選択を描きます。

2026年 中国権力地図 cover

目次

2026年 中国権力地図

金景珍(キム・ギョンジン)

一人体制の完成、そして空いた次の席

習近平体制、軍部粛清、閉ざされた後継の道、経済と安全保障の板挟みを読む一冊です。

矛盾の設計者 cover

目次

矛盾の設計者

金景珍(キム・ギョンジン)

ピーター・ティール、競争を嫌った男が築いた帝国

南アフリカでの幼少期からPayPal、Facebook、Palantir、政治、そして死に抗う夢までをたどります。

クロード、GPT、パランティアと2026年の世界戦争 表紙

全8編

クロード、GPT、パランティアと2026年の世界戦争

キム・ギョンジン

人工知能はいかにして戦争の引き金を引くようになったのか. プロローグ、三部六章、エピローグ

画面に一つの名前が表示されています。情報将校はそれを20秒間見つめ、男性かどうかだけを確認して次へ進みます。その20秒のうちに一人が死に、その人を殺すと決めた責任が消えます。ガザのラベンダーからウクライナのメイブン、イランのエピック・フューリー、ベネズエラ上空の標的選定まで、標的を選ぶ手が人から機械へ移っていく2026年の戦場を追います。

中国ロボット産業2026:量産と実戦の時代 表紙

全25編

中国ロボット産業2026:量産と実戦の時代

キム・ギョンジン(金京鎮)

ヒューマノイド量産競争から米中覇権まで、2026年の中国ロボット産業の現在. 目次・まえがき・7部23章・エピローグ

深圳のある工場で、数百台のヒューマノイドが同じ動作を繰り返します。ユニツリーとUBTECHの量産競争、オプティマスのサプライチェーン、実戦配備の現場、そして米中技術覇権のなかで韓国が立つ位置を見据えます。

世界の人々はAIをどう使っているのか 表紙

全38編

世界の人々はAIをどう使っているのか

金京鎮 弁護士

人々がAIに実際に何を尋ねているのか、100の使い方の記録. 序文・全8部35章・本を閉じるにあたって・エピローグ

夜中の1時、電気を消した台所で、誰かは人間よりも機械に先に心を打ち明けます。ハーバード・ビジネス・レビューが選んだ100のAIの使い方を、心・健康・学び・思考・書くこと・仕事・道具・暮らしという8つの人生の場面に置き換えた本です。

技術の思春期を越える 表紙

全15編

技術の思春期を越える

金京鎮 弁護士

Dario AmodeiとAnthropic、そして制御可能な知能に向けた死闘. 目次、序文、プロローグ、12章、エピローグ

父親を失った一人の物理学徒が、制御可能な人工知能を作ると誓って繰り広げた死闘。Dario AmodeiとAnthropicがPentagonやホワイトハウスと衝突し、スケーリング法則と憲法的AIで時代を揺るがした物語。

ドローン戦争

AIライブラリ · PDF Book

ドローン戦争

ウクライナが書き換える戦争の文法

金景珍 · ドローン戦争:ウクライナが書き換える戦争の文法

社長、そろそろAI社員を一人置きましょう

目次、43章、付録11編、エピローグ

社長、そろそろAI社員を一人置きましょう

キム・ギョンジン 著

小規模事業者のためのAI自動化システム構築

Codexの具体的な活用事例37選 cover

本として読む

Codexの具体的な活用事例37選

キム・ギョンジン弁護士

朝のブリーフィングからエージェント群まで、実務で使う37の自動化

このガイドは、CodexとAIエージェントを個人業務、データ処理、マーケティング、営業、文書、開発、ブラウザ操作に結びつける37の実務例をまとめたものです。

2026年北京:二人の巨人の危険な舞踏 表紙

16本公開

2026年北京:二人の巨人の危険な舞踏

金景珍(キム・キョンジン)

トランプ・習近平会談、その内側で起きたこと. 目次、序論、13章、結び

トランプの北京訪問を、ホルムズ、希土類、台湾、ボーイング、大豆、AIチップという場面から追います。

AIに任せて席を離れる 表紙

27本公開

AIに任せて席を離れる

キム・ギョンジン弁護士

YOLOモード完全入門. 目次と26章

Claude CodeとCodexのYOLOモードを初めて使う人のためのオンライン書籍です。AIにファイル読み取り、コード作成、コマンド実行を任せながら、取り消し、Dockerサンドボックス、安全確認を手元に置く流れを説明します。

人工知能と社会構造の変化 表紙

16記事

人工知能と社会構造の変化

金京鎮

目次、序文、13章、エピローグ

『人工知能と社会構造の変化』は金京鎮がAI書房で公開するオンライン書籍です。労働、教育、不平等、知的財産、都市、エネルギー、サイバー安全保障、人間関係、民主主義まで、AIが社会構造をどう変えるかを考察します。

ジェンスン・フアンの物語 表紙

16記事

ジェンスン・フアンの物語

金京鎮

目次、序文、13章、エピローグ

『ジェンスン・フアンの物語』は金京鎮がAI書房で公開するオンライン書籍です。移民少年からNVIDIA創業者へ、GPU、CUDA、AI工場、ロボティクスへと続くジェンスン・フアンの選択とAI産業の変化を辿ります。

人工知能AI、法廷に立つ 表紙

26記事

人工知能AI、法廷に立つ

金京鎮

目次、序文、21章、付録3編

『人工知能AI、法廷に立つ』は金京鎮がAI書房で公開するオンライン書籍です。生成AI、著作権、営業秘密、差別、顔認識、医療AI、自動運転、刑事司法まで、AI時代の法的争点を判例と規制から読み解きます。

PALANTIR:戦争、監視、人工知能 表紙

16記事

PALANTIR:戦争、監視、人工知能

金京鎮

目次、序文、14章

『PALANTIR:戦争、監視、人工知能』は金京鎮がAI書房で公開するオンライン書籍です。PayPalマフィア、9.11以後の安全保障、ウクライナ戦場、Pentagon改革、監視と予測警察、AI覇権競争を通じてPalantirの力を分析します。

AIが人類に投げかける10の問い 表紙

12記事

AIが人類に投げかける10の問い

金京鎮

目次、序文、10章

『AIが人類に投げかける10の問い』は金京鎮がAI書房で公開するオンライン書籍です。AI責任、監視、兵器、ディープフェイク、雇用、統制、環境、データ、人間のアイデンティティを10の問いとして整理します。

軍事人工知能 cover

全17編公開

軍事人工知能

金京鎮・金元泰

目次、序文、14章、エピローグ

自律兵器、ドローン、指揮統制、兵站、サイバー防衛から、米国、中国、イスラエル、韓国、世界の防衛AI企業まで、軍事人工知能を体系的に読み解く一冊です。

韓東勲が韓国に残したこれまでの痕跡 表紙

13記事

韓東勲が韓国に残したこれまでの痕跡

金京鎮

目次、12章

『韓東勲が韓国に残したこれまでの痕跡』は金京鎮がAI書房で公開するオンライン書籍です。非常戒厳の夜、ローンスター、金融投資税、検察改革、児童保護、移民庁構想、弱者のための法まで、韓東勲の公的記録を整理します。

人工知能戦闘機、人工知能空軍 表紙

43記事

人工知能戦闘機、人工知能空軍

金京鎮

目次、序文、40章、エピローグ

『人工知能戦闘機、人工知能空軍』は金京鎮がAI書房で公開するオンライン書籍です。無人機、AIパイロット、CCA、MUM-T、第6世代戦闘機、群集飛行、韓国型空中戦闘体系まで、AIが変える空戦と軍事倫理を記録します。

チャイ売りから首相へ cover

全13編公開

チャイ売りから首相へ

金京鎮

目次、序文、10章、エピローグ

ヴァドナガルのチャイ売りの少年ナレンドラ・モディが、RSS組織者、グジャラート州首相、三期目のインド首相へ進む軌跡をたどり、現代インド、韓印関係、台頭する大国のリスクを読む政治評伝です。

脳を読む人々:Neuralinkと人類最後の革命 表紙

21記事

脳を読む人々:Neuralinkと人類最後の革命

金京鎮

目次、プロローグ、18章、エピローグ

『脳を読む人々:Neuralinkと人類最後の革命』は金京鎮がAI書房で公開するオンライン書籍です。BCI、Neuralink、Synchron、非侵襲型技術、医療革命、神経権、人間増強を通じて脳と機械が接続される未来を考えます。

サム・アルトマン伝:人工知能革命の開拓者 cover

22本公開

サム・アルトマン伝:人工知能革命の開拓者

キム・ギョンジン、キム・ギョンラン

目次、プロローグ、7部、20章

サム・アルトマンの少年時代、起業、Y Combinator、OpenAI、ChatGPT、解任と復帰、AI時代の責任をたどるオンライン伝記です。

ガラスの天井を越えて cover

全39編公開

ガラスの天井を越えて

金京鎮

目次、プロローグ、31章、エピローグ、付録5編

日本初の女性首相となった高市早苗の成長、政治入門、三度の総裁選、首相就任、外交・安全保障・経済路線をたどる政治評伝です。

Nano Banana Pro実践プロンプトブック cover

24本公開

Nano Banana Pro実践プロンプトブック

キム・ギョンジン

6部、22章、授業用プロンプト付録

Nano Banana Proの画像生成、編集、文字レンダリング、キャラクター一貫性、実務での使い方、収益化までを授業と仕事で使いやすくまとめたオンライン書籍です。

法律実務と人工知能 表紙

16本の記事

法律実務と人工知能

金京鎮

目次、序文、14部

金京鎮AI書房のオンライン書籍。法律リサーチ、書面作成、証拠分析、契約レビュー、NotebookLM、生成AIの実務ワークフローを法律実務の視点で整理します。

北極航路に関する7つの誤解 表紙

10本の記事

北極航路に関する7つの誤解

金京鎮

目次、序文、7章、エピローグ

金京鎮AI書房のオンライン書籍。北極航路をめぐる速さ、定期航路、保険、安全規則、通年開放、炭素削減、インフラに関する7つの誤解を扱います。

こんにちは、金京鎮です 表紙

10本の記事

こんにちは、金京鎮です

金京鎮

目次、はじめに、推薦文、6章、結び

金京鎮AI書房のオンライン書籍。成長の歩み、科学技術政策、議員外交、立法の闘い、東大門のビジョン、韓国の人口危機への提案を収めています。

人工知能選挙 cover

14本公開

人工知能選挙

キム・ギョンジン

目次、著者序文、11章、結びの文章

選挙メッセージ、広報物、デジタル選挙運動、データ分析、陣営運営、偽情報への備え、法的リスク、すぐ使えるプロンプトをまとめたオンライン書籍です。

韓東勲の物語 表紙

39記事

韓東勲の物語

金京鎮

目次、プロローグ、36章、エピローグ

『韓東勲の物語』は金京鎮がAI書房で公開するオンライン書籍です。2024年12月3日の非常戒厳から法務行政、検察改革、庶民政策に至るまで、韓東勲の公的歩みと人間的な姿を記録しています。

大学生のための教養AI 表紙

16本の記事

大学生のための教養AI

金京鎮

目次、まえがき、13章、結びの文章

金京鎮AI書房のオンライン教科書。AIの歴史、日常活用、文書作成、研究、画像、発表、動画、生産性、学習、就職、著作権、ガバナンスを扱います。

デミス・ハサビス、Google人工知能の父 表紙

34記事

デミス・ハサビス、Google人工知能の父

金京鎮

目次、序文、31章、エピローグ

『デミス・ハサビス、Google人工知能の父』は金京鎮がAI書房で公開するオンライン書籍です。DeepMindの創設からAlphaGo、AlphaFold、ノーベル賞受賞に至るまで、AIの歴史を変えた天才科学者の軌跡を辿ります。

ジョージア歴史文化紀行 表紙

24記事

ジョージア歴史文化紀行

金京鎮

目次、序文、17章、4付録、エピローグ

『ジョージア歴史文化紀行』は金京鎮がAI書房で公開するオンライン書籍です。コーカサスの関門ジョージアの8000年の歴史、ワイン文化、正教会、薔薇革命から現代の地政学まで、旅と歴史が交差する紀行文です。

千の祈り、一つの山。アルメニアを読む 表紙

13記事

千の祈り、一つの山。アルメニアを読む

金京鎮

目次、序文、10章、エピローグ

『千の祈り、一つの山。アルメニアを読む』は金京鎮がAI書房で公開するオンライン書籍です。世界初のキリスト教国家アルメニアの古代王国から虐殺、ディアスポラ、現代の課題まで、信仰と苦難の歴史を辿ります。

政治と人 表紙

25本公開

政治と人

キム・ギョンジン

目次、プロローグ、22章、エピローグ

政治は人を読むこと、信頼を得ること、関係を守ること、危機の季節を耐えることから始まる。金京鎮がAI書斎で公開するオンライン書籍です。

Claude Code完全攻略 表紙

41記事

Claude Code完全攻略

金京鎮

目次、40章

『Claude Code完全攻略』は金京鎮がAI書房で公開するオンライン書籍です。Claude Codeの基本操作からエージェントワークフロー、MCP接続、実践事例まで、AIツールを業務に活かすための完全ガイドです。

マレーシア、マラッカ海峡を制する者が世界を制する 表紙

23記事

マレーシア、マラッカ海峡を制する者が世界を制する

金京鎮

目次、序文、20章、エピローグ

『マレーシア、マラッカ海峡を制する者が世界を制する』は金京鎮がAI書房で公開するオンライン書籍です。マレーシアの歴史・政治体制・マラッカ海峡の戦略的重要性・主要都市・韓国との関係を幅広く考察します。

2026年米国・イラン戦争と世界エネルギー危機 表紙

39記事

2026年米国・イラン戦争と世界エネルギー危機

金京鎮

目次、プロローグ、36章、エピローグ

『2026年米国・イラン戦争と世界エネルギー危機』は金京鎮がAI書房で公開するオンライン書籍です。ホルムズ海峡封鎖シナリオから始まり、エネルギー安全保障、地政学的リスク、韓国の選択を考察します。

法句経 423偈 表紙

28本の記事

法句経 423偈

金京鎮

目次、編者の言葉、26品、423偈

金京鎮AI書房のオンライン書籍。法句経423偈を26品に整理し、詩集のような呼吸でゆっくり読めるようにした版です。

行政に人工知能を導入した世界各国の事例 表紙

25本の記事

行政に人工知能を導入した世界各国の事例

金京鎮

目次、23章、エピローグ

金京鎮AI書房のオンライン書籍。公共部門へのAI導入、各国戦略、行政サービス、ガバナンス、今後の政策課題を扱います。

Claude Coworkとエージェント活用マニュアル 表紙

11記事

Claude Coworkとエージェント活用マニュアル

金京鎮

目次、序文、8章、エピローグ

『Claude Coworkとエージェント活用マニュアル』は金京鎮がAI書房で公開するオンライン書籍です。ファイル管理、財務分析、マーケティング、リサーチ、IT開発など各業務領域でのAIエージェント活用法を実践的に解説します。

AI教室、成績が変わる 表紙

26本の記事

AI教室、成績が変わる

金京鎮

目次、まえがき、24節

金京鎮AI書房のオンライン書籍。AIが小中高の学習、授業、評価、教育格差の改善をどう支援するかを扱います。

AI覇権戦争 表紙

8本の記事

AI覇権戦争

金京鎮

目次、7章

金京鎮AI書房のオンライン書籍。AI超知能、米中技術競争、欧州と韓国のAI法、国際AIガバナンスを扱います。

[AI書房] 第7章 ITプロジェクトおよびソフトウェア開発

Claude Coworkとエージェント活用マニュアル
投稿者
金京鎮
投稿日
2026-05-07 01:11
閲覧数
214

Claude Coworkとエージェント活用マニュアル

第7章 ITプロジェクトおよびソフトウェア開発

金京鎮

ソフトウェアを作ることは、家を建てる過程に似ています。設計図を描き、資材を選び、骨組みを組み立て、内装を仕上げ、漏水がないか点検します。

この過程で最も時間を要するのは、レンガを積む行為ではなく、レンガをどこにどのように積むかを決め、正しく積まれたかを確認するプロセスです。Claude Code と Cowork は、この決定と確認の領域において、開発者と企画者の負担を軽減します。

この章は、これまでの第1章から第6章とは性格が異なります。コードを扱う章ですが、コーディング経験のない読者でも、要件定義書(PRD)の作成やテストケース文書の作成といった企画領域を追随できるよう、参入障壁を低く設定しています。一方、エージェントチームの運用やコードマイグレーションなど、開発経験が必要な領域については、概念理解に比重を置きつつ、実行については中級者以上の読者を対象に案内します。

1 エージェントチームを基盤とした並列作業

一人が四人分の仕事をこなさなければならない開発者の一日

ウェブアプリケーションを一つ作成すると仮定してみましょう。

ユーザーが見る画面(フロントエンド)を作成し、画面の背後でデータを処理するサーバー(バックエンド)を構築し、データを保存するデータベースを設計する必要があります。最後に、これら三つが適切に連携して動作するかをテストしなければなりません。

一人の人がこの四つの作業を順番に行う場合、前の作業が完了しなければ次の作業を開始できません。バックエンドが完成していなければフロントエンドでデータを取得できず、データベースの構造が確定していなければバックエンドのコードを書くことができません。この順次的なボトルネックが、開発期間を延ばす最大の原因です。

実際の企業では、この問題をチームで解決します。フロントエンド開発者、バックエンド開発者、データベース管理者、QAエンジニアがそれぞれ担当領域を並行して作業し、必要に応じて互いにコミュニケーションを取りながら調整します。エージェントチーム(Agent Teams)は、この人間チームの構造をAIで再現したものです。

「ナ エージェントチーム」とは何か

エージェントチームとは、複数の Claude コードインスタンス(同時に実行される個別の AI セッション)がそれぞれ独立した役割を担い、一つのプロジェクトを並列で実行する機能です。2026 年 2 月に Claude Ops 4.6 のリリースに伴い、研究プレビューの形態で公開されました。

以前にも「サブエージェント」という概念は存在していました。

サブエージェントは、メインエージェントが指示を出すと独立して作業を実行し、結果だけを返す方式でした。問題は、サブエージェント同士が互いに会話できない点でした。フロントエンドのサブエージェントがバックエンドのサブエージェントに「API のアドレスが変わったのでコードを修正してください」と直接伝える方法がありませんでした。すべてのメッセージはメインエージェントを経由する必要があり、このボトルネックにより、複雑なプロジェクトでは互いのコードが衝突する事態が頻発しました。

エージェントチームはこの構造を変革しました。チームメンバーのエージェント同士がメッセージを直接やり取りできるようになりました。共有タスクリストを通じて、誰がどのような作業を担当しているかを確認し、一つのタスクが完了すると、次のタスクを自ら取得します。チームリード役のエージェントが全体を調整しますが、実務的なコミュニケーションはメンバー同士が直接行います。

[知っておいてください] エージェントインスタンスとは、一つの Claude コードセッションを指します。各インスタンスは独自のコンテキストウィンドウ(AI が一度に記憶できる情報の範囲)を持ち、独立して動作します。Claude Ops 4.6 は、インスタンスあたり 100 万トークン(約 75 万語)のコンテキストウィンドウをサポートしているため、大規模なコードベース全体をアップロードして作業を行うことが可能です。

エージェントチームはどのように活用するか

(1) 基本的な使い方: エージェントチームのアクティブ化と最初の実行 エージェントチームは実験機能のため、別途有効化する必要があります。

① クロードコードの設定ファイル (settings.json) を開きます。

② 以下の一行を追加します。「CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1"」

③ 設定を保存し、 Claude コードを再起動します。

④ ターミナルで以下のように指示します。「このプロジェクトの README.md ファイルと全体のフォルダ構造を分析し、セキュリティレビュー担当者およびコード品質レビュー担当者の 2 名のエージェントチームを作成して、コードレビューを実行してください。」

⑤ クロードがチームリーダーの役割を自ら引き受け、2 名のチームメンバーエージェントを生成します。ターミナルには各エージェントの活動ログが表示されます。

⑥ チームメンバーエージェントがそれぞれコードを分析し、発見した問題をメッセージで互いに共有します。チームリーダーが結果を統合して最終的なレビューレポートを生成します。

(2) 応用例:tmux によるエージェントごとの画面分離 tmux(ターミナル多機能化ツール)を事前にインストールしておくと、各エージェントの作業画面を分割して同時に観察できます。

① tmux がインストールされた状態でエージェントチームを実行すると、画面が複数のパネルに分割され、各エージェントのターミナルが個別に表示されます。

② Shift キーと方向キーを押して特定のエージェントのパネルに移動し、そのエージェントに対してのみ個別の指示を出すことができます。

「フロントエンドエージェントよ、先ほど作成したログインページのボタン色を青から紺色に変更してください。」

③ 当該エージェントが指示を受け、修正を行い、変更事項をチームメンバーに通知します。

(3) 実戦活用:ブログプラットフォーム構築プロジェクト 小規模なブログプラットフォームを構築するシナリオです。

① プロジェクトフォルダに要件定義文書を用意します。(PRD の作成方法は、この章の第 2 節で取り扱います。)

② クロードには以下のように指示します。

「このPRDを読み、バックエンドAPI担当、フロントエンドUI担当、データベーススキーマ担当、テスト作成担当で構成されるエージェントチームを作成してください。バックエンドエージェントはNode.jsとFastifyを用いてREST APIを実装し、フロントエンドエージェントはReactでUIを実装してください。データベースエージェントはまずPostgreSQLのスキーマを確定し、他のエージェントと共有してください。テストエージェントは各APIエンドポイントに対するユニットテストを作成してください。」

③ クロードがチームを編成し、作業を分担します。データベースエージェントがスキーマを確定すると、バックエンドエージェントとフロントエンドエージェントがそのスキーマを基準に同時にコードを作成します。

④ 作業が進行する間、チームリードが進行状況を要約して示します。衝突が発生した場合は優先順位を判断して解決します。

エージェントチームを活用する際に知っておくべきこと

エージェントチームはトークン消費量が多くなります。各メンバーが独立した文脈ウィンドウを維持しながら互いにメッセージをやり取りするため、単一のエージェントで同じ作業を行う場合と比較してコストが4〜7倍に増大する可能性があります。単純なスクリプト作成やファイル整理のような作業にエージェントチームを使う理由はありません。

エージェントチームが効果を発揮する状況は明確です。フロントエンド、バックエンド、データベース、テストなど複数の階層を同時に扱うプロジェクト、異なる仮説を同時に検証する必要があるデバッグ、大規模なコードレビューなど、並列探索が実質的な価値を生む場合です。

もう一点。エージェントチームが生成したコードは個々の部分では清潔に見えても、全体システムの文脈において予期せぬ衝突を引き起こす可能性があります。あるエージェントがパフォーマンスのために導入したキャッシング構造が、別のエージェント

が作成したリアルタイム同期ロジックと衝突するといったケースです。エージェントがコードを記述する速度は速くなりましたが、そのコードが全体システム内でどのように機能するかを判断する責任は依然として人間にあります。

このような問題が発生した場合

(1) エージェントチームを作成したが、1 通のメッセージを送信しただけでセッションが終了する場合は、settings.json にエージェントチームの設定が正しく保存されているか確認してください。二重引用符とコロンの位置が正しいか確認し、Claude のコードを完全に終了してから再起動してください。

(2) チームメンバーのエージェントが同じファイルを同時に編集してコードが破損する場合は、プロンプトでファイルの所有権を明示してください。「各エージェントは担当フォルダのファイルのみを編集し、他のエージェントのファイルは読み取り専用とする」と指示することで、競合を減らすことができます。

(3) トークン使用量が予想よりも大幅に多い場合は、チームメンバー数を減らしてください。3 人で十分な作業に 5 人を投入すると、調整コストが増大するだけです。エージェントチームの作業には、Pro プランよりも Max プランの方が適しています。

2 ソフトウェア要件定義書およびアーキテクチャ文書化

「決済機能付きのアプリを作って」という依頼が失敗する理由

AI にコードを書かせる際、最も頻繁に起こる失敗は AI の能力不足ではなく、指示の曖昧さに起因します。「決済機能付きのプロジェクト管理アプリを作ってほしい」と伝えると、AI は無数の空白を自ら埋めます。決済手段はカードか振込か、ユーザー認証はメールかソーシャルログインか、プロジェクト管理の単位はチームか個人か。AI が補完した仮定が利用者の意図と異なる場合、結果は誰も望まないものとなります。

要件定義書(PRD:Product Requirements Document)は、この空白を事前に埋める文書です。何を作るのか、誰のためのものか、成功の基準は何か、今回は行わないことは何かを明確に記述します。PRD の品質がプロジェクトの成否を左右します。

私が Claude Code で作る PRD はどのようなものか

Claude Code の計画モード(Plan Mode)を活用すれば、AI はコードを一行も書かずに、分析と設計にのみ集中します。頭の中に浮かぶ断片的なアイデアを入力すると、AI が体系的な質問を投げかけて隙間を埋め、その結果を数十ページにわたる企画書として整理します。

最終的な成果物には、サービスの目的と成功基準、主要なユーザージャーニー、機能要件と非機能要件(パフォーマンス、セキュリティ、可用性)、データベーススキーマ(テーブル間の関係、データ型、制約条件)、システムアーキテクチャ(技術スタック、インフラ構成、認証体系)、そしてテストシナリオが含まれます。

PRD を作成してみましょう

(1) 基本利用:アイデアから質問リストを抽出する

① Claude コードターミナルを開き、計画モードに切り替えます。

② 以下のように入力します。

「中古品取引アプリを作りたいです。位置情報検索、チャット、エスクロー決済が核心です。コードを書く前に、プロジェクトに関する仮説を減らすために、明確化のための質問を 10 個以上投げてください。」

③ クロードが以下のような質問を提示します。「位置ベース検索の基本的な半径は何キロメートルに設定しますか?」「チャットで画像送信をサポートしますか?」「エスクロー決済の手数料率はいくらにしますか?」「会員登録はメール認証方式ですか、それともソーシャルログインですか?」「販売者認証手続きは必要ですか?

④ 各質問に答えます。

⑤ クロードはすべての回答に基づいて PRD 草案を生成します。

(2) 応用例:データベーススキーマと API 仕様まで含める

① 基本使用で生成された PRD 草案を確認した後、追加指示を入力します。

「この PRD をもとに、データベーススキーマを Prisma 形式で設計してください。User、Product、Transaction、Chat、Review の各テーブルを含め、各関係性とインデックスを明記してください。また、主要な API エンドポイントを OpenAPI 形式で整理してください。」

② クロードが Prisma スキーマファイルと OpenAPI 仕様を生成します。

③ 生成されたドキュメントを開き、内容を精査します。

(3) 実戦活用:PRD をエージェントチームの実行指針として活用する PRD の真の価値は、この文書がコーディングの起点となる点にあります。

① PRD が完成したら、Claude コードセッションを初期化します。コンテキストウィンドウに過去の対話が混在すると混乱を招くためです。

② 新しいセッションで、以下のように指示します。

「このフォルダにある PRD.md ファイルと schema.prisma、openapi.yaml を読み、その文書に従ってエージェントチームを構成し、アプリを実装してください。バックエンドは Fastify、フロントエンドは React、データベースは PostgreSQL を使用します。」

③ エージェントチームは PRD を「実行指針書(ソース・オブ・トゥルース)」として作業を開始します。

AI が作成した PRD をそのまま使用してはならない理由

AI が作成した PRD は出発点であり、最終版ではありません。AI は論理的に隙のない構造を構築するのが得意ですが、ビジネスの文脈における微妙な差異を完全に理解することはできません。韓国のエスクロー決済規定、個人情報保護法におけるデータ保管要件、対象顧客の年齢層に応じた UX の嗜好といった現実的な制約は、人間が必ず確認する必要があります。

レビューの順序は、次のように設定するのが良いでしょう。製品責任者が目標と範囲を確認し、エンジニアが技術的な実現可能性を検討します。セキュリティ担当者が認証、暗号化、ログポリシーを検証し、運用担当者がデプロイとモニタリングの体制を確認します。優れた設計書とは、一度で完成する文書ではなく、レビューを通じて決定を明確に残す文書です。

非開発者でも取り組める領域

PRDの作成は、コーディングの経験がなくても十分に可能です。サービスのアイデアを言葉で説明し、AIの質問に答えるプロセスは、ビジネス感覚の領域です。Coworkのデスクトップインターフェースでも同様のプロセスを実行できるため、ターミナルに馴染みのない読者には、Coworkから始めることをお勧めします。

このような問題が生じた場合

(1) PRDがあまりにも一般的で、自プロジェクトに合っていないと感じる場合、明確化の質問ステップを飛ばして直接PRDを要求すると、以下のような結果になります。まずAIに質問を投げかけ、具体的に回答を得た後に文書を作成させることで、品質を向上させることができます。

(2) 生成されたデータベーススキーマに必要なテーブルが欠けている場合、「監査ログ(Audit Log)、通知(Notification)、ファイル添付(Attachment)テーブルを追加してください」といったように、欠落している要素を具体的に指定します。

3 コードマイグレーションと自動テスト

技術的負債という見えない負債

技術的負債(Technical Debt)とは、古いコードが積み重なって生じる見えないコストのことです。新機能を追加するたびに予期せぬ場所でエラーが発生し、新しい開発者が合流すればコードを理解するだけで数週間を要し、セキュリティパッチを適用するには依存関係の問題に直面します。そのため、企業は定期的にコードマイグレーション(既存のフレームワークを新しいフレームワークへ移行する作業)を実施します。

この作業は開発チームが最も嫌がる業務の一つです。新機能を開発するのではなく、既存の機能を維持しながら内部構造のみを変更する作業だからです。ユーザーの目に見える変化はありませんが、投入される時間とコストは莫大です。

Claude Code がマイグレーションを支援する仕組み

Claude Opus 4.6 の 100 万トークンという文脈ウィンドウは、数十万行に及ぶコードベース全体を一度に分析することを可能にします。従来の AI ツールはコードを細かく分割して入力する必要があったため、ファイル間の依存関係を見過ごしがちでしたが、今では全体構造を把握した上で変換計画を立てることができます。

マイグレーションは通常、以下の 4 つの段階を経て行われます。第一に、現在のコードの境界を特定します。ルーティング、ミドルウェア、認証、エラー処理、データベースアクセス、外部 API 呼び出しを分離します。第二に、現在の API 構造を OpenAPI または JSON Schema として固定します。第三に、新しいフレームワークの構造に合わせて再構築します。第四に、既存バージョンと新バージョンを並べて動作の違いを検証します。

Express から Fastify への移行

(1) 基本利用:マイグレーション分析レポートの生成 ① 既存の Express プロジェクトフォルダを Claude Code に接続します。② 以下のように指示を出します。

「このプロジェクト全体を分析してください。Express の app.get、app.post パターンを使用するすべてのルートを特定し、ミドルウェアチェーンをマッピングし、データベースクエリがどこで実行されるかを整理してください。コードを修正せず、Fastify へ移行する際のリスクを 1(低)から 5(高)まで評価した移行分析レポートを作成してください。」

③ クロードがプロジェクトをスキャンし、全ファイルの相互参照関係とリスク要因を分析したレポートを生成します。

(2) 応用事例:段階的移行の実行

① 分析レポートを確認した後、リスクの低いモジュールから移行を開始します。

「リスク 1〜2 と評価されたルートから Fastify 形式へ変換してください。Express の req、res オブジェクトを Fastify の request、reply オブジェクトに置き換え、各ルートに JSON Schema ベースのリクエスト検証を追加してください。」

② クロードはこれらのファイルを変換します。この際、単なる機械的な置換ではなく、Express のミドルウェア方式と Fastify のプラグイン方式の構造的差異を反映させます。

(3) 実戦活用:自動テストの生成と検証

コードを移すことと同じくらい重要なのは、移したコードが正しく動作しているかを確認することです。

① 以下のように指示します。②「変換された各 Fastify ルートに対して、単体テストを作成してください。正常なリクエスト、不正なパラメータ、認証失敗、リソース不存在、サーバーエラーのシナリオを含めてください。Fastify の inject 方式を用いて、ネットワークポートを開かずにテストできるようにしてください。」

② クロードは各エンドポイントに対するテストコードを生成します。

③ 生成されたテストを実行し、通過したかどうかを確認します。「今作成したテストをすべて実行してください。」

④ クロードがテストを実行し、失敗した項目があればその原因を分析してコードを修正します。このプロセスはすべてのテストが通過するまで繰り返されます。

E2E(エンドツーエンド)テストまで必要であれば、Playwright(ブラウザ自動化ツール)を連携します。「Playwrightを使用して、ユーザーがログインし、商品を検索し、カートに追加し、決済するまでの一連の流れをテストするE2Eテストコードを作成してください。」

AIが生成したテストの限界

AIが生成したテストは、コードの現在の動作をそのまま検証します。現在の動作自体にバグがある場合、そのバグを正常とみなすテストが作成される可能性があります。そのため、AIが生成したテストコードも人間がレビューする必要があります。「このテストが検証する動作が、私たちが意図した動作と一致しているか」を確認するプロセスは自動化できません。

過去の開発者が残した不合理に見えるロジックが、実際には特定の運用環境のバグを回避するための解決策だった可能性があります。AI はこうした背景の歴史を知らずにコードを整理してしまう恐れがあります。移行において何を保存すべきかを判断するのは人間の役割です。

このような問題が発生した場合

(1) 移行中に「Cannot find module」エラーが繰り返される場合、依存パッケージが新しいフレームワークと互換性がない可能性があります。Claude に「package.json の依存性リストを分析して、Fastify と互換性がないパッケージを見つけてください」と指示してください。

(2) すべてのテストが通過するにもかかわらず、実際のサービスでエラーが発生する場合、テストでカバーしきれていないシナリオが存在することを意味します。運用環境の実際のデータパターンやネットワーク遅延などの条件をテストに反映させる必要があります。

4 UI/UX ウェブデザインおよび Figma 同期

デザイナーと開発者の間の古くからの溝

デザイナーがピグマ(Figma、ウェブベースのデザインツール)で精巧に作成したデザイン案が、開発者のコードとして実装されると、微妙に異なってしまいます。余白が4ピクセルずれたり、フォントの太さがセミボールドではなくボールドで適用されたり、影の透明度が変化したりします。デザイン案を開発者に引き渡すプロセスは「ハンドオフ(Handoff)」と呼ばれますが、この区間が製品開発において最も摩擦の大きいポイントの一つでした。

AIはこのハンドオフにおける摩擦を軽減しています。3つの方向からアプローチします。

ピグマMCP連携とは何か

MCP(Model Context Protocol)は、AIが外部ツールやデータとやり取りするための通信規格です。ピグマがMCPサーバーを提供したことで、Claudeのコードがピグマのキャンバス上のデザイン情報を直接読み書きできるようになりました。2026年2月17日に公開された「コード・トゥ・キャンバス(Code to Canvas)」機能により、双方向の同期が可能となっています。

Figma MCP サーバーはスクリーンショットのピクセルだけを眺めているわけではありません。コンポーネントの階層構造、色コード、フォントサイズ、余白の数値、デザイントークン(デザインの基本単位を定義した値)といった構造的な情報を読み取っています。

さあ、Figma と Claude Code を接続して実際に使ってみましょう

(1)基本使用:Figma MCP サーバーの設定

① Figma デスクトップアプリを最新バージョンに更新します。

② Claude Code のターミナルで次のコマンドを入力します。

claude mcp add --transport http figma https://mcp.figma.com/mcp

③ Claude Code で/mcp コマンドを入力し、Figma サーバーが接続されているか確認します。

④ Figma で認証を求められたら、「Allow Access」をクリックしてください。

(2) 応用例:Figma デザインをコードへ変換する

① Figma で変換したいフレーム(画面単位)を選択します。

② Claude コードに Figma のリンクを貼り付け、以下のように指示します。

「この Figma デザインを分析して、React コンポーネントに変換してください。Tailwind CSS を使用し、レスポンシブブレイクポイントを適用してください。デザインに定義された色コードとフォントサイズをそのまま反映してください。」

③ Claude は Figma MCP を通じてデザインの構造的情報を取得し、React コンポーネントのコードを生成します。

④ 生成されたコードをローカルサーバーで実行し、デザイン案と比較します。

(3)実戦活用:コードから Figma への逆方向転送

この機能が双方向同期を実現する核心です。開発者がコードで作成した UI をピグマのキャンバスへ送り、デザイナーが編集可能なフレームとして受け取ることができます。

① クロードのコード上でローカルサーバーを実行した状態で、以下のように指示します。

「私のアプリのローカルサーバーを開始し、現在の画面をキャプチャして新しいピグマファイルへ送信してください。」

② クロードがブラウザウィンドウを開き、キャプチャツールバーを表示します。ページ全体、特定の要素、複数の画面を連続してキャプチャできます。

③ キャプチャが完了すると、クラウドがピグマファイルのリンクを提供します。このリンクを開くと、キャプチャされた画面が編集可能なピグマフレームとして変換されています。

④ デザイナーが Figma で色や余白を修正すると、Claude Code がその変更を検知し、コードに反映できます。「Figma 内のこのフレームの変更を確認し、変更された部分のみコードに反映してください。」

知っておくべき制約事項

Figma MCP サーバーの一部機能は特定の条件下でのみ動作します。Code to Canvas 機能は現在、Claude Code、OpenAI Codex、VS Code のみでサポートされています。Figma のプランも、Dev または Full シート、Organization または Enterprise プランが必要です。API 呼び出しにはレート制限があるため、大量のフレームを一度に変換すると処理速度が遅くなる可能性があります。

AI が生成する UI コードの視覚的精度は向上していますが、アクセシビリティ基準を自動的に満たすわけではありません。スクリーンリーダー(視覚障害者用画面読み上げプログラム)との互換性、キーボードナビゲーション、色対比比などの詳細は、人間が別途検証する必要があります。ドラッグ&ドロップ、無限スクロール、複雑なフォーム検証などのインタラクションロジックについては、AI が生成したコードの品質にばらつきがあります。

デザインの見た目自体は AI が迅速に作成できます。しかし、ユーザーの指先が感じる反応の速さ、スクロール時の画面の呼吸感、エラーメッセージが伝えるトーンなどは、依然として人間が手直しすべき領域です。

MA 実装は 3 つの段階で行います

一度にすべての機能を導入しようとすると、チームが疲弊してしまいます。最初の段階では、デザイン案をコードに変換する基本的な流れを習得します。2 番目の段階では、Figma MCP を接続して、デザイン文脈(色、余白、コンポーネント階層)を AI に提供します。

3 番目の段階では、Code Connect(Figma のデザインコンポーネントとコードリポジトリの実際のコンポーネントを接続するツール)を設定し、AI が新しいコンポーネントを考案するのではなく、チームがすでに使用しているコンポーネントを活用できるようにします。秩序立てて進める方が、結局はより迅速です。

このような問題が発生した場合

(1) Figma MCP サーバーを接続したにもかかわらず、generate_figma_design ツールが表示されない場合、以前に接続した Figma MCP インスタンスが残っていると競合が発生します。既存の接続を解除し、Claude コードを再起動してから再度接続してください。Figma プラグインを通じてインストールする方法が最も安定しています。

claude plugin install figma@claude-plugins-official

(2) ピグマでコードへの変換結果が元稿と大きく異なる場合は、スクリーンショットのみから推測するのと、MCPを通じて構造を読み取るのでは結果が異なります。MCPが正常に接続されているかを確認し、/mcp コマンドで確認した上で、プロンプトに「ピグマ MCP からデザイン文脈を取得して変換してください」と明記してください。

(3) 「コードからキャンバスへ (Code to Canvas)」機能が動作しない場合、この機能はリモート MCP サーバー (https://mcp.figma.com/mcp) を通じてのみサポートされています。ローカル MCP サーバー(デスクトップアプリの Dev Mode MCP サーバー)のみが接続されている状態では、コードからピグマへ送る機能は動作しません。リモートサーバーを別途接続してください。

本章で取り上げた 4 つの領域はそれぞれ独立した機能ですが、実際のプロジェクトでは一つの流れとして連携します。

PRD で要件を定義し、エージェントチームがコードを実装し、自動テストが品質を検証し、ピグマの同期がデザインとコードの隔たりを埋めます。AI がコードを書く速度は人間よりも速いです。しかし、何を作るべきかを決定し、作成された結果が事業の文脈に合致しているかを判断するのは、画面の前に座る人の役割として残されています。機械が構築した骨格の上に、私たちの組織独自の判断と経験を重ねること。それがこれらのツールを正しく使う方法です。

金京鎮

弁護士 · 元国会議員 · AI政策研究者

kimkj.com

© 2026 金京鎮. All rights reserved.

#金京鎮 #AI書房 #ClaudeCowork #AIエージェント #業務自動化 #データ分析 #マーケティング #IT開発
kimkj.com ホーム
上部へスクロール
kimkj.com ホーム